openai 0.18.1 → 0.19.0

data/lib/openai/models/responses/response.rb

@@ -141,6 +141,13 @@ module OpenAI
         #   @return [Boolean, nil]
         optional :background, OpenAI::Internal::Type::Boolean, nil?: true
 
+        # @!attribute conversation
+        #   The conversation that this response belongs to. Input items and output items
+        #   from this response are automatically added to this conversation.
+        #
+        #   @return [OpenAI::Models::Responses::Response::Conversation, nil]
+        optional :conversation, -> { OpenAI::Responses::Response::Conversation }, nil?: true
+
         # @!attribute max_output_tokens
         #   An upper bound for the number of tokens that can be generated for a response,
         #   including visible output tokens and
@@ -162,6 +169,7 @@ module OpenAI
         #   The unique ID of the previous response to the model. Use this to create
         #   multi-turn conversations. Learn more about
         #   [conversation state](https://platform.openai.com/docs/guides/conversation-state).
+        #   Cannot be used in conjunction with `conversation`.
         #
         #   @return [String, nil]
         optional :previous_response_id, String, nil?: true
@@ -296,7 +304,7 @@ module OpenAI
           texts.join
         end
 
-        # @!method initialize(id:, created_at:, error:, incomplete_details:, instructions:, metadata:, model:, output:, parallel_tool_calls:, temperature:, tool_choice:, tools:, top_p:, background: nil, max_output_tokens: nil, max_tool_calls: nil, previous_response_id: nil, prompt: nil, prompt_cache_key: nil, reasoning: nil, safety_identifier: nil, service_tier: nil, status: nil, text: nil, top_logprobs: nil, truncation: nil, usage: nil, user: nil, object: :response)
+        # @!method initialize(id:, created_at:, error:, incomplete_details:, instructions:, metadata:, model:, output:, parallel_tool_calls:, temperature:, tool_choice:, tools:, top_p:, background: nil, conversation: nil, max_output_tokens: nil, max_tool_calls: nil, previous_response_id: nil, prompt: nil, prompt_cache_key: nil, reasoning: nil, safety_identifier: nil, service_tier: nil, status: nil, text: nil, top_logprobs: nil, truncation: nil, usage: nil, user: nil, object: :response)
         #   Some parameter documentations has been truncated, see
         #   {OpenAI::Models::Responses::Response} for more details.
         #
@@ -328,6 +336,8 @@ module OpenAI
         #
         #   @param background [Boolean, nil] Whether to run the model response in the background.
         #
+        #   @param conversation [OpenAI::Models::Responses::Response::Conversation, nil] The conversation that this response belongs to. Input items and output items fro
+        #
         #   @param max_output_tokens [Integer, nil] An upper bound for the number of tokens that can be generated for a response, in
         #
         #   @param max_tool_calls [Integer, nil] The maximum number of total calls to built-in tools that can be processed in a r
@@ -449,6 +459,21 @@ module OpenAI
           #   @return [Array(Symbol, OpenAI::Models::Responses::ToolChoiceOptions, OpenAI::Models::Responses::ToolChoiceAllowed, OpenAI::Models::Responses::ToolChoiceTypes, OpenAI::Models::Responses::ToolChoiceFunction, OpenAI::Models::Responses::ToolChoiceMcp, OpenAI::Models::Responses::ToolChoiceCustom)]
         end
 
+        # @see OpenAI::Models::Responses::Response#conversation
+        class Conversation < OpenAI::Internal::Type::BaseModel
+          # @!attribute id
+          #   The unique ID of the conversation.
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!method initialize(id:)
+          #   The conversation that this response belongs to. Input items and output items
+          #   from this response are automatically added to this conversation.
+          #
+          #   @param id [String] The unique ID of the conversation.
+        end
+
         # Specifies the processing type used for serving the request.
         #
         # - If set to 'auto', then the request will be processed with the service tier

data/lib/openai/models/responses/response_computer_tool_call.rb

@@ -27,9 +27,7 @@ module OpenAI
         #
         #   @return [Array<OpenAI::Models::Responses::ResponseComputerToolCall::PendingSafetyCheck>]
         required :pending_safety_checks,
