openai 0.86.0 → 0.88.0

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

@@ -45,16 +45,22 @@ module OpenAI
         optional :betas, -> { OpenAI::Internal::Type::ArrayOf[enum: OpenAI::Beta::ResponseRetrieveParams::Beta] }
 
         # @!method initialize(response_id:, include: nil, include_obfuscation: nil, starting_after: nil, betas: nil, request_options: {})
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Beta::ResponseRetrieveParams} for more details.
-        #
         #   @param response_id [String]
         #
-        #   @param include [Array<Symbol, OpenAI::Models::Beta::BetaResponseIncludable>] Additional fields to include in the response. See the `include`
+        #   @param include [Array<Symbol, OpenAI::Models::Beta::BetaResponseIncludable>]
+        #     Additional fields to include in the response. See the `include` parameter for
+        #     Response creation above for more information.
         #
-        #   @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.
         #
-        #   @param starting_after [Integer] The sequence number of the event after which to start streaming.
+        #   @param starting_after [Integer]
+        #     The sequence number of the event after which to start streaming.
         #
         #   @param betas [Array<Symbol, OpenAI::Models::Beta::ResponseRetrieveParams::Beta>]
         #

data/lib/openai/models/beta/responses/beta_response_item_list.rb

@@ -38,15 +38,20 @@ module OpenAI
           # @!method initialize(data:, first_id:, has_more:, last_id:, object: :list)
           #   A list of Response items.
           #
-          #   @param data [Array<OpenAI::Models::Beta::BetaResponseInputMessageItem, OpenAI::Models::Beta::BetaResponseOutputMessage, OpenAI::Models::Beta::BetaResponseFileSearchToolCall, OpenAI::Models::Beta::BetaResponseComputerToolCall, OpenAI::Models::Beta::BetaResponseComputerToolCallOutputItem, OpenAI::Models::Beta::BetaResponseFunctionWebSearch, OpenAI::Models::Beta::BetaResponseFunctionToolCallItem, OpenAI::Models::Beta::BetaResponseFunctionToolCallOutputItem, OpenAI::Models::Beta::BetaResponseItem::AgentMessage, OpenAI::Models::Beta::BetaResponseItem::MultiAgentCall, OpenAI::Models::Beta::BetaResponseItem::MultiAgentCallOutput, OpenAI::Models::Beta::BetaResponseToolSearchCall, OpenAI::Models::Beta::BetaResponseToolSearchOutputItem, OpenAI::Models::Beta::BetaResponseItem::AdditionalTools, OpenAI::Models::Beta::BetaResponseConfigurationUpdateItem, OpenAI::Models::Beta::BetaResponseReasoningItem, OpenAI::Models::Beta::BetaResponseItem::Program, OpenAI::Models::Beta::BetaResponseItem::ProgramOutput, OpenAI::Models::Beta::BetaResponseCompactionItem, OpenAI::Models::Beta::BetaResponseItem::ImageGenerationCall, OpenAI::Models::Beta::BetaResponseCodeInterpreterToolCall, OpenAI::Models::Beta::BetaResponseItem::LocalShellCall, OpenAI::Models::Beta::BetaResponseItem::LocalShellCallOutput, OpenAI::Models::Beta::BetaResponseFunctionShellToolCall, OpenAI::Models::Beta::BetaResponseFunctionShellToolCallOutput, OpenAI::Models::Beta::BetaResponseApplyPatchToolCall, OpenAI::Models::Beta::BetaResponseApplyPatchToolCallOutput, OpenAI::Models::Beta::BetaResponseItem::McpListTools, OpenAI::Models::Beta::BetaResponseItem::McpApprovalRequest, OpenAI::Models::Beta::BetaResponseItem::McpApprovalResponse, OpenAI::Models::Beta::BetaResponseItem::McpCall, OpenAI::Models::Beta::BetaResponseCustomToolCallItem, OpenAI::Models::Beta::BetaResponseCustomToolCallOutputItem>] A list of items used to generate this response.
+          #   @param data [Array<OpenAI::Models::Beta::BetaResponseInputMessageItem, OpenAI::Models::Beta::BetaResponseOutputMessage, OpenAI::Models::Beta::BetaResponseFileSearchToolCall, OpenAI::Models::Beta::BetaResponseComputerToolCall, OpenAI::Models::Beta::BetaResponseComputerToolCallOutputItem, OpenAI::Models::Beta::BetaResponseFunctionWebSearch, OpenAI::Models::Beta::BetaResponseFunctionToolCallItem, OpenAI::Models::Beta::BetaResponseFunctionToolCallOutputItem, OpenAI::Models::Beta::BetaResponseItem::AgentMessage, OpenAI::Models::Beta::BetaResponseItem::MultiAgentCall, OpenAI::Models::Beta::BetaResponseItem::MultiAgentCallOutput, OpenAI::Models::Beta::BetaResponseToolSearchCall, OpenAI::Models::Beta::BetaResponseToolSearchOutputItem, OpenAI::Models::Beta::BetaResponseItem::AdditionalTools, OpenAI::Models::Beta::BetaResponseConfigurationUpdateItem, OpenAI::Models::Beta::BetaResponseReasoningItem, OpenAI::Models::Beta::BetaResponseItem::Program, OpenAI::Models::Beta::BetaResponseItem::ProgramOutput, OpenAI::Models::Beta::BetaResponseCompactionItem, OpenAI::Models::Beta::BetaResponseItem::ImageGenerationCall, OpenAI::Models::Beta::BetaResponseCodeInterpreterToolCall, OpenAI::Models::Beta::BetaResponseItem::LocalShellCall, OpenAI::Models::Beta::BetaResponseItem::LocalShellCallOutput, OpenAI::Models::Beta::BetaResponseFunctionShellToolCall, OpenAI::Models::Beta::BetaResponseFunctionShellToolCallOutput, OpenAI::Models::Beta::BetaResponseApplyPatchToolCall, OpenAI::Models::Beta::BetaResponseApplyPatchToolCallOutput, OpenAI::Models::Beta::BetaResponseItem::McpListTools, OpenAI::Models::Beta::BetaResponseItem::McpApprovalRequest, OpenAI::Models::Beta::BetaResponseItem::McpApprovalResponse, OpenAI::Models::Beta::BetaResponseItem::McpCall, OpenAI::Models::Beta::BetaResponseCustomToolCallItem, OpenAI::Models::Beta::BetaResponseCustomToolCallOutputItem>]
+          #     A list of items used to generate this response.
           #
