openai 0.28.0 → 0.28.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 01342bdfdf8f3ad25ed0b3266cae9dc3022f3356ed7b6268d01164e10702ce69
-  data.tar.gz: f49a9c99e8441520c6ed0fcfc5acac72d0622c73c811ae5462d2c4d615f66e54
+  metadata.gz: d2963c9fab97188dd1986e144236a3700d3095ce4c1dce0716cb64a6d772a58c
+  data.tar.gz: 013da2c55af2fefe9ed8eb57c63898baabe405b2daf9098c896c9a6ab6e34e48
 SHA512:
-  metadata.gz: 5ce27503d671f912a27cd1e9e0dfb78088ec362aa1697c9fbaf938882bb5f7e6fc25e7c7e50b2a6b8bb7ec84acb356a9ce3756885084ddf6aa0def3f8841c245
-  data.tar.gz: bad48c4d256ff7d274432f6361432adca1c0cba1696f75c42f656757f3cdc9bd5913c695184bb3307e9f93e360d745c87002cbc96333bd6af960a912ee19e7dd
+  metadata.gz: 421f268dd81210d9fcc86b31718489f0272114be636f74adf66e9eb23119e76c1105b9753129125a92bfc5c7b6b5a7a6b0fbbcbdb3a7bd09d243332907ed00c7
+  data.tar.gz: 608b54d37f7db445794622a00ecfe8423d4be4ad37fb587c142472ab25f8c8fc5b5b3682e43ef7c8f491e8766980e282b1dd1e2658cae54084a3fe93fd82a1fb

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.28.1 (2025-10-01)
+
+Full Changelog: [v0.28.0...v0.28.1](https://github.com/openai/openai-ruby/compare/v0.28.0...v0.28.1)
+
+### Bug Fixes
+
+* **api:** add status, approval_request_id to MCP tool call ([51622d0](https://github.com/openai/openai-ruby/commit/51622d065828bec248fb765c5bc243a058f0044d))
+
 ## 0.28.0 (2025-09-30)
 
 Full Changelog: [v0.27.1...v0.28.0](https://github.com/openai/openai-ruby/compare/v0.27.1...v0.28.0)

data/README.md

@@ -15,7 +15,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "openai", "~> 0.28.0"
+gem "openai", "~> 0.28.1"
 ```
 
 <!-- x-release-please-end -->

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

@@ -526,6 +526,14 @@ module OpenAI
           #   @return [Symbol, :mcp_call]
           required :type, const: :mcp_call
 
+          # @!attribute approval_request_id
+          #   Unique identifier for the MCP tool call approval request. Include this value in
+          #   a subsequent `mcp_approval_response` input to approve or reject the
+          #   corresponding tool call.
+          #
+          #   @return [String, nil]
+          optional :approval_request_id, String, nil?: true
+
           # @!attribute error
           #   The error from the tool call, if any.
           #
@@ -538,7 +546,14 @@ module OpenAI
           #   @return [String, nil]
           optional :output, String, nil?: true
 
-          # @!method initialize(id:, arguments:, name:, server_label:, error: nil, output: nil, type: :mcp_call)
+          # @!attribute status
+          #   The status of the tool call. One of `in_progress`, `completed`, `incomplete`,
+          #   `calling`, or `failed`.
+          #
+          #   @return [Symbol, OpenAI::Models::Conversations::ConversationItem::McpCall::Status, nil]
+          optional :status, enum: -> { OpenAI::Conversations::ConversationItem::McpCall::Status }
+
+          # @!method initialize(id:, arguments:, name:, server_label:, approval_request_id: nil, error: nil, output: nil, status: nil, type: :mcp_call)
           #   Some parameter documentations has been truncated, see
           #   {OpenAI::Models::Conversations::ConversationItem::McpCall} for more details.
           #
@@ -552,11 +567,32 @@ module OpenAI
           #
           #   @param server_label [String] The label of the MCP server running the tool.
           #
+          #   @param approval_request_id [String, nil] Unique identifier for the MCP tool call approval request.
+          #
           #   @param error [String, nil] The error from the tool call, if any.
           #
           #   @param output [String, nil] The output from the tool call.
           #
+          #   @param status [Symbol, OpenAI::Models::Conversations::ConversationItem::McpCall::Status] The status of the tool call. One of `in_progress`, `completed`, `incomplete`, `c
+          #
           #   @param type [Symbol, :mcp_call] The type of the item. Always `mcp_call`.
+
+          # The status of the tool call. One of `in_progress`, `completed`, `incomplete`,
+          # `calling`, or `failed`.
+          #
+          # @see OpenAI::Models::Conversations::ConversationItem::McpCall#status
+          module Status
+            extend OpenAI::Internal::Type::Enum
+
+            IN_PROGRESS = :in_progress
+            COMPLETED = :completed
+            INCOMPLETE = :incomplete
+            CALLING = :calling
+            FAILED = :failed
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
         end
 
         # @!method self.variants

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

@@ -818,6 +818,14 @@ module OpenAI
           #   @return [Symbol, :mcp_call]
           required :type, const: :mcp_call
 
+          # @!attribute approval_request_id
+          #   Unique identifier for the MCP tool call approval request. Include this value in
+          #   a subsequent `mcp_approval_response` input to approve or reject the
+          #   corresponding tool call.
+          #
+          #   @return [String, nil]
+          optional :approval_request_id, String, nil?: true
+
           # @!attribute error
           #   The error from the tool call, if any.
           #
@@ -830,7 +838,14 @@ module OpenAI
           #   @return [String, nil]
           optional :output, String, nil?: true
 
-          # @!method initialize(id:, arguments:, name:, server_label:, error: nil, output: nil, type: :mcp_call)
+          # @!attribute status
+          #   The status of the tool call. One of `in_progress`, `completed`, `incomplete`,
+          #   `calling`, or `failed`.
+          #
+          #   @return [Symbol, OpenAI::Models::Responses::ResponseInputItem::McpCall::Status, nil]
+          optional :status, enum: -> { OpenAI::Responses::ResponseInputItem::McpCall::Status }
+
+          # @!method initialize(id:, arguments:, name:, server_label:, approval_request_id: nil, error: nil, output: nil, status: nil, type: :mcp_call)
           #   Some parameter documentations has been truncated, see
           #   {OpenAI::Models::Responses::ResponseInputItem::McpCall} for more details.
           #
@@ -844,11 +859,32 @@ module OpenAI
           #
           #   @param server_label [String] The label of the MCP server running the tool.
           #
+          #   @param approval_request_id [String, nil] Unique identifier for the MCP tool call approval request.
+          #
           #   @param error [String, nil] The error from the tool call, if any.
           #
           #   @param output [String, nil] The output from the tool call.
           #
+          #   @param status [Symbol, OpenAI::Models::Responses::ResponseInputItem::McpCall::Status] The status of the tool call. One of `in_progress`, `completed`, `incomplete`, `c
+          #
           #   @param type [Symbol, :mcp_call] The type of the item. Always `mcp_call`.
+
+          # The status of the tool call. One of `in_progress`, `completed`, `incomplete`,
+          # `calling`, or `failed`.
+          #
+          # @see OpenAI::Models::Responses::ResponseInputItem::McpCall#status
+          module Status
+            extend OpenAI::Internal::Type::Enum
+
+            IN_PROGRESS = :in_progress
+            COMPLETED = :completed
+            INCOMPLETE = :incomplete
+            CALLING = :calling
+            FAILED = :failed
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
         end
 
         class ItemReference < OpenAI::Internal::Type::BaseModel

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

@@ -508,6 +508,14 @@ module OpenAI
           #   @return [Symbol, :mcp_call]
           required :type, const: :mcp_call
 
+          # @!attribute approval_request_id
+          #   Unique identifier for the MCP tool call approval request. Include this value in
+          #   a subsequent `mcp_approval_response` input to approve or reject the
+          #   corresponding tool call.
+          #
+          #   @return [String, nil]
+          optional :approval_request_id, String, nil?: true
+
           # @!attribute error
           #   The error from the tool call, if any.
           #
@@ -520,7 +528,14 @@ module OpenAI
           #   @return [String, nil]
           optional :output, String, nil?: true
 
-          # @!method initialize(id:, arguments:, name:, server_label:, error: nil, output: nil, type: :mcp_call)
+          # @!attribute status
+          #   The status of the tool call. One of `in_progress`, `completed`, `incomplete`,
+          #   `calling`, or `failed`.
+          #
+          #   @return [Symbol, OpenAI::Models::Responses::ResponseItem::McpCall::Status, nil]
+          optional :status, enum: -> { OpenAI::Responses::ResponseItem::McpCall::Status }
+
+          # @!method initialize(id:, arguments:, name:, server_label:, approval_request_id: nil, error: nil, output: nil, status: nil, type: :mcp_call)
           #   Some parameter documentations has been truncated, see
           #   {OpenAI::Models::Responses::ResponseItem::McpCall} for more details.
           #
@@ -534,11 +549,32 @@ module OpenAI
           #
           #   @param server_label [String] The label of the MCP server running the tool.
           #
+          #   @param approval_request_id [String, nil] Unique identifier for the MCP tool call approval request.
+          #
           #   @param error [String, nil] The error from the tool call, if any.
           #
           #   @param output [String, nil] The output from the tool call.
           #
+          #   @param status [Symbol, OpenAI::Models::Responses::ResponseItem::McpCall::Status] The status of the tool call. One of `in_progress`, `completed`, `incomplete`, `c
+          #
           #   @param type [Symbol, :mcp_call] The type of the item. Always `mcp_call`.
+
+          # The status of the tool call. One of `in_progress`, `completed`, `incomplete`,
+          # `calling`, or `failed`.
+          #
+          # @see OpenAI::Models::Responses::ResponseItem::McpCall#status
+          module Status
+            extend OpenAI::Internal::Type::Enum
+
+            IN_PROGRESS = :in_progress
+            COMPLETED = :completed
+            INCOMPLETE = :incomplete
+            CALLING = :calling
+            FAILED = :failed
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
         end
 
         # @!method self.variants

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

@@ -263,6 +263,14 @@ module OpenAI
           #   @return [Symbol, :mcp_call]
           required :type, const: :mcp_call
 
+          # @!attribute approval_request_id
+          #   Unique identifier for the MCP tool call approval request. Include this value in
+          #   a subsequent `mcp_approval_response` input to approve or reject the
+          #   corresponding tool call.
+          #
+          #   @return [String, nil]
+          optional :approval_request_id, String, nil?: true
+
           # @!attribute error
           #   The error from the tool call, if any.
           #
@@ -275,7 +283,14 @@ module OpenAI
           #   @return [String, nil]
           optional :output, String, nil?: true
 
-          # @!method initialize(id:, arguments:, name:, server_label:, error: nil, output: nil, type: :mcp_call)
+          # @!attribute status
+          #   The status of the tool call. One of `in_progress`, `completed`, `incomplete`,
+          #   `calling`, or `failed`.
+          #
+          #   @return [Symbol, OpenAI::Models::Responses::ResponseOutputItem::McpCall::Status, nil]
+          optional :status, enum: -> { OpenAI::Responses::ResponseOutputItem::McpCall::Status }
+
+          # @!method initialize(id:, arguments:, name:, server_label:, approval_request_id: nil, error: nil, output: nil, status: nil, type: :mcp_call)
           #   Some parameter documentations has been truncated, see
           #   {OpenAI::Models::Responses::ResponseOutputItem::McpCall} for more details.
           #
@@ -289,11 +304,32 @@ module OpenAI
           #
           #   @param server_label [String] The label of the MCP server running the tool.
           #
+          #   @param approval_request_id [String, nil] Unique identifier for the MCP tool call approval request.
+          #
           #   @param error [String, nil] The error from the tool call, if any.
           #
           #   @param output [String, nil] The output from the tool call.
           #
+          #   @param status [Symbol, OpenAI::Models::Responses::ResponseOutputItem::McpCall::Status] The status of the tool call. One of `in_progress`, `completed`, `incomplete`, `c
+          #
           #   @param type [Symbol, :mcp_call] The type of the item. Always `mcp_call`.
+
+          # The status of the tool call. One of `in_progress`, `completed`, `incomplete`,
+          # `calling`, or `failed`.
+          #
+          # @see OpenAI::Models::Responses::ResponseOutputItem::McpCall#status
+          module Status
+            extend OpenAI::Internal::Type::Enum
+
+            IN_PROGRESS = :in_progress
+            COMPLETED = :completed
+            INCOMPLETE = :incomplete
+            CALLING = :calling
+            FAILED = :failed
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
         end
 
         class McpListTools < OpenAI::Internal::Type::BaseModel

data/lib/openai/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module OpenAI
-  VERSION = "0.28.0"
+  VERSION = "0.28.1"
 end

data/rbi/openai/models/conversations/conversation_item.rbi

@@ -767,6 +767,12 @@ module OpenAI
           sig { returns(Symbol) }
           attr_accessor :type
 
+          # Unique identifier for the MCP tool call approval request. Include this value in
+          # a subsequent `mcp_approval_response` input to approve or reject the
+          # corresponding tool call.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :approval_request_id
+
           # The error from the tool call, if any.
           sig { returns(T.nilable(String)) }
           attr_accessor :error
@@ -775,6 +781,25 @@ module OpenAI
           sig { returns(T.nilable(String)) }
           attr_accessor :output
 
+          # The status of the tool call. One of `in_progress`, `completed`, `incomplete`,
+          # `calling`, or `failed`.
+          sig do
+            returns(
+              T.nilable(
+                OpenAI::Conversations::ConversationItem::McpCall::Status::TaggedSymbol
+              )
+            )
+          end
+          attr_reader :status
+
+          sig do
+            params(
+              status:
+                OpenAI::Conversations::ConversationItem::McpCall::Status::OrSymbol
+            ).void
+          end
+          attr_writer :status
+
           # An invocation of a tool on an MCP server.
           sig do
             params(
@@ -782,8 +807,11 @@ module OpenAI
               arguments: String,
               name: String,
               server_label: String,
+              approval_request_id: T.nilable(String),
               error: T.nilable(String),
               output: T.nilable(String),
+              status:
+                OpenAI::Conversations::ConversationItem::McpCall::Status::OrSymbol,
               type: Symbol
             ).returns(T.attached_class)
           end
@@ -796,10 +824,17 @@ module OpenAI
             name:,
             # The label of the MCP server running the tool.
             server_label:,
+            # Unique identifier for the MCP tool call approval request. Include this value in
+            # a subsequent `mcp_approval_response` input to approve or reject the
+            # corresponding tool call.
+            approval_request_id: nil,
             # The error from the tool call, if any.
             error: nil,
             # The output from the tool call.
             output: nil,
+            # The status of the tool call. One of `in_progress`, `completed`, `incomplete`,
+            # `calling`, or `failed`.
+            status: nil,
             # The type of the item. Always `mcp_call`.
             type: :mcp_call
           )
@@ -813,13 +848,67 @@ module OpenAI
                 name: String,
                 server_label: String,
                 type: Symbol,
+                approval_request_id: T.nilable(String),
                 error: T.nilable(String),
-                output: T.nilable(String)
+                output: T.nilable(String),
+                status:
+                  OpenAI::Conversations::ConversationItem::McpCall::Status::TaggedSymbol
               }
             )
           end
           def to_hash
           end
+
+          # The status of the tool call. One of `in_progress`, `completed`, `incomplete`,
+          # `calling`, or `failed`.
+          module Status
+            extend OpenAI::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  OpenAI::Conversations::ConversationItem::McpCall::Status
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            IN_PROGRESS =
+              T.let(
+                :in_progress,
+                OpenAI::Conversations::ConversationItem::McpCall::Status::TaggedSymbol
+              )
+            COMPLETED =
+              T.let(
+                :completed,
+                OpenAI::Conversations::ConversationItem::McpCall::Status::TaggedSymbol
+              )
+            INCOMPLETE =
+              T.let(
+                :incomplete,
+                OpenAI::Conversations::ConversationItem::McpCall::Status::TaggedSymbol
+              )
+            CALLING =
+              T.let(
+                :calling,
+                OpenAI::Conversations::ConversationItem::McpCall::Status::TaggedSymbol
+              )
+            FAILED =
+              T.let(
+                :failed,
+                OpenAI::Conversations::ConversationItem::McpCall::Status::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  OpenAI::Conversations::ConversationItem::McpCall::Status::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
         end
 
         sig do

data/rbi/openai/models/responses/response_input_item.rbi

@@ -1381,6 +1381,12 @@ module OpenAI
           sig { returns(Symbol) }
           attr_accessor :type
 
+          # Unique identifier for the MCP tool call approval request. Include this value in
+          # a subsequent `mcp_approval_response` input to approve or reject the
+          # corresponding tool call.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :approval_request_id
+
           # The error from the tool call, if any.
           sig { returns(T.nilable(String)) }
           attr_accessor :error
@@ -1389,6 +1395,25 @@ module OpenAI
           sig { returns(T.nilable(String)) }
           attr_accessor :output
 
+          # The status of the tool call. One of `in_progress`, `completed`, `incomplete`,
+          # `calling`, or `failed`.
+          sig do
+            returns(
+              T.nilable(
+                OpenAI::Responses::ResponseInputItem::McpCall::Status::OrSymbol
+              )
+            )
+          end
+          attr_reader :status
+
+          sig do
+            params(
+              status:
+                OpenAI::Responses::ResponseInputItem::McpCall::Status::OrSymbol
+            ).void
+          end
+          attr_writer :status
+
           # An invocation of a tool on an MCP server.
           sig do
             params(
@@ -1396,8 +1421,11 @@ module OpenAI
               arguments: String,
               name: String,
               server_label: String,
+              approval_request_id: T.nilable(String),
               error: T.nilable(String),
               output: T.nilable(String),
+              status:
+                OpenAI::Responses::ResponseInputItem::McpCall::Status::OrSymbol,
               type: Symbol
             ).returns(T.attached_class)
           end
@@ -1410,10 +1438,17 @@ module OpenAI
             name:,
             # The label of the MCP server running the tool.
             server_label:,
+            # Unique identifier for the MCP tool call approval request. Include this value in
+            # a subsequent `mcp_approval_response` input to approve or reject the
+            # corresponding tool call.
+            approval_request_id: nil,
             # The error from the tool call, if any.
             error: nil,
             # The output from the tool call.
             output: nil,
+            # The status of the tool call. One of `in_progress`, `completed`, `incomplete`,
+            # `calling`, or `failed`.
+            status: nil,
             # The type of the item. Always `mcp_call`.
             type: :mcp_call
           )
@@ -1427,13 +1462,67 @@ module OpenAI
                 name: String,
                 server_label: String,
                 type: Symbol,
+                approval_request_id: T.nilable(String),
                 error: T.nilable(String),
-                output: T.nilable(String)
+                output: T.nilable(String),
+                status:
+                  OpenAI::Responses::ResponseInputItem::McpCall::Status::OrSymbol
               }
             )
           end
           def to_hash
           end
