openai 0.41.0 → 0.43.0

data/rbi/openai/models/audio_model.rbi

@@ -13,6 +13,11 @@ module OpenAI
         T.let(:"gpt-4o-transcribe", OpenAI::AudioModel::TaggedSymbol)
       GPT_4O_MINI_TRANSCRIBE =
         T.let(:"gpt-4o-mini-transcribe", OpenAI::AudioModel::TaggedSymbol)
+      GPT_4O_MINI_TRANSCRIBE_2025_12_15 =
+        T.let(
+          :"gpt-4o-mini-transcribe-2025-12-15",
+          OpenAI::AudioModel::TaggedSymbol
+        )
       GPT_4O_TRANSCRIBE_DIARIZE =
         T.let(:"gpt-4o-transcribe-diarize", OpenAI::AudioModel::TaggedSymbol)
 

data/rbi/openai/models/chat/chat_completion_audio_param.rbi

@@ -21,8 +21,9 @@ module OpenAI
         end
         attr_accessor :format_
 
-        # The voice the model uses to respond. Supported voices are `alloy`, `ash`,
-        # `ballad`, `coral`, `echo`, `fable`, `nova`, `onyx`, `sage`, and `shimmer`.
+        # The voice the model uses to respond. Supported built-in voices are `alloy`,
+        # `ash`, `ballad`, `coral`, `echo`, `fable`, `nova`, `onyx`, `sage`, `shimmer`,
+        # `marin`, and `cedar`.
         sig do
           returns(
             T.any(
@@ -50,8 +51,9 @@ module OpenAI
           # Specifies the output audio format. Must be one of `wav`, `mp3`, `flac`, `opus`,
           # or `pcm16`.
           format_:,
-          # The voice the model uses to respond. Supported voices are `alloy`, `ash`,
-          # `ballad`, `coral`, `echo`, `fable`, `nova`, `onyx`, `sage`, and `shimmer`.
+          # The voice the model uses to respond. Supported built-in voices are `alloy`,
+          # `ash`, `ballad`, `coral`, `echo`, `fable`, `nova`, `onyx`, `sage`, `shimmer`,
+          # `marin`, and `cedar`.
           voice:
         )
         end
@@ -124,8 +126,9 @@ module OpenAI
           end
         end
 
-        # The voice the model uses to respond. Supported voices are `alloy`, `ash`,
-        # `ballad`, `coral`, `echo`, `fable`, `nova`, `onyx`, `sage`, and `shimmer`.
+        # The voice the model uses to respond. Supported built-in voices are `alloy`,
+        # `ash`, `ballad`, `coral`, `echo`, `fable`, `nova`, `onyx`, `sage`, `shimmer`,
+        # `marin`, and `cedar`.
         module Voice
           extend OpenAI::Internal::Type::Union
 

data/rbi/openai/models/conversations/message.rbi

@@ -87,7 +87,7 @@ module OpenAI
         def to_hash
         end
 
-        # A text input to the model.
+        # A content part that makes up an input or output item.
         module Content
           extend OpenAI::Internal::Type::Union
 

data/rbi/openai/models/realtime/audio_transcription.rbi

@@ -22,18 +22,28 @@ module OpenAI
         attr_writer :language
 
         # The model to use for transcription. Current options are `whisper-1`,
-        # `gpt-4o-mini-transcribe`, `gpt-4o-transcribe`, and `gpt-4o-transcribe-diarize`.
-        # Use `gpt-4o-transcribe-diarize` when you need diarization with speaker labels.
+        # `gpt-4o-mini-transcribe`, `gpt-4o-mini-transcribe-2025-12-15`,
+        # `gpt-4o-transcribe`, and `gpt-4o-transcribe-diarize`. Use
+        # `gpt-4o-transcribe-diarize` when you need diarization with speaker labels.
         sig do
           returns(
-            T.nilable(OpenAI::Realtime::AudioTranscription::Model::OrSymbol)
+            T.nilable(
+              T.any(
+                String,
+                OpenAI::Realtime::AudioTranscription::Model::OrSymbol
+              )
+            )
           )
         end
         attr_reader :model
 
         sig do
           params(
-            model: OpenAI::Realtime::AudioTranscription::Model::OrSymbol
+            model:
+              T.any(
+                String,
+                OpenAI::Realtime::AudioTranscription::Model::OrSymbol
+              )
           ).void
         end
         attr_writer :model
@@ -52,7 +62,11 @@ module OpenAI
         sig do
           params(
             language: String,
-            model: OpenAI::Realtime::AudioTranscription::Model::OrSymbol,
+            model:
+              T.any(
+                String,
+                OpenAI::Realtime::AudioTranscription::Model::OrSymbol
+              ),
             prompt: String
           ).returns(T.attached_class)
         end
@@ -62,8 +76,9 @@ module OpenAI
           # format will improve accuracy and latency.
           language: nil,
           # The model to use for transcription. Current options are `whisper-1`,
-          # `gpt-4o-mini-transcribe`, `gpt-4o-transcribe`, and `gpt-4o-transcribe-diarize`.
-          # Use `gpt-4o-transcribe-diarize` when you need diarization with speaker labels.
+          # `gpt-4o-mini-transcribe`, `gpt-4o-mini-transcribe-2025-12-15`,
+          # `gpt-4o-transcribe`, and `gpt-4o-transcribe-diarize`. Use
+          # `gpt-4o-transcribe-diarize` when you need diarization with speaker labels.
           model: nil,
           # An optional text to guide the model's style or continue a previous audio
           # segment. For `whisper-1`, the
@@ -78,7 +93,11 @@ module OpenAI
           override.returns(
             {
               language: String,
-              model: OpenAI::Realtime::AudioTranscription::Model::OrSymbol,
+              model:
+                T.any(
+                  String,
+                  OpenAI::Realtime::AudioTranscription::Model::OrSymbol
+                ),
               prompt: String
             }
           )
@@ -87,10 +106,27 @@ module OpenAI
         end
 
         # The model to use for transcription. Current options are `whisper-1`,
-        # `gpt-4o-mini-transcribe`, `gpt-4o-transcribe`, and `gpt-4o-transcribe-diarize`.
-        # Use `gpt-4o-transcribe-diarize` when you need diarization with speaker labels.
+        # `gpt-4o-mini-transcribe`, `gpt-4o-mini-transcribe-2025-12-15`,
+        # `gpt-4o-transcribe`, and `gpt-4o-transcribe-diarize`. Use
+        # `gpt-4o-transcribe-diarize` when you need diarization with speaker labels.
         module Model
-          extend OpenAI::Internal::Type::Enum
+          extend OpenAI::Internal::Type::Union
+
+          Variants =
+            T.type_alias do
+              T.any(
+                String,
+                OpenAI::Realtime::AudioTranscription::Model::TaggedSymbol
+              )
+            end
+
+          sig do
+            override.returns(
+              T::Array[OpenAI::Realtime::AudioTranscription::Model::Variants]
+            )
+          end
+          def self.variants
+          end
 
           TaggedSymbol =
             T.type_alias do
@@ -108,6 +144,11 @@ module OpenAI
               :"gpt-4o-mini-transcribe",
               OpenAI::Realtime::AudioTranscription::Model::TaggedSymbol
             )
