RubyGems - openai - Versions diffs - 0.68.0 → 0.69.0 - Mend

openai 0.68.0 → 0.69.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (701) hide show

data/lib/openai/models/conversations/conversation_item.rb CHANGED Viewed

@@ -51,6 +51,10 @@ module OpenAI
         # [managing context](https://platform.openai.com/docs/guides/conversation-state).
         variant :reasoning, -> { OpenAI::Responses::ResponseReasoningItem }
+        variant :program, -> { OpenAI::Conversations::ConversationItem::Program }
+        variant :program_output, -> { OpenAI::Conversations::ConversationItem::ProgramOutput }
         # A compaction item generated by the [`v1/responses/compact` API](https://platform.openai.com/docs/api-reference/responses/compact).
         variant :compaction, -> { OpenAI::Responses::ResponseCompactionItem }
@@ -165,7 +169,7 @@ module OpenAI
           # @!attribute tools
           #   The additional tool definitions made available at this item.
           #
-          #   @return [Array<OpenAI::Models::Responses::FunctionTool, OpenAI::Models::Responses::FileSearchTool, OpenAI::Models::Responses::ComputerTool, OpenAI::Models::Responses::ComputerUsePreviewTool, OpenAI::Models::Responses::Tool::Mcp, OpenAI::Models::Responses::Tool::CodeInterpreter, OpenAI::Models::Responses::Tool::ImageGeneration, OpenAI::Models::Responses::Tool::LocalShell, OpenAI::Models::Responses::FunctionShellTool, OpenAI::Models::Responses::CustomTool, OpenAI::Models::Responses::NamespaceTool, OpenAI::Models::Responses::ToolSearchTool, OpenAI::Models::Responses::ApplyPatchTool, OpenAI::Models::Responses::WebSearchTool, OpenAI::Models::Responses::WebSearchPreviewTool>]
+          #   @return [Array<OpenAI::Models::Responses::FunctionTool, OpenAI::Models::Responses::FileSearchTool, OpenAI::Models::Responses::ComputerTool, OpenAI::Models::Responses::ComputerUsePreviewTool, OpenAI::Models::Responses::Tool::Mcp, OpenAI::Models::Responses::Tool::CodeInterpreter, OpenAI::Models::Responses::Tool::ProgrammaticToolCalling, OpenAI::Models::Responses::Tool::ImageGeneration, OpenAI::Models::Responses::Tool::LocalShell, OpenAI::Models::Responses::FunctionShellTool, OpenAI::Models::Responses::CustomTool, OpenAI::Models::Responses::NamespaceTool, OpenAI::Models::Responses::ToolSearchTool, OpenAI::Models::Responses::ApplyPatchTool, OpenAI::Models::Responses::WebSearchTool, OpenAI::Models::Responses::WebSearchPreviewTool>]
           required :tools, -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Responses::Tool] }
           # @!attribute type
@@ -179,7 +183,7 @@ module OpenAI
           #
           #   @param role [Symbol, OpenAI::Models::Conversations::ConversationItem::AdditionalTools::Role] The role that provided the additional tools.
           #
-          #   @param tools [Array<OpenAI::Models::Responses::FunctionTool, OpenAI::Models::Responses::FileSearchTool, OpenAI::Models::Responses::ComputerTool, OpenAI::Models::Responses::ComputerUsePreviewTool, OpenAI::Models::Responses::Tool::Mcp, OpenAI::Models::Responses::Tool::CodeInterpreter, OpenAI::Models::Responses::Tool::ImageGeneration, OpenAI::Models::Responses::Tool::LocalShell, OpenAI::Models::Responses::FunctionShellTool, OpenAI::Models::Responses::CustomTool, OpenAI::Models::Responses::NamespaceTool, OpenAI::Models::Responses::ToolSearchTool, OpenAI::Models::Responses::ApplyPatchTool, OpenAI::Models::Responses::WebSearchTool, OpenAI::Models::Responses::WebSearchPreviewTool>] The additional tool definitions made available at this item.
+          #   @param tools [Array<OpenAI::Models::Responses::FunctionTool, OpenAI::Models::Responses::FileSearchTool, OpenAI::Models::Responses::ComputerTool, OpenAI::Models::Responses::ComputerUsePreviewTool, OpenAI::Models::Responses::Tool::Mcp, OpenAI::Models::Responses::Tool::CodeInterpreter, OpenAI::Models::Responses::Tool::ProgrammaticToolCalling, OpenAI::Models::Responses::Tool::ImageGeneration, OpenAI::Models::Responses::Tool::LocalShell, OpenAI::Models::Responses::FunctionShellTool, OpenAI::Models::Responses::CustomTool, OpenAI::Models::Responses::NamespaceTool, OpenAI::Models::Responses::ToolSearchTool, OpenAI::Models::Responses::ApplyPatchTool, OpenAI::Models::Responses::WebSearchTool, OpenAI::Models::Responses::WebSearchPreviewTool>] The additional tool definitions made available at this item.
           #
           #   @param type [Symbol, :additional_tools] The type of the item. Always `additional_tools`.
@@ -203,6 +207,105 @@ module OpenAI
           end
         end