+
+          # The status of the tool call. One of `in_progress`, `completed`, `incomplete`,
+          # `calling`, or `failed`.
+          module Status
+            extend OpenAI::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  OpenAI::Responses::ResponseInputItem::McpCall::Status
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            IN_PROGRESS =
+              T.let(
+                :in_progress,
+                OpenAI::Responses::ResponseInputItem::McpCall::Status::TaggedSymbol
+              )
+            COMPLETED =
+              T.let(
+                :completed,
+                OpenAI::Responses::ResponseInputItem::McpCall::Status::TaggedSymbol
+              )
+            INCOMPLETE =
+              T.let(
+                :incomplete,
+                OpenAI::Responses::ResponseInputItem::McpCall::Status::TaggedSymbol
+              )
+            CALLING =
+              T.let(
+                :calling,
+                OpenAI::Responses::ResponseInputItem::McpCall::Status::TaggedSymbol
+              )
+            FAILED =
+              T.let(
+                :failed,
+                OpenAI::Responses::ResponseInputItem::McpCall::Status::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  OpenAI::Responses::ResponseInputItem::McpCall::Status::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
         end
 
         class ItemReference < OpenAI::Internal::Type::BaseModel

data/rbi/openai/models/responses/response_item.rbi

@@ -754,6 +754,12 @@ module OpenAI
           sig { returns(Symbol) }
           attr_accessor :type
 
+          # Unique identifier for the MCP tool call approval request. Include this value in
+          # a subsequent `mcp_approval_response` input to approve or reject the
+          # corresponding tool call.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :approval_request_id
+
           # The error from the tool call, if any.
           sig { returns(T.nilable(String)) }
           attr_accessor :error
@@ -762,6 +768,24 @@ module OpenAI
           sig { returns(T.nilable(String)) }
           attr_accessor :output
 
+          # The status of the tool call. One of `in_progress`, `completed`, `incomplete`,
+          # `calling`, or `failed`.
+          sig do
+            returns(
+              T.nilable(
+                OpenAI::Responses::ResponseItem::McpCall::Status::TaggedSymbol
+              )
+            )
+          end
+          attr_reader :status
+
+          sig do
+            params(
+              status: OpenAI::Responses::ResponseItem::McpCall::Status::OrSymbol
+            ).void
+          end
+          attr_writer :status
+
           # An invocation of a tool on an MCP server.
           sig do
             params(
@@ -769,8 +793,11 @@ module OpenAI
               arguments: String,
               name: String,
               server_label: String,
+              approval_request_id: T.nilable(String),
               error: T.nilable(String),
               output: T.nilable(String),
+              status:
+                OpenAI::Responses::ResponseItem::McpCall::Status::OrSymbol,
               type: Symbol
             ).returns(T.attached_class)
           end
@@ -783,10 +810,17 @@ module OpenAI
             name:,
             # The label of the MCP server running the tool.
             server_label:,
+            # Unique identifier for the MCP tool call approval request. Include this value in
+            # a subsequent `mcp_approval_response` input to approve or reject the
+            # corresponding tool call.
+            approval_request_id: nil,
             # The error from the tool call, if any.
             error: nil,
             # The output from the tool call.
             output: nil,
+            # The status of the tool call. One of `in_progress`, `completed`, `incomplete`,
+            # `calling`, or `failed`.
+            status: nil,
             # The type of the item. Always `mcp_call`.
             type: :mcp_call
           )