-                 -> {
-                   OpenAI::Internal::Type::ArrayOf[OpenAI::Responses::ResponseComputerToolCall::PendingSafetyCheck]
-                 }
+                 -> { OpenAI::Internal::Type::ArrayOf[OpenAI::Responses::ResponseComputerToolCall::PendingSafetyCheck] }
 
         # @!attribute status
         #   The status of the item. One of `in_progress`, `completed`, or `incomplete`.
@@ -207,9 +205,7 @@ module OpenAI
             #
             #   @return [Array<OpenAI::Models::Responses::ResponseComputerToolCall::Action::Drag::Path>]
             required :path,
-                     -> {
-                       OpenAI::Internal::Type::ArrayOf[OpenAI::Responses::ResponseComputerToolCall::Action::Drag::Path]
-                     }
+                     -> { OpenAI::Internal::Type::ArrayOf[OpenAI::Responses::ResponseComputerToolCall::Action::Drag::Path] }
 
             # @!attribute type
             #   Specifies the event type. For a drag action, this property is always set to

data/lib/openai/models/responses/response_computer_tool_call_output_item.rb

@@ -34,9 +34,7 @@ module OpenAI
         #
         #   @return [Array<OpenAI::Models::Responses::ResponseComputerToolCallOutputItem::AcknowledgedSafetyCheck>, nil]
         optional :acknowledged_safety_checks,
-                 -> {
-                   OpenAI::Internal::Type::ArrayOf[OpenAI::Responses::ResponseComputerToolCallOutputItem::AcknowledgedSafetyCheck]
-                 }
+                 -> { OpenAI::Internal::Type::ArrayOf[OpenAI::Responses::ResponseComputerToolCallOutputItem::AcknowledgedSafetyCheck] }
 
         # @!attribute status
         #   The status of the message input. One of `in_progress`, `completed`, or

data/lib/openai/models/responses/response_conversation_param.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Responses
+      class ResponseConversationParam < OpenAI::Internal::Type::BaseModel
+        # @!attribute id
+        #   The unique ID of the conversation.
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!method initialize(id:)
+        #   The conversation that this response belongs to.
+        #
+        #   @param id [String] The unique ID of the conversation.
+      end
+    end
+  end
+end

data/lib/openai/models/responses/response_create_params.rb

@@ -17,6 +17,19 @@ module OpenAI
         #   @return [Boolean, nil]
         optional :background, OpenAI::Internal::Type::Boolean, nil?: true
 
+        # @!attribute conversation
+        #   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.
+        #
+        #   @return [String, OpenAI::Models::Responses::ResponseConversationParam, nil]
+        optional :conversation,
+                 union: -> {
+                   OpenAI::Responses::ResponseCreateParams::Conversation
+                 },
+                 nil?: true
+
         # @!attribute include
         #   Specify additional output data to include in the model response. Currently
         #   supported values are:
@@ -112,6 +125,7 @@ module OpenAI
         #   The unique ID of the previous response to the model. Use this to create
         #   multi-turn conversations. Learn more about
         #   [conversation state](https://platform.openai.com/docs/guides/conversation-state).
+        #   Cannot be used in conjunction with `conversation`.
         #
         #   @return [String, nil]
         optional :previous_response_id, String, nil?: true
@@ -278,12 +292,14 @@ module OpenAI
         #   @return [String, nil]
         optional :user, String
 
-        # @!method initialize(background: nil, include: nil, input: nil, instructions: nil, max_output_tokens: nil, max_tool_calls: nil, metadata: nil, model: nil, parallel_tool_calls: nil, previous_response_id: nil, prompt: nil, prompt_cache_key: nil, reasoning: nil, safety_identifier: nil, service_tier: nil, store: nil, stream_options: nil, temperature: nil, text: nil, tool_choice: nil, tools: nil, top_logprobs: nil, top_p: nil, truncation: nil, user: nil, request_options: {})
+        # @!method initialize(background: nil, conversation: nil, include: nil, input: nil, instructions: nil, max_output_tokens: nil, max_tool_calls: nil, metadata: nil, model: nil, parallel_tool_calls: nil, previous_response_id: nil, prompt: nil, prompt_cache_key: nil, reasoning: nil, safety_identifier: nil, service_tier: nil, store: nil, stream_options: nil, temperature: nil, text: nil, tool_choice: nil, tools: nil, top_logprobs: nil, top_p: nil, truncation: nil, user: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {OpenAI::Models::Responses::ResponseCreateParams} for more details.
         #
         #   @param background [Boolean, nil] Whether to run the model response in the background.
         #