+        class Program < OpenAI::Internal::Type::BaseModel
+          # @!attribute id
+          #   The unique ID of the program item.
+          #
+          #   @return [String]
+          required :id, String
+          # @!attribute call_id
+          #   The stable call ID of the program item.
+          #
+          #   @return [String]
+          required :call_id, String
+          # @!attribute code
+          #   The JavaScript source executed by programmatic tool calling.
+          #
+          #   @return [String]
+          required :code, String
+          # @!attribute fingerprint
+          #   Opaque program replay fingerprint that must be round-tripped.
+          #
+          #   @return [String]
+          required :fingerprint, String
+          # @!attribute type
+          #   The type of the item. Always `program`.
+          #
+          #   @return [Symbol, :program]
+          required :type, const: :program
+          # @!method initialize(id:, call_id:, code:, fingerprint:, type: :program)
+          #   @param id [String] The unique ID of the program item.
+          #
+          #   @param call_id [String] The stable call ID of the program item.
+          #
+          #   @param code [String] The JavaScript source executed by programmatic tool calling.
+          #
+          #   @param fingerprint [String] Opaque program replay fingerprint that must be round-tripped.
+          #
+          #   @param type [Symbol, :program] The type of the item. Always `program`.
+        end
+        class ProgramOutput < OpenAI::Internal::Type::BaseModel
+          # @!attribute id
+          #   The unique ID of the program output item.
+          #
+          #   @return [String]
+          required :id, String
+          # @!attribute call_id
+          #   The call ID of the program item.
+          #
+          #   @return [String]
+          required :call_id, String
+          # @!attribute result
+          #   The result produced by the program item.
+          #
+          #   @return [String]
+          required :result, String
+          # @!attribute status
+          #   The terminal status of the program output item.
+          #
+          #   @return [Symbol, OpenAI::Models::Conversations::ConversationItem::ProgramOutput::Status]
+          required :status, enum: -> { OpenAI::Conversations::ConversationItem::ProgramOutput::Status }
+          # @!attribute type
+          #   The type of the item. Always `program_output`.
+          #
+          #   @return [Symbol, :program_output]
+          required :type, const: :program_output
+          # @!method initialize(id:, call_id:, result:, status:, type: :program_output)
+          #   @param id [String] The unique ID of the program output item.
+          #
+          #   @param call_id [String] The call ID of the program item.
+          #
+          #   @param result [String] The result produced by the program item.
+          #
+          #   @param status [Symbol, OpenAI::Models::Conversations::ConversationItem::ProgramOutput::Status] The terminal status of the program output item.
+          #
+          #   @param type [Symbol, :program_output] The type of the item. Always `program_output`.
+          # The terminal status of the program output item.
+          #
+          # @see OpenAI::Models::Conversations::ConversationItem::ProgramOutput#status
+          module Status
+            extend OpenAI::Internal::Type::Enum
+            COMPLETED = :completed
+            INCOMPLETE = :incomplete
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
         class LocalShellCall < OpenAI::Internal::Type::BaseModel
           # @!attribute id
           #   The unique ID of the local shell call.
@@ -667,7 +770,7 @@ module OpenAI
         end
         # @!method self.variants
-        #   @return [Array(OpenAI::Models::Conversations::Message, OpenAI::Models::Responses::ResponseFunctionToolCallItem, OpenAI::Models::Responses::ResponseFunctionToolCallOutputItem, OpenAI::Models::Responses::ResponseFileSearchToolCall, OpenAI::Models::Responses::ResponseFunctionWebSearch, OpenAI::Models::Conversations::ConversationItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseComputerToolCall, OpenAI::Models::Responses::ResponseComputerToolCallOutputItem, OpenAI::Models::Responses::ResponseToolSearchCall, OpenAI::Models::Responses::ResponseToolSearchOutputItem, OpenAI::Models::Conversations::ConversationItem::AdditionalTools, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Responses::ResponseCompactionItem, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Conversations::ConversationItem::LocalShellCall, OpenAI::Models::Conversations::ConversationItem::LocalShellCallOutput, OpenAI::Models::Responses::ResponseFunctionShellToolCall, OpenAI::Models::Responses::ResponseFunctionShellToolCallOutput, OpenAI::Models::Responses::ResponseApplyPatchToolCall, OpenAI::Models::Responses::ResponseApplyPatchToolCallOutput, OpenAI::Models::Conversations::ConversationItem::McpListTools, OpenAI::Models::Conversations::ConversationItem::McpApprovalRequest, OpenAI::Models::Conversations::ConversationItem::McpApprovalResponse, OpenAI::Models::Conversations::ConversationItem::McpCall, OpenAI::Models::Responses::ResponseCustomToolCall, OpenAI::Models::Responses::ResponseCustomToolCallOutput)]
+        #   @return [Array(OpenAI::Models::Conversations::Message, OpenAI::Models::Responses::ResponseFunctionToolCallItem, OpenAI::Models::Responses::ResponseFunctionToolCallOutputItem, OpenAI::Models::Responses::ResponseFileSearchToolCall, OpenAI::Models::Responses::ResponseFunctionWebSearch, OpenAI::Models::Conversations::ConversationItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseComputerToolCall, OpenAI::Models::Responses::ResponseComputerToolCallOutputItem, OpenAI::Models::Responses::ResponseToolSearchCall, OpenAI::Models::Responses::ResponseToolSearchOutputItem, OpenAI::Models::Conversations::ConversationItem::AdditionalTools, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Conversations::ConversationItem::Program, OpenAI::Models::Conversations::ConversationItem::ProgramOutput, OpenAI::Models::Responses::ResponseCompactionItem, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Conversations::ConversationItem::LocalShellCall, OpenAI::Models::Conversations::ConversationItem::LocalShellCallOutput, OpenAI::Models::Responses::ResponseFunctionShellToolCall, OpenAI::Models::Responses::ResponseFunctionShellToolCallOutput, OpenAI::Models::Responses::ResponseApplyPatchToolCall, OpenAI::Models::Responses::ResponseApplyPatchToolCallOutput, OpenAI::Models::Conversations::ConversationItem::McpListTools, OpenAI::Models::Conversations::ConversationItem::McpApprovalRequest, OpenAI::Models::Conversations::ConversationItem::McpApprovalResponse, OpenAI::Models::Conversations::ConversationItem::McpCall, OpenAI::Models::Responses::ResponseCustomToolCall, OpenAI::Models::Responses::ResponseCustomToolCallOutput)]
       end
     end

data/lib/openai/models/conversations/conversation_item_list.rb CHANGED Viewed

@@ -8,7 +8,7 @@ module OpenAI
         # @!attribute data
         #   A list of conversation items.
         #
