openai 0.87.0 → 0.89.0

data/lib/openai/models/beta/beta_responses_client_event.rb

@@ -63,7 +63,7 @@ module OpenAI
 
           # @!attribute background
           #   Whether to run the model response in the background.
-          #   [Learn more](https://platform.openai.com/docs/guides/background).
+          #   [Learn more](https://developers.openai.com/api/docs/guides/background).
           #
           #   @return [Boolean, nil]
           optional :background, OpenAI::Internal::Type::Boolean, nil?: true
@@ -125,11 +125,11 @@ module OpenAI
           #
           #   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)
+          #   - [Text inputs and outputs](https://developers.openai.com/api/docs/guides/text)
+          #   - [Image inputs](https://developers.openai.com/api/docs/guides/images-vision)
+          #   - [File inputs](https://developers.openai.com/api/docs/guides/file-inputs)
+          #   - [Conversation state](https://developers.openai.com/api/docs/guides/conversation-state)
+          #   - [Function calling](https://developers.openai.com/api/docs/guides/function-calling)
           #
           #   @return [String, Array<OpenAI::Models::Beta::BetaEasyInputMessage, OpenAI::Models::Beta::BetaResponseInputItem::Message, OpenAI::Models::Beta::BetaResponseOutputMessage, OpenAI::Models::Beta::BetaResponseFileSearchToolCall, OpenAI::Models::Beta::BetaResponseComputerToolCall, OpenAI::Models::Beta::BetaResponseInputItem::ComputerCallOutput, OpenAI::Models::Beta::BetaResponseFunctionWebSearch, OpenAI::Models::Beta::BetaResponseFunctionToolCall, OpenAI::Models::Beta::BetaResponseInputItem::FunctionCallOutput, OpenAI::Models::Beta::BetaResponseInputItem::AgentMessage, OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCall, OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput, OpenAI::Models::Beta::BetaResponseInputItem::ToolSearchCall, OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam, OpenAI::Models::Beta::BetaResponseInputItem::AdditionalTools, OpenAI::Models::Beta::BetaResponseConfigurationUpdateItemParam, OpenAI::Models::Beta::BetaResponseReasoningItem, OpenAI::Models::Beta::BetaResponseCompactionItemParam, OpenAI::Models::Beta::BetaResponseInputItem::ImageGenerationCall, OpenAI::Models::Beta::BetaResponseCodeInterpreterToolCall, OpenAI::Models::Beta::BetaResponseInputItem::LocalShellCall, OpenAI::Models::Beta::BetaResponseInputItem::LocalShellCallOutput, OpenAI::Models::Beta::BetaResponseInputItem::ShellCall, OpenAI::Models::Beta::BetaResponseInputItem::ShellCallOutput, OpenAI::Models::Beta::BetaResponseInputItem::ApplyPatchCall, OpenAI::Models::Beta::BetaResponseInputItem::ApplyPatchCallOutput, OpenAI::Models::Beta::BetaResponseInputItem::McpListTools, OpenAI::Models::Beta::BetaResponseInputItem::McpApprovalRequest, OpenAI::Models::Beta::BetaResponseInputItem::McpApprovalResponse, OpenAI::Models::Beta::BetaResponseInputItem::McpCall, OpenAI::Models::Beta::BetaResponseCustomToolCallOutput, OpenAI::Models::Beta::BetaResponseCustomToolCall, OpenAI::Models::Beta::BetaResponseInputItem::CompactionTrigger, OpenAI::Models::Beta::BetaResponseInputItem::ItemReference, OpenAI::Models::Beta::BetaResponseInputItem::Program, OpenAI::Models::Beta::BetaResponseInputItem::ProgramOutput>, nil]
           optional :input, union: -> { OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::Input }
@@ -147,7 +147,7 @@ module OpenAI
           # @!attribute max_output_tokens
           #   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).
+          #   [reasoning tokens](https://developers.openai.com/api/docs/guides/reasoning).
           #
           #   @return [Integer, nil]
           optional :max_output_tokens, Integer, nil?: true
@@ -176,8 +176,8 @@ module OpenAI
           #   Model ID used to generate the response, like `gpt-6-astra`. 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.
+          #   [model guide](https://developers.openai.com/api/docs/models) to browse and
+          #   compare available models.
           #
           #   @return [Symbol, String, OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Model, nil]
           optional :model, union: -> { OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::Model }
@@ -211,7 +211,7 @@ module OpenAI
           # @!attribute previous_response_id
           #   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).
+          #   [conversation state](https://developers.openai.com/api/docs/guides/conversation-state).
           #   Cannot be used in conjunction with `conversation`.
           #
           #   @return [String, nil]
@@ -219,7 +219,7 @@ module OpenAI
 
           # @!attribute prompt
           #   Reference to a prompt template and its variables.
-          #   [Learn more](https://platform.openai.com/docs/guides/text?api-mode=responses#reusable-prompts).
+          #   [Learn more](https://developers.openai.com/api/docs/guides/text?api-mode=responses#version-prompts-in-code).
           #
           #   @return [OpenAI::Models::Beta::BetaResponsePrompt, nil]
           optional :prompt, -> { OpenAI::Beta::BetaResponsePrompt }, nil?: true
@@ -227,7 +227,7 @@ module OpenAI
           # @!attribute prompt_cache_key
           #   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).