@@ -800,13 +834,64 @@ module OpenAI
                 name: String,
                 server_label: String,
                 type: Symbol,
+                approval_request_id: T.nilable(String),
                 error: T.nilable(String),
-                output: T.nilable(String)
+                output: T.nilable(String),
+                status:
+                  OpenAI::Responses::ResponseItem::McpCall::Status::TaggedSymbol
               }
             )
           end
           def to_hash
           end
+
+          # The status of the tool call. One of `in_progress`, `completed`, `incomplete`,
+          # `calling`, or `failed`.
+          module Status
+            extend OpenAI::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(Symbol, OpenAI::Responses::ResponseItem::McpCall::Status)
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            IN_PROGRESS =
+              T.let(
+                :in_progress,
+                OpenAI::Responses::ResponseItem::McpCall::Status::TaggedSymbol
+              )
+            COMPLETED =
+              T.let(
+                :completed,
+                OpenAI::Responses::ResponseItem::McpCall::Status::TaggedSymbol
+              )
+            INCOMPLETE =
+              T.let(
+                :incomplete,
+                OpenAI::Responses::ResponseItem::McpCall::Status::TaggedSymbol
+              )
+            CALLING =
+              T.let(
+                :calling,
+                OpenAI::Responses::ResponseItem::McpCall::Status::TaggedSymbol
+              )
+            FAILED =
+              T.let(
+                :failed,
+                OpenAI::Responses::ResponseItem::McpCall::Status::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  OpenAI::Responses::ResponseItem::McpCall::Status::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
         end
 
         sig do

data/rbi/openai/models/responses/response_output_item.rbi

@@ -370,6 +370,12 @@ module OpenAI
           sig { returns(Symbol) }
           attr_accessor :type
 
+          # Unique identifier for the MCP tool call approval request. Include this value in
+          # a subsequent `mcp_approval_response` input to approve or reject the
+          # corresponding tool call.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :approval_request_id
+
           # The error from the tool call, if any.
           sig { returns(T.nilable(String)) }
           attr_accessor :error
@@ -378,6 +384,25 @@ module OpenAI
           sig { returns(T.nilable(String)) }
           attr_accessor :output
 
+          # The status of the tool call. One of `in_progress`, `completed`, `incomplete`,
+          # `calling`, or `failed`.
+          sig do
+            returns(
+              T.nilable(
+                OpenAI::Responses::ResponseOutputItem::McpCall::Status::TaggedSymbol
+              )
+            )
+          end
+          attr_reader :status
+
+          sig do
+            params(
+              status:
+                OpenAI::Responses::ResponseOutputItem::McpCall::Status::OrSymbol
+            ).void
+          end
+          attr_writer :status
+
           # An invocation of a tool on an MCP server.
           sig do
             params(
@@ -385,8 +410,11 @@ module OpenAI
               arguments: String,
               name: String,
               server_label: String,
+              approval_request_id: T.nilable(String),
               error: T.nilable(String),
               output: T.nilable(String),
+              status:
+                OpenAI::Responses::ResponseOutputItem::McpCall::Status::OrSymbol,
               type: Symbol
             ).returns(T.attached_class)
           end
@@ -399,10 +427,17 @@ module OpenAI
             name:,
             # The label of the MCP server running the tool.
             server_label:,
+            # Unique identifier for the MCP tool call approval request. Include this value in
+            # a subsequent `mcp_approval_response` input to approve or reject the
+            # corresponding tool call.
+            approval_request_id: nil,
             # The error from the tool call, if any.
             error: nil,
             # The output from the tool call.
             output: nil,
+            # The status of the tool call. One of `in_progress`, `completed`, `incomplete`,
+            # `calling`, or `failed`.
+            status: nil,
             # The type of the item. Always `mcp_call`.
             type: :mcp_call
           )
