openai 0.17.1 → 0.19.0

data/rbi/openai/models/responses/response_conversation_param.rbi

@@ -0,0 +1,33 @@
+# typed: strong
+
+module OpenAI
+  module Models
+    module Responses
+      class ResponseConversationParam < OpenAI::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              OpenAI::Responses::ResponseConversationParam,
+              OpenAI::Internal::AnyHash
+            )
+          end
+
+        # The unique ID of the conversation.
+        sig { returns(String) }
+        attr_accessor :id
+
+        # The conversation that this response belongs to.
+        sig { params(id: String).returns(T.attached_class) }
+        def self.new(
+          # The unique ID of the conversation.
+          id:
+        )
+        end
+
+        sig { override.returns({ id: String }) }
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/openai/models/responses/response_create_params.rbi

@@ -20,6 +20,19 @@ module OpenAI
         sig { returns(T.nilable(T::Boolean)) }
         attr_accessor :background
 
+        # 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.
+        sig do
+          returns(
+            T.nilable(
+              T.any(String, OpenAI::Responses::ResponseConversationParam)
+            )
+          )
+        end
+        attr_accessor :conversation
+
         # Specify additional output data to include in the model response. Currently
         # supported values are:
         #
@@ -133,6 +146,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`.
         sig { returns(T.nilable(String)) }
         attr_accessor :previous_response_id
 
@@ -157,7 +171,7 @@ module OpenAI
         sig { params(prompt_cache_key: String).void }
         attr_writer :prompt_cache_key
 
-        # **o-series models only**
+        # **gpt-5 and o-series models only**
         #
         # Configuration options for
         # [reasoning models](https://platform.openai.com/docs/guides/reasoning).
@@ -186,9 +200,8 @@ module OpenAI
         # - If set to 'default', then the request will be processed with the standard
         #   pricing and performance for the selected model.
         # - If set to '[flex](https://platform.openai.com/docs/guides/flex-processing)' or
-        #   'priority', then the request will be processed with the corresponding service
-        #   tier. [Contact sales](https://openai.com/contact-sales) to learn more about
-        #   Priority processing.
+        #   '[priority](https://openai.com/api-priority-processing/)', then the request
+        #   will be processed with the corresponding service tier.
         # - When not set, the default behavior is 'auto'.
         #
         # When the `service_tier` parameter is set, the response body will include the
@@ -386,6 +399,13 @@ module OpenAI
         sig do
           params(
             background: T.nilable(T::Boolean),
+            conversation:
+              T.nilable(
+                T.any(
+                  String,
+                  OpenAI::Responses::ResponseConversationParam::OrHash
+                )
+              ),
             include:
               T.nilable(
                 T::Array[OpenAI::Responses::ResponseIncludable::OrSymbol]
@@ -455,6 +475,11 @@ module OpenAI
           # Whether to run the model response in the background.
           # [Learn more](https://platform.openai.com/docs/guides/background).
           background: nil,
+          # The conversation that this response belongs to. Items from this conversation are
+          # prepended to `input_items` for this response request. Input items and output
+          # items from this response are automatically added to this conversation after this
+          # response completes.
+          conversation: nil,
           # Specify additional output data to include in the model response. Currently
           # supported values are:
           #
@@ -515,6 +540,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`.
           previous_response_id: nil,
           # Reference to a prompt template and its variables.
           # [Learn more](https://platform.openai.com/docs/guides/text?api-mode=responses#reusable-prompts).
@@ -523,7 +549,7 @@ module OpenAI
           # hit rates. Replaces the `user` field.
           # [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
           prompt_cache_key: nil,
-          # **o-series models only**
+          # **gpt-5 and o-series models only**
           #
           # Configuration options for
           # [reasoning models](https://platform.openai.com/docs/guides/reasoning).
@@ -542,9 +568,8 @@ module OpenAI
           # - If set to 'default', then the request will be processed with the standard
           #   pricing and performance for the selected model.
           # - If set to '[flex](https://platform.openai.com/docs/guides/flex-processing)' or
-          #   'priority', then the request will be processed with the corresponding service
-          #   tier. [Contact sales](https://openai.com/contact-sales) to learn more about
-          #   Priority processing.
+          #   '[priority](https://openai.com/api-priority-processing/)', then the request
+          #   will be processed with the corresponding service tier.
           # - When not set, the default behavior is 'auto'.
           #
           # When the `service_tier` parameter is set, the response body will include the