+        #   @param conversation [String, OpenAI::Models::Responses::ResponseConversationParam, nil] The conversation that this response belongs to. Items from this conversation are
+        #
         #   @param include [Array<Symbol, OpenAI::Models::Responses::ResponseIncludable>, nil] Specify additional output data to include in the model response. Currently
         #
         #   @param input [String, 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::ResponseReasoningItem, OpenAI::Models::Responses::ResponseInputItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCallOutput, 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::ItemReference>] Text, image, or file inputs to the model, used to generate a response.
@@ -334,6 +350,23 @@ module OpenAI
         #
         #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
 
+        # 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.
+        module Conversation
+          extend OpenAI::Internal::Type::Union
+
+          # The unique ID of the conversation.
+          variant String
+
+          # The conversation that this response belongs to.
+          variant -> { OpenAI::Responses::ResponseConversationParam }
+
+          # @!method self.variants
+          #   @return [Array(String, OpenAI::Models::Responses::ResponseConversationParam)]
+        end
+
         # Text, image, or file inputs to the model, used to generate a response.
         #
         # Learn more:

data/lib/openai/models/responses/response_input_item.rb

@@ -95,10 +95,7 @@ module OpenAI
           #   types.
           #
           #   @return [Array<OpenAI::Models::Responses::ResponseInputText, OpenAI::Models::Responses::ResponseInputImage, OpenAI::Models::Responses::ResponseInputFile>]
-          required :content,
-                   -> {
-                     OpenAI::Internal::Type::ArrayOf[union: OpenAI::Responses::ResponseInputContent]
-                   }
+          required :content, -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Responses::ResponseInputContent] }
 
           # @!attribute role
           #   The role of the message input. One of `user`, `system`, or `developer`.
@@ -605,9 +602,7 @@ module OpenAI
           #
           #   @return [Array<OpenAI::Models::Responses::ResponseInputItem::McpListTools::Tool>]
           required :tools,
-                   -> {
-                     OpenAI::Internal::Type::ArrayOf[OpenAI::Responses::ResponseInputItem::McpListTools::Tool]
-                   }
+                   -> { OpenAI::Internal::Type::ArrayOf[OpenAI::Responses::ResponseInputItem::McpListTools::Tool] }
 
           # @!attribute type
           #   The type of the item. Always `mcp_list_tools`.

data/lib/openai/models/responses/response_input_message_item.rb

@@ -15,10 +15,7 @@ module OpenAI
         #   types.
         #
         #   @return [Array<OpenAI::Models::Responses::ResponseInputText, OpenAI::Models::Responses::ResponseInputImage, OpenAI::Models::Responses::ResponseInputFile>]
-        required :content,
-                 -> {
-                   OpenAI::Internal::Type::ArrayOf[union: OpenAI::Responses::ResponseInputContent]
-                 }
+        required :content, -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Responses::ResponseInputContent] }
 
         # @!attribute role
         #   The role of the message input. One of `user`, `system`, or `developer`.

data/lib/openai/models/responses/response_output_item.rb

@@ -314,9 +314,7 @@ module OpenAI
           #
           #   @return [Array<OpenAI::Models::Responses::ResponseOutputItem::McpListTools::Tool>]
           required :tools,
-                   -> {
-                     OpenAI::Internal::Type::ArrayOf[OpenAI::Responses::ResponseOutputItem::McpListTools::Tool]
-                   }
+                   -> { OpenAI::Internal::Type::ArrayOf[OpenAI::Responses::ResponseOutputItem::McpListTools::Tool] }
 
           # @!attribute type
           #   The type of the item. Always `mcp_list_tools`.

data/lib/openai/models/responses/response_output_message.rb

@@ -15,9 +15,7 @@ module OpenAI
         #
         #   @return [Array<OpenAI::Models::Responses::ResponseOutputText, OpenAI::Models::Responses::ResponseOutputRefusal>]
         required :content,