-        #   @return [Array<OpenAI::Models::Conversations::Message, OpenAI::Models::Responses::ResponseFunctionToolCallItem, OpenAI::Models::Responses::ResponseFunctionToolCallOutputItem, OpenAI::Models::Responses::ResponseFileSearchToolCall, OpenAI::Models::Responses::ResponseFunctionWebSearch, OpenAI::Models::Conversations::ConversationItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseComputerToolCall, OpenAI::Models::Responses::ResponseComputerToolCallOutputItem, OpenAI::Models::Responses::ResponseToolSearchCall, OpenAI::Models::Responses::ResponseToolSearchOutputItem, OpenAI::Models::Conversations::ConversationItem::AdditionalTools, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Responses::ResponseCompactionItem, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Conversations::ConversationItem::LocalShellCall, OpenAI::Models::Conversations::ConversationItem::LocalShellCallOutput, OpenAI::Models::Responses::ResponseFunctionShellToolCall, OpenAI::Models::Responses::ResponseFunctionShellToolCallOutput, OpenAI::Models::Responses::ResponseApplyPatchToolCall, OpenAI::Models::Responses::ResponseApplyPatchToolCallOutput, OpenAI::Models::Conversations::ConversationItem::McpListTools, OpenAI::Models::Conversations::ConversationItem::McpApprovalRequest, OpenAI::Models::Conversations::ConversationItem::McpApprovalResponse, OpenAI::Models::Conversations::ConversationItem::McpCall, OpenAI::Models::Responses::ResponseCustomToolCall, OpenAI::Models::Responses::ResponseCustomToolCallOutput>]
+        #   @return [Array<OpenAI::Models::Conversations::Message, OpenAI::Models::Responses::ResponseFunctionToolCallItem, OpenAI::Models::Responses::ResponseFunctionToolCallOutputItem, OpenAI::Models::Responses::ResponseFileSearchToolCall, OpenAI::Models::Responses::ResponseFunctionWebSearch, OpenAI::Models::Conversations::ConversationItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseComputerToolCall, OpenAI::Models::Responses::ResponseComputerToolCallOutputItem, OpenAI::Models::Responses::ResponseToolSearchCall, OpenAI::Models::Responses::ResponseToolSearchOutputItem, OpenAI::Models::Conversations::ConversationItem::AdditionalTools, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Conversations::ConversationItem::Program, OpenAI::Models::Conversations::ConversationItem::ProgramOutput, OpenAI::Models::Responses::ResponseCompactionItem, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Conversations::ConversationItem::LocalShellCall, OpenAI::Models::Conversations::ConversationItem::LocalShellCallOutput, OpenAI::Models::Responses::ResponseFunctionShellToolCall, OpenAI::Models::Responses::ResponseFunctionShellToolCallOutput, OpenAI::Models::Responses::ResponseApplyPatchToolCall, OpenAI::Models::Responses::ResponseApplyPatchToolCallOutput, OpenAI::Models::Conversations::ConversationItem::McpListTools, OpenAI::Models::Conversations::ConversationItem::McpApprovalRequest, OpenAI::Models::Conversations::ConversationItem::McpApprovalResponse, OpenAI::Models::Conversations::ConversationItem::McpCall, OpenAI::Models::Responses::ResponseCustomToolCall, OpenAI::Models::Responses::ResponseCustomToolCallOutput>]
         required :data, -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Conversations::ConversationItem] }
         # @!attribute first_id
@@ -38,7 +38,7 @@ module OpenAI
         # @!method initialize(data:, first_id:, has_more:, last_id:, object: :list)
         #   A list of Conversation items.
         #
-        #   @param data [Array<OpenAI::Models::Conversations::Message, OpenAI::Models::Responses::ResponseFunctionToolCallItem, OpenAI::Models::Responses::ResponseFunctionToolCallOutputItem, OpenAI::Models::Responses::ResponseFileSearchToolCall, OpenAI::Models::Responses::ResponseFunctionWebSearch, OpenAI::Models::Conversations::ConversationItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseComputerToolCall, OpenAI::Models::Responses::ResponseComputerToolCallOutputItem, OpenAI::Models::Responses::ResponseToolSearchCall, OpenAI::Models::Responses::ResponseToolSearchOutputItem, OpenAI::Models::Conversations::ConversationItem::AdditionalTools, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Responses::ResponseCompactionItem, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Conversations::ConversationItem::LocalShellCall, OpenAI::Models::Conversations::ConversationItem::LocalShellCallOutput, OpenAI::Models::Responses::ResponseFunctionShellToolCall, OpenAI::Models::Responses::ResponseFunctionShellToolCallOutput, OpenAI::Models::Responses::ResponseApplyPatchToolCall, OpenAI::Models::Responses::ResponseApplyPatchToolCallOutput, OpenAI::Models::Conversations::ConversationItem::McpListTools, OpenAI::Models::Conversations::ConversationItem::McpApprovalRequest, OpenAI::Models::Conversations::ConversationItem::McpApprovalResponse, OpenAI::Models::Conversations::ConversationItem::McpCall, OpenAI::Models::Responses::ResponseCustomToolCall, OpenAI::Models::Responses::ResponseCustomToolCallOutput>] A list of conversation items.
+        #   @param data [Array<OpenAI::Models::Conversations::Message, OpenAI::Models::Responses::ResponseFunctionToolCallItem, OpenAI::Models::Responses::ResponseFunctionToolCallOutputItem, OpenAI::Models::Responses::ResponseFileSearchToolCall, OpenAI::Models::Responses::ResponseFunctionWebSearch, OpenAI::Models::Conversations::ConversationItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseComputerToolCall, OpenAI::Models::Responses::ResponseComputerToolCallOutputItem, OpenAI::Models::Responses::ResponseToolSearchCall, OpenAI::Models::Responses::ResponseToolSearchOutputItem, OpenAI::Models::Conversations::ConversationItem::AdditionalTools, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Conversations::ConversationItem::Program, OpenAI::Models::Conversations::ConversationItem::ProgramOutput, OpenAI::Models::Responses::ResponseCompactionItem, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Conversations::ConversationItem::LocalShellCall, OpenAI::Models::Conversations::ConversationItem::LocalShellCallOutput, OpenAI::Models::Responses::ResponseFunctionShellToolCall, OpenAI::Models::Responses::ResponseFunctionShellToolCallOutput, OpenAI::Models::Responses::ResponseApplyPatchToolCall, OpenAI::Models::Responses::ResponseApplyPatchToolCallOutput, OpenAI::Models::Conversations::ConversationItem::McpListTools, OpenAI::Models::Conversations::ConversationItem::McpApprovalRequest, OpenAI::Models::Conversations::ConversationItem::McpApprovalResponse, OpenAI::Models::Conversations::ConversationItem::McpCall, OpenAI::Models::Responses::ResponseCustomToolCall, OpenAI::Models::Responses::ResponseCustomToolCallOutput>] A list of conversation items.
         #
         #   @param first_id [String] The ID of the first item in the list.
         #

data/lib/openai/models/conversations/item_create_params.rb CHANGED Viewed

@@ -16,7 +16,7 @@ module OpenAI
         # @!attribute items
         #   The items to add to the conversation. You may add up to 20 items at a time.
         #