+          #   [Learn more](https://developers.openai.com/api/docs/guides/prompt-caching).
           #
           #   @return [String, nil]
           optional :prompt_cache_key, String, nil?: true
@@ -240,7 +240,7 @@ module OpenAI
           #   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)
+          #   [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
           #   for current details.
           #
           #   @return [OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::PromptCacheOptions, nil]
@@ -257,7 +257,7 @@ module OpenAI
           #   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).
+          #   [Learn more](https://developers.openai.com/api/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
@@ -279,7 +279,7 @@ module OpenAI
 
           # @!attribute reasoning
           #   Configuration options for
-          #   [reasoning models](https://platform.openai.com/docs/guides/reasoning).
+          #   [reasoning models](https://developers.openai.com/api/docs/guides/reasoning).
           #
           #   @return [OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Reasoning, nil]
           optional(
@@ -296,7 +296,7 @@ module OpenAI
           #   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).
+          #   [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
           #
           #   @return [String, nil]
           optional :safety_identifier, String, nil?: true
@@ -309,13 +309,15 @@ module OpenAI
           #     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)',
-          #     then the request will be processed with the Flex Processing service tier.
-          #   - To opt-in to [Fast mode](/api/docs/guides/fast-mode) at the request level,
-          #     include the `service_tier=fast` or `service_tier=priority` parameter for
-          #     Responses or Chat Completions. The response will show `service_tier=priority`
-          #     regardless of if you specify `service_tier=fast` or `priority` in your
-          #     request.
+          #   - If set to
+          #     '[flex](https://developers.openai.com/api/docs/guides/flex-processing)', then
+          #     the request will be processed with the Flex Processing service tier.
+          #   - To opt-in to
+          #     [Fast mode](https://developers.openai.com/api/docs/guides/fast-mode) at the
+          #     request level, include the `service_tier=fast` or `service_tier=priority`
+          #     parameter for Responses or Chat Completions. The response will show
+          #     `service_tier=priority` regardless of if you specify `service_tier=fast` or
+          #     `priority` in your request.
           #   - If set to 'ultrafast', then the request will be processed with the
           #     access-controlled Ultrafast Processing service tier. This tier is currently
           #     available for `gpt-5.6-sol`; a response served through it will show
@@ -338,7 +340,7 @@ module OpenAI
           #   Whether to store the generated model response for later retrieval via API.
           #   Defaults to true when omitted. If set to true, response data will be stored for
           #   at least 30 days, subject to the
-          #   [data retention exceptions](/api/docs/guides/your-data#v1responses).
+          #   [data retention exceptions](https://developers.openai.com/api/docs/guides/your-data#v1responses).
           #
           #   @return [Boolean, nil]
           optional :store, OpenAI::Internal::Type::Boolean, nil?: true
@@ -348,7 +350,7 @@ module OpenAI
           #   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)
+          #   [Streaming section below](https://developers.openai.com/api/reference/resources/responses/streaming-events)
           #   for more information.
           #
           #   @return [Boolean, nil]
@@ -387,8 +389,8 @@ module OpenAI
           #   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)
+          #   - [Text inputs and outputs](https://developers.openai.com/api/docs/guides/text)
+          #   - [Structured Outputs](https://developers.openai.com/api/docs/guides/structured-outputs)
           #
           #   @return [OpenAI::Models::Beta::BetaResponseTextConfig, nil]
           optional :text, -> { OpenAI::Beta::BetaResponseTextConfig }
@@ -409,17 +411,18 @@ module OpenAI
           #
           #   - **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).
+          #     [web search](https://developers.openai.com/api/docs/guides/tools-web-search)
+          #     or
+          #     [file search](https://developers.openai.com/api/docs/guides/tools-file-search).
           #     Learn more about
-          #     [built-in tools](https://platform.openai.com/docs/guides/tools).
+          #     [built-in tools](https://developers.openai.com/api/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).
+          #     [MCP Tools](https://developers.openai.com/api/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).
+          #     [function calling](https://developers.openai.com/api/docs/guides/function-calling).
           #     You can also use custom tools to call your own code.
           #
           #   @return [Array<OpenAI::Models::Beta::BetaFunctionTool, OpenAI::Models::Beta::BetaFileSearchTool, OpenAI::Models::Beta::BetaComputerTool, OpenAI::Models::Beta::BetaComputerUsePreviewTool, OpenAI::Models::Beta::BetaTool::Mcp, OpenAI::Models::Beta::BetaTool::CodeInterpreter, OpenAI::Models::Beta::BetaTool::ProgrammaticToolCalling, OpenAI::Models::Beta::BetaTool::ImageGeneration, OpenAI::Models::Beta::BetaTool::LocalShell, OpenAI::Models::Beta::BetaFunctionShellTool, OpenAI::Models::Beta::BetaCustomTool, OpenAI::Models::Beta::BetaNamespaceTool, OpenAI::Models::Beta::BetaToolSearchTool, OpenAI::Models::Beta::BetaApplyPatchTool, OpenAI::Models::Beta::BetaWebSearchTool, OpenAI::Models::Beta::BetaWebSearchPreviewTool>, nil]
@@ -468,16 +471,12 @@ module OpenAI
           #   `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).
+          #   [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
           #
           #   @return [String, nil]
           optional :user, String
 
           # @!method initialize(background: nil, context_management: nil, conversation: nil, include: nil, input: nil, instructions: nil, max_output_tokens: nil, max_tool_calls: nil, metadata: nil, model: nil, moderation: nil, multi_agent: nil, parallel_tool_calls: nil, previous_response_id: nil, prompt: nil, prompt_cache_key: nil, prompt_cache_options: nil, prompt_cache_retention: nil, reasoning: nil, safety_identifier: nil, service_tier: nil, store: nil, stream: nil, stream_id: nil, stream_options: nil, temperature: nil, text: nil, tool_choice: nil, tools: nil, top_logprobs: nil, top_p: nil, truncation: nil, user: nil, type: :"response.create")
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate} for more
-          #   details.
-          #
           #   Client event for creating a response over a persistent WebSocket connection.
           #   This payload uses the same top-level fields as `POST /v1/responses`, plus
           #   WebSocket-only envelope metadata.