-                 -> {
-                   OpenAI::Internal::Type::ArrayOf[union: OpenAI::Responses::ResponseOutputMessage::Content]
-                 }
+                 -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Responses::ResponseOutputMessage::Content] }
 
         # @!attribute role
         #   The role of the output message. Always `assistant`.

data/lib/openai/models/responses/response_output_text.rb

@@ -9,9 +9,7 @@ module OpenAI
         #
         #   @return [Array<OpenAI::Models::Responses::ResponseOutputText::Annotation::FileCitation, OpenAI::Models::Responses::ResponseOutputText::Annotation::URLCitation, OpenAI::Models::Responses::ResponseOutputText::Annotation::ContainerFileCitation, OpenAI::Models::Responses::ResponseOutputText::Annotation::FilePath>]
         required :annotations,
-                 -> {
-                   OpenAI::Internal::Type::ArrayOf[union: OpenAI::Responses::ResponseOutputText::Annotation]
-                 }
+                 -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Responses::ResponseOutputText::Annotation] }
 
         # @!attribute text
         #   The text output from the model.
@@ -34,10 +32,7 @@ module OpenAI
         # @!attribute logprobs
         #
         #   @return [Array<OpenAI::Models::Responses::ResponseOutputText::Logprob>, nil]
-        optional :logprobs,
-                 -> {
-                   OpenAI::Internal::Type::ArrayOf[OpenAI::Responses::ResponseOutputText::Logprob]
-                 }
+        optional :logprobs, -> { OpenAI::Internal::Type::ArrayOf[OpenAI::Responses::ResponseOutputText::Logprob] }
 
         # @!method initialize(annotations:, text:, logprobs: nil, type: :output_text)
         #   A text output from the model.
@@ -261,9 +256,7 @@ module OpenAI
           #
           #   @return [Array<OpenAI::Models::Responses::ResponseOutputText::Logprob::TopLogprob>]
           required :top_logprobs,
-                   -> {
-                     OpenAI::Internal::Type::ArrayOf[OpenAI::Responses::ResponseOutputText::Logprob::TopLogprob]
-                   }
+                   -> { OpenAI::Internal::Type::ArrayOf[OpenAI::Responses::ResponseOutputText::Logprob::TopLogprob] }
 
           # @!method initialize(token:, bytes:, logprob:, top_logprobs:)
           #   The log probability of a token.

data/lib/openai/models/responses/response_stream_event.rb

@@ -16,10 +16,7 @@ module OpenAI
         variant :"response.audio.done", -> { OpenAI::Responses::ResponseAudioDoneEvent }
 
         # Emitted when there is a partial transcript of audio.
-        variant :"response.audio.transcript.delta",
-                -> {
-                  OpenAI::Responses::ResponseAudioTranscriptDeltaEvent
-                }
+        variant :"response.audio.transcript.delta", -> { OpenAI::Responses::ResponseAudioTranscriptDeltaEvent }
 
         # Emitted when the full audio transcript is completed.
         variant :"response.audio.transcript.done", -> { OpenAI::Responses::ResponseAudioTranscriptDoneEvent }
@@ -157,16 +154,10 @@ module OpenAI
                 -> { OpenAI::Responses::ResponseImageGenCallPartialImageEvent }
 
         # Emitted when there is a delta (partial update) to the arguments of an MCP tool call.
-        variant :"response.mcp_call_arguments.delta",
-                -> {
-                  OpenAI::Responses::ResponseMcpCallArgumentsDeltaEvent
-                }
+        variant :"response.mcp_call_arguments.delta", -> { OpenAI::Responses::ResponseMcpCallArgumentsDeltaEvent }
 
         # Emitted when the arguments for an MCP tool call are finalized.
-        variant :"response.mcp_call_arguments.done",
-                -> {
-                  OpenAI::Responses::ResponseMcpCallArgumentsDoneEvent
-                }
+        variant :"response.mcp_call_arguments.done", -> { OpenAI::Responses::ResponseMcpCallArgumentsDoneEvent }
 
         # Emitted when an MCP  tool call has completed successfully.
         variant :"response.mcp_call.completed", -> { OpenAI::Responses::ResponseMcpCallCompletedEvent }