-        #   @return [Array<OpenAI::Models::Responses::EasyInputMessage, OpenAI::Models::Responses::ResponseInputItem::Message, OpenAI::Models::Responses::ResponseOutputMessage, OpenAI::Models::Responses::ResponseFileSearchToolCall, OpenAI::Models::Responses::ResponseComputerToolCall, OpenAI::Models::Responses::ResponseInputItem::ComputerCallOutput, OpenAI::Models::Responses::ResponseFunctionWebSearch, OpenAI::Models::Responses::ResponseFunctionToolCall, OpenAI::Models::Responses::ResponseInputItem::FunctionCallOutput, OpenAI::Models::Responses::ResponseInputItem::ToolSearchCall, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam, OpenAI::Models::Responses::ResponseInputItem::AdditionalTools, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Responses::ResponseCompactionItemParam, OpenAI::Models::Responses::ResponseInputItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCallOutput, OpenAI::Models::Responses::ResponseInputItem::ShellCall, OpenAI::Models::Responses::ResponseInputItem::ShellCallOutput, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCall, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCallOutput, OpenAI::Models::Responses::ResponseInputItem::McpListTools, OpenAI::Models::Responses::ResponseInputItem::McpApprovalRequest, OpenAI::Models::Responses::ResponseInputItem::McpApprovalResponse, OpenAI::Models::Responses::ResponseInputItem::McpCall, OpenAI::Models::Responses::ResponseCustomToolCallOutput, OpenAI::Models::Responses::ResponseCustomToolCall, OpenAI::Models::Responses::ResponseInputItem::CompactionTrigger, OpenAI::Models::Responses::ResponseInputItem::ItemReference>]
+        #   @return [Array<OpenAI::Models::Responses::EasyInputMessage, OpenAI::Models::Responses::ResponseInputItem::Message, OpenAI::Models::Responses::ResponseOutputMessage, OpenAI::Models::Responses::ResponseFileSearchToolCall, OpenAI::Models::Responses::ResponseComputerToolCall, OpenAI::Models::Responses::ResponseInputItem::ComputerCallOutput, OpenAI::Models::Responses::ResponseFunctionWebSearch, OpenAI::Models::Responses::ResponseFunctionToolCall, OpenAI::Models::Responses::ResponseInputItem::FunctionCallOutput, OpenAI::Models::Responses::ResponseInputItem::ToolSearchCall, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam, OpenAI::Models::Responses::ResponseInputItem::AdditionalTools, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Responses::ResponseCompactionItemParam, OpenAI::Models::Responses::ResponseInputItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCallOutput, OpenAI::Models::Responses::ResponseInputItem::ShellCall, OpenAI::Models::Responses::ResponseInputItem::ShellCallOutput, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCall, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCallOutput, OpenAI::Models::Responses::ResponseInputItem::McpListTools, OpenAI::Models::Responses::ResponseInputItem::McpApprovalRequest, OpenAI::Models::Responses::ResponseInputItem::McpApprovalResponse, OpenAI::Models::Responses::ResponseInputItem::McpCall, OpenAI::Models::Responses::ResponseCustomToolCallOutput, OpenAI::Models::Responses::ResponseCustomToolCall, OpenAI::Models::Responses::ResponseInputItem::CompactionTrigger, OpenAI::Models::Responses::ResponseInputItem::ItemReference, OpenAI::Models::Responses::ResponseInputItem::Program, OpenAI::Models::Responses::ResponseInputItem::ProgramOutput>]
         required :items, -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Responses::ResponseInputItem] }
         # @!attribute include
@@ -33,7 +33,7 @@ module OpenAI
         #
         #   @param conversation_id [String]
         #
-        #   @param items [Array<OpenAI::Models::Responses::EasyInputMessage, OpenAI::Models::Responses::ResponseInputItem::Message, OpenAI::Models::Responses::ResponseOutputMessage, OpenAI::Models::Responses::ResponseFileSearchToolCall, OpenAI::Models::Responses::ResponseComputerToolCall, OpenAI::Models::Responses::ResponseInputItem::ComputerCallOutput, OpenAI::Models::Responses::ResponseFunctionWebSearch, OpenAI::Models::Responses::ResponseFunctionToolCall, OpenAI::Models::Responses::ResponseInputItem::FunctionCallOutput, OpenAI::Models::Responses::ResponseInputItem::ToolSearchCall, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam, OpenAI::Models::Responses::ResponseInputItem::AdditionalTools, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Responses::ResponseCompactionItemParam, OpenAI::Models::Responses::ResponseInputItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCallOutput, OpenAI::Models::Responses::ResponseInputItem::ShellCall, OpenAI::Models::Responses::ResponseInputItem::ShellCallOutput, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCall, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCallOutput, OpenAI::Models::Responses::ResponseInputItem::McpListTools, OpenAI::Models::Responses::ResponseInputItem::McpApprovalRequest, OpenAI::Models::Responses::ResponseInputItem::McpApprovalResponse, OpenAI::Models::Responses::ResponseInputItem::McpCall, OpenAI::Models::Responses::ResponseCustomToolCallOutput, OpenAI::Models::Responses::ResponseCustomToolCall, OpenAI::Models::Responses::ResponseInputItem::CompactionTrigger, OpenAI::Models::Responses::ResponseInputItem::ItemReference>] The items to add to the conversation. You may add up to 20 items at a time.
+        #   @param items [Array<OpenAI::Models::Responses::EasyInputMessage, OpenAI::Models::Responses::ResponseInputItem::Message, OpenAI::Models::Responses::ResponseOutputMessage, OpenAI::Models::Responses::ResponseFileSearchToolCall, OpenAI::Models::Responses::ResponseComputerToolCall, OpenAI::Models::Responses::ResponseInputItem::ComputerCallOutput, OpenAI::Models::Responses::ResponseFunctionWebSearch, OpenAI::Models::Responses::ResponseFunctionToolCall, OpenAI::Models::Responses::ResponseInputItem::FunctionCallOutput, OpenAI::Models::Responses::ResponseInputItem::ToolSearchCall, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam, OpenAI::Models::Responses::ResponseInputItem::AdditionalTools, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Responses::ResponseCompactionItemParam, OpenAI::Models::Responses::ResponseInputItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCallOutput, OpenAI::Models::Responses::ResponseInputItem::ShellCall, OpenAI::Models::Responses::ResponseInputItem::ShellCallOutput, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCall, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCallOutput, OpenAI::Models::Responses::ResponseInputItem::McpListTools, OpenAI::Models::Responses::ResponseInputItem::McpApprovalRequest, OpenAI::Models::Responses::ResponseInputItem::McpApprovalResponse, OpenAI::Models::Responses::ResponseInputItem::McpCall, OpenAI::Models::Responses::ResponseCustomToolCallOutput, OpenAI::Models::Responses::ResponseCustomToolCall, OpenAI::Models::Responses::ResponseInputItem::CompactionTrigger, OpenAI::Models::Responses::ResponseInputItem::ItemReference, OpenAI::Models::Responses::ResponseInputItem::Program, OpenAI::Models::Responses::ResponseInputItem::ProgramOutput>] The items to add to the conversation. You may add up to 20 items at a time.
         #
         #   @param include [Array<Symbol, OpenAI::Models::Responses::ResponseIncludable>] Additional fields to include in the response. See the `include`
         #