-          #   @param first_id [String] The ID of the first item in the list.
+          #   @param first_id [String]
+          #     The ID of the first item in the list.
           #
-          #   @param has_more [Boolean] Whether there are more items available.
+          #   @param has_more [Boolean]
+          #     Whether there are more items available.
           #
-          #   @param last_id [String] The ID of the last item in the list.
+          #   @param last_id [String]
+          #     The ID of the last item in the list.
           #
-          #   @param object [Symbol, :list] The type of object returned, must be `list`.
+          #   @param object [Symbol, :list]
+          #     The type of object returned, must be `list`.
         end
       end
     end

data/lib/openai/models/beta/responses/input_item_list_params.rb

@@ -52,18 +52,24 @@ module OpenAI
           )
 
           # @!method initialize(response_id:, after: nil, include: nil, limit: nil, order: nil, betas: nil, request_options: {})
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Beta::Responses::InputItemListParams} for more details.
-          #
           #   @param response_id [String]
           #
-          #   @param after [String] An item ID to list items after, used in pagination.
+          #   @param after [String]
+          #     An item ID to list items after, used in pagination.
+          #
+          #   @param include [Array<Symbol, OpenAI::Models::Beta::BetaResponseIncludable>]
+          #     Additional fields to include in the response. See the `include` parameter for
+          #     Response creation above for more information.
           #
-          #   @param include [Array<Symbol, OpenAI::Models::Beta::BetaResponseIncludable>] Additional fields to include in the response. See the `include`
+          #   @param limit [Integer]
+          #     A limit on the number of objects to be returned. Limit can range between 1 and
+          #     100, and the default is 20.
           #
-          #   @param limit [Integer] A limit on the number of objects to be returned. Limit can range between
+          #   @param order [Symbol, OpenAI::Models::Beta::Responses::InputItemListParams::Order]
+          #     The order to return the input items in. Default is `desc`.
           #
-          #   @param order [Symbol, OpenAI::Models::Beta::Responses::InputItemListParams::Order] 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.
           #
           #   @param betas [Array<Symbol, OpenAI::Models::Beta::Responses::InputItemListParams::Beta>]
           #

data/lib/openai/models/beta/responses/input_token_count_params.rb

@@ -41,8 +41,8 @@ module OpenAI
           #   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.
+          #   [model guide](https://developers.openai.com/api/docs/models) to browse and
+          #   compare available models.
           #
           #   @return [String, nil]
           optional :model, String, nil?: true