@@ -178,10 +169,7 @@ module OpenAI
         variant :"response.mcp_call.in_progress", -> { OpenAI::Responses::ResponseMcpCallInProgressEvent }
 
         # Emitted when the list of available MCP tools has been successfully retrieved.
-        variant :"response.mcp_list_tools.completed",
-                -> {
-                  OpenAI::Responses::ResponseMcpListToolsCompletedEvent
-                }
+        variant :"response.mcp_list_tools.completed", -> { OpenAI::Responses::ResponseMcpListToolsCompletedEvent }
 
         # Emitted when the attempt to list available MCP tools has failed.
         variant :"response.mcp_list_tools.failed", -> { OpenAI::Responses::ResponseMcpListToolsFailedEvent }

data/lib/openai/models/responses/response_text_delta_event.rb

@@ -85,9 +85,7 @@ module OpenAI
           #
           #   @return [Array<OpenAI::Models::Responses::ResponseTextDeltaEvent::Logprob::TopLogprob>, nil]
           optional :top_logprobs,
-                   -> {
-                     OpenAI::Internal::Type::ArrayOf[OpenAI::Responses::ResponseTextDeltaEvent::Logprob::TopLogprob]
-                   }
+                   -> { OpenAI::Internal::Type::ArrayOf[OpenAI::Responses::ResponseTextDeltaEvent::Logprob::TopLogprob] }
 
           # @!method initialize(token:, logprob:, top_logprobs: nil)
           #   Some parameter documentations has been truncated, see

data/lib/openai/models/responses/response_text_done_event.rb

@@ -85,9 +85,7 @@ module OpenAI
           #
           #   @return [Array<OpenAI::Models::Responses::ResponseTextDoneEvent::Logprob::TopLogprob>, nil]
           optional :top_logprobs,
-                   -> {
-                     OpenAI::Internal::Type::ArrayOf[OpenAI::Responses::ResponseTextDoneEvent::Logprob::TopLogprob]
-                   }
+                   -> { OpenAI::Internal::Type::ArrayOf[OpenAI::Responses::ResponseTextDoneEvent::Logprob::TopLogprob] }
 
           # @!method initialize(token:, logprob:, top_logprobs: nil)
           #   Some parameter documentations has been truncated, see

data/lib/openai/models/responses/tool.rb

@@ -47,12 +47,6 @@ module OpenAI
           #   @return [String]
           required :server_label, String
 
-          # @!attribute server_url
-          #   The URL for the MCP server.
-          #
-          #   @return [String]
-          required :server_url, String
-
           # @!attribute type
           #   The type of the MCP tool. Always `mcp`.
           #
@@ -62,9 +56,37 @@ module OpenAI
           # @!attribute allowed_tools
           #   List of allowed tool names or a filter object.
           #
-          #   @return [Array<String>, OpenAI::Models::Responses::Tool::Mcp::AllowedTools::McpAllowedToolsFilter, nil]
+          #   @return [Array<String>, OpenAI::Models::Responses::Tool::Mcp::AllowedTools::McpToolFilter, nil]
           optional :allowed_tools, union: -> { OpenAI::Responses::Tool::Mcp::AllowedTools }, nil?: true
 
+          # @!attribute authorization
+          #   An OAuth access token that can be used with a remote MCP server, either with a
+          #   custom MCP server URL or a service connector. Your application must handle the
+          #   OAuth authorization flow and provide the token here.
+          #
+          #   @return [String, nil]
+          optional :authorization, String
+
+          # @!attribute connector_id
+          #   Identifier for service connectors, like those available in ChatGPT. One of
+          #   `server_url` or `connector_id` must be provided. Learn more about service
+          #   connectors
+          #   [here](https://platform.openai.com/docs/guides/tools-remote-mcp#connectors).
+          #
+          #   Currently supported `connector_id` values are:
+          #
+          #   - Dropbox: `connector_dropbox`
+          #   - Gmail: `connector_gmail`
+          #   - Google Calendar: `connector_googlecalendar`
+          #   - Google Drive: `connector_googledrive`
+          #   - Microsoft Teams: `connector_microsoftteams`
+          #   - Outlook Calendar: `connector_outlookcalendar`
+          #   - Outlook Email: `connector_outlookemail`
+          #   - SharePoint: `connector_sharepoint`
+          #
+          #   @return [Symbol, OpenAI::Models::Responses::Tool::Mcp::ConnectorID, nil]
+          optional :connector_id, enum: -> { OpenAI::Responses::Tool::Mcp::ConnectorID }
+
           # @!attribute headers
           #   Optional HTTP headers to send to the MCP server. Use for authentication or other
           #   purposes.