@@ -619,6 +644,10 @@ module OpenAI
           override.returns(
             {
               background: T.nilable(T::Boolean),
+              conversation:
+                T.nilable(
+                  T.any(String, OpenAI::Responses::ResponseConversationParam)
+                ),
               include:
                 T.nilable(
                   T::Array[OpenAI::Responses::ResponseIncludable::OrSymbol]
@@ -688,6 +717,29 @@ module OpenAI
         def to_hash
         end
 
+        # 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
+
+          Variants =
+            T.type_alias do
+              T.any(String, OpenAI::Responses::ResponseConversationParam)
+            end
+
+          sig do
+            override.returns(
+              T::Array[
+                OpenAI::Responses::ResponseCreateParams::Conversation::Variants
+              ]
+            )
+          end
+          def self.variants
+          end
+        end
+
         # Text, image, or file inputs to the model, used to generate a response.
         #
         # Learn more:
@@ -725,9 +777,8 @@ module OpenAI
         # - If set to 'default', then the request will be processed with the standard
         #   pricing and performance for the selected model.
         # - If set to '[flex](https://platform.openai.com/docs/guides/flex-processing)' or
-        #   'priority', then the request will be processed with the corresponding service
-        #   tier. [Contact sales](https://openai.com/contact-sales) to learn more about
-        #   Priority processing.
+        #   '[priority](https://openai.com/api-priority-processing/)', then the request
+        #   will be processed with the corresponding service tier.
         # - When not set, the default behavior is 'auto'.
         #
         # When the `service_tier` parameter is set, the response body will include the

data/rbi/openai/models/responses/tool.rbi

@@ -32,10 +32,6 @@ module OpenAI
           sig { returns(String) }
           attr_accessor :server_label
 
-          # The URL for the MCP server.
-          sig { returns(String) }
-          attr_accessor :server_url
-
           # The type of the MCP tool. Always `mcp`.
           sig { returns(Symbol) }
           attr_accessor :type
@@ -46,13 +42,51 @@ module OpenAI
               T.nilable(
                 T.any(
                   T::Array[String],
-                  OpenAI::Responses::Tool::Mcp::AllowedTools::McpAllowedToolsFilter
+                  OpenAI::Responses::Tool::Mcp::AllowedTools::McpToolFilter
                 )
               )
             )
           end
           attr_accessor :allowed_tools
 
+          # An OAuth access token that can be used with a remote MCP server, either with a
+          # custom MCP server URL or a service connector. Your application must handle the
+          # OAuth authorization flow and provide the token here.
+          sig { returns(T.nilable(String)) }
+          attr_reader :authorization
+
+          sig { params(authorization: String).void }
+          attr_writer :authorization
+
+          # 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`
+          sig do
+            returns(
+              T.nilable(OpenAI::Responses::Tool::Mcp::ConnectorID::OrSymbol)
+            )
+          end
+          attr_reader :connector_id
+
+          sig do
+            params(
+              connector_id: OpenAI::Responses::Tool::Mcp::ConnectorID::OrSymbol
+            ).void
+          end
+          attr_writer :connector_id
+
           # Optional HTTP headers to send to the MCP server. Use for authentication or other
           # purposes.
           sig { returns(T.nilable(T::Hash[Symbol, String])) }
@@ -78,20 +112,29 @@ module OpenAI
           sig { params(server_description: String).void }
           attr_writer :server_description
 
+          # The URL for the MCP server. One of `server_url` or `connector_id` must be
+          # provided.
+          sig { returns(T.nilable(String)) }
+          attr_reader :server_url
+
+          sig { params(server_url: String).void }
+          attr_writer :server_url
+
           # Give the model access to additional tools via remote Model Context Protocol
           # (MCP) servers.
           # [Learn more about MCP](https://platform.openai.com/docs/guides/tools-remote-mcp).
           sig do
             params(
               server_label: String,
-              server_url: String,
               allowed_tools:
                 T.nilable(
                   T.any(
                     T::Array[String],
-                    OpenAI::Responses::Tool::Mcp::AllowedTools::McpAllowedToolsFilter::OrHash
+                    OpenAI::Responses::Tool::Mcp::AllowedTools::McpToolFilter::OrHash
                   )
                 ),
+              authorization: String,
+              connector_id: OpenAI::Responses::Tool::Mcp::ConnectorID::OrSymbol,
               headers: T.nilable(T::Hash[Symbol, String]),
               require_approval:
                 T.nilable(
@@ -101,16 +144,35 @@ module OpenAI
                   )
                 ),
               server_description: String,
+              server_url: String,
               type: Symbol
             ).returns(T.attached_class)
           end
           def self.new(
             # A label for this MCP server, used to identify it in tool calls.
             server_label:,
-            # The URL for the MCP server.
-            server_url:,
             # List of allowed tool names or a filter object.
             allowed_tools: nil,
+            # 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.
+            authorization: nil,
+            # 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`
+            connector_id: nil,
             # Optional HTTP headers to send to the MCP server. Use for authentication or other
             # purposes.
             headers: nil,
@@ -118,6 +180,9 @@ module OpenAI
             require_approval: nil,
             # Optional description of the MCP server, used to provide more context.
             server_description: nil,
+            # The URL for the MCP server. One of `server_url` or `connector_id` must be
+            # provided.
+            server_url: nil,
             # The type of the MCP tool. Always `mcp`.
             type: :mcp
           )
@@ -127,15 +192,17 @@ module OpenAI
             override.returns(
               {
                 server_label: String,
-                server_url: String,
                 type: Symbol,
                 allowed_tools:
                   T.nilable(
                     T.any(
                       T::Array[String],
-                      OpenAI::Responses::Tool::Mcp::AllowedTools::McpAllowedToolsFilter
+                      OpenAI::Responses::Tool::Mcp::AllowedTools::McpToolFilter
                     )
                   ),
+                authorization: String,
+                connector_id:
+                  OpenAI::Responses::Tool::Mcp::ConnectorID::OrSymbol,
                 headers: T.nilable(T::Hash[Symbol, String]),
                 require_approval:
                   T.nilable(
@@ -144,7 +211,8 @@ module OpenAI
                       OpenAI::Responses::Tool::Mcp::RequireApproval::McpToolApprovalSetting::OrSymbol
                     )
                   ),
-                server_description: String
+                server_description: String,
+                server_url: String
               }
             )
           end