@@ -64,7 +64,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]
@@ -72,7 +72,7 @@ module OpenAI
 
           # @!attribute reasoning
           #   **gpt-5 and o-series models only** 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::Responses::InputTokenCountParams::Reasoning, nil]
           optional :reasoning, -> { OpenAI::Beta::Responses::InputTokenCountParams::Reasoning }, nil?: true
@@ -81,8 +81,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::Responses::InputTokenCountParams::Text, nil]
           optional :text, -> { OpenAI::Beta::Responses::InputTokenCountParams::Text }, nil?: true
@@ -125,32 +125,66 @@ module OpenAI
           )
 
           # @!method initialize(conversation: nil, input: nil, instructions: nil, model: nil, parallel_tool_calls: nil, personality: nil, previous_response_id: nil, reasoning: nil, text: nil, tool_choice: nil, tools: nil, truncation: nil, betas: nil, request_options: {})
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Beta::Responses::InputTokenCountParams} for more details.
+          #   @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 conversation [String, OpenAI::Models::Beta::BetaResponseConversationParam, nil] The conversation that this response belongs to. Items from this conversation are
+          #   @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>, nil]
+          #     Text, image, or file inputs to the model, used to generate a response
           #
-          #   @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>, nil] 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. 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.
           #
-          #   @param instructions [String, nil] A system (or developer) message inserted into the model's context.
+          #   @param model [String, nil]
+          #     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://developers.openai.com/api/docs/models) to browse and
+          #     compare available models.
           #
-          #   @param model [String, nil] Model ID used to generate the response, like `gpt-4o` or `o3`. OpenAI offers a w
+          #   @param parallel_tool_calls [Boolean, nil]
+          #     Whether to allow the model to run tool calls in parallel.
           #
-          #   @param parallel_tool_calls [Boolean, nil] Whether to allow the model to run tool calls in parallel.
+          #   @param personality [String, Symbol, OpenAI::Models::Beta::Responses::InputTokenCountParams::Personality]
+          #     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.
           #
-          #   @param personality [String, Symbol, OpenAI::Models::Beta::Responses::InputTokenCountParams::Personality] A model-owned style preset to apply to this request. Omit this parameter to use
+          #   @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 previous_response_id [String, nil] The unique ID of the previous response to the model. Use this to create multi-tu
+          #   @param reasoning [OpenAI::Models::Beta::Responses::InputTokenCountParams::Reasoning, nil]
+          #     **gpt-5 and o-series models only** Configuration options for
+          #     [reasoning models](https://developers.openai.com/api/docs/guides/reasoning).
           #
-          #   @param reasoning [OpenAI::Models::Beta::Responses::InputTokenCountParams::Reasoning, nil] **gpt-5 and o-series models only** Configuration options for [reasoning models](
+          #   @param text [OpenAI::Models::Beta::Responses::InputTokenCountParams::Text, nil]
+          #     Configuration options for a text response from the model. Can be plain text or
+          #     structured JSON data. Learn more:
           #
-          #   @param text [OpenAI::Models::Beta::Responses::InputTokenCountParams::Text, nil] Configuration options for a text response from the model. Can be plain
+          #     - [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::Responses::InputTokenCountParams::ToolChoice::BetaSpecificProgrammaticToolCallingParam, OpenAI::Models::Beta::BetaToolChoiceApplyPatch, OpenAI::Models::Beta::BetaToolChoiceShell, nil] Controls which tool the model should use, if any.
+          #   @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::Responses::InputTokenCountParams::ToolChoice::BetaSpecificProgrammaticToolCallingParam, OpenAI::Models::Beta::BetaToolChoiceApplyPatch, OpenAI::Models::Beta::BetaToolChoiceShell, nil]
+          #     Controls which tool the model should use, if any.
           #
-          #   @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>, nil] An array of tools the model may call while generating a response. You can specif
+          #   @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>, nil]
+          #     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.
           #
-          #   @param truncation [Symbol, OpenAI::Models::Beta::Responses::InputTokenCountParams::Truncation] The truncation strategy to use for the model response. - `auto`: If the input to
+          #   @param truncation [Symbol, OpenAI::Models::Beta::Responses::InputTokenCountParams::Truncation]
+          #     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 betas [Array<Symbol, OpenAI::Models::Beta::Responses::InputTokenCountParams::Beta>]
           #