data/lib/openai/models/evals/create_eval_completions_run_data_source.rb CHANGED Viewed

@@ -459,19 +459,12 @@ module OpenAI
           optional :max_completion_tokens, Integer
           # @!attribute reasoning_effort
-          #   Constrains effort on reasoning for
-          #   [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
-          #   supported values are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`.
-          #   Reducing reasoning effort can result in faster responses and fewer tokens used
-          #   on reasoning in a response.
-          #
-          #   - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported
-          #     reasoning values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool
-          #     calls are supported for all reasoning values in gpt-5.1.
-          #   - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
-          #     support `none`.
-          #   - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-          #   - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+          #   Constrains effort on reasoning for reasoning models. Currently supported values
+          #   are `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing
+          #   reasoning effort can result in faster responses and fewer tokens used on
+          #   reasoning in a response. Not all reasoning models support every value. See the
+          #   [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for
+          #   model-specific support.
           #
           #   @return [Symbol, OpenAI::Models::ReasoningEffort, nil]
           optional :reasoning_effort, enum: -> { OpenAI::ReasoningEffort }, nil?: true
@@ -525,7 +518,7 @@ module OpenAI
           #
           #   @param max_completion_tokens [Integer] The maximum number of tokens in the generated output.
           #
-          #   @param reasoning_effort [Symbol, OpenAI::Models::ReasoningEffort, nil] Constrains effort on reasoning for
+          #   @param reasoning_effort [Symbol, OpenAI::Models::ReasoningEffort, nil] Constrains effort on reasoning for reasoning models. Currently supported
           #
           #   @param response_format [OpenAI::Models::ResponseFormatText, OpenAI::Models::ResponseFormatJSONSchema, OpenAI::Models::ResponseFormatJSONObject] An object specifying the format that the model must output.
           #

data/lib/openai/models/evals/run_cancel_response.rb CHANGED Viewed

@@ -314,19 +314,12 @@ module OpenAI
                 optional :model, String, nil?: true
                 # @!attribute reasoning_effort
-                #   Constrains effort on reasoning for
-                #   [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
-                #   supported values are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`.
-                #   Reducing reasoning effort can result in faster responses and fewer tokens used
-                #   on reasoning in a response.
-                #
-                #   - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported
-                #     reasoning values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool
-                #     calls are supported for all reasoning values in gpt-5.1.
-                #   - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
-                #     support `none`.
-                #   - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-                #   - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+                #   Constrains effort on reasoning for reasoning models. Currently supported values
+                #   are `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing
+                #   reasoning effort can result in faster responses and fewer tokens used on
+                #   reasoning in a response. Not all reasoning models support every value. See the
+                #   [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for
+                #   model-specific support.
                 #
                 #   @return [Symbol, OpenAI::Models::ReasoningEffort, nil]
                 optional :reasoning_effort, enum: -> { OpenAI::ReasoningEffort }, nil?: true
@@ -372,7 +365,7 @@ module OpenAI
                 #
                 #   @param model [String, nil] The name of the model to find responses for. This is a query parameter used to s
                 #
-                #   @param reasoning_effort [Symbol, OpenAI::Models::ReasoningEffort, nil] Constrains effort on reasoning for
+                #   @param reasoning_effort [Symbol, OpenAI::Models::ReasoningEffort, nil] Constrains effort on reasoning for reasoning models. Currently supported
                 #
                 #   @param temperature [Float, nil] Sampling temperature. This is a query parameter used to select responses.
                 #
@@ -662,19 +655,12 @@ module OpenAI
               optional :max_completion_tokens, Integer
               # @!attribute reasoning_effort
-              #   Constrains effort on reasoning for
-              #   [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
-              #   supported values are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`.
-              #   Reducing reasoning effort can result in faster responses and fewer tokens used
-              #   on reasoning in a response.
-              #
-              #   - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported
-              #     reasoning values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool
-              #     calls are supported for all reasoning values in gpt-5.1.
-              #   - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
-              #     support `none`.
-              #   - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-              #   - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+              #   Constrains effort on reasoning for reasoning models. Currently supported values
+              #   are `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing
+              #   reasoning effort can result in faster responses and fewer tokens used on
+              #   reasoning in a response. Not all reasoning models support every value. See the
+              #   [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for
+              #   model-specific support.
               #
               #   @return [Symbol, OpenAI::Models::ReasoningEffort, nil]
               optional :reasoning_effort, enum: -> { OpenAI::ReasoningEffort }, nil?: true
@@ -718,7 +704,7 @@ module OpenAI
               #     the model to call your own code. Learn more about
               #     [function calling](https://platform.openai.com/docs/guides/function-calling).
               #