@@ -84,7 +106,14 @@ module OpenAI
           #   @return [String, nil]
           optional :server_description, String
 
-          # @!method initialize(server_label:, server_url:, allowed_tools: nil, headers: nil, require_approval: nil, server_description: nil, type: :mcp)
+          # @!attribute server_url
+          #   The URL for the MCP server. One of `server_url` or `connector_id` must be
+          #   provided.
+          #
+          #   @return [String, nil]
+          optional :server_url, String
+
+          # @!method initialize(server_label:, allowed_tools: nil, authorization: nil, connector_id: nil, headers: nil, require_approval: nil, server_description: nil, server_url: nil, type: :mcp)
           #   Some parameter documentations has been truncated, see
           #   {OpenAI::Models::Responses::Tool::Mcp} for more details.
           #
@@ -94,9 +123,11 @@ module OpenAI
           #
           #   @param server_label [String] A label for this MCP server, used to identify it in tool calls.
           #
-          #   @param server_url [String] The URL for the MCP server.
+          #   @param allowed_tools [Array<String>, OpenAI::Models::Responses::Tool::Mcp::AllowedTools::McpToolFilter, nil] List of allowed tool names or a filter object.
+          #
+          #   @param authorization [String] An OAuth access token that can be used with a remote MCP server, either
           #
-          #   @param allowed_tools [Array<String>, OpenAI::Models::Responses::Tool::Mcp::AllowedTools::McpAllowedToolsFilter, nil] List of allowed tool names or a filter object.
+          #   @param connector_id [Symbol, OpenAI::Models::Responses::Tool::Mcp::ConnectorID] Identifier for service connectors, like those available in ChatGPT. One of
           #
           #   @param headers [Hash{Symbol=>String}, nil] Optional HTTP headers to send to the MCP server. Use for authentication
           #
@@ -104,6 +135,8 @@ module OpenAI
           #
           #   @param server_description [String] Optional description of the MCP server, used to provide more context.
           #
+          #   @param server_url [String] The URL for the MCP server. One of `server_url` or `connector_id` must be
+          #
           #   @param type [Symbol, :mcp] The type of the MCP tool. Always `mcp`.
 
           # List of allowed tool names or a filter object.
@@ -116,34 +149,85 @@ module OpenAI
             variant -> { OpenAI::Models::Responses::Tool::Mcp::AllowedTools::StringArray }
 
             # A filter object to specify which tools are allowed.
-            variant -> { OpenAI::Responses::Tool::Mcp::AllowedTools::McpAllowedToolsFilter }
+            variant -> { OpenAI::Responses::Tool::Mcp::AllowedTools::McpToolFilter }
+
+            class McpToolFilter < OpenAI::Internal::Type::BaseModel
+              # @!attribute read_only
+              #   Indicates whether or not a tool modifies data or is read-only. If an MCP server
+              #   is
+              #   [annotated with `readOnlyHint`](https://modelcontextprotocol.io/specification/2025-06-18/schema#toolannotations-readonlyhint),
+              #   it will match this filter.
+              #
+              #   @return [Boolean, nil]
+              optional :read_only, OpenAI::Internal::Type::Boolean
 
-            class McpAllowedToolsFilter < OpenAI::Internal::Type::BaseModel
               # @!attribute tool_names
               #   List of allowed tool names.
               #
               #   @return [Array<String>, nil]
               optional :tool_names, OpenAI::Internal::Type::ArrayOf[String]
 
-              # @!method initialize(tool_names: nil)
+              # @!method initialize(read_only: nil, tool_names: nil)
+              #   Some parameter documentations has been truncated, see
+              #   {OpenAI::Models::Responses::Tool::Mcp::AllowedTools::McpToolFilter} for more
+              #   details.
+              #
               #   A filter object to specify which tools are allowed.
               #