@@ -240,7 +274,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::Responses::InputTokenCountParams::Reasoning::Effort, nil]
@@ -290,22 +324,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::Responses::InputTokenCountParams::Reasoning} for more
-            #   details.
-            #
             #   **gpt-5 and o-series models only** 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::Responses::InputTokenCountParams::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`.
+            #
+            #     When returned on a response, this is the effective reasoning context mode used
+            #     for the response.
+            #
+            #   @param effort [Symbol, OpenAI::Models::Beta::Responses::InputTokenCountParams::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 generate_summary [Symbol, OpenAI::Models::Beta::Responses::InputTokenCountParams::Reasoning::GenerateSummary, nil]
+            #     **Deprecated:** use `summary` instead.
             #
-            #   @param context [Symbol, OpenAI::Models::Beta::Responses::InputTokenCountParams::Reasoning::Context, nil] Controls which reasoning items are rendered back to the model on later turns.
+            #     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 effort [Symbol, OpenAI::Models::Beta::Responses::InputTokenCountParams::Reasoning::Effort, nil] Constrains effort on reasoning for reasoning models. Currently supported
+            #   @param mode [String, Symbol, OpenAI::Models::Beta::Responses::InputTokenCountParams::Reasoning::Mode]
+            #     Controls the reasoning execution mode for the request.
             #
-            #   @param generate_summary [Symbol, OpenAI::Models::Beta::Responses::InputTokenCountParams::Reasoning::GenerateSummary, nil] **Deprecated:** use `summary` instead.
+            #     When returned on a response, this is the effective execution mode.
             #
-            #   @param mode [String, Symbol, OpenAI::Models::Beta::Responses::InputTokenCountParams::Reasoning::Mode] Controls the reasoning execution mode for the request.
+            #   @param summary [Symbol, OpenAI::Models::Beta::Responses::InputTokenCountParams::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`.
             #
-            #   @param summary [Symbol, OpenAI::Models::Beta::Responses::InputTokenCountParams::Reasoning::Summary, nil] A summary of the reasoning performed by the model. This can be
+            #     `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`
@@ -330,7 +386,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::Responses::InputTokenCountParams::Reasoning#effort
@@ -426,7 +482,7 @@ module OpenAI
             #
             #   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).
+            #   [Structured Outputs guide](https://developers.openai.com/api/docs/guides/structured-outputs).
             #
             #   The default format is `{ "type": "text" }` with no additional options.
             #
@@ -453,18 +509,32 @@ module OpenAI
             )
 
             # @!method initialize(format_: nil, verbosity: nil)
-            #   Some parameter documentations has been truncated, see
-            #   {OpenAI::Models::Beta::Responses::InputTokenCountParams::Text} for more details.
-            #
             #   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)
+            #
+            #   @param format_ [OpenAI::Models::Beta::BetaResponseFormatTextConfig::Text, OpenAI::Models::Beta::BetaResponseFormatTextJSONSchemaConfig, OpenAI::Models::Beta::BetaResponseFormatTextConfig::JSONObject]
+            #     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://developers.openai.com/api/docs/guides/structured-outputs).
+            #
+            #     The default format is `{ "type": "text" }` with no additional options.
+            #
+            #     **Not recommended for gpt-4o and newer models:**
             #
-            #   @param format_ [OpenAI::Models::Beta::BetaResponseFormatTextConfig::Text, OpenAI::Models::Beta::BetaResponseFormatTextJSONSchemaConfig, OpenAI::Models::Beta::BetaResponseFormatTextConfig::JSONObject] An object specifying the format that the model must output.
+            #     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.
             #
-            #   @param verbosity [Symbol, OpenAI::Models::Beta::Responses::InputTokenCountParams::Text::Verbosity, nil] Constrains the verbosity of the model's response. Lower values will result in
+            #   @param verbosity [Symbol, OpenAI::Models::Beta::Responses::InputTokenCountParams::Text::Verbosity, nil]
+            #     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`. The
+            #     default is `medium`.
 
             # Constrains the verbosity of the model's response. Lower values will result in
             # more concise responses, while higher values will result in more verbose
@@ -502,7 +572,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.
@@ -534,7 +604,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

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

@@ -4,32 +4,32 @@ module OpenAI
   module Models
     module Beta
       # Occurs when a
-      # [run step](https://platform.openai.com/docs/api-reference/run-steps/step-object)
-      # is created.
+      # [run step](https://developers.openai.com/api/docs/assistants/migration) is
+      # created.
       module RunStepStreamEvent
         extend OpenAI::Internal::Type::Union
 
         discriminator :event
 