@@ -416,13 +451,67 @@ module OpenAI
                 name: String,
                 server_label: String,
                 type: Symbol,
+                approval_request_id: T.nilable(String),
                 error: T.nilable(String),
-                output: T.nilable(String)
+                output: T.nilable(String),
+                status:
+                  OpenAI::Responses::ResponseOutputItem::McpCall::Status::TaggedSymbol
               }
             )
           end
           def to_hash
           end
+
+          # The status of the tool call. One of `in_progress`, `completed`, `incomplete`,
+          # `calling`, or `failed`.
+          module Status
+            extend OpenAI::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  OpenAI::Responses::ResponseOutputItem::McpCall::Status
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            IN_PROGRESS =
+              T.let(
+                :in_progress,
+                OpenAI::Responses::ResponseOutputItem::McpCall::Status::TaggedSymbol
+              )
+            COMPLETED =
+              T.let(
+                :completed,
+                OpenAI::Responses::ResponseOutputItem::McpCall::Status::TaggedSymbol
+              )
+            INCOMPLETE =
+              T.let(
+                :incomplete,
+                OpenAI::Responses::ResponseOutputItem::McpCall::Status::TaggedSymbol
+              )
+            CALLING =
+              T.let(
+                :calling,
+                OpenAI::Responses::ResponseOutputItem::McpCall::Status::TaggedSymbol
+              )
+            FAILED =
+              T.let(
+                :failed,
+                OpenAI::Responses::ResponseOutputItem::McpCall::Status::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  OpenAI::Responses::ResponseOutputItem::McpCall::Status::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
         end
 
         class McpListTools < OpenAI::Internal::Type::BaseModel

data/sig/openai/models/conversations/conversation_item.rbs

@@ -356,8 +356,10 @@ module OpenAI
             name: String,
             server_label: String,
             type: :mcp_call,
+            approval_request_id: String?,
             error: String?,
-            output: String?
+            output: String?,
+            status: OpenAI::Models::Conversations::ConversationItem::McpCall::status
           }
 
         class McpCall < OpenAI::Internal::Type::BaseModel