@@ -488,74 +487,271 @@ module OpenAI
           #   - `background` is not supported over WebSocket.
           #   - `stream_id` is WebSocket-only and is not part of `POST /v1/responses`.
           #
-          #   @param background [Boolean, nil] Whether to run the model response in the background.
-          #
-          #   @param context_management [Array<OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::ContextManagement>, nil] Context management configuration for this request.
-          #
-          #   @param conversation [String, OpenAI::Models::Beta::BetaResponseConversationParam, nil] The conversation that this response belongs to. Items from this conversation are
-          #
-          #   @param include [Array<Symbol, OpenAI::Models::Beta::BetaResponseIncludable>, nil] Specify additional output data to include in the model response. Currently suppo
-          #
-          #   @param input [String, Array<OpenAI::Models::Beta::BetaEasyInputMessage, OpenAI::Models::Beta::BetaResponseInputItem::Message, OpenAI::Models::Beta::BetaResponseOutputMessage, OpenAI::Models::Beta::BetaResponseFileSearchToolCall, OpenAI::Models::Beta::BetaResponseComputerToolCall, OpenAI::Models::Beta::BetaResponseInputItem::ComputerCallOutput, OpenAI::Models::Beta::BetaResponseFunctionWebSearch, OpenAI::Models::Beta::BetaResponseFunctionToolCall, OpenAI::Models::Beta::BetaResponseInputItem::FunctionCallOutput, OpenAI::Models::Beta::BetaResponseInputItem::AgentMessage, OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCall, OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput, OpenAI::Models::Beta::BetaResponseInputItem::ToolSearchCall, OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam, OpenAI::Models::Beta::BetaResponseInputItem::AdditionalTools, OpenAI::Models::Beta::BetaResponseConfigurationUpdateItemParam, OpenAI::Models::Beta::BetaResponseReasoningItem, OpenAI::Models::Beta::BetaResponseCompactionItemParam, OpenAI::Models::Beta::BetaResponseInputItem::ImageGenerationCall, OpenAI::Models::Beta::BetaResponseCodeInterpreterToolCall, OpenAI::Models::Beta::BetaResponseInputItem::LocalShellCall, OpenAI::Models::Beta::BetaResponseInputItem::LocalShellCallOutput, OpenAI::Models::Beta::BetaResponseInputItem::ShellCall, OpenAI::Models::Beta::BetaResponseInputItem::ShellCallOutput, OpenAI::Models::Beta::BetaResponseInputItem::ApplyPatchCall, OpenAI::Models::Beta::BetaResponseInputItem::ApplyPatchCallOutput, OpenAI::Models::Beta::BetaResponseInputItem::McpListTools, OpenAI::Models::Beta::BetaResponseInputItem::McpApprovalRequest, OpenAI::Models::Beta::BetaResponseInputItem::McpApprovalResponse, OpenAI::Models::Beta::BetaResponseInputItem::McpCall, OpenAI::Models::Beta::BetaResponseCustomToolCallOutput, OpenAI::Models::Beta::BetaResponseCustomToolCall, OpenAI::Models::Beta::BetaResponseInputItem::CompactionTrigger, OpenAI::Models::Beta::BetaResponseInputItem::ItemReference, OpenAI::Models::Beta::BetaResponseInputItem::Program, OpenAI::Models::Beta::BetaResponseInputItem::ProgramOutput>] Text, image, or file inputs to the model, used to generate a response.
-          #
-          #   @param instructions [String, nil] A system (or developer) message inserted into the model's context.
-          #
-          #   @param max_output_tokens [Integer, nil] An upper bound for the number of tokens that can be generated for a response, in
-          #
-          #   @param max_tool_calls [Integer, nil] The maximum number of total calls to built-in tools that can be processed in a r
-          #
-          #   @param metadata [Hash{Symbol=>String}, nil] Set of 16 key-value pairs that can be attached to an object. This can be
-          #
-          #   @param model [Symbol, String, OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Model] Model ID used to generate the response, like `gpt-6-astra`. OpenAI
-          #
-          #   @param moderation [OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Moderation, nil] Configuration for running moderation on the input and output of this response.
-          #
-          #   @param multi_agent [OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::MultiAgent, nil] Configuration for server-hosted multi-agent execution.
-          #
-          #   @param parallel_tool_calls [Boolean, nil] Whether to allow the model to run tool calls in parallel.
-          #
-          #   @param previous_response_id [String, nil] The unique ID of the previous response to the model. Use this to
-          #
-          #   @param prompt [OpenAI::Models::Beta::BetaResponsePrompt, nil] Reference to a prompt template and its variables.
-          #
-          #   @param prompt_cache_key [String, nil] Used by OpenAI to cache responses for similar requests to optimize your cache hi
-          #
-          #   @param prompt_cache_options [OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::PromptCacheOptions] Options for prompt caching. Supported for `gpt-5.6` and later models. By default
-          #
-          #   @param prompt_cache_retention [Symbol, OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::PromptCacheRetention, nil] Deprecated. Use `prompt_cache_options.ttl` instead.
-          #
-          #   @param reasoning [OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Reasoning, nil] Configuration options for
-          #
-          #   @param safety_identifier [String, nil] A stable identifier used to help detect users of your application that may be vi
-          #
-          #   @param service_tier [Symbol, OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::ServiceTier, nil] Specifies the processing type used for serving the request.
-          #
-          #   @param store [Boolean, nil] Whether to store the generated model response for later retrieval via
-          #
-          #   @param stream [Boolean, nil] If set to true, the model response data will be streamed to the client
-          #
-          #   @param stream_id [String] The WebSocket lane for this response. Requests with the same
-          #
-          #   @param stream_options [OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::StreamOptions, nil] Options for streaming responses. Only set this when you set `stream: true`.
-          #
-          #   @param temperature [Float, nil] What sampling temperature to use, between 0 and 2. Higher values like 0.8 will m
-          #
-          #   @param text [OpenAI::Models::Beta::BetaResponseTextConfig] Configuration options for a text response from the model. Can be plain
-          #
-          #   @param tool_choice [Symbol, OpenAI::Models::Beta::BetaToolChoiceOptions, OpenAI::Models::Beta::BetaToolChoiceAllowed, OpenAI::Models::Beta::BetaToolChoiceTypes, OpenAI::Models::Beta::BetaToolChoiceFunction, OpenAI::Models::Beta::BetaToolChoiceMcp, OpenAI::Models::Beta::BetaToolChoiceCustom, OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::ToolChoice::BetaSpecificProgrammaticToolCallingParam, OpenAI::Models::Beta::BetaToolChoiceApplyPatch, OpenAI::Models::Beta::BetaToolChoiceShell] How the model should select which tool (or tools) to use when generating
-          #
-          #   @param tools [Array<OpenAI::Models::Beta::BetaFunctionTool, OpenAI::Models::Beta::BetaFileSearchTool, OpenAI::Models::Beta::BetaComputerTool, OpenAI::Models::Beta::BetaComputerUsePreviewTool, OpenAI::Models::Beta::BetaTool::Mcp, OpenAI::Models::Beta::BetaTool::CodeInterpreter, OpenAI::Models::Beta::BetaTool::ProgrammaticToolCalling, OpenAI::Models::Beta::BetaTool::ImageGeneration, OpenAI::Models::Beta::BetaTool::LocalShell, OpenAI::Models::Beta::BetaFunctionShellTool, OpenAI::Models::Beta::BetaCustomTool, OpenAI::Models::Beta::BetaNamespaceTool, OpenAI::Models::Beta::BetaToolSearchTool, OpenAI::Models::Beta::BetaApplyPatchTool, OpenAI::Models::Beta::BetaWebSearchTool, OpenAI::Models::Beta::BetaWebSearchPreviewTool>] An array of tools the model may call while generating a response. You
-          #
-          #   @param top_logprobs [Integer, nil] An integer between 0 and 20 specifying the maximum number of most likely
-          #
-          #   @param top_p [Float, nil] An alternative to sampling with temperature, called nucleus sampling,
-          #
-          #   @param truncation [Symbol, OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Truncation, nil] The truncation strategy to use for the model response.
-          #
-          #   @param user [String] This field is being replaced by `safety_identifier` and `prompt_cache_key`. Use
-          #
-          #   @param type [Symbol, :"response.create"] The type of the client event. Always `response.create`.
-
+          #   @param background [Boolean, nil]
+          #     Whether to run the model response in the background.
+          #     [Learn more](https://developers.openai.com/api/docs/guides/background).
+          #
+          #   @param context_management [Array<OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::ContextManagement>, nil]
+          #     Context management configuration for this request.
+          #
+          #   @param conversation [String, OpenAI::Models::Beta::BetaResponseConversationParam, nil]
+          #     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.
+          #
+          #   @param include [Array<Symbol, OpenAI::Models::Beta::BetaResponseIncludable>, nil]
+          #     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).
+          #
+          #   @param input [String, Array<OpenAI::Models::Beta::BetaEasyInputMessage, OpenAI::Models::Beta::BetaResponseInputItem::Message, OpenAI::Models::Beta::BetaResponseOutputMessage, OpenAI::Models::Beta::BetaResponseFileSearchToolCall, OpenAI::Models::Beta::BetaResponseComputerToolCall, OpenAI::Models::Beta::BetaResponseInputItem::ComputerCallOutput, OpenAI::Models::Beta::BetaResponseFunctionWebSearch, OpenAI::Models::Beta::BetaResponseFunctionToolCall, OpenAI::Models::Beta::BetaResponseInputItem::FunctionCallOutput, OpenAI::Models::Beta::BetaResponseInputItem::AgentMessage, OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCall, OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput, OpenAI::Models::Beta::BetaResponseInputItem::ToolSearchCall, OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam, OpenAI::Models::Beta::BetaResponseInputItem::AdditionalTools, OpenAI::Models::Beta::BetaResponseConfigurationUpdateItemParam, OpenAI::Models::Beta::BetaResponseReasoningItem, OpenAI::Models::Beta::BetaResponseCompactionItemParam, OpenAI::Models::Beta::BetaResponseInputItem::ImageGenerationCall, OpenAI::Models::Beta::BetaResponseCodeInterpreterToolCall, OpenAI::Models::Beta::BetaResponseInputItem::LocalShellCall, OpenAI::Models::Beta::BetaResponseInputItem::LocalShellCallOutput, OpenAI::Models::Beta::BetaResponseInputItem::ShellCall, OpenAI::Models::Beta::BetaResponseInputItem::ShellCallOutput, OpenAI::Models::Beta::BetaResponseInputItem::ApplyPatchCall, OpenAI::Models::Beta::BetaResponseInputItem::ApplyPatchCallOutput, OpenAI::Models::Beta::BetaResponseInputItem::McpListTools, OpenAI::Models::Beta::BetaResponseInputItem::McpApprovalRequest, OpenAI::Models::Beta::BetaResponseInputItem::McpApprovalResponse, OpenAI::Models::Beta::BetaResponseInputItem::McpCall, OpenAI::Models::Beta::BetaResponseCustomToolCallOutput, OpenAI::Models::Beta::BetaResponseCustomToolCall, OpenAI::Models::Beta::BetaResponseInputItem::CompactionTrigger, OpenAI::Models::Beta::BetaResponseInputItem::ItemReference, OpenAI::Models::Beta::BetaResponseInputItem::Program, OpenAI::Models::Beta::BetaResponseInputItem::ProgramOutput>]
+          #     Text, image, or file inputs to the model, used to generate a response.
+          #
+          #     Learn more:
+          #
+          #     - [Text inputs and outputs](https://developers.openai.com/api/docs/guides/text)
+          #     - [Image inputs](https://developers.openai.com/api/docs/guides/images-vision)
+          #     - [File inputs](https://developers.openai.com/api/docs/guides/file-inputs)
+          #     - [Conversation state](https://developers.openai.com/api/docs/guides/conversation-state)
+          #     - [Function calling](https://developers.openai.com/api/docs/guides/function-calling)
+          #
+          #   @param instructions [String, nil]
+          #     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.
+          #
+          #   @param max_output_tokens [Integer, nil]
+          #     An upper bound for the number of tokens that can be generated for a response,
+          #     including visible output tokens and
+          #     [reasoning tokens](https://developers.openai.com/api/docs/guides/reasoning).
+          #
+          #   @param max_tool_calls [Integer, nil]
+          #     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.
+          #
+          #   @param metadata [Hash{Symbol=>String}, nil]
+          #     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.
+          #
+          #   @param model [Symbol, String, OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Model]
+          #     Model ID used to generate the response, like `gpt-6-astra`. OpenAI offers a wide
+          #     range of models with different capabilities, performance characteristics, and
+          #     price points. Refer to the
+          #     [model guide](https://developers.openai.com/api/docs/models) to browse and
+          #     compare available models.
+          #
+          #   @param moderation [OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Moderation, nil]
+          #     Configuration for running moderation on the input and output of this response.
+          #
+          #   @param multi_agent [OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::MultiAgent, nil]
+          #     Configuration for server-hosted multi-agent execution.
+          #
+          #   @param parallel_tool_calls [Boolean, nil]
+          #     Whether to allow the model to run tool calls in parallel.
+          #
+          #   @param previous_response_id [String, nil]
+          #     The unique ID of the previous response to the model. Use this to create
+          #     multi-turn conversations. Learn more about
+          #     [conversation state](https://developers.openai.com/api/docs/guides/conversation-state).
+          #     Cannot be used in conjunction with `conversation`.
+          #
+          #   @param prompt [OpenAI::Models::Beta::BetaResponsePrompt, nil]
+          #     Reference to a prompt template and its variables.
+          #     [Learn more](https://developers.openai.com/api/docs/guides/text?api-mode=responses#version-prompts-in-code).
+          #
+          #   @param prompt_cache_key [String, nil]
+          #     Used by OpenAI to cache responses for similar requests to optimize your cache
+          #     hit rates. Replaces the `user` field.
+          #     [Learn more](https://developers.openai.com/api/docs/guides/prompt-caching).
+          #
+          #   @param prompt_cache_options [OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::PromptCacheOptions]
+          #     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://developers.openai.com/api/docs/guides/prompt-caching)
+          #     for current details.
+          #
+          #   @param prompt_cache_retention [Symbol, OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::PromptCacheRetention, nil]
+          #     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://developers.openai.com/api/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.
+          #
+          #   @param reasoning [OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Reasoning, nil]
+          #     Configuration options for
+          #     [reasoning models](https://developers.openai.com/api/docs/guides/reasoning).
+          #
+          #   @param safety_identifier [String, nil]
+          #     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://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
+          #
+          #   @param service_tier [Symbol, OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::ServiceTier, nil]
+          #     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://developers.openai.com/api/docs/guides/flex-processing)', then
+          #       the request will be processed with the Flex Processing service tier.
+          #     - To opt-in to
+          #       [Fast mode](https://developers.openai.com/api/docs/guides/fast-mode) at the
+          #       request level, include the `service_tier=fast` or `service_tier=priority`
+          #       parameter for Responses or Chat Completions. The response will show
+          #       `service_tier=priority` regardless of if you specify `service_tier=fast` or
+          #       `priority` in your request.
+          #     - If set to 'ultrafast', then the request will be processed with the
+          #       access-controlled Ultrafast Processing service tier. This tier is currently
+          #       available for `gpt-5.6-sol`; a response served through it will show
+          #       `service_tier=ultrafast`.
+          #     - 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.
+          #
+          #   @param store [Boolean, nil]
+          #     Whether to store the generated model response for later retrieval via API.
+          #     Defaults to true when omitted. If set to true, response data will be stored for
+          #     at least 30 days, subject to the
+          #     [data retention exceptions](https://developers.openai.com/api/docs/guides/your-data#v1responses).
+          #
+          #   @param stream [Boolean, nil]
+          #     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://developers.openai.com/api/reference/resources/responses/streaming-events)
+          #     for more information.
+          #
+          #   @param stream_id [String]
+          #     The WebSocket lane for this response. Requests with the same `stream_id` are
+          #     processed FIFO, and events for the response echo the same `stream_id`.
+          #
+          #     `stream_id` controls routing; `previous_response_id` controls conversation
+          #     lineage, so a new lane can fork from a response created on another lane.
+          #
+          #   @param stream_options [OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::StreamOptions, nil]
+          #     Options for streaming responses. Only set this when you set `stream: true`.
+          #
+          #   @param temperature [Float, nil]
+          #     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.
+          #
+          #   @param text [OpenAI::Models::Beta::BetaResponseTextConfig]
+          #     Configuration options for a text response from the model. Can be plain text or
+          #     structured JSON data. Learn more:
+          #
+          #     - [Text inputs and outputs](https://developers.openai.com/api/docs/guides/text)
+          #     - [Structured Outputs](https://developers.openai.com/api/docs/guides/structured-outputs)
+          #
+          #   @param tool_choice [Symbol, OpenAI::Models::Beta::BetaToolChoiceOptions, OpenAI::Models::Beta::BetaToolChoiceAllowed, OpenAI::Models::Beta::BetaToolChoiceTypes, OpenAI::Models::Beta::BetaToolChoiceFunction, OpenAI::Models::Beta::BetaToolChoiceMcp, OpenAI::Models::Beta::BetaToolChoiceCustom, OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::ToolChoice::BetaSpecificProgrammaticToolCallingParam, OpenAI::Models::Beta::BetaToolChoiceApplyPatch, OpenAI::Models::Beta::BetaToolChoiceShell]
+          #     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.
+          #
+          #   @param tools [Array<OpenAI::Models::Beta::BetaFunctionTool, OpenAI::Models::Beta::BetaFileSearchTool, OpenAI::Models::Beta::BetaComputerTool, OpenAI::Models::Beta::BetaComputerUsePreviewTool, OpenAI::Models::Beta::BetaTool::Mcp, OpenAI::Models::Beta::BetaTool::CodeInterpreter, OpenAI::Models::Beta::BetaTool::ProgrammaticToolCalling, OpenAI::Models::Beta::BetaTool::ImageGeneration, OpenAI::Models::Beta::BetaTool::LocalShell, OpenAI::Models::Beta::BetaFunctionShellTool, OpenAI::Models::Beta::BetaCustomTool, OpenAI::Models::Beta::BetaNamespaceTool, OpenAI::Models::Beta::BetaToolSearchTool, OpenAI::Models::Beta::BetaApplyPatchTool, OpenAI::Models::Beta::BetaWebSearchTool, OpenAI::Models::Beta::BetaWebSearchPreviewTool>]
+          #     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://developers.openai.com/api/docs/guides/tools-web-search)
+          #       or
+          #       [file search](https://developers.openai.com/api/docs/guides/tools-file-search).
+          #       Learn more about
+          #       [built-in tools](https://developers.openai.com/api/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://developers.openai.com/api/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://developers.openai.com/api/docs/guides/function-calling).
+          #       You can also use custom tools to call your own code.
+          #
+          #   @param top_logprobs [Integer, nil]
+          #     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.
+          #
+          #   @param top_p [Float, nil]
+          #     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.
+          #
+          #   @param truncation [Symbol, OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Truncation, nil]
+          #     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.
+          #
+          #   @param user [String]
+          #     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://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
+          #
+          #   @param type [Symbol, :"response.create"]
+          #     The type of the client event. Always `response.create`.
           class ContextManagement < OpenAI::Internal::Type::BaseModel
             # @!attribute type
             #   The context management entry type. Currently only 'compaction' is supported.