-              #   @return [Array<OpenAI::Models::Responses::FunctionTool, OpenAI::Models::Responses::FileSearchTool, OpenAI::Models::Responses::ComputerTool, OpenAI::Models::Responses::ComputerUsePreviewTool, OpenAI::Models::Responses::Tool::Mcp, OpenAI::Models::Responses::Tool::CodeInterpreter, OpenAI::Models::Responses::Tool::ImageGeneration, OpenAI::Models::Responses::Tool::LocalShell, OpenAI::Models::Responses::FunctionShellTool, OpenAI::Models::Responses::CustomTool, OpenAI::Models::Responses::NamespaceTool, OpenAI::Models::Responses::ToolSearchTool, OpenAI::Models::Responses::ApplyPatchTool, OpenAI::Models::Responses::WebSearchTool, OpenAI::Models::Responses::WebSearchPreviewTool>, nil]
+              #   @return [Array<OpenAI::Models::Responses::FunctionTool, OpenAI::Models::Responses::FileSearchTool, OpenAI::Models::Responses::ComputerTool, OpenAI::Models::Responses::ComputerUsePreviewTool, OpenAI::Models::Responses::Tool::Mcp, OpenAI::Models::Responses::Tool::CodeInterpreter, OpenAI::Models::Responses::Tool::ProgrammaticToolCalling, OpenAI::Models::Responses::Tool::ImageGeneration, OpenAI::Models::Responses::Tool::LocalShell, OpenAI::Models::Responses::FunctionShellTool, OpenAI::Models::Responses::CustomTool, OpenAI::Models::Responses::NamespaceTool, OpenAI::Models::Responses::ToolSearchTool, OpenAI::Models::Responses::ApplyPatchTool, OpenAI::Models::Responses::WebSearchTool, OpenAI::Models::Responses::WebSearchPreviewTool>, nil]
               optional :tools, -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Responses::Tool] }
               # @!attribute top_p
@@ -734,7 +720,7 @@ module OpenAI
               #
               #   @param max_completion_tokens [Integer] The maximum number of tokens in the generated output.
               #
-              #   @param reasoning_effort [Symbol, OpenAI::Models::ReasoningEffort, nil] Constrains effort on reasoning for
+              #   @param reasoning_effort [Symbol, OpenAI::Models::ReasoningEffort, nil] Constrains effort on reasoning for reasoning models. Currently supported
               #
               #   @param seed [Integer] A seed value to initialize the randomness, during sampling.
               #
@@ -742,7 +728,7 @@ module OpenAI
               #
               #   @param text [OpenAI::Models::Evals::RunCancelResponse::DataSource::Responses::SamplingParams::Text] Configuration options for a text response from the model. Can be plain
               #
-              #   @param tools [Array<OpenAI::Models::Responses::FunctionTool, OpenAI::Models::Responses::FileSearchTool, OpenAI::Models::Responses::ComputerTool, OpenAI::Models::Responses::ComputerUsePreviewTool, OpenAI::Models::Responses::Tool::Mcp, OpenAI::Models::Responses::Tool::CodeInterpreter, OpenAI::Models::Responses::Tool::ImageGeneration, OpenAI::Models::Responses::Tool::LocalShell, OpenAI::Models::Responses::FunctionShellTool, OpenAI::Models::Responses::CustomTool, OpenAI::Models::Responses::NamespaceTool, OpenAI::Models::Responses::ToolSearchTool, OpenAI::Models::Responses::ApplyPatchTool, OpenAI::Models::Responses::WebSearchTool, OpenAI::Models::Responses::WebSearchPreviewTool>] An array of tools the model may call while generating a response. You
+              #   @param tools [Array<OpenAI::Models::Responses::FunctionTool, OpenAI::Models::Responses::FileSearchTool, OpenAI::Models::Responses::ComputerTool, OpenAI::Models::Responses::ComputerUsePreviewTool, OpenAI::Models::Responses::Tool::Mcp, OpenAI::Models::Responses::Tool::CodeInterpreter, OpenAI::Models::Responses::Tool::ProgrammaticToolCalling, OpenAI::Models::Responses::Tool::ImageGeneration, OpenAI::Models::Responses::Tool::LocalShell, OpenAI::Models::Responses::FunctionShellTool, OpenAI::Models::Responses::CustomTool, OpenAI::Models::Responses::NamespaceTool, OpenAI::Models::Responses::ToolSearchTool, OpenAI::Models::Responses::ApplyPatchTool, OpenAI::Models::Responses::WebSearchTool, OpenAI::Models::Responses::WebSearchPreviewTool>] An array of tools the model may call while generating a response. You
               #
               #   @param top_p [Float] An alternative to temperature for nucleus sampling; 1.0 includes all tokens.

data/lib/openai/models/evals/run_create_params.rb CHANGED Viewed

@@ -233,19 +233,12 @@ module OpenAI
                 optional :model, String, nil?: true
                 # @!attribute reasoning_effort
-                #   Constrains effort on reasoning for
-                #   [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
-                #   supported values are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`.
-                #   Reducing reasoning effort can result in faster responses and fewer tokens used
-                #   on reasoning in a response.
-                #
-                #   - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported
-                #     reasoning values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool
-                #     calls are supported for all reasoning values in gpt-5.1.
-                #   - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
-                #     support `none`.
-                #   - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-                #   - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+                #   Constrains effort on reasoning for reasoning models. Currently supported values
+                #   are `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing
+                #   reasoning effort can result in faster responses and fewer tokens used on
+                #   reasoning in a response. Not all reasoning models support every value. See the
+                #   [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for
+                #   model-specific support.
                 #
                 #   @return [Symbol, OpenAI::Models::ReasoningEffort, nil]
                 optional :reasoning_effort, enum: -> { OpenAI::ReasoningEffort }, nil?: true
@@ -291,7 +284,7 @@ module OpenAI
                 #
                 #   @param model [String, nil] The name of the model to find responses for. This is a query parameter used to s
                 #
-                #   @param reasoning_effort [Symbol, OpenAI::Models::ReasoningEffort, nil] Constrains effort on reasoning for
+                #   @param reasoning_effort [Symbol, OpenAI::Models::ReasoningEffort, nil] Constrains effort on reasoning for reasoning models. Currently supported
                 #
                 #   @param temperature [Float, nil] Sampling temperature. This is a query parameter used to select responses.
                 #
@@ -597,19 +590,12 @@ module OpenAI
               optional :max_completion_tokens, Integer
               # @!attribute reasoning_effort
-              #   Constrains effort on reasoning for
-              #   [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
-              #   supported values are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`.
-              #   Reducing reasoning effort can result in faster responses and fewer tokens used
-              #   on reasoning in a response.
-              #
-              #   - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported
-              #     reasoning values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool
-              #     calls are supported for all reasoning values in gpt-5.1.
-              #   - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
-              #     support `none`.
-              #   - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-              #   - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+              #   Constrains effort on reasoning for reasoning models. Currently supported values
+              #   are `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing
+              #   reasoning effort can result in faster responses and fewer tokens used on
+              #   reasoning in a response. Not all reasoning models support every value. See the
+              #   [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for
+              #   model-specific support.
               #
               #   @return [Symbol, OpenAI::Models::ReasoningEffort, nil]
               optional :reasoning_effort, enum: -> { OpenAI::ReasoningEffort }, nil?: true