@@ -371,17 +373,27 @@ module OpenAI
 
           attr_accessor type: :mcp_call
 
+          attr_accessor approval_request_id: String?
+
           attr_accessor error: String?
 
           attr_accessor output: String?
 
+          attr_reader status: OpenAI::Models::Conversations::ConversationItem::McpCall::status?
+
+          def status=: (
+            OpenAI::Models::Conversations::ConversationItem::McpCall::status
+          ) -> OpenAI::Models::Conversations::ConversationItem::McpCall::status
+
           def initialize: (
             id: String,
             arguments: String,
             name: String,
             server_label: String,
+            ?approval_request_id: String?,
             ?error: String?,
             ?output: String?,
+            ?status: OpenAI::Models::Conversations::ConversationItem::McpCall::status,
             ?type: :mcp_call
           ) -> void
 
@@ -391,9 +403,26 @@ module OpenAI
             name: String,
             server_label: String,
             type: :mcp_call,
+            approval_request_id: String?,
             error: String?,
-            output: String?
+            output: String?,
+            status: OpenAI::Models::Conversations::ConversationItem::McpCall::status
           }
+
+          type status =
+            :in_progress | :completed | :incomplete | :calling | :failed
+
+          module Status
+            extend OpenAI::Internal::Type::Enum
+
+            IN_PROGRESS: :in_progress
+            COMPLETED: :completed
+            INCOMPLETE: :incomplete
+            CALLING: :calling
+            FAILED: :failed
+
+            def self?.values: -> ::Array[OpenAI::Models::Conversations::ConversationItem::McpCall::status]
+          end
         end
 
         def self?.variants: -> ::Array[OpenAI::Models::Conversations::conversation_item]