@@ -570,9 +766,11 @@ module OpenAI
             optional :compact_threshold, Integer, nil?: true
 
             # @!method initialize(type:, compact_threshold: nil)
-            #   @param type [String] The context management entry type. Currently only 'compaction' is supported.
+            #   @param type [String]
+            #     The context management entry type. Currently only 'compaction' is supported.
             #
-            #   @param compact_threshold [Integer, nil] Token threshold at which compaction should be triggered for this entry.
+            #   @param compact_threshold [Integer, nil]
+            #     Token threshold at which compaction should be triggered for this entry.
           end
 
           # The conversation that this response belongs to. Items from this conversation are
@@ -598,11 +796,11 @@ module OpenAI
           #
           # 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)
+          # - [Text inputs and outputs](https://developers.openai.com/api/docs/guides/text)
+          # - [Image inputs](https://developers.openai.com/api/docs/guides/images-vision)
+          # - [File inputs](https://developers.openai.com/api/docs/guides/file-inputs)
+          # - [Conversation state](https://developers.openai.com/api/docs/guides/conversation-state)
+          # - [Function calling](https://developers.openai.com/api/docs/guides/function-calling)
           #
           # @see OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate#input
           module Input
@@ -623,8 +821,8 @@ module OpenAI
           # Model ID used to generate the response, like `gpt-6-astra`. 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.