@@ -159,19 +227,29 @@ module OpenAI
               T.type_alias do
                 T.any(
                   T::Array[String],
-                  OpenAI::Responses::Tool::Mcp::AllowedTools::McpAllowedToolsFilter
+                  OpenAI::Responses::Tool::Mcp::AllowedTools::McpToolFilter
                 )
               end
 
-            class McpAllowedToolsFilter < OpenAI::Internal::Type::BaseModel
+            class McpToolFilter < OpenAI::Internal::Type::BaseModel
               OrHash =
                 T.type_alias do
                   T.any(
-                    OpenAI::Responses::Tool::Mcp::AllowedTools::McpAllowedToolsFilter,
+                    OpenAI::Responses::Tool::Mcp::AllowedTools::McpToolFilter,
                     OpenAI::Internal::AnyHash
                   )
                 end
 
+              # 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.
+              sig { returns(T.nilable(T::Boolean)) }
+              attr_reader :read_only
+
+              sig { params(read_only: T::Boolean).void }
+              attr_writer :read_only
+
               # List of allowed tool names.
               sig { returns(T.nilable(T::Array[String])) }
               attr_reader :tool_names
@@ -181,15 +259,27 @@ module OpenAI
 
               # A filter object to specify which tools are allowed.
               sig do
-                params(tool_names: T::Array[String]).returns(T.attached_class)
+                params(
+                  read_only: T::Boolean,
+                  tool_names: T::Array[String]
+                ).returns(T.attached_class)
               end
               def self.new(
+                # 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.
+                read_only: nil,
                 # List of allowed tool names.
                 tool_names: nil
               )
               end
 
-              sig { override.returns({ tool_names: T::Array[String] }) }
+              sig do
+                override.returns(
+                  { read_only: T::Boolean, tool_names: T::Array[String] }
+                )
+              end
               def to_hash
               end
             end