data/sig/openai/models/responses/response_input_item.rbs

@@ -563,8 +563,10 @@ module OpenAI
             name: String,
             server_label: String,
             type: :mcp_call,
+            approval_request_id: String?,
             error: String?,
-            output: String?
+            output: String?,
+            status: OpenAI::Models::Responses::ResponseInputItem::McpCall::status
           }
 
         class McpCall < OpenAI::Internal::Type::BaseModel
@@ -578,17 +580,27 @@ module OpenAI
 
           attr_accessor type: :mcp_call
 
+          attr_accessor approval_request_id: String?
+
           attr_accessor error: String?
 
           attr_accessor output: String?
 
+          attr_reader status: OpenAI::Models::Responses::ResponseInputItem::McpCall::status?
+
+          def status=: (
+            OpenAI::Models::Responses::ResponseInputItem::McpCall::status
+          ) -> OpenAI::Models::Responses::ResponseInputItem::McpCall::status
+
           def initialize: (
             id: String,
             arguments: String,
             name: String,
             server_label: String,
+            ?approval_request_id: String?,
             ?error: String?,
             ?output: String?,
+            ?status: OpenAI::Models::Responses::ResponseInputItem::McpCall::status,
             ?type: :mcp_call
           ) -> void
 
@@ -598,9 +610,26 @@ module OpenAI
             name: String,
             server_label: String,
             type: :mcp_call,