@@ -653,7 +639,7 @@ module OpenAI
               #     the model to call your own code. Learn more about
               #     [function calling](https://platform.openai.com/docs/guides/function-calling).
               #
-              #   @return [Array<OpenAI::Models::Responses::FunctionTool, OpenAI::Models::Responses::FileSearchTool, OpenAI::Models::Responses::ComputerTool, OpenAI::Models::Responses::ComputerUsePreviewTool, OpenAI::Models::Responses::Tool::Mcp, OpenAI::Models::Responses::Tool::CodeInterpreter, OpenAI::Models::Responses::Tool::ImageGeneration, OpenAI::Models::Responses::Tool::LocalShell, OpenAI::Models::Responses::FunctionShellTool, OpenAI::Models::Responses::CustomTool, OpenAI::Models::Responses::NamespaceTool, OpenAI::Models::Responses::ToolSearchTool, OpenAI::Models::Responses::ApplyPatchTool, OpenAI::Models::Responses::WebSearchTool, OpenAI::Models::Responses::WebSearchPreviewTool>, nil]
+              #   @return [Array<OpenAI::Models::Responses::FunctionTool, OpenAI::Models::Responses::FileSearchTool, OpenAI::Models::Responses::ComputerTool, OpenAI::Models::Responses::ComputerUsePreviewTool, OpenAI::Models::Responses::Tool::Mcp, OpenAI::Models::Responses::Tool::CodeInterpreter, OpenAI::Models::Responses::Tool::ProgrammaticToolCalling, OpenAI::Models::Responses::Tool::ImageGeneration, OpenAI::Models::Responses::Tool::LocalShell, OpenAI::Models::Responses::FunctionShellTool, OpenAI::Models::Responses::CustomTool, OpenAI::Models::Responses::NamespaceTool, OpenAI::Models::Responses::ToolSearchTool, OpenAI::Models::Responses::ApplyPatchTool, OpenAI::Models::Responses::WebSearchTool, OpenAI::Models::Responses::WebSearchPreviewTool>, nil]
               optional :tools, -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Responses::Tool] }
               # @!attribute top_p
@@ -669,7 +655,7 @@ module OpenAI
               #
               #   @param max_completion_tokens [Integer] The maximum number of tokens in the generated output.
               #
-              #   @param reasoning_effort [Symbol, OpenAI::Models::ReasoningEffort, nil] Constrains effort on reasoning for
+              #   @param reasoning_effort [Symbol, OpenAI::Models::ReasoningEffort, nil] Constrains effort on reasoning for reasoning models. Currently supported
               #
               #   @param seed [Integer] A seed value to initialize the randomness, during sampling.
               #
@@ -677,7 +663,7 @@ module OpenAI
               #
               #   @param text [OpenAI::Models::Evals::RunCreateParams::DataSource::CreateEvalResponsesRunDataSource::SamplingParams::Text] Configuration options for a text response from the model. Can be plain
               #
-              #   @param tools [Array<OpenAI::Models::Responses::FunctionTool, OpenAI::Models::Responses::FileSearchTool, OpenAI::Models::Responses::ComputerTool, OpenAI::Models::Responses::ComputerUsePreviewTool, OpenAI::Models::Responses::Tool::Mcp, OpenAI::Models::Responses::Tool::CodeInterpreter, OpenAI::Models::Responses::Tool::ImageGeneration, OpenAI::Models::Responses::Tool::LocalShell, OpenAI::Models::Responses::FunctionShellTool, OpenAI::Models::Responses::CustomTool, OpenAI::Models::Responses::NamespaceTool, OpenAI::Models::Responses::ToolSearchTool, OpenAI::Models::Responses::ApplyPatchTool, OpenAI::Models::Responses::WebSearchTool, OpenAI::Models::Responses::WebSearchPreviewTool>] An array of tools the model may call while generating a response. You
+              #   @param tools [Array<OpenAI::Models::Responses::FunctionTool, OpenAI::Models::Responses::FileSearchTool, OpenAI::Models::Responses::ComputerTool, OpenAI::Models::Responses::ComputerUsePreviewTool, OpenAI::Models::Responses::Tool::Mcp, OpenAI::Models::Responses::Tool::CodeInterpreter, OpenAI::Models::Responses::Tool::ProgrammaticToolCalling, OpenAI::Models::Responses::Tool::ImageGeneration, OpenAI::Models::Responses::Tool::LocalShell, OpenAI::Models::Responses::FunctionShellTool, OpenAI::Models::Responses::CustomTool, OpenAI::Models::Responses::NamespaceTool, OpenAI::Models::Responses::ToolSearchTool, OpenAI::Models::Responses::ApplyPatchTool, OpenAI::Models::Responses::WebSearchTool, OpenAI::Models::Responses::WebSearchPreviewTool>] An array of tools the model may call while generating a response. You
               #
               #   @param top_p [Float] An alternative to temperature for nucleus sampling; 1.0 includes all tokens.

data/lib/openai/models/evals/run_create_response.rb CHANGED Viewed

@@ -314,19 +314,12 @@ module OpenAI
                 optional :model, String, nil?: true
                 # @!attribute reasoning_effort
-                #   Constrains effort on reasoning for
-                #   [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
-                #   supported values are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`.
-                #   Reducing reasoning effort can result in faster responses and fewer tokens used
-                #   on reasoning in a response.
-                #
-                #   - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported
-                #     reasoning values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool
-                #     calls are supported for all reasoning values in gpt-5.1.
-                #   - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
-                #     support `none`.
-                #   - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-                #   - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+                #   Constrains effort on reasoning for reasoning models. Currently supported values
+                #   are `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing
+                #   reasoning effort can result in faster responses and fewer tokens used on
+                #   reasoning in a response. Not all reasoning models support every value. See the
+                #   [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for
+                #   model-specific support.
                 #
                 #   @return [Symbol, OpenAI::Models::ReasoningEffort, nil]
                 optional :reasoning_effort, enum: -> { OpenAI::ReasoningEffort }, nil?: true
@@ -372,7 +365,7 @@ module OpenAI
                 #
                 #   @param model [String, nil] The name of the model to find responses for. This is a query parameter used to s
                 #