+          # [model guide](https://developers.openai.com/api/docs/models) to browse and
+          # compare available models.
           #
           # @see OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate#model
           module Model
@@ -1150,15 +1348,14 @@ module OpenAI
             )
 
             # @!method initialize(model:, policy: nil)
-            #   Some parameter documentations has been truncated, see
-            #   {OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Moderation} for
-            #   more details.
-            #
             #   Configuration for running moderation on the input and output of this response.
             #
-            #   @param model [String] The moderation model to use for moderated completions, e.g. 'omni-moderation-lat
+            #   @param model [String]
+            #     The moderation model to use for moderated completions, e.g.
+            #     'omni-moderation-latest'.
             #
-            #   @param policy [OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Moderation::Policy, nil] The policy to apply to moderated response input and output.
+            #   @param policy [OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Moderation::Policy, nil]
+            #     The policy to apply to moderated response input and output.
 
             # @see OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Moderation#policy
             class Policy < OpenAI::Internal::Type::BaseModel
@@ -1189,9 +1386,11 @@ module OpenAI
               # @!method initialize(input: nil, output: nil)
               #   The policy to apply to moderated response input and output.
               #
-              #   @param input [OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Moderation::Policy::Input, nil] The moderation policy for the response input.
+              #   @param input [OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Moderation::Policy::Input, nil]
+              #     The moderation policy for the response input.
               #