+            approval_request_id: String?,
             error: String?,
-            output: String?
+            output: String?,
+            status: OpenAI::Models::Responses::ResponseInputItem::McpCall::status
           }
+
+          type status =
+            :in_progress | :completed | :incomplete | :calling | :failed
+
+          module Status
+            extend OpenAI::Internal::Type::Enum
+
+            IN_PROGRESS: :in_progress
+            COMPLETED: :completed
+            INCOMPLETE: :incomplete
+            CALLING: :calling
+            FAILED: :failed
+
+            def self?.values: -> ::Array[OpenAI::Models::Responses::ResponseInputItem::McpCall::status]
+          end
         end
 
         type item_reference =

data/sig/openai/models/responses/response_item.rbs

@@ -352,8 +352,10 @@ module OpenAI
             name: String,
             server_label: String,
             type: :mcp_call,
+            approval_request_id: String?,
             error: String?,
-            output: String?
+            output: String?,
+            status: OpenAI::Models::Responses::ResponseItem::McpCall::status
           }
 
         class McpCall < OpenAI::Internal::Type::BaseModel
@@ -367,17 +369,27 @@ module OpenAI
 
           attr_accessor type: :mcp_call
 
+          attr_accessor approval_request_id: String?
+
           attr_accessor error: String?
 
           attr_accessor output: String?
 