-                #   @param reasoning_effort [Symbol, OpenAI::Models::ReasoningEffort, nil] Constrains effort on reasoning for
+                #   @param reasoning_effort [Symbol, OpenAI::Models::ReasoningEffort, nil] Constrains effort on reasoning for reasoning models. Currently supported
                 #
                 #   @param temperature [Float, nil] Sampling temperature. This is a query parameter used to select responses.
                 #
@@ -662,19 +655,12 @@ module OpenAI
               optional :max_completion_tokens, Integer
               # @!attribute reasoning_effort
-              #   Constrains effort on reasoning for
-              #   [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
-              #   supported values are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`.
-              #   Reducing reasoning effort can result in faster responses and fewer tokens used
-              #   on reasoning in a response.
-              #
-              #   - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported
-              #     reasoning values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool
-              #     calls are supported for all reasoning values in gpt-5.1.
-              #   - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
-              #     support `none`.
-              #   - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-              #   - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+              #   Constrains effort on reasoning for reasoning models. Currently supported values
+              #   are `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing
+              #   reasoning effort can result in faster responses and fewer tokens used on
+              #   reasoning in a response. Not all reasoning models support every value. See the
+              #   [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for
+              #   model-specific support.
               #
               #   @return [Symbol, OpenAI::Models::ReasoningEffort, nil]
               optional :reasoning_effort, enum: -> { OpenAI::ReasoningEffort }, nil?: true
@@ -718,7 +704,7 @@ module OpenAI
               #     the model to call your own code. Learn more about
               #     [function calling](https://platform.openai.com/docs/guides/function-calling).
               #
-              #   @return [Array<OpenAI::Models::Responses::FunctionTool, OpenAI::Models::Responses::FileSearchTool, OpenAI::Models::Responses::ComputerTool, OpenAI::Models::Responses::ComputerUsePreviewTool, OpenAI::Models::Responses::Tool::Mcp, OpenAI::Models::Responses::Tool::CodeInterpreter, OpenAI::Models::Responses::Tool::ImageGeneration, OpenAI::Models::Responses::Tool::LocalShell, OpenAI::Models::Responses::FunctionShellTool, OpenAI::Models::Responses::CustomTool, OpenAI::Models::Responses::NamespaceTool, OpenAI::Models::Responses::ToolSearchTool, OpenAI::Models::Responses::ApplyPatchTool, OpenAI::Models::Responses::WebSearchTool, OpenAI::Models::Responses::WebSearchPreviewTool>, nil]
+              #   @return [Array<OpenAI::Models::Responses::FunctionTool, OpenAI::Models::Responses::FileSearchTool, OpenAI::Models::Responses::ComputerTool, OpenAI::Models::Responses::ComputerUsePreviewTool, OpenAI::Models::Responses::Tool::Mcp, OpenAI::Models::Responses::Tool::CodeInterpreter, OpenAI::Models::Responses::Tool::ProgrammaticToolCalling, OpenAI::Models::Responses::Tool::ImageGeneration, OpenAI::Models::Responses::Tool::LocalShell, OpenAI::Models::Responses::FunctionShellTool, OpenAI::Models::Responses::CustomTool, OpenAI::Models::Responses::NamespaceTool, OpenAI::Models::Responses::ToolSearchTool, OpenAI::Models::Responses::ApplyPatchTool, OpenAI::Models::Responses::WebSearchTool, OpenAI::Models::Responses::WebSearchPreviewTool>, nil]
               optional :tools, -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Responses::Tool] }
               # @!attribute top_p
@@ -734,7 +720,7 @@ module OpenAI
               #
               #   @param max_completion_tokens [Integer] The maximum number of tokens in the generated output.
               #
-              #   @param reasoning_effort [Symbol, OpenAI::Models::ReasoningEffort, nil] Constrains effort on reasoning for
+              #   @param reasoning_effort [Symbol, OpenAI::Models::ReasoningEffort, nil] Constrains effort on reasoning for reasoning models. Currently supported
               #
               #   @param seed [Integer] A seed value to initialize the randomness, during sampling.
               #
@@ -742,7 +728,7 @@ module OpenAI
               #
               #   @param text [OpenAI::Models::Evals::RunCreateResponse::DataSource::Responses::SamplingParams::Text] Configuration options for a text response from the model. Can be plain
               #
-              #   @param tools [Array<OpenAI::Models::Responses::FunctionTool, OpenAI::Models::Responses::FileSearchTool, OpenAI::Models::Responses::ComputerTool, OpenAI::Models::Responses::ComputerUsePreviewTool, OpenAI::Models::Responses::Tool::Mcp, OpenAI::Models::Responses::Tool::CodeInterpreter, OpenAI::Models::Responses::Tool::ImageGeneration, OpenAI::Models::Responses::Tool::LocalShell, OpenAI::Models::Responses::FunctionShellTool, OpenAI::Models::Responses::CustomTool, OpenAI::Models::Responses::NamespaceTool, OpenAI::Models::Responses::ToolSearchTool, OpenAI::Models::Responses::ApplyPatchTool, OpenAI::Models::Responses::WebSearchTool, OpenAI::Models::Responses::WebSearchPreviewTool>] An array of tools the model may call while generating a response. You
+              #   @param tools [Array<OpenAI::Models::Responses::FunctionTool, OpenAI::Models::Responses::FileSearchTool, OpenAI::Models::Responses::ComputerTool, OpenAI::Models::Responses::ComputerUsePreviewTool, OpenAI::Models::Responses::Tool::Mcp, OpenAI::Models::Responses::Tool::CodeInterpreter, OpenAI::Models::Responses::Tool::ProgrammaticToolCalling, OpenAI::Models::Responses::Tool::ImageGeneration, OpenAI::Models::Responses::Tool::LocalShell, OpenAI::Models::Responses::FunctionShellTool, OpenAI::Models::Responses::CustomTool, OpenAI::Models::Responses::NamespaceTool, OpenAI::Models::Responses::ToolSearchTool, OpenAI::Models::Responses::ApplyPatchTool, OpenAI::Models::Responses::WebSearchTool, OpenAI::Models::Responses::WebSearchPreviewTool>] An array of tools the model may call while generating a response. You
               #
               #   @param top_p [Float] An alternative to temperature for nucleus sampling; 1.0 includes all tokens.