-        # Occurs when a [run step](https://platform.openai.com/docs/api-reference/run-steps/step-object) is created.
+        # Occurs when a [run step](https://developers.openai.com/api/docs/assistants/migration) is created.
         variant :"thread.run.step.created", -> { OpenAI::Beta::RunStepStreamEvent::ThreadRunStepCreated }
 
-        # Occurs when a [run step](https://platform.openai.com/docs/api-reference/run-steps/step-object) moves to an `in_progress` state.
+        # Occurs when a [run step](https://developers.openai.com/api/docs/assistants/migration) moves to an `in_progress` state.
         variant :"thread.run.step.in_progress", -> { OpenAI::Beta::RunStepStreamEvent::ThreadRunStepInProgress }
 
-        # Occurs when parts of a [run step](https://platform.openai.com/docs/api-reference/run-steps/step-object) are being streamed.
+        # Occurs when parts of a [run step](https://developers.openai.com/api/docs/assistants/migration) are being streamed.
         variant :"thread.run.step.delta", -> { OpenAI::Beta::RunStepStreamEvent::ThreadRunStepDelta }
 
-        # Occurs when a [run step](https://platform.openai.com/docs/api-reference/run-steps/step-object) is completed.
+        # Occurs when a [run step](https://developers.openai.com/api/docs/assistants/migration) is completed.
         variant :"thread.run.step.completed", -> { OpenAI::Beta::RunStepStreamEvent::ThreadRunStepCompleted }
 
-        # Occurs when a [run step](https://platform.openai.com/docs/api-reference/run-steps/step-object) fails.
+        # Occurs when a [run step](https://developers.openai.com/api/docs/assistants/migration) fails.
         variant :"thread.run.step.failed", -> { OpenAI::Beta::RunStepStreamEvent::ThreadRunStepFailed }
 
-        # Occurs when a [run step](https://platform.openai.com/docs/api-reference/run-steps/step-object) is cancelled.
+        # Occurs when a [run step](https://developers.openai.com/api/docs/assistants/migration) is cancelled.
         variant :"thread.run.step.cancelled", -> { OpenAI::Beta::RunStepStreamEvent::ThreadRunStepCancelled }
 
-        # Occurs when a [run step](https://platform.openai.com/docs/api-reference/run-steps/step-object) expires.
+        # Occurs when a [run step](https://developers.openai.com/api/docs/assistants/migration) expires.
         variant :"thread.run.step.expired", -> { OpenAI::Beta::RunStepStreamEvent::ThreadRunStepExpired }
 
         class ThreadRunStepCreated < OpenAI::Internal::Type::BaseModel
@@ -45,15 +45,12 @@ module OpenAI
           required :event, const: :"thread.run.step.created"
 
           # @!method initialize(data:, event: :"thread.run.step.created")
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Beta::RunStepStreamEvent::ThreadRunStepCreated} for more
-          #   details.
-          #
           #   Occurs when a
-          #   [run step](https://platform.openai.com/docs/api-reference/run-steps/step-object)
-          #   is created.
+          #   [run step](https://developers.openai.com/api/docs/assistants/migration) is
+          #   created.
           #
-          #   @param data [OpenAI::Models::Beta::Threads::Runs::RunStep] Represents a step in execution of a run.
+          #   @param data [OpenAI::Models::Beta::Threads::Runs::RunStep]
+          #     Represents a step in execution of a run.
           #
           #   @param event [Symbol, :"thread.run.step.created"]
         end
@@ -71,15 +68,12 @@ module OpenAI
           required :event, const: :"thread.run.step.in_progress"
 
           # @!method initialize(data:, event: :"thread.run.step.in_progress")
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Beta::RunStepStreamEvent::ThreadRunStepInProgress} for more
-          #   details.
-          #
           #   Occurs when a
-          #   [run step](https://platform.openai.com/docs/api-reference/run-steps/step-object)
-          #   moves to an `in_progress` state.
+          #   [run step](https://developers.openai.com/api/docs/assistants/migration) moves to
+          #   an `in_progress` state.
           #
-          #   @param data [OpenAI::Models::Beta::Threads::Runs::RunStep] Represents a step in execution of a run.
+          #   @param data [OpenAI::Models::Beta::Threads::Runs::RunStep]
+          #     Represents a step in execution of a run.
           #
           #   @param event [Symbol, :"thread.run.step.in_progress"]
         end