+          GPT_4O_MINI_TRANSCRIBE_2025_12_15 =
+            T.let(
+              :"gpt-4o-mini-transcribe-2025-12-15",
+              OpenAI::Realtime::AudioTranscription::Model::TaggedSymbol
+            )
           GPT_4O_TRANSCRIBE =
             T.let(
               :"gpt-4o-transcribe",
@@ -118,16 +159,6 @@ module OpenAI
               :"gpt-4o-transcribe-diarize",
               OpenAI::Realtime::AudioTranscription::Model::TaggedSymbol
             )
-
-          sig do
-            override.returns(
-              T::Array[
-                OpenAI::Realtime::AudioTranscription::Model::TaggedSymbol
-              ]
-            )
-          end
-          def self.values
-          end
         end
       end
     end

data/rbi/openai/models/realtime/realtime_audio_config_output.rbi

@@ -51,10 +51,10 @@ module OpenAI
         sig { params(speed: Float).void }
         attr_writer :speed
 
-        # The voice the model uses to respond. Voice cannot be changed during the session
-        # once the model has responded with audio at least once. Current voice options are
-        # `alloy`, `ash`, `ballad`, `coral`, `echo`, `sage`, `shimmer`, `verse`, `marin`,
-        # and `cedar`. We recommend `marin` and `cedar` for best quality.
+        # The voice the model uses to respond. Supported built-in voices are `alloy`,
+        # `ash`, `ballad`, `coral`, `echo`, `sage`, `shimmer`, `verse`, `marin`, and
+        # `cedar`. Voice cannot be changed during the session once the model has responded
+        # with audio at least once. We recommend `marin` and `cedar` for best quality.
         sig do
           returns(
             T.nilable(
@@ -105,10 +105,10 @@ module OpenAI
           # This parameter is a post-processing adjustment to the audio after it is
           # generated, it's also possible to prompt the model to speak faster or slower.
           speed: nil,
-          # The voice the model uses to respond. Voice cannot be changed during the session
-          # once the model has responded with audio at least once. Current voice options are
-          # `alloy`, `ash`, `ballad`, `coral`, `echo`, `sage`, `shimmer`, `verse`, `marin`,
-          # and `cedar`. We recommend `marin` and `cedar` for best quality.
+          # The voice the model uses to respond. Supported built-in voices are `alloy`,
+          # `ash`, `ballad`, `coral`, `echo`, `sage`, `shimmer`, `verse`, `marin`, and
+          # `cedar`. Voice cannot be changed during the session once the model has responded
+          # with audio at least once. We recommend `marin` and `cedar` for best quality.
           voice: nil
         )
         end
@@ -134,10 +134,10 @@ module OpenAI
         def to_hash
         end
 
-        # The voice the model uses to respond. Voice cannot be changed during the session
-        # once the model has responded with audio at least once. Current voice options are
-        # `alloy`, `ash`, `ballad`, `coral`, `echo`, `sage`, `shimmer`, `verse`, `marin`,
-        # and `cedar`. We recommend `marin` and `cedar` for best quality.
+        # The voice the model uses to respond. Supported built-in voices are `alloy`,
+        # `ash`, `ballad`, `coral`, `echo`, `sage`, `shimmer`, `verse`, `marin`, and
+        # `cedar`. Voice cannot be changed during the session once the model has responded
+        # with audio at least once. We recommend `marin` and `cedar` for best quality.
         module Voice
           extend OpenAI::Internal::Type::Union
 

data/rbi/openai/models/realtime/realtime_response_create_audio_output.rbi

@@ -85,10 +85,10 @@ module OpenAI
           end
           attr_writer :format_
 
-          # The voice the model uses to respond. Voice cannot be changed during the session
-          # once the model has responded with audio at least once. Current voice options are
-          # `alloy`, `ash`, `ballad`, `coral`, `echo`, `sage`, `shimmer`, `verse`, `marin`,
-          # and `cedar`. We recommend `marin` and `cedar` for best quality.
+          # The voice the model uses to respond. Supported built-in voices are `alloy`,
+          # `ash`, `ballad`, `coral`, `echo`, `sage`, `shimmer`, `verse`, `marin`, and
+          # `cedar`. Voice cannot be changed during the session once the model has responded
+          # with audio at least once.
           sig do
             returns(
               T.nilable(
@@ -130,10 +130,10 @@ module OpenAI
           def self.new(
             # The format of the output audio.
             format_: nil,
-            # The voice the model uses to respond. Voice cannot be changed during the session
-            # once the model has responded with audio at least once. Current voice options are
-            # `alloy`, `ash`, `ballad`, `coral`, `echo`, `sage`, `shimmer`, `verse`, `marin`,
-            # and `cedar`. We recommend `marin` and `cedar` for best quality.
+            # The voice the model uses to respond. Supported built-in voices are `alloy`,
+            # `ash`, `ballad`, `coral`, `echo`, `sage`, `shimmer`, `verse`, `marin`, and
+            # `cedar`. Voice cannot be changed during the session once the model has responded
+            # with audio at least once.
             voice: nil
           )
           end
@@ -158,10 +158,10 @@ module OpenAI
           def to_hash
           end
 
-          # The voice the model uses to respond. Voice cannot be changed during the session
-          # once the model has responded with audio at least once. Current voice options are
-          # `alloy`, `ash`, `ballad`, `coral`, `echo`, `sage`, `shimmer`, `verse`, `marin`,
-          # and `cedar`. We recommend `marin` and `cedar` for best quality.
+          # The voice the model uses to respond. Supported built-in voices are `alloy`,
+          # `ash`, `ballad`, `coral`, `echo`, `sage`, `shimmer`, `verse`, `marin`, and
+          # `cedar`. Voice cannot be changed during the session once the model has responded
+          # with audio at least once.
           module Voice
             extend OpenAI::Internal::Type::Union
 

data/rbi/openai/models/realtime/realtime_session.rbi

@@ -144,12 +144,19 @@ module OpenAI
 
         # The Realtime model used for this session.
         sig do
-          returns(T.nilable(OpenAI::Realtime::RealtimeSession::Model::OrSymbol))
+          returns(
+            T.nilable(
+              T.any(String, OpenAI::Realtime::RealtimeSession::Model::OrSymbol)
+            )
+          )
         end
         attr_reader :model
 
         sig do
-          params(model: OpenAI::Realtime::RealtimeSession::Model::OrSymbol).void
+          params(
+            model:
+              T.any(String, OpenAI::Realtime::RealtimeSession::Model::OrSymbol)
+          ).void
         end
         attr_writer :model
 
@@ -318,7 +325,8 @@ module OpenAI
             max_response_output_tokens: T.any(Integer, Symbol),
             modalities:
               T::Array[OpenAI::Realtime::RealtimeSession::Modality::OrSymbol],
-            model: OpenAI::Realtime::RealtimeSession::Model::OrSymbol,
+            model:
+              T.any(String, OpenAI::Realtime::RealtimeSession::Model::OrSymbol),
             object: OpenAI::Realtime::RealtimeSession::Object::OrSymbol,
             output_audio_format:
               OpenAI::Realtime::RealtimeSession::OutputAudioFormat::OrSymbol,
@@ -461,7 +469,11 @@ module OpenAI
               max_response_output_tokens: T.any(Integer, Symbol),
               modalities:
                 T::Array[OpenAI::Realtime::RealtimeSession::Modality::OrSymbol],
-              model: OpenAI::Realtime::RealtimeSession::Model::OrSymbol,
+              model:
+                T.any(
+                  String,
+                  OpenAI::Realtime::RealtimeSession::Model::OrSymbol
+                ),
               object: OpenAI::Realtime::RealtimeSession::Object::OrSymbol,
               output_audio_format:
                 OpenAI::Realtime::RealtimeSession::OutputAudioFormat::OrSymbol,
@@ -659,7 +671,23 @@ module OpenAI
 
         # The Realtime model used for this session.
         module Model
-          extend OpenAI::Internal::Type::Enum
+          extend OpenAI::Internal::Type::Union
+
+          Variants =
+            T.type_alias do
+              T.any(
+                String,
+                OpenAI::Realtime::RealtimeSession::Model::TaggedSymbol
+              )
+            end
+
+          sig do
+            override.returns(
+              T::Array[OpenAI::Realtime::RealtimeSession::Model::Variants]
+            )
+          end
+          def self.variants
+          end
 
           TaggedSymbol =
             T.type_alias do
@@ -717,6 +745,11 @@ module OpenAI
               :"gpt-realtime-mini-2025-10-06",
               OpenAI::Realtime::RealtimeSession::Model::TaggedSymbol
             )
+          GPT_REALTIME_MINI_2025_12_15 =
+            T.let(
+              :"gpt-realtime-mini-2025-12-15",
+              OpenAI::Realtime::RealtimeSession::Model::TaggedSymbol
+            )
           GPT_AUDIO_MINI =
             T.let(
               :"gpt-audio-mini",
@@ -727,14 +760,11 @@ module OpenAI
               :"gpt-audio-mini-2025-10-06",
               OpenAI::Realtime::RealtimeSession::Model::TaggedSymbol
             )
-
-          sig do
-            override.returns(
-              T::Array[OpenAI::Realtime::RealtimeSession::Model::TaggedSymbol]
+          GPT_AUDIO_MINI_2025_12_15 =
+            T.let(
+              :"gpt-audio-mini-2025-12-15",
+              OpenAI::Realtime::RealtimeSession::Model::TaggedSymbol
             )
-          end
-          def self.values
-          end
         end
 
         # The object type. Always `realtime.session`.

data/rbi/openai/models/realtime/realtime_session_create_request.rbi

@@ -550,6 +550,11 @@ module OpenAI
               :"gpt-realtime-mini-2025-10-06",
               OpenAI::Realtime::RealtimeSessionCreateRequest::Model::TaggedSymbol
             )
+          GPT_REALTIME_MINI_2025_12_15 =
+            T.let(
+              :"gpt-realtime-mini-2025-12-15",
+              OpenAI::Realtime::RealtimeSessionCreateRequest::Model::TaggedSymbol
+            )
           GPT_AUDIO_MINI =
             T.let(
               :"gpt-audio-mini",
@@ -560,6 +565,11 @@ module OpenAI
               :"gpt-audio-mini-2025-10-06",
               OpenAI::Realtime::RealtimeSessionCreateRequest::Model::TaggedSymbol
             )
+          GPT_AUDIO_MINI_2025_12_15 =
+            T.let(
+              :"gpt-audio-mini-2025-12-15",
+              OpenAI::Realtime::RealtimeSessionCreateRequest::Model::TaggedSymbol
+            )
         end
 
         module OutputModality

data/rbi/openai/models/realtime/realtime_session_create_response.rbi

@@ -1366,6 +1366,11 @@ module OpenAI
               :"gpt-realtime-mini-2025-10-06",
               OpenAI::Realtime::RealtimeSessionCreateResponse::Model::TaggedSymbol
             )
+          GPT_REALTIME_MINI_2025_12_15 =
+            T.let(
+              :"gpt-realtime-mini-2025-12-15",
+              OpenAI::Realtime::RealtimeSessionCreateResponse::Model::TaggedSymbol
+            )
           GPT_AUDIO_MINI =
             T.let(
               :"gpt-audio-mini",
@@ -1376,6 +1381,11 @@ module OpenAI
               :"gpt-audio-mini-2025-10-06",
               OpenAI::Realtime::RealtimeSessionCreateResponse::Model::TaggedSymbol
             )
+          GPT_AUDIO_MINI_2025_12_15 =
+            T.let(
+              :"gpt-audio-mini-2025-12-15",
+              OpenAI::Realtime::RealtimeSessionCreateResponse::Model::TaggedSymbol
+            )
         end
 
         module OutputModality

data/rbi/openai/models/responses/input_token_count_params.rbi

@@ -88,9 +88,7 @@ module OpenAI
         end
         attr_writer :text
 
-        # How the model should select which tool (or tools) to use when generating a
-        # response. See the `tools` parameter to see how to specify which tools the model
-        # can call.
+        # Controls which tool the model should use, if any.
         sig do
           returns(
             T.nilable(
@@ -249,9 +247,7 @@ module OpenAI
           # - [Text inputs and outputs](https://platform.openai.com/docs/guides/text)
           # - [Structured Outputs](https://platform.openai.com/docs/guides/structured-outputs)
           text: nil,
-          # How the model should select which tool (or tools) to use when generating a
-          # response. See the `tools` parameter to see how to specify which tools the model
-          # can call.
+          # Controls which tool the model should use, if any.
           tool_choice: nil,
           # An array of tools the model may call while generating a response. You can
           # specify which tool to use by setting the `tool_choice` parameter.
@@ -540,9 +536,7 @@ module OpenAI
           end
         end
 
-        # How the model should select which tool (or tools) to use when generating a
-        # response. See the `tools` parameter to see how to specify which tools the model
-        # can call.
+        # Controls which tool the model should use, if any.
         module ToolChoice
           extend OpenAI::Internal::Type::Union
 

data/rbi/openai/models/responses/response.rbi

@@ -139,8 +139,13 @@ module OpenAI
         sig { returns(T.nilable(T::Boolean)) }
         attr_accessor :background
 
-        # The conversation that this response belongs to. Input items and output items
-        # from this response are automatically added to this conversation.
+        # Unix timestamp (in seconds) of when this Response was completed. Only present
+        # when the status is `completed`.
+        sig { returns(T.nilable(Float)) }
+        attr_accessor :completed_at
+
+        # The conversation that this response belonged to. Input items and output items
+        # from this response were automatically added to this conversation.
         sig { returns(T.nilable(OpenAI::Responses::Response::Conversation)) }
         attr_reader :conversation
 
@@ -380,6 +385,7 @@ module OpenAI
               ],
             top_p: T.nilable(Float),
             background: T.nilable(T::Boolean),
+            completed_at: T.nilable(Float),
             conversation:
               T.nilable(OpenAI::Responses::Response::Conversation::OrHash),
             max_output_tokens: T.nilable(Integer),
@@ -481,8 +487,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. Input items and output items
-          # from this response are automatically added to this conversation.
+          # Unix timestamp (in seconds) of when this Response was completed. Only present
+          # when the status is `completed`.
+          completed_at: nil,
+          # The conversation that this response belonged to. Input items and output items
+          # from this response were automatically added to this conversation.
           conversation: nil,
           # An upper bound for the number of tokens that can be generated for a response,
           # including visible output tokens and
@@ -592,6 +601,7 @@ module OpenAI
               tools: T::Array[OpenAI::Responses::Tool::Variants],
               top_p: T.nilable(Float),
               background: T.nilable(T::Boolean),
+              completed_at: T.nilable(Float),
               conversation:
                 T.nilable(OpenAI::Responses::Response::Conversation),
               max_output_tokens: T.nilable(Integer),
@@ -782,15 +792,15 @@ module OpenAI
               )
             end
 
-          # The unique ID of the conversation.
+          # The unique ID of the conversation that this response was associated with.
           sig { returns(String) }
           attr_accessor :id
 
-          # The conversation that this response belongs to. Input items and output items
-          # from this response are automatically added to this conversation.
+          # The conversation that this response belonged to. Input items and output items
+          # from this response were automatically added to this conversation.
           sig { params(id: String).returns(T.attached_class) }
           def self.new(
-            # The unique ID of the conversation.
+            # The unique ID of the conversation that this response was associated with.
             id:
           )
           end

data/rbi/openai/models/responses/response_compaction_item.rbi

@@ -16,6 +16,7 @@ module OpenAI
         sig { returns(String) }
         attr_accessor :id
 
+        # The encrypted content that was produced by compaction.
         sig { returns(String) }
         attr_accessor :encrypted_content
 
@@ -23,6 +24,7 @@ module OpenAI
         sig { returns(Symbol) }
         attr_accessor :type
 
+        # The identifier of the actor that created the item.
         sig { returns(T.nilable(String)) }
         attr_reader :created_by
 
@@ -42,7 +44,9 @@ module OpenAI
         def self.new(
           # The unique ID of the compaction item.
           id:,
+          # The encrypted content that was produced by compaction.
           encrypted_content:,
+          # The identifier of the actor that created the item.
           created_by: nil,
           # The type of the item. Always `compaction`.
           type: :compaction

data/rbi/openai/models/responses/response_compaction_item_param.rbi

@@ -12,6 +12,7 @@ module OpenAI
             )
           end
 
+        # The encrypted content of the compaction summary.
         sig { returns(String) }
         attr_accessor :encrypted_content
 
@@ -33,6 +34,7 @@ module OpenAI
           ).returns(T.attached_class)
         end
         def self.new(
+          # The encrypted content of the compaction summary.
           encrypted_content:,
           # The ID of the compaction item.
           id: nil,

data/rbi/openai/models/responses/response_function_call_output_item.rbi

@@ -3,7 +3,7 @@
 module OpenAI
   module Models
     module Responses
-      # A text input to the model.
+      # A piece of message content, such as text, an image, or a file.
       module ResponseFunctionCallOutputItem
         extend OpenAI::Internal::Type::Union
 

data/rbi/openai/models/responses/response_function_shell_tool_call_output.rbi

@@ -40,13 +40,14 @@ module OpenAI
         sig { returns(Symbol) }
         attr_accessor :type
 
+        # The identifier of the actor that created the item.
         sig { returns(T.nilable(String)) }
         attr_reader :created_by
 
         sig { params(created_by: String).void }
         attr_writer :created_by
 
-        # The output of a shell tool call.
+        # The output of a shell tool call that was emitted.
         sig do
           params(
             id: String,
@@ -71,6 +72,7 @@ module OpenAI
           max_output_length:,
           # An array of shell call output contents
           output:,
+          # The identifier of the actor that created the item.
           created_by: nil,
           # The type of the shell call output. Always `shell_call_output`.
           type: :shell_call_output
@@ -113,19 +115,22 @@ module OpenAI
           end
           attr_accessor :outcome
 
+          # The standard error output that was captured.
           sig { returns(String) }
           attr_accessor :stderr
 
+          # The standard output that was captured.
           sig { returns(String) }
           attr_accessor :stdout
 
+          # The identifier of the actor that created the item.
           sig { returns(T.nilable(String)) }
           attr_reader :created_by
 
           sig { params(created_by: String).void }
           attr_writer :created_by
 
-          # The content of a shell call output.
+          # The content of a shell tool call output that was emitted.
           sig do
             params(
               outcome:
@@ -142,8 +147,11 @@ module OpenAI
             # Represents either an exit outcome (with an exit code) or a timeout outcome for a
             # shell call output chunk.
             outcome:,
+            # The standard error output that was captured.
             stderr:,
+            # The standard output that was captured.
             stdout:,
+            # The identifier of the actor that created the item.
             created_by: nil
           )
           end