+              #   @param read_only [Boolean] Indicates whether or not a tool modifies data or is read-only. If an
+              #
               #   @param tool_names [Array<String>] List of allowed tool names.
             end
 
             # @!method self.variants
-            #   @return [Array(Array<String>, OpenAI::Models::Responses::Tool::Mcp::AllowedTools::McpAllowedToolsFilter)]
+            #   @return [Array(Array<String>, OpenAI::Models::Responses::Tool::Mcp::AllowedTools::McpToolFilter)]
 
             # @type [OpenAI::Internal::Type::Converter]
             StringArray = OpenAI::Internal::Type::ArrayOf[String]
           end
 
+          # Identifier for service connectors, like those available in ChatGPT. One of
+          # `server_url` or `connector_id` must be provided. Learn more about service
+          # connectors
+          # [here](https://platform.openai.com/docs/guides/tools-remote-mcp#connectors).
+          #
+          # Currently supported `connector_id` values are:
+          #
+          # - Dropbox: `connector_dropbox`
+          # - Gmail: `connector_gmail`
+          # - Google Calendar: `connector_googlecalendar`
+          # - Google Drive: `connector_googledrive`
+          # - Microsoft Teams: `connector_microsoftteams`
+          # - Outlook Calendar: `connector_outlookcalendar`
+          # - Outlook Email: `connector_outlookemail`
+          # - SharePoint: `connector_sharepoint`
+          #
+          # @see OpenAI::Models::Responses::Tool::Mcp#connector_id
+          module ConnectorID
+            extend OpenAI::Internal::Type::Enum
+
+            CONNECTOR_DROPBOX = :connector_dropbox
+            CONNECTOR_GMAIL = :connector_gmail
+            CONNECTOR_GOOGLECALENDAR = :connector_googlecalendar
+            CONNECTOR_GOOGLEDRIVE = :connector_googledrive
+            CONNECTOR_MICROSOFTTEAMS = :connector_microsoftteams
+            CONNECTOR_OUTLOOKCALENDAR = :connector_outlookcalendar
+            CONNECTOR_OUTLOOKEMAIL = :connector_outlookemail
+            CONNECTOR_SHAREPOINT = :connector_sharepoint
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
           # Specify which of the MCP server's tools require approval.
           #
           # @see OpenAI::Models::Responses::Tool::Mcp#require_approval
           module RequireApproval
             extend OpenAI::Internal::Type::Union
 
+            # Specify which of the MCP server's tools require approval. Can be
+            # `always`, `never`, or a filter object associated with tools
+            # that require approval.
             variant -> { OpenAI::Responses::Tool::Mcp::RequireApproval::McpToolApprovalFilter }
 
             # Specify a single approval policy for all tools. One of `always` or
@@ -153,58 +237,85 @@ module OpenAI
 
             class McpToolApprovalFilter < OpenAI::Internal::Type::BaseModel
               # @!attribute always
-              #   A list of tools that always require approval.
+              #   A filter object to specify which tools are allowed.
               #
               #   @return [OpenAI::Models::Responses::Tool::Mcp::RequireApproval::McpToolApprovalFilter::Always, nil]
-              optional :always,
-                       -> {
-                         OpenAI::Responses::Tool::Mcp::RequireApproval::McpToolApprovalFilter::Always
-                       }
+              optional :always, -> { OpenAI::Responses::Tool::Mcp::RequireApproval::McpToolApprovalFilter::Always }
 
               # @!attribute never
-              #   A list of tools that never require approval.
+              #   A filter object to specify which tools are allowed.
               #
               #   @return [OpenAI::Models::Responses::Tool::Mcp::RequireApproval::McpToolApprovalFilter::Never, nil]
-              optional :never,
-                       -> {
-                         OpenAI::Responses::Tool::Mcp::RequireApproval::McpToolApprovalFilter::Never
-                       }
+              optional :never, -> { OpenAI::Responses::Tool::Mcp::RequireApproval::McpToolApprovalFilter::Never }
 
               # @!method initialize(always: nil, never: nil)
               #   Some parameter documentations has been truncated, see
               #   {OpenAI::Models::Responses::Tool::Mcp::RequireApproval::McpToolApprovalFilter}
               #   for more details.
               #