-              #   @param output [OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Moderation::Policy::Output, nil] The moderation policy for the response output.
+              #   @param output [OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Moderation::Policy::Output, nil]
+              #     The moderation policy for the response output.
 
               # @see OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Moderation::Policy#input
               class Input < OpenAI::Internal::Type::BaseModel
@@ -1269,15 +1468,18 @@ module OpenAI
             optional :max_concurrent_subagents, Integer
 
             # @!method initialize(enabled:, max_concurrent_subagents: nil)
-            #   Some parameter documentations has been truncated, see
-            #   {OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::MultiAgent} for
-            #   more details.
-            #
             #   Configuration for server-hosted multi-agent execution.
             #
-            #   @param enabled [Boolean] Whether to enable server-hosted multi-agent execution for this response.
+            #   @param enabled [Boolean]
+            #     Whether to enable server-hosted multi-agent execution for this response.
             #
-            #   @param max_concurrent_subagents [Integer] `max_concurrent_subagents` sets the maximum number of subagents that can be acti
+            #   @param max_concurrent_subagents [Integer]
+            #     `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.
           end
 
           # @see OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate#prompt_cache_options
@@ -1315,10 +1517,6 @@ module OpenAI
             )
 
             # @!method initialize(comparison_response_id: nil, mode: nil, ttl: nil)