@@ -209,6 +299,82 @@ module OpenAI
               )
           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`
+          module ConnectorID
+            extend OpenAI::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(Symbol, OpenAI::Responses::Tool::Mcp::ConnectorID)
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            CONNECTOR_DROPBOX =
+              T.let(
+                :connector_dropbox,
+                OpenAI::Responses::Tool::Mcp::ConnectorID::TaggedSymbol
+              )
+            CONNECTOR_GMAIL =
+              T.let(
+                :connector_gmail,
+                OpenAI::Responses::Tool::Mcp::ConnectorID::TaggedSymbol
+              )
+            CONNECTOR_GOOGLECALENDAR =
+              T.let(
+                :connector_googlecalendar,
+                OpenAI::Responses::Tool::Mcp::ConnectorID::TaggedSymbol
+              )
+            CONNECTOR_GOOGLEDRIVE =
+              T.let(
+                :connector_googledrive,
+                OpenAI::Responses::Tool::Mcp::ConnectorID::TaggedSymbol
+              )
+            CONNECTOR_MICROSOFTTEAMS =
+              T.let(
+                :connector_microsoftteams,
+                OpenAI::Responses::Tool::Mcp::ConnectorID::TaggedSymbol
+              )
+            CONNECTOR_OUTLOOKCALENDAR =
+              T.let(
+                :connector_outlookcalendar,
+                OpenAI::Responses::Tool::Mcp::ConnectorID::TaggedSymbol
+              )
+            CONNECTOR_OUTLOOKEMAIL =
+              T.let(
+                :connector_outlookemail,
+                OpenAI::Responses::Tool::Mcp::ConnectorID::TaggedSymbol
+              )
+            CONNECTOR_SHAREPOINT =
+              T.let(
+                :connector_sharepoint,
+                OpenAI::Responses::Tool::Mcp::ConnectorID::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  OpenAI::Responses::Tool::Mcp::ConnectorID::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+
           # Specify which of the MCP server's tools require approval.
           module RequireApproval
             extend OpenAI::Internal::Type::Union
@@ -230,7 +396,7 @@ module OpenAI
                   )
                 end
 
-              # A list of tools that always require approval.
+              # A filter object to specify which tools are allowed.
               sig do
                 returns(
                   T.nilable(
@@ -248,7 +414,7 @@ module OpenAI
               end
               attr_writer :always
 
-              # A list of tools that never require approval.
+              # A filter object to specify which tools are allowed.
               sig do
                 returns(
                   T.nilable(
@@ -266,6 +432,8 @@ module OpenAI
               end
               attr_writer :never
 
+              # Specify which of the MCP server's tools require approval. Can be `always`,
+              # `never`, or a filter object associated with tools that require approval.
               sig do
                 params(
                   always:
@@ -275,9 +443,9 @@ module OpenAI
                 ).returns(T.attached_class)
               end
               def self.new(
-                # A list of tools that always require approval.
+                # A filter object to specify which tools are allowed.
                 always: nil,
-                # A list of tools that never require approval.
+                # A filter object to specify which tools are allowed.
                 never: nil
               )
               end
@@ -304,24 +472,46 @@ module OpenAI
                     )
                   end
 
-                # List of tools that require approval.
+                # 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.
+                sig { returns(T.nilable(T::Boolean)) }
+                attr_reader :read_only
+
+                sig { params(read_only: T::Boolean).void }
+                attr_writer :read_only
+
+                # List of allowed tool names.
                 sig { returns(T.nilable(T::Array[String])) }
                 attr_reader :tool_names
 
                 sig { params(tool_names: T::Array[String]).void }
                 attr_writer :tool_names
 
-                # A list of tools that always require approval.
+                # A filter object to specify which tools are allowed.
                 sig do
-                  params(tool_names: T::Array[String]).returns(T.attached_class)
+                  params(
+                    read_only: T::Boolean,
+                    tool_names: T::Array[String]
+                  ).returns(T.attached_class)
                 end
                 def self.new(
-                  # List of tools that require approval.
+                  # 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.
+                  read_only: nil,
+                  # List of allowed tool names.
                   tool_names: nil
                 )
                 end
 
-                sig { override.returns({ tool_names: T::Array[String] }) }
+                sig do
+                  override.returns(
+                    { read_only: T::Boolean, tool_names: T::Array[String] }
+                  )
+                end
                 def to_hash
                 end
               end
@@ -335,24 +525,46 @@ module OpenAI
                     )
                   end
 
-                # List of tools that do not require approval.
+                # 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.
+                sig { returns(T.nilable(T::Boolean)) }
+                attr_reader :read_only
+
+                sig { params(read_only: T::Boolean).void }
+                attr_writer :read_only
+
+                # List of allowed tool names.
                 sig { returns(T.nilable(T::Array[String])) }
                 attr_reader :tool_names
 
                 sig { params(tool_names: T::Array[String]).void }
                 attr_writer :tool_names
 
-                # A list of tools that never require approval.
+                # A filter object to specify which tools are allowed.
                 sig do
-                  params(tool_names: T::Array[String]).returns(T.attached_class)
+                  params(
+                    read_only: T::Boolean,
+                    tool_names: T::Array[String]
+                  ).returns(T.attached_class)
                 end
                 def self.new(
-                  # List of tools that do not require approval.
+                  # 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.
+                  read_only: nil,
+                  # List of allowed tool names.
                   tool_names: nil
                 )
                 end
 
-                sig { override.returns({ tool_names: T::Array[String] }) }
+                sig do
+                  override.returns(
+                    { read_only: T::Boolean, tool_names: T::Array[String] }
+                  )
+                end
                 def to_hash
                 end
               end