+          attr_reader status: OpenAI::Models::Responses::ResponseItem::McpCall::status?
+
+          def status=: (
+            OpenAI::Models::Responses::ResponseItem::McpCall::status
+          ) -> OpenAI::Models::Responses::ResponseItem::McpCall::status
+
           def initialize: (
             id: String,
             arguments: String,
             name: String,
             server_label: String,
+            ?approval_request_id: String?,
             ?error: String?,
             ?output: String?,
+            ?status: OpenAI::Models::Responses::ResponseItem::McpCall::status,
             ?type: :mcp_call
           ) -> void
 
@@ -387,9 +399,26 @@ module OpenAI
             name: String,
             server_label: String,
             type: :mcp_call,
+            approval_request_id: String?,
             error: String?,
-            output: String?
+            output: String?,
+            status: OpenAI::Models::Responses::ResponseItem::McpCall::status
           }
+
+          type status =
+            :in_progress | :completed | :incomplete | :calling | :failed
+
+          module Status
+            extend OpenAI::Internal::Type::Enum
+
+            IN_PROGRESS: :in_progress
+            COMPLETED: :completed
+            INCOMPLETE: :incomplete
+            CALLING: :calling
+            FAILED: :failed
+
+            def self?.values: -> ::Array[OpenAI::Models::Responses::ResponseItem::McpCall::status]
+          end
         end
 
         def self?.variants: -> ::Array[OpenAI::Models::Responses::response_item]

data/sig/openai/models/responses/response_output_item.rbs

@@ -162,8 +162,10 @@ module OpenAI
             name: String,
             server_label: String,
             type: :mcp_call,
+            approval_request_id: String?,
             error: String?,
-            output: String?
+            output: String?,
+            status: OpenAI::Models::Responses::ResponseOutputItem::McpCall::status
           }
 
         class McpCall < OpenAI::Internal::Type::BaseModel
@@ -177,17 +179,27 @@ module OpenAI
 
           attr_accessor type: :mcp_call
 
+          attr_accessor approval_request_id: String?
+
           attr_accessor error: String?
 
           attr_accessor output: String?
 
+          attr_reader status: OpenAI::Models::Responses::ResponseOutputItem::McpCall::status?
+
+          def status=: (
+            OpenAI::Models::Responses::ResponseOutputItem::McpCall::status
+          ) -> OpenAI::Models::Responses::ResponseOutputItem::McpCall::status
+
           def initialize: (
             id: String,
             arguments: String,
             name: String,
             server_label: String,
+            ?approval_request_id: String?,
             ?error: String?,
             ?output: String?,
+            ?status: OpenAI::Models::Responses::ResponseOutputItem::McpCall::status,
             ?type: :mcp_call
           ) -> void
 
@@ -197,9 +209,26 @@ module OpenAI
             name: String,
             server_label: String,
             type: :mcp_call,
+            approval_request_id: String?,
             error: String?,
-            output: String?
+            output: String?,
+            status: OpenAI::Models::Responses::ResponseOutputItem::McpCall::status
           }
+
+          type status =
+            :in_progress | :completed | :incomplete | :calling | :failed
+
+          module Status
+            extend OpenAI::Internal::Type::Enum
+
+            IN_PROGRESS: :in_progress
+            COMPLETED: :completed
+            INCOMPLETE: :incomplete
+            CALLING: :calling
+            FAILED: :failed
+
+            def self?.values: -> ::Array[OpenAI::Models::Responses::ResponseOutputItem::McpCall::status]
+          end
         end
 
         type mcp_list_tools =

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: openai
 version: !ruby/object:Gem::Version
-  version: 0.28.0
+  version: 0.28.1
 platform: ruby
 authors:
 - OpenAI
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-09-30 00:00:00.000000000 Z
+date: 2025-10-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: connection_pool