-            #   Some parameter documentations has been truncated, see
-            #   {OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::PromptCacheOptions}
-            #   for more details.
-            #
             #   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
@@ -1326,14 +1524,25 @@ module OpenAI
             #   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)
+            #   [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
             #   for current details.
             #
-            #   @param comparison_response_id [String, nil] The ID of a response to compare when diagnosing prompt cache reuse. Supplying th
+            #   @param comparison_response_id [String, nil]
+            #     The ID of a response to compare when diagnosing prompt cache reuse. Supplying
+            #     this field requests prompt cache diagnostics when the feature is enabled.
             #
-            #   @param mode [Symbol, OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::PromptCacheOptions::Mode] Controls whether OpenAI automatically creates an implicit cache breakpoint. Defa
+            #   @param mode [Symbol, OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::PromptCacheOptions::Mode]
+            #     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.
             #
-            #   @param ttl [Symbol, OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::PromptCacheOptions::Ttl] The minimum lifetime applied to every implicit and explicit cache breakpoint wri
+            #   @param ttl [Symbol, OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::PromptCacheOptions::Ttl]
+            #     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.
 
             # Controls whether OpenAI automatically creates an implicit cache breakpoint.
             # Defaults to `implicit`. With `implicit`, OpenAI creates one implicit breakpoint
@@ -1375,7 +1584,7 @@ module OpenAI
           # 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).
+          # [Learn more](https://developers.openai.com/api/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
@@ -1421,7 +1630,7 @@ module OpenAI
             #   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
+            #   [reasoning guide](https://developers.openai.com/api/docs/guides/reasoning) for
             #   model-specific support.
             #
             #   @return [Symbol, OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Reasoning::Effort, nil]