@@ -98,14 +92,13 @@ module OpenAI
           required :event, const: :"thread.run.step.delta"
 
           # @!method initialize(data:, event: :"thread.run.step.delta")
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Beta::RunStepStreamEvent::ThreadRunStepDelta} for more details.
-          #
           #   Occurs when parts of a
-          #   [run step](https://platform.openai.com/docs/api-reference/run-steps/step-object)
-          #   are being streamed.
+          #   [run step](https://developers.openai.com/api/docs/assistants/migration) are
+          #   being streamed.
           #
-          #   @param data [OpenAI::Models::Beta::Threads::Runs::RunStepDeltaEvent] Represents a run step delta i.e. any changed fields on a run step during streami
+          #   @param data [OpenAI::Models::Beta::Threads::Runs::RunStepDeltaEvent]
+          #     Represents a run step delta i.e. any changed fields on a run step during
+          #     streaming.
           #
           #   @param event [Symbol, :"thread.run.step.delta"]
         end
@@ -123,15 +116,12 @@ module OpenAI
           required :event, const: :"thread.run.step.completed"
 
           # @!method initialize(data:, event: :"thread.run.step.completed")
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Beta::RunStepStreamEvent::ThreadRunStepCompleted} for more
-          #   details.
-          #
           #   Occurs when a
-          #   [run step](https://platform.openai.com/docs/api-reference/run-steps/step-object)
-          #   is completed.
+          #   [run step](https://developers.openai.com/api/docs/assistants/migration) is
+          #   completed.
           #
-          #   @param data [OpenAI::Models::Beta::Threads::Runs::RunStep] Represents a step in execution of a run.
+          #   @param data [OpenAI::Models::Beta::Threads::Runs::RunStep]
+          #     Represents a step in execution of a run.
           #
           #   @param event [Symbol, :"thread.run.step.completed"]
         end
@@ -149,15 +139,11 @@ module OpenAI
           required :event, const: :"thread.run.step.failed"
 
           # @!method initialize(data:, event: :"thread.run.step.failed")
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Beta::RunStepStreamEvent::ThreadRunStepFailed} for more
-          #   details.
-          #
           #   Occurs when a
-          #   [run step](https://platform.openai.com/docs/api-reference/run-steps/step-object)
-          #   fails.
+          #   [run step](https://developers.openai.com/api/docs/assistants/migration) fails.
           #
-          #   @param data [OpenAI::Models::Beta::Threads::Runs::RunStep] Represents a step in execution of a run.
+          #   @param data [OpenAI::Models::Beta::Threads::Runs::RunStep]
+          #     Represents a step in execution of a run.
           #
           #   @param event [Symbol, :"thread.run.step.failed"]
         end
@@ -175,15 +161,12 @@ module OpenAI
           required :event, const: :"thread.run.step.cancelled"
 
           # @!method initialize(data:, event: :"thread.run.step.cancelled")
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Beta::RunStepStreamEvent::ThreadRunStepCancelled} for more
-          #   details.
-          #
           #   Occurs when a
-          #   [run step](https://platform.openai.com/docs/api-reference/run-steps/step-object)
-          #   is cancelled.
+          #   [run step](https://developers.openai.com/api/docs/assistants/migration) is
+          #   cancelled.
           #
-          #   @param data [OpenAI::Models::Beta::Threads::Runs::RunStep] Represents a step in execution of a run.
+          #   @param data [OpenAI::Models::Beta::Threads::Runs::RunStep]
+          #     Represents a step in execution of a run.
           #
           #   @param event [Symbol, :"thread.run.step.cancelled"]
         end
@@ -201,15 +184,11 @@ module OpenAI
           required :event, const: :"thread.run.step.expired"
 
           # @!method initialize(data:, event: :"thread.run.step.expired")
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Beta::RunStepStreamEvent::ThreadRunStepExpired} for more
-          #   details.
-          #
           #   Occurs when a
-          #   [run step](https://platform.openai.com/docs/api-reference/run-steps/step-object)
-          #   expires.
+          #   [run step](https://developers.openai.com/api/docs/assistants/migration) expires.
           #
-          #   @param data [OpenAI::Models::Beta::Threads::Runs::RunStep] Represents a step in execution of a run.
+          #   @param data [OpenAI::Models::Beta::Threads::Runs::RunStep]
+          #     Represents a step in execution of a run.
           #
           #   @param event [Symbol, :"thread.run.step.expired"]
         end