-              #   @param always [OpenAI::Models::Responses::Tool::Mcp::RequireApproval::McpToolApprovalFilter::Always] A list of tools that always require approval.
+              #   Specify which of the MCP server's tools require approval. Can be `always`,
+              #   `never`, or a filter object associated with tools that require approval.
+              #
+              #   @param always [OpenAI::Models::Responses::Tool::Mcp::RequireApproval::McpToolApprovalFilter::Always] A filter object to specify which tools are allowed.
               #
-              #   @param never [OpenAI::Models::Responses::Tool::Mcp::RequireApproval::McpToolApprovalFilter::Never] A list of tools that never require approval.
+              #   @param never [OpenAI::Models::Responses::Tool::Mcp::RequireApproval::McpToolApprovalFilter::Never] A filter object to specify which tools are allowed.
 
               # @see OpenAI::Models::Responses::Tool::Mcp::RequireApproval::McpToolApprovalFilter#always
               class Always < OpenAI::Internal::Type::BaseModel
+                # @!attribute read_only
+                #   Indicates whether or not a tool modifies data or is read-only. If an MCP server
+                #   is
+                #   [annotated with `readOnlyHint`](https://modelcontextprotocol.io/specification/2025-06-18/schema#toolannotations-readonlyhint),
+                #   it will match this filter.
+                #
+                #   @return [Boolean, nil]
+                optional :read_only, OpenAI::Internal::Type::Boolean
+
                 # @!attribute tool_names
-                #   List of tools that require approval.
+                #   List of allowed tool names.
                 #
                 #   @return [Array<String>, nil]
                 optional :tool_names, OpenAI::Internal::Type::ArrayOf[String]
 
-                # @!method initialize(tool_names: nil)
-                #   A list of tools that always require approval.
+                # @!method initialize(read_only: nil, tool_names: nil)
+                #   Some parameter documentations has been truncated, see
+                #   {OpenAI::Models::Responses::Tool::Mcp::RequireApproval::McpToolApprovalFilter::Always}
+                #   for more details.
+                #
+                #   A filter object to specify which tools are allowed.
                 #
-                #   @param tool_names [Array<String>] List of tools that require approval.
+                #   @param read_only [Boolean] Indicates whether or not a tool modifies data or is read-only. If an
+                #
+                #   @param tool_names [Array<String>] List of allowed tool names.
               end
 
               # @see OpenAI::Models::Responses::Tool::Mcp::RequireApproval::McpToolApprovalFilter#never
               class Never < OpenAI::Internal::Type::BaseModel
+                # @!attribute read_only
+                #   Indicates whether or not a tool modifies data or is read-only. If an MCP server
+                #   is
+                #   [annotated with `readOnlyHint`](https://modelcontextprotocol.io/specification/2025-06-18/schema#toolannotations-readonlyhint),
+                #   it will match this filter.
+                #
+                #   @return [Boolean, nil]
+                optional :read_only, OpenAI::Internal::Type::Boolean
+
                 # @!attribute tool_names
-                #   List of tools that do not require approval.
+                #   List of allowed tool names.
                 #
                 #   @return [Array<String>, nil]
                 optional :tool_names, OpenAI::Internal::Type::ArrayOf[String]
 
-                # @!method initialize(tool_names: nil)
-                #   A list of tools that never require approval.
+                # @!method initialize(read_only: nil, tool_names: nil)
+                #   Some parameter documentations has been truncated, see
+                #   {OpenAI::Models::Responses::Tool::Mcp::RequireApproval::McpToolApprovalFilter::Never}
+                #   for more details.
+                #
+                #   A filter object to specify which tools are allowed.
+                #
+                #   @param read_only [Boolean] Indicates whether or not a tool modifies data or is read-only. If an
                 #
-                #   @param tool_names [Array<String>] List of tools that do not require approval.
+                #   @param tool_names [Array<String>] List of allowed tool names.
               end
             end
 

data/lib/openai/models.rb

@@ -91,6 +91,8 @@ module OpenAI
 
   Containers = OpenAI::Models::Containers
 
+  Conversations = OpenAI::Models::Conversations
+
   CreateEmbeddingResponse = OpenAI::Models::CreateEmbeddingResponse
 
   CustomToolInputFormat = OpenAI::Models::CustomToolInputFormat