@@ -1473,22 +1682,44 @@ module OpenAI
             )
 
             # @!method initialize(context: nil, effort: nil, generate_summary: nil, mode: nil, summary: nil)
-            #   Some parameter documentations has been truncated, see
-            #   {OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Reasoning} for
-            #   more details.
-            #
             #   Configuration options for
-            #   [reasoning models](https://platform.openai.com/docs/guides/reasoning).
+            #   [reasoning models](https://developers.openai.com/api/docs/guides/reasoning).
             #
-            #   @param context [Symbol, OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Reasoning::Context, nil] Controls which reasoning items are rendered back to the model on later turns.
+            #   @param context [Symbol, OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Reasoning::Context, nil]
+            #     Controls which reasoning items are rendered back to the model on later turns. If
+            #     omitted or set to `auto`, the model determines the context mode. The `gpt-5.6`
+            #     model family defaults to `all_turns`; earlier models default to `current_turn`.
             #
-            #   @param effort [Symbol, OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Reasoning::Effort, nil] Constrains effort on reasoning for reasoning models. Currently supported
+            #     When returned on a response, this is the effective reasoning context mode used
+            #     for the response.
             #
-            #   @param generate_summary [Symbol, OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Reasoning::GenerateSummary, nil] **Deprecated:** use `summary` instead.
+            #   @param effort [Symbol, OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Reasoning::Effort, nil]
+            #     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://developers.openai.com/api/docs/guides/reasoning) for
+            #     model-specific support.
             #
-            #   @param mode [String, Symbol, OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Reasoning::Mode] Controls the reasoning execution mode for the request.
+            #   @param generate_summary [Symbol, OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Reasoning::GenerateSummary, nil]
+            #     **Deprecated:** use `summary` instead.
             #
-            #   @param summary [Symbol, OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Reasoning::Summary, nil] A summary of the reasoning performed by the model. This can be
+            #     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`.
+            #
+            #   @param mode [String, Symbol, OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Reasoning::Mode]
+            #     Controls the reasoning execution mode for the request.
+            #
+            #     When returned on a response, this is the effective execution mode.
+            #
+            #   @param summary [Symbol, OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Reasoning::Summary, nil]
+            #     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`.
 
             # Controls which reasoning items are rendered back to the model on later turns. If
             # omitted or set to `auto`, the model determines the context mode. The `gpt-5.6`
@@ -1513,7 +1744,7 @@ module OpenAI
             # 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
+            # [reasoning guide](https://developers.openai.com/api/docs/guides/reasoning) for
             # model-specific support.
             #
             # @see OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Reasoning#effort
@@ -1614,13 +1845,15 @@ module OpenAI
           #   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)',
-          #   then the request will be processed with the Flex Processing service tier.
-          # - To opt-in to [Fast mode](/api/docs/guides/fast-mode) at the request level,
-          #   include the `service_tier=fast` or `service_tier=priority` parameter for
-          #   Responses or Chat Completions. The response will show `service_tier=priority`
-          #   regardless of if you specify `service_tier=fast` or `priority` in your
-          #   request.
+          # - If set to
+          #   '[flex](https://developers.openai.com/api/docs/guides/flex-processing)', then
+          #   the request will be processed with the Flex Processing service tier.
+          # - To opt-in to
+          #   [Fast mode](https://developers.openai.com/api/docs/guides/fast-mode) at the
+          #   request level, include the `service_tier=fast` or `service_tier=priority`
+          #   parameter for Responses or Chat Completions. The response will show
+          #   `service_tier=priority` regardless of if you specify `service_tier=fast` or
+          #   `priority` in your request.
           # - If set to 'ultrafast', then the request will be processed with the
           #   access-controlled Ultrafast Processing service tier. This tier is currently
           #   available for `gpt-5.6-sol`; a response served through it will show
@@ -1662,13 +1895,15 @@ module OpenAI
             optional :include_obfuscation, OpenAI::Internal::Type::Boolean
 
             # @!method initialize(include_obfuscation: nil)
-            #   Some parameter documentations has been truncated, see
-            #   {OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::StreamOptions}
-            #   for more details.
-            #
             #   Options for streaming responses. Only set this when you set `stream: true`.
             #
-            #   @param include_obfuscation [Boolean] When true, stream obfuscation will be enabled. Stream obfuscation adds
+            #   @param include_obfuscation [Boolean]
+            #     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.
           end
 
           # How the model should select which tool (or tools) to use when generating a
@@ -1693,7 +1928,7 @@ module OpenAI
             variant -> { OpenAI::Beta::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).
+            # [Learn more about built-in tools](https://developers.openai.com/api/docs/guides/tools).
             variant -> { OpenAI::Beta::BetaToolChoiceTypes }
 
             # Use this option to force the model to call a specific function.
@@ -1725,7 +1960,8 @@ module OpenAI
               required :type, const: :programmatic_tool_calling
 
               # @!method initialize(type: :programmatic_tool_calling)
-              #   @param type [Symbol, :programmatic_tool_calling] The tool to call. Always `programmatic_tool_calling`.
+              #   @param type [Symbol, :programmatic_tool_calling]
+              #     The tool to call. Always `programmatic_tool_calling`.
             end
 
             # @!method self.variants