openai 0.91.0 → 0.93.0

data/sig/openai/models/beta/beta_response_input_item.rbs

@@ -54,24 +54,46 @@ module OpenAI
           }
 
         class Message < OpenAI::Internal::Type::BaseModel
+          # A list of one or many input items to the model, containing different content
+          # types.
           attr_accessor content: OpenAI::Models::Beta::beta_response_input_message_content_list
 
+          # The role of the message input. One of `user`, `system`, or `developer`.
           attr_accessor role: OpenAI::Models::Beta::BetaResponseInputItem::Message::role
 
+          # The agent that produced this item.
           attr_accessor agent: OpenAI::Beta::BetaResponseInputItem::Message::Agent?
 
+          # The status of item. One of `in_progress`, `completed`, or `incomplete`.
+          # Populated when items are returned via API.
           attr_reader status: OpenAI::Models::Beta::BetaResponseInputItem::Message::status?
 
+          # The status of item. One of `in_progress`, `completed`, or `incomplete`.
+          # Populated when items are returned via API.
           def status=: (
             OpenAI::Models::Beta::BetaResponseInputItem::Message::status
           ) -> OpenAI::Models::Beta::BetaResponseInputItem::Message::status
 
+          # The type of the message input. Always set to `message`.
           attr_reader type: OpenAI::Models::Beta::BetaResponseInputItem::Message::type_?
 
+          # The type of the message input. Always set to `message`.
           def type=: (
             OpenAI::Models::Beta::BetaResponseInputItem::Message::type_
           ) -> OpenAI::Models::Beta::BetaResponseInputItem::Message::type_
 
+          # @param content
+          #   A list of one or many input items to the model, containing different content
+          #   types.
+          # @param role
+          #   The role of the message input. One of `user`, `system`, or `developer`.
+          # @param agent
+          #   The agent that produced this item.
+          # @param status
+          #   The status of item. One of `in_progress`, `completed`, or `incomplete`.
+          #   Populated when items are returned via API.
+          # @param type
+          #   The type of the message input. Always set to `message`.
           def initialize: (
             content: OpenAI::Models::Beta::beta_response_input_message_content_list,
             role: OpenAI::Models::Beta::BetaResponseInputItem::Message::role,
@@ -103,8 +125,11 @@ module OpenAI
           type agent = { agent_name: String }
 
           class Agent < OpenAI::Internal::Type::BaseModel
+            # The canonical name of the agent that produced this item.
             attr_accessor agent_name: String
 
+            # @param agent_name
+            #   The canonical name of the agent that produced this item.
             def initialize: (agent_name: String) -> void
 
             def to_hash: -> { agent_name: String }
@@ -145,20 +170,45 @@ module OpenAI
           }
 
         class ComputerCallOutput < OpenAI::Internal::Type::BaseModel
+          # The ID of the computer tool call that produced the output.
           attr_accessor call_id: String
 
+          # A computer screenshot image used with the computer use tool.
           attr_accessor output: OpenAI::Beta::BetaResponseComputerToolCallOutputScreenshot
 
+          # The type of the computer tool call output. Always `computer_call_output`.
           attr_accessor type: :computer_call_output
 
+          # The ID of the computer tool call output.
           attr_accessor id: String?
 
+          # The safety checks reported by the API that have been acknowledged by the
+          # developer.
           attr_accessor acknowledged_safety_checks: ::Array[OpenAI::Beta::BetaResponseInputItem::ComputerCallOutput::AcknowledgedSafetyCheck]?
 
+          # The agent that produced this item.
           attr_accessor agent: OpenAI::Beta::BetaResponseInputItem::ComputerCallOutput::Agent?
 
+          # The status of the message input. One of `in_progress`, `completed`, or
+          # `incomplete`. Populated when input items are returned via API.
           attr_accessor status: OpenAI::Models::Beta::BetaResponseInputItem::ComputerCallOutput::status?
 
+          # @param call_id
+          #   The ID of the computer tool call that produced the output.
+          # @param output
+          #   A computer screenshot image used with the computer use tool.
+          # @param id
+          #   The ID of the computer tool call output.
+          # @param acknowledged_safety_checks
+          #   The safety checks reported by the API that have been acknowledged by the
+          #   developer.
+          # @param agent
+          #   The agent that produced this item.
+          # @param status
+          #   The status of the message input. One of `in_progress`, `completed`, or
+          #   `incomplete`. Populated when input items are returned via API.
+          # @param type
+          #   The type of the computer tool call output. Always `computer_call_output`.
           def initialize: (
             call_id: String,
             output: OpenAI::Beta::BetaResponseComputerToolCallOutputScreenshot,
@@ -183,12 +233,21 @@ module OpenAI
             { id: String, ?code: String?, ?message: String? }
 
           class AcknowledgedSafetyCheck < OpenAI::Internal::Type::BaseModel
+            # The ID of the pending safety check.
             attr_accessor id: String
 
+            # The type of the pending safety check.
             attr_accessor code: String?
 
+            # Details about the pending safety check.
             attr_accessor message: String?
 
+            # @param id
+            #   The ID of the pending safety check.
+            # @param code
+            #   The type of the pending safety check.
+            # @param message
+            #   Details about the pending safety check.
             def initialize: (
               id: String,
               ?code: String?,
@@ -201,8 +260,11 @@ module OpenAI
           type agent = { agent_name: String }
 
           class Agent < OpenAI::Internal::Type::BaseModel
+            # The canonical name of the agent that produced this item.
             attr_accessor agent_name: String
 
+            # @param agent_name
+            #   The canonical name of the agent that produced this item.
             def initialize: (agent_name: String) -> void
 
             def to_hash: -> { agent_name: String }
@@ -235,24 +297,55 @@ module OpenAI
           }
 
         class FunctionCallOutput < OpenAI::Internal::Type::BaseModel
+          # Text, image, or file output of the function tool call.
           attr_accessor output: OpenAI::Models::Beta::BetaResponseInputItem::FunctionCallOutput::output
 
+          # The type of the function tool call output. Always `function_call_output`.
           attr_accessor type: :function_call_output
 
+          # The unique ID of the function tool call output. Populated when this item is
+          # returned via API.
           attr_accessor id: String?
 
+          # The agent that produced this item.
           attr_accessor agent: OpenAI::Beta::BetaResponseInputItem::FunctionCallOutput::Agent?
 
+          # The unique ID of the function tool call generated by the model.
           attr_accessor call_id: String?
 
+          # The execution context that produced this tool call.
           attr_accessor caller_: OpenAI::Models::Beta::BetaResponseInputItem::FunctionCallOutput::caller_?
 
+          # The name of the tool that produced the output.
           attr_accessor name: String?
 
+          # The namespace of the tool that produced the output.
           attr_accessor namespace: String?
 
+          # The status of the item. One of `in_progress`, `completed`, or `incomplete`.
+          # Populated when items are returned via API.
           attr_accessor status: OpenAI::Models::Beta::BetaResponseInputItem::FunctionCallOutput::status?
 
+          # @param output
+          #   Text, image, or file output of the function tool call.
+          # @param id
+          #   The unique ID of the function tool call output. Populated when this item is
+          #   returned via API.
+          # @param agent
+          #   The agent that produced this item.
+          # @param call_id
+          #   The unique ID of the function tool call generated by the model.
+          # @param caller_
+          #   The execution context that produced this tool call.
+          # @param name
+          #   The name of the tool that produced the output.
+          # @param namespace
+          #   The namespace of the tool that produced the output.
+          # @param status
+          #   The status of the item. One of `in_progress`, `completed`, or `incomplete`.
+          #   Populated when items are returned via API.
+          # @param type
+          #   The type of the function tool call output. Always `function_call_output`.
           def initialize: (
             output: OpenAI::Models::Beta::BetaResponseInputItem::FunctionCallOutput::output,
             ?id: String?,
@@ -290,8 +383,11 @@ module OpenAI
           type agent = { agent_name: String }
 
           class Agent < OpenAI::Internal::Type::BaseModel
+            # The canonical name of the agent that produced this item.
             attr_accessor agent_name: String
 
+            # @param agent_name
+            #   The canonical name of the agent that produced this item.
             def initialize: (agent_name: String) -> void
 
             def to_hash: -> { agent_name: String }
@@ -307,8 +403,11 @@ module OpenAI
             type direct = { ?type: :direct }
 
             class Direct < OpenAI::Internal::Type::BaseModel
+              # The caller type. Always `direct`.
               attr_accessor type: :direct
 
+              # @param type
+              #   The caller type. Always `direct`.
               def initialize: (?type: :direct) -> void
 
               def to_hash: -> { ?type: :direct }
@@ -317,10 +416,16 @@ module OpenAI
             type program = { caller_id: String, ?type: :program }
 
             class Program < OpenAI::Internal::Type::BaseModel
+              # The call ID of the program item that produced this tool call.
               attr_accessor caller_id: String
 
+              # The caller type. Always `program`.
               attr_accessor type: :program
 
+              # @param caller_id
+              #   The call ID of the program item that produced this tool call.
+              # @param type
+              #   The caller type. Always `program`.
               def initialize: (caller_id: String, ?type: :program) -> void
 
               def to_hash: -> { caller_id: String, ?type: :program }
@@ -353,18 +458,36 @@ module OpenAI
           }
 
         class AgentMessage < OpenAI::Internal::Type::BaseModel
+          # The sending agent identity.
           attr_accessor author: String
 
+          # Plaintext, image, or encrypted content sent between agents.
           attr_accessor content: ::Array[OpenAI::Models::Beta::BetaResponseInputItem::AgentMessage::content]
 
+          # The destination agent identity.
           attr_accessor recipient: String
 
+          # The item type. Always `agent_message`.
           attr_accessor type: :agent_message
 
+          # The unique ID of this agent message item.
           attr_accessor id: String?
 
+          # The agent that produced this item.
           attr_accessor agent: OpenAI::Beta::BetaResponseInputItem::AgentMessage::Agent?
 
+          # @param author
+          #   The sending agent identity.
+          # @param content
+          #   Plaintext, image, or encrypted content sent between agents.
+          # @param recipient
+          #   The destination agent identity.
+          # @param id
+          #   The unique ID of this agent message item.
+          # @param agent
+          #   The agent that produced this item.
+          # @param type
+          #   The item type. Always `agent_message`.
           def initialize: (
             author: String,
             content: ::Array[OpenAI::Models::Beta::BetaResponseInputItem::AgentMessage::content],
@@ -395,10 +518,16 @@ module OpenAI
               { encrypted_content: String, ?type: :encrypted_content }
 
             class EncryptedContent < OpenAI::Internal::Type::BaseModel
+              # Opaque encrypted content.
               attr_accessor encrypted_content: String
 
+              # The type of the input item. Always `encrypted_content`.
               attr_accessor type: :encrypted_content
 
+              # @param encrypted_content
+              #   Opaque encrypted content.
+              # @param type
+              #   The type of the input item. Always `encrypted_content`.
               def initialize: (
                 encrypted_content: String,
                 ?type: :encrypted_content
@@ -416,8 +545,11 @@ module OpenAI
           type agent = { agent_name: String }
 
           class Agent < OpenAI::Internal::Type::BaseModel
+            # The canonical name of the agent that produced this item.
             attr_accessor agent_name: String
 
+            # @param agent_name
+            #   The canonical name of the agent that produced this item.
             def initialize: (agent_name: String) -> void
 
             def to_hash: -> { agent_name: String }
@@ -435,18 +567,36 @@ module OpenAI
           }
 
         class MultiAgentCall < OpenAI::Internal::Type::BaseModel
+          # The multi-agent action that was executed.
           attr_accessor action: OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCall::action
 
+          # The action arguments as a JSON string.
           attr_accessor arguments: String
 
+          # The unique ID linking this call to its output.
           attr_accessor call_id: String
 
+          # The item type. Always `multi_agent_call`.
           attr_accessor type: :multi_agent_call
 
+          # The unique ID of this multi-agent call.
           attr_accessor id: String?
 
+          # The agent that produced this item.
           attr_accessor agent: OpenAI::Beta::BetaResponseInputItem::MultiAgentCall::Agent?
 
+          # @param action
+          #   The multi-agent action that was executed.
+          # @param arguments
+          #   The action arguments as a JSON string.
+          # @param call_id
+          #   The unique ID linking this call to its output.
+          # @param id
+          #   The unique ID of this multi-agent call.
+          # @param agent
+          #   The agent that produced this item.
+          # @param type
+          #   The item type. Always `multi_agent_call`.
           def initialize: (
             action: OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCall::action,
             arguments: String,
@@ -489,8 +639,11 @@ module OpenAI
           type agent = { agent_name: String }
 
           class Agent < OpenAI::Internal::Type::BaseModel
+            # The canonical name of the agent that produced this item.
             attr_accessor agent_name: String
 
+            # @param agent_name
+            #   The canonical name of the agent that produced this item.
             def initialize: (agent_name: String) -> void
 
             def to_hash: -> { agent_name: String }
@@ -508,18 +661,36 @@ module OpenAI
           }
 
         class MultiAgentCallOutput < OpenAI::Internal::Type::BaseModel
+          # The multi-agent action that produced this result.
           attr_accessor action: OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::action
 
+          # The unique ID of the multi-agent call.
           attr_accessor call_id: String
 
+          # Text output returned by the multi-agent action.
           attr_accessor output: ::Array[OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output]
 
+          # The item type. Always `multi_agent_call_output`.
           attr_accessor type: :multi_agent_call_output
 
+          # The unique ID of this multi-agent call output.
           attr_accessor id: String?
 
+          # The agent that produced this item.
           attr_accessor agent: OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Agent?
 
+          # @param action
+          #   The multi-agent action that produced this result.
+          # @param call_id
+          #   The unique ID of the multi-agent call.
+          # @param output
+          #   Text output returned by the multi-agent action.
+          # @param id
+          #   The unique ID of this multi-agent call output.
+          # @param agent
+          #   The agent that produced this item.
+          # @param type
+          #   The item type. Always `multi_agent_call_output`.
           def initialize: (
             action: OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::action,
             call_id: String,
@@ -567,16 +738,26 @@ module OpenAI
             }
 
           class Output < OpenAI::Internal::Type::BaseModel
+            # The text content.
             attr_accessor text: String
 
+            # The content type. Always `output_text`.
             attr_accessor type: :output_text
 
+            # Citations associated with the text content.
             attr_reader annotations: ::Array[OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::annotation]?
 
+            # Citations associated with the text content.
             def annotations=: (
               ::Array[OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::annotation]
             ) -> ::Array[OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::annotation]
 
+            # @param text
+            #   The text content.
+            # @param annotations
+            #   Citations associated with the text content.
+            # @param type
+            #   The content type. Always `output_text`.
             def initialize: (
               text: String,
               ?annotations: ::Array[OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::annotation],
@@ -606,14 +787,26 @@ module OpenAI
                 }
 
               class FileCitation < OpenAI::Internal::Type::BaseModel
+                # The ID of the file.
                 attr_accessor file_id: String
 
+                # The filename of the file cited.
                 attr_accessor filename: String
 
+                # The index of the file in the list of files.
                 attr_accessor index: Integer
 
+                # The citation type. Always `file_citation`.
                 attr_accessor type: :file_citation
 
+                # @param file_id
+                #   The ID of the file.
+                # @param filename
+                #   The filename of the file cited.
+                # @param index
+                #   The index of the file in the list of files.
+                # @param type
+                #   The citation type. Always `file_citation`.
                 def initialize: (
                   file_id: String,
                   filename: String,
@@ -639,16 +832,31 @@ module OpenAI
                 }
 
               class URLCitation < OpenAI::Internal::Type::BaseModel
+                # The index of the last character of the citation in the message.
                 attr_accessor end_index: Integer
 
+                # The index of the first character of the citation in the message.
                 attr_accessor start_index: Integer
 
+                # The title of the cited resource.
                 attr_accessor title: String
 
+                # The citation type. Always `url_citation`.
                 attr_accessor type: :url_citation
 
+                # The URL of the cited resource.
                 attr_accessor url: String
 
+                # @param end_index
+                #   The index of the last character of the citation in the message.
+                # @param start_index
+                #   The index of the first character of the citation in the message.
+                # @param title
+                #   The title of the cited resource.
+                # @param url
+                #   The URL of the cited resource.
+                # @param type
+                #   The citation type. Always `url_citation`.
                 def initialize: (
                   end_index: Integer,
                   start_index: Integer,
@@ -677,18 +885,36 @@ module OpenAI
                 }
 
               class ContainerFileCitation < OpenAI::Internal::Type::BaseModel
+                # The ID of the container.
                 attr_accessor container_id: String
 
+                # The index of the last character of the citation in the message.
                 attr_accessor end_index: Integer
 
+                # The ID of the container file.
                 attr_accessor file_id: String
 
+                # The filename of the container file cited.
                 attr_accessor filename: String
 
+                # The index of the first character of the citation in the message.
                 attr_accessor start_index: Integer
 
+                # The citation type. Always `container_file_citation`.
                 attr_accessor type: :container_file_citation
 
+                # @param container_id
+                #   The ID of the container.
+                # @param end_index
+                #   The index of the last character of the citation in the message.
+                # @param file_id
+                #   The ID of the container file.
+                # @param filename
+                #   The filename of the container file cited.
+                # @param start_index
+                #   The index of the first character of the citation in the message.
+                # @param type
+                #   The citation type. Always `container_file_citation`.
                 def initialize: (
                   container_id: String,
                   end_index: Integer,
@@ -715,8 +941,11 @@ module OpenAI
           type agent = { agent_name: String }
 
           class Agent < OpenAI::Internal::Type::BaseModel
+            # The canonical name of the agent that produced this item.
             attr_accessor agent_name: String
 
+            # @param agent_name
+            #   The canonical name of the agent that produced this item.
             def initialize: (agent_name: String) -> void
 
             def to_hash: -> { agent_name: String }
@@ -735,24 +964,46 @@ module OpenAI
           }
 
         class ToolSearchCall < OpenAI::Internal::Type::BaseModel
+          # The arguments supplied to the tool search call.
           attr_accessor arguments: top
 
+          # The item type. Always `tool_search_call`.
           attr_accessor type: :tool_search_call
 
+          # The unique ID of this tool search call.
           attr_accessor id: String?
 
+          # The agent that produced this item.
           attr_accessor agent: OpenAI::Beta::BetaResponseInputItem::ToolSearchCall::Agent?
 
+          # The unique ID of the tool search call generated by the model.
           attr_accessor call_id: String?
 
+          # Whether tool search was executed by the server or by the client.
           attr_reader execution: OpenAI::Models::Beta::BetaResponseInputItem::ToolSearchCall::execution?
 
+          # Whether tool search was executed by the server or by the client.
           def execution=: (
             OpenAI::Models::Beta::BetaResponseInputItem::ToolSearchCall::execution
           ) -> OpenAI::Models::Beta::BetaResponseInputItem::ToolSearchCall::execution
 
+          # The status of the tool search call.
           attr_accessor status: OpenAI::Models::Beta::BetaResponseInputItem::ToolSearchCall::status?
 
+          # @param arguments
+          #   The arguments supplied to the tool search call.
+          # @param id
+          #   The unique ID of this tool search call.
+          # @param agent
+          #   The agent that produced this item.
+          # @param call_id
+          #   The unique ID of the tool search call generated by the model.
+          # @param execution
+          #   Whether tool search was executed by the server or by the client.
+          # @param status
+          #   The status of the tool search call.
+          # @param type
+          #   The item type. Always `tool_search_call`.
           def initialize: (
             arguments: top,
             ?id: String?,
@@ -776,8 +1027,11 @@ module OpenAI
           type agent = { agent_name: String }
 
           class Agent < OpenAI::Internal::Type::BaseModel
+            # The canonical name of the agent that produced this item.
             attr_accessor agent_name: String
 
+            # @param agent_name
+            #   The canonical name of the agent that produced this item.
             def initialize: (agent_name: String) -> void
 
             def to_hash: -> { agent_name: String }
@@ -817,16 +1071,31 @@ module OpenAI
           }
 
         class AdditionalTools < OpenAI::Internal::Type::BaseModel
+          # The role that provided the additional tools. Only `developer` is supported.
           attr_accessor role: :developer
 
+          # A list of additional tools made available at this item.
           attr_accessor tools: ::Array[OpenAI::Models::Beta::beta_tool]
 
+          # The item type. Always `additional_tools`.
           attr_accessor type: :additional_tools
 
+          # The unique ID of this additional tools item.
           attr_accessor id: String?
 
+          # The agent that produced this item.
           attr_accessor agent: OpenAI::Beta::BetaResponseInputItem::AdditionalTools::Agent?
 
+          # @param tools
+          #   A list of additional tools made available at this item.
+          # @param id
+          #   The unique ID of this additional tools item.
+          # @param agent
+          #   The agent that produced this item.
+          # @param role
+          #   The role that provided the additional tools. Only `developer` is supported.
+          # @param type
+          #   The item type. Always `additional_tools`.
           def initialize: (
             tools: ::Array[OpenAI::Models::Beta::beta_tool],
             ?id: String?,
@@ -846,8 +1115,11 @@ module OpenAI
           type agent = { agent_name: String }
 
           class Agent < OpenAI::Internal::Type::BaseModel
+            # The canonical name of the agent that produced this item.
             attr_accessor agent_name: String
 
+            # @param agent_name
+            #   The canonical name of the agent that produced this item.
             def initialize: (agent_name: String) -> void
 
             def to_hash: -> { agent_name: String }
@@ -870,28 +1142,63 @@ module OpenAI
           }
 
         class ImageGenerationCall < OpenAI::Internal::Type::BaseModel
+          # The unique ID of the image generation call.
           attr_accessor id: String
 
+          # The generated image encoded in base64.
           attr_accessor result: String?
 
+          # The status of the image generation call.
           attr_accessor status: OpenAI::Models::Beta::BetaResponseInputItem::ImageGenerationCall::status
 
+          # The type of the image generation call. Always `image_generation_call`.
           attr_accessor type: :image_generation_call
 
+          # The action used for image generation.
           attr_accessor action: OpenAI::Models::Beta::BetaResponseInputItem::ImageGenerationCall::action?
 
+          # The agent that produced this item.
           attr_accessor agent: OpenAI::Beta::BetaResponseInputItem::ImageGenerationCall::Agent?
 
+          # The background setting used for generation.
           attr_accessor background: OpenAI::Models::Beta::BetaResponseInputItem::ImageGenerationCall::background?
 
+          # The output format used for generation.
           attr_accessor output_format: OpenAI::Models::Beta::BetaResponseInputItem::ImageGenerationCall::output_format?
 
+          # The quality of the image generated by the image generation tool call. One of
+          # `low`, `medium`, `high`, `xhigh`, `max`, or `auto`.
           attr_accessor quality: OpenAI::Models::Beta::BetaResponseInputItem::ImageGenerationCall::quality?
 
+          # The prompt that was used after any model prompt rewriting.
           attr_accessor revised_prompt: String?
 
+          # The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
           attr_accessor size: OpenAI::Models::Beta::BetaResponseInputItem::ImageGenerationCall::size?
 
+          # @param id
+          #   The unique ID of the image generation call.
+          # @param result
+          #   The generated image encoded in base64.
+          # @param status
+          #   The status of the image generation call.
+          # @param action
+          #   The action used for image generation.
+          # @param agent
+          #   The agent that produced this item.
+          # @param background
+          #   The background setting used for generation.
+          # @param output_format
+          #   The output format used for generation.
+          # @param quality
+          #   The quality of the image generated by the image generation tool call. One of
+          #   `low`, `medium`, `high`, `xhigh`, `max`, or `auto`.
+          # @param revised_prompt
+          #   The prompt that was used after any model prompt rewriting.
+          # @param size
+          #   The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
+          # @param type
+          #   The type of the image generation call. Always `image_generation_call`.
           def initialize: (
             id: String,
             result: String?,
@@ -948,8 +1255,11 @@ module OpenAI
           type agent = { agent_name: String }
 
           class Agent < OpenAI::Internal::Type::BaseModel
+            # The canonical name of the agent that produced this item.
             attr_accessor agent_name: String
 
+            # @param agent_name
+            #   The canonical name of the agent that produced this item.
             def initialize: (agent_name: String) -> void
 
             def to_hash: -> { agent_name: String }
@@ -1018,18 +1328,36 @@ module OpenAI
           }
 
         class LocalShellCall < OpenAI::Internal::Type::BaseModel
+          # The unique ID of the local shell call.
           attr_accessor id: String
 
+          # Execute a shell command on the server.
           attr_accessor action: OpenAI::Beta::BetaResponseInputItem::LocalShellCall::Action
 
+          # The unique ID of the local shell tool call generated by the model.
           attr_accessor call_id: String
 
+          # The status of the local shell call.
           attr_accessor status: OpenAI::Models::Beta::BetaResponseInputItem::LocalShellCall::status
 
+          # The type of the local shell call. Always `local_shell_call`.
           attr_accessor type: :local_shell_call
 
+          # The agent that produced this item.
           attr_accessor agent: OpenAI::Beta::BetaResponseInputItem::LocalShellCall::Agent?
 
+          # @param id
+          #   The unique ID of the local shell call.
+          # @param action
+          #   Execute a shell command on the server.
+          # @param call_id
+          #   The unique ID of the local shell tool call generated by the model.
+          # @param status
+          #   The status of the local shell call.
+          # @param agent
+          #   The agent that produced this item.
+          # @param type
+          #   The type of the local shell call. Always `local_shell_call`.
           def initialize: (
             id: String,
             action: OpenAI::Beta::BetaResponseInputItem::LocalShellCall::Action,
@@ -1059,18 +1387,36 @@ module OpenAI
             }
 
           class Action < OpenAI::Internal::Type::BaseModel
+            # The command to run.
             attr_accessor command: ::Array[String]
 
+            # Environment variables to set for the command.
             attr_accessor env: ::Hash[Symbol, String]
 
+            # The type of the local shell action. Always `exec`.
             attr_accessor type: :exec
 
+            # Optional timeout in milliseconds for the command.
             attr_accessor timeout_ms: Integer?
 
+            # Optional user to run the command as.
             attr_accessor user: String?
 
+            # Optional working directory to run the command in.
             attr_accessor working_directory: String?
 
+            # @param command
+            #   The command to run.
+            # @param env
+            #   Environment variables to set for the command.
+            # @param timeout_ms
+            #   Optional timeout in milliseconds for the command.
+            # @param user
+            #   Optional user to run the command as.
+            # @param working_directory
+            #   Optional working directory to run the command in.
+            # @param type
+            #   The type of the local shell action. Always `exec`.
             def initialize: (
               command: ::Array[String],
               env: ::Hash[Symbol, String],
@@ -1105,8 +1451,11 @@ module OpenAI
           type agent = { agent_name: String }
 
           class Agent < OpenAI::Internal::Type::BaseModel
+            # The canonical name of the agent that produced this item.
             attr_accessor agent_name: String
 
+            # @param agent_name
+            #   The canonical name of the agent that produced this item.
             def initialize: (agent_name: String) -> void
 
             def to_hash: -> { agent_name: String }
@@ -1123,16 +1472,31 @@ module OpenAI
           }
 
         class LocalShellCallOutput < OpenAI::Internal::Type::BaseModel
+          # The unique ID of the local shell tool call generated by the model.
           attr_accessor id: String
 
+          # A JSON string of the output of the local shell tool call.
           attr_accessor output: String
 
+          # The type of the local shell tool call output. Always `local_shell_call_output`.
           attr_accessor type: :local_shell_call_output
 
+          # The agent that produced this item.
           attr_accessor agent: OpenAI::Beta::BetaResponseInputItem::LocalShellCallOutput::Agent?
 
+          # The status of the item. One of `in_progress`, `completed`, or `incomplete`.
           attr_accessor status: OpenAI::Models::Beta::BetaResponseInputItem::LocalShellCallOutput::status?
 
+          # @param id
+          #   The unique ID of the local shell tool call generated by the model.
+          # @param output
+          #   A JSON string of the output of the local shell tool call.
+          # @param agent
+          #   The agent that produced this item.
+          # @param status
+          #   The status of the item. One of `in_progress`, `completed`, or `incomplete`.
+          # @param type
+          #   The type of the local shell tool call output. Always `local_shell_call_output`.
           def initialize: (
             id: String,
             output: String,
@@ -1152,8 +1516,11 @@ module OpenAI
           type agent = { agent_name: String }
 
           class Agent < OpenAI::Internal::Type::BaseModel
+            # The canonical name of the agent that produced this item.
             attr_accessor agent_name: String
 
+            # @param agent_name
+            #   The canonical name of the agent that produced this item.
             def initialize: (agent_name: String) -> void
 
             def to_hash: -> { agent_name: String }
@@ -1185,22 +1552,50 @@ module OpenAI
           }
 
         class ShellCall < OpenAI::Internal::Type::BaseModel
+          # The shell commands and limits that describe how to run the tool call.
           attr_accessor action: OpenAI::Beta::BetaResponseInputItem::ShellCall::Action
 
+          # The unique ID of the shell tool call generated by the model.
           attr_accessor call_id: String
 
+          # The type of the item. Always `shell_call`.
           attr_accessor type: :shell_call
 
+          # The unique ID of the shell tool call. Populated when this item is returned via
+          # API.
           attr_accessor id: String?
 
+          # The agent that produced this item.
           attr_accessor agent: OpenAI::Beta::BetaResponseInputItem::ShellCall::Agent?
 
+          # The execution context that produced this tool call.
           attr_accessor caller_: OpenAI::Models::Beta::BetaResponseInputItem::ShellCall::caller_?
 
+          # The environment to execute the shell commands in.
           attr_accessor environment: OpenAI::Models::Beta::BetaResponseInputItem::ShellCall::environment?
 
+          # The status of the shell call. One of `in_progress`, `completed`, or
+          # `incomplete`.
           attr_accessor status: OpenAI::Models::Beta::BetaResponseInputItem::ShellCall::status?
 
+          # @param action
+          #   The shell commands and limits that describe how to run the tool call.
+          # @param call_id
+          #   The unique ID of the shell tool call generated by the model.
+          # @param id
+          #   The unique ID of the shell tool call. Populated when this item is returned via
+          #   API.
+          # @param agent
+          #   The agent that produced this item.
+          # @param caller_
+          #   The execution context that produced this tool call.
+          # @param environment
+          #   The environment to execute the shell commands in.
+          # @param status
+          #   The status of the shell call. One of `in_progress`, `completed`, or
+          #   `incomplete`.
+          # @param type
+          #   The type of the item. Always `shell_call`.
           def initialize: (
             action: OpenAI::Beta::BetaResponseInputItem::ShellCall::Action,
             call_id: String,
@@ -1231,12 +1626,23 @@ module OpenAI
             }
 
           class Action < OpenAI::Internal::Type::BaseModel
+            # Ordered shell commands for the execution environment to run.
             attr_accessor commands: ::Array[String]
 
+            # Maximum number of UTF-8 characters to capture from combined stdout and stderr
+            # output.
             attr_accessor max_output_length: Integer?
 
+            # Maximum wall-clock time in milliseconds to allow the shell commands to run.
             attr_accessor timeout_ms: Integer?
 
+            # @param commands
+            #   Ordered shell commands for the execution environment to run.
+            # @param max_output_length
+            #   Maximum number of UTF-8 characters to capture from combined stdout and stderr
+            #   output.
+            # @param timeout_ms
+            #   Maximum wall-clock time in milliseconds to allow the shell commands to run.
             def initialize: (
               commands: ::Array[String],
               ?max_output_length: Integer?,
@@ -1253,8 +1659,11 @@ module OpenAI
           type agent = { agent_name: String }
 
           class Agent < OpenAI::Internal::Type::BaseModel
+            # The canonical name of the agent that produced this item.
             attr_accessor agent_name: String
 
+            # @param agent_name
+            #   The canonical name of the agent that produced this item.
             def initialize: (agent_name: String) -> void
 
             def to_hash: -> { agent_name: String }
@@ -1270,8 +1679,11 @@ module OpenAI
             type direct = { ?type: :direct }
 
             class Direct < OpenAI::Internal::Type::BaseModel
+              # The caller type. Always `direct`.
               attr_accessor type: :direct
 
+              # @param type
+              #   The caller type. Always `direct`.
               def initialize: (?type: :direct) -> void
 
               def to_hash: -> { ?type: :direct }
@@ -1280,10 +1692,16 @@ module OpenAI
             type program = { caller_id: String, ?type: :program }
 
             class Program < OpenAI::Internal::Type::BaseModel
+              # The call ID of the program item that produced this tool call.
               attr_accessor caller_id: String
 
+              # The caller type. Always `program`.
               attr_accessor type: :program
 
+              # @param caller_id
+              #   The call ID of the program item that produced this tool call.
+              # @param type
+              #   The caller type. Always `program`.
               def initialize: (caller_id: String, ?type: :program) -> void
 
               def to_hash: -> { caller_id: String, ?type: :program }
@@ -1328,22 +1746,52 @@ module OpenAI
           }
 
         class ShellCallOutput < OpenAI::Internal::Type::BaseModel
+          # The unique ID of the shell tool call generated by the model.
           attr_accessor call_id: String
 
+          # Captured chunks of stdout and stderr output, along with their associated
+          # outcomes.
           attr_accessor output: ::Array[OpenAI::Beta::BetaResponseFunctionShellCallOutputContent]
 
+          # The type of the item. Always `shell_call_output`.
           attr_accessor type: :shell_call_output
 
+          # The unique ID of the shell tool call output. Populated when this item is
+          # returned via API.
           attr_accessor id: String?
 
+          # The agent that produced this item.
           attr_accessor agent: OpenAI::Beta::BetaResponseInputItem::ShellCallOutput::Agent?
 
+          # The execution context that produced this tool call.
           attr_accessor caller_: OpenAI::Models::Beta::BetaResponseInputItem::ShellCallOutput::caller_?
 
+          # The maximum number of UTF-8 characters captured for this shell call's combined
+          # output.
           attr_accessor max_output_length: Integer?
 
+          # The status of the shell call output.
           attr_accessor status: OpenAI::Models::Beta::BetaResponseInputItem::ShellCallOutput::status?
 
+          # @param call_id
+          #   The unique ID of the shell tool call generated by the model.
+          # @param output
+          #   Captured chunks of stdout and stderr output, along with their associated
+          #   outcomes.
+          # @param id
+          #   The unique ID of the shell tool call output. Populated when this item is
+          #   returned via API.
+          # @param agent
+          #   The agent that produced this item.
+          # @param caller_
+          #   The execution context that produced this tool call.
+          # @param max_output_length
+          #   The maximum number of UTF-8 characters captured for this shell call's combined
+          #   output.
+          # @param status
+          #   The status of the shell call output.
+          # @param type
+          #   The type of the item. Always `shell_call_output`.
           def initialize: (
             call_id: String,
             output: ::Array[OpenAI::Beta::BetaResponseFunctionShellCallOutputContent],
@@ -1369,8 +1817,11 @@ module OpenAI
           type agent = { agent_name: String }
 
           class Agent < OpenAI::Internal::Type::BaseModel
+            # The canonical name of the agent that produced this item.
             attr_accessor agent_name: String
 
+            # @param agent_name
+            #   The canonical name of the agent that produced this item.
             def initialize: (agent_name: String) -> void
 
             def to_hash: -> { agent_name: String }
@@ -1386,8 +1837,11 @@ module OpenAI
             type direct = { ?type: :direct }
 
             class Direct < OpenAI::Internal::Type::BaseModel
+              # The caller type. Always `direct`.
               attr_accessor type: :direct
 
+              # @param type
+              #   The caller type. Always `direct`.
               def initialize: (?type: :direct) -> void
 
               def to_hash: -> { ?type: :direct }
@@ -1396,10 +1850,16 @@ module OpenAI
             type program = { caller_id: String, ?type: :program }
 
             class Program < OpenAI::Internal::Type::BaseModel
+              # The call ID of the program item that produced this tool call.
               attr_accessor caller_id: String
 
+              # The caller type. Always `program`.
               attr_accessor type: :program
 
+              # @param caller_id
+              #   The call ID of the program item that produced this tool call.
+              # @param type
+              #   The caller type. Always `program`.
               def initialize: (caller_id: String, ?type: :program) -> void
 
               def to_hash: -> { caller_id: String, ?type: :program }
@@ -1433,20 +1893,45 @@ module OpenAI
           }
 
         class ApplyPatchCall < OpenAI::Internal::Type::BaseModel
+          # The unique ID of the apply patch tool call generated by the model.
           attr_accessor call_id: String
 
+          # The specific create, delete, or update instruction for the apply_patch tool
+          # call.
           attr_accessor operation: OpenAI::Models::Beta::BetaResponseInputItem::ApplyPatchCall::operation
 
+          # The status of the apply patch tool call. One of `in_progress` or `completed`.
           attr_accessor status: OpenAI::Models::Beta::BetaResponseInputItem::ApplyPatchCall::status
 
+          # The type of the item. Always `apply_patch_call`.
           attr_accessor type: :apply_patch_call
 
+          # The unique ID of the apply patch tool call. Populated when this item is returned
+          # via API.
           attr_accessor id: String?
 
+          # The agent that produced this item.
           attr_accessor agent: OpenAI::Beta::BetaResponseInputItem::ApplyPatchCall::Agent?
 
+          # The execution context that produced this tool call.
           attr_accessor caller_: OpenAI::Models::Beta::BetaResponseInputItem::ApplyPatchCall::caller_?
 
+          # @param call_id
+          #   The unique ID of the apply patch tool call generated by the model.
+          # @param operation
+          #   The specific create, delete, or update instruction for the apply_patch tool
+          #   call.
+          # @param status
+          #   The status of the apply patch tool call. One of `in_progress` or `completed`.
+          # @param id
+          #   The unique ID of the apply patch tool call. Populated when this item is returned
+          #   via API.
+          # @param agent
+          #   The agent that produced this item.
+          # @param caller_
+          #   The execution context that produced this tool call.
+          # @param type
+          #   The type of the item. Always `apply_patch_call`.
           def initialize: (
             call_id: String,
             operation: OpenAI::Models::Beta::BetaResponseInputItem::ApplyPatchCall::operation,
@@ -1479,12 +1964,21 @@ module OpenAI
               { diff: String, path: String, ?type: :create_file }
 
             class CreateFile < OpenAI::Internal::Type::BaseModel
+              # Unified diff content to apply when creating the file.
               attr_accessor diff: String
 
+              # Path of the file to create relative to the workspace root.
               attr_accessor path: String
 
+              # The operation type. Always `create_file`.
               attr_accessor type: :create_file
 
+              # @param diff
+              #   Unified diff content to apply when creating the file.
+              # @param path
+              #   Path of the file to create relative to the workspace root.
+              # @param type
+              #   The operation type. Always `create_file`.
               def initialize: (
                 diff: String,
                 path: String,
@@ -1501,10 +1995,16 @@ module OpenAI
             type delete_file = { path: String, ?type: :delete_file }
 
             class DeleteFile < OpenAI::Internal::Type::BaseModel
+              # Path of the file to delete relative to the workspace root.
               attr_accessor path: String
 
+              # The operation type. Always `delete_file`.
               attr_accessor type: :delete_file
 
+              # @param path
+              #   Path of the file to delete relative to the workspace root.
+              # @param type
+              #   The operation type. Always `delete_file`.
               def initialize: (path: String, ?type: :delete_file) -> void
 
               def to_hash: -> { path: String, ?type: :delete_file }
@@ -1514,12 +2014,21 @@ module OpenAI
               { diff: String, path: String, ?type: :update_file }
 
             class UpdateFile < OpenAI::Internal::Type::BaseModel
+              # Unified diff content to apply to the existing file.
               attr_accessor diff: String
 
+              # Path of the file to update relative to the workspace root.
               attr_accessor path: String
 
+              # The operation type. Always `update_file`.
               attr_accessor type: :update_file
 
+              # @param diff
+              #   Unified diff content to apply to the existing file.
+              # @param path
+              #   Path of the file to update relative to the workspace root.
+              # @param type
+              #   The operation type. Always `update_file`.
               def initialize: (
                 diff: String,
                 path: String,
@@ -1550,8 +2059,11 @@ module OpenAI
           type agent = { agent_name: String }
 
           class Agent < OpenAI::Internal::Type::BaseModel
+            # The canonical name of the agent that produced this item.
             attr_accessor agent_name: String
 
+            # @param agent_name
+            #   The canonical name of the agent that produced this item.
             def initialize: (agent_name: String) -> void
 
             def to_hash: -> { agent_name: String }
@@ -1567,8 +2079,11 @@ module OpenAI
             type direct = { ?type: :direct }
 
             class Direct < OpenAI::Internal::Type::BaseModel
+              # The caller type. Always `direct`.
               attr_accessor type: :direct
 
+              # @param type
+              #   The caller type. Always `direct`.
               def initialize: (?type: :direct) -> void
 
               def to_hash: -> { ?type: :direct }
@@ -1577,10 +2092,16 @@ module OpenAI
             type program = { caller_id: String, ?type: :program }
 
             class Program < OpenAI::Internal::Type::BaseModel
+              # The call ID of the program item that produced this tool call.
               attr_accessor caller_id: String
 
+              # The caller type. Always `program`.
               attr_accessor type: :program
 
+              # @param caller_id
+              #   The call ID of the program item that produced this tool call.
+              # @param type
+              #   The caller type. Always `program`.
               def initialize: (caller_id: String, ?type: :program) -> void
 
               def to_hash: -> { caller_id: String, ?type: :program }
@@ -1602,20 +2123,45 @@ module OpenAI
           }
 
         class ApplyPatchCallOutput < OpenAI::Internal::Type::BaseModel
+          # The unique ID of the apply patch tool call generated by the model.
           attr_accessor call_id: String
 
+          # The status of the apply patch tool call output. One of `completed` or `failed`.
           attr_accessor status: OpenAI::Models::Beta::BetaResponseInputItem::ApplyPatchCallOutput::status
 
+          # The type of the item. Always `apply_patch_call_output`.
           attr_accessor type: :apply_patch_call_output
 
+          # The unique ID of the apply patch tool call output. Populated when this item is
+          # returned via API.
           attr_accessor id: String?
 
+          # The agent that produced this item.
           attr_accessor agent: OpenAI::Beta::BetaResponseInputItem::ApplyPatchCallOutput::Agent?
 
+          # The execution context that produced this tool call.
           attr_accessor caller_: OpenAI::Models::Beta::BetaResponseInputItem::ApplyPatchCallOutput::caller_?
 
+          # Optional human-readable log text from the apply patch tool (e.g., patch results
+          # or errors).
           attr_accessor output: String?
 
+          # @param call_id
+          #   The unique ID of the apply patch tool call generated by the model.
+          # @param status
+          #   The status of the apply patch tool call output. One of `completed` or `failed`.
+          # @param id
+          #   The unique ID of the apply patch tool call output. Populated when this item is
+          #   returned via API.
+          # @param agent
+          #   The agent that produced this item.
+          # @param caller_
+          #   The execution context that produced this tool call.
+          # @param output
+          #   Optional human-readable log text from the apply patch tool (e.g., patch results
+          #   or errors).
+          # @param type
+          #   The type of the item. Always `apply_patch_call_output`.
           def initialize: (
             call_id: String,
             status: OpenAI::Models::Beta::BetaResponseInputItem::ApplyPatchCallOutput::status,
@@ -1650,8 +2196,11 @@ module OpenAI
           type agent = { agent_name: String }
 
           class Agent < OpenAI::Internal::Type::BaseModel
+            # The canonical name of the agent that produced this item.
             attr_accessor agent_name: String
 
+            # @param agent_name
+            #   The canonical name of the agent that produced this item.
             def initialize: (agent_name: String) -> void
 
             def to_hash: -> { agent_name: String }
@@ -1667,8 +2216,11 @@ module OpenAI
             type direct = { ?type: :direct }
 
             class Direct < OpenAI::Internal::Type::BaseModel
+              # The caller type. Always `direct`.
               attr_accessor type: :direct
 
+              # @param type
+              #   The caller type. Always `direct`.
               def initialize: (?type: :direct) -> void
 
               def to_hash: -> { ?type: :direct }
@@ -1677,10 +2229,16 @@ module OpenAI
             type program = { caller_id: String, ?type: :program }
 
             class Program < OpenAI::Internal::Type::BaseModel
+              # The call ID of the program item that produced this tool call.
               attr_accessor caller_id: String
 
+              # The caller type. Always `program`.
               attr_accessor type: :program
 
+              # @param caller_id
+              #   The call ID of the program item that produced this tool call.
+              # @param type
+              #   The caller type. Always `program`.
               def initialize: (caller_id: String, ?type: :program) -> void
 
               def to_hash: -> { caller_id: String, ?type: :program }
@@ -1701,18 +2259,36 @@ module OpenAI
           }
 
         class McpListTools < OpenAI::Internal::Type::BaseModel
+          # The unique ID of the list.
           attr_accessor id: String
 
+          # The label of the MCP server.
           attr_accessor server_label: String
 
+          # The tools available on the server.
           attr_accessor tools: ::Array[OpenAI::Beta::BetaResponseInputItem::McpListTools::Tool]
 
+          # The type of the item. Always `mcp_list_tools`.
           attr_accessor type: :mcp_list_tools
 
+          # The agent that produced this item.
           attr_accessor agent: OpenAI::Beta::BetaResponseInputItem::McpListTools::Agent?
 
+          # Error message if the server could not list tools.
           attr_accessor error: String?
 
+          # @param id
+          #   The unique ID of the list.
+          # @param server_label
+          #   The label of the MCP server.
+          # @param tools
+          #   The tools available on the server.
+          # @param agent
+          #   The agent that produced this item.
+          # @param error
+          #   Error message if the server could not list tools.
+          # @param type
+          #   The type of the item. Always `mcp_list_tools`.
           def initialize: (
             id: String,
             server_label: String,
@@ -1740,14 +2316,26 @@ module OpenAI
             }
 
           class Tool < OpenAI::Internal::Type::BaseModel
+            # The JSON schema describing the tool's input.
             attr_accessor input_schema: top
 
+            # The name of the tool.
             attr_accessor name: String
 
+            # Additional annotations about the tool.
             attr_accessor annotations: top?
 
+            # The description of the tool.
             attr_accessor description: String?
 
+            # @param input_schema
+            #   The JSON schema describing the tool's input.
+            # @param name
+            #   The name of the tool.
+            # @param annotations
+            #   Additional annotations about the tool.
+            # @param description
+            #   The description of the tool.
             def initialize: (
               input_schema: top,
               name: String,
@@ -1766,8 +2354,11 @@ module OpenAI
           type agent = { agent_name: String }
 
           class Agent < OpenAI::Internal::Type::BaseModel
+            # The canonical name of the agent that produced this item.
             attr_accessor agent_name: String
 
+            # @param agent_name
+            #   The canonical name of the agent that produced this item.
             def initialize: (agent_name: String) -> void
 
             def to_hash: -> { agent_name: String }
@@ -1785,18 +2376,36 @@ module OpenAI
           }
 
         class McpApprovalRequest < OpenAI::Internal::Type::BaseModel
+          # The unique ID of the approval request.
           attr_accessor id: String
 
+          # A JSON string of arguments for the tool.
           attr_accessor arguments: String
 
+          # The name of the tool to run.
           attr_accessor name: String
 
+          # The label of the MCP server making the request.
           attr_accessor server_label: String
 
+          # The type of the item. Always `mcp_approval_request`.
           attr_accessor type: :mcp_approval_request
 
+          # The agent that produced this item.
           attr_accessor agent: OpenAI::Beta::BetaResponseInputItem::McpApprovalRequest::Agent?
 
+          # @param id
+          #   The unique ID of the approval request.
+          # @param arguments
+          #   A JSON string of arguments for the tool.
+          # @param name
+          #   The name of the tool to run.
+          # @param server_label
+          #   The label of the MCP server making the request.
+          # @param agent
+          #   The agent that produced this item.
+          # @param type
+          #   The type of the item. Always `mcp_approval_request`.
           def initialize: (
             id: String,
             arguments: String,
@@ -1818,8 +2427,11 @@ module OpenAI
           type agent = { agent_name: String }
 
           class Agent < OpenAI::Internal::Type::BaseModel
+            # The canonical name of the agent that produced this item.
             attr_accessor agent_name: String
 
+            # @param agent_name
+            #   The canonical name of the agent that produced this item.
             def initialize: (agent_name: String) -> void
 
             def to_hash: -> { agent_name: String }
@@ -1837,18 +2449,36 @@ module OpenAI
           }
 
         class McpApprovalResponse < OpenAI::Internal::Type::BaseModel
+          # The ID of the approval request being answered.
           attr_accessor approval_request_id: String
 
+          # Whether the request was approved.
           attr_accessor approve: bool
 
+          # The type of the item. Always `mcp_approval_response`.
           attr_accessor type: :mcp_approval_response
 
+          # The unique ID of the approval response
           attr_accessor id: String?
 
+          # The agent that produced this item.
           attr_accessor agent: OpenAI::Beta::BetaResponseInputItem::McpApprovalResponse::Agent?
 
+          # Optional reason for the decision.
           attr_accessor reason: String?
 
+          # @param approval_request_id
+          #   The ID of the approval request being answered.
+          # @param approve
+          #   Whether the request was approved.
+          # @param id
+          #   The unique ID of the approval response
+          # @param agent
+          #   The agent that produced this item.
+          # @param reason
+          #   Optional reason for the decision.
+          # @param type
+          #   The type of the item. Always `mcp_approval_response`.
           def initialize: (
             approval_request_id: String,
             approve: bool,
@@ -1870,8 +2500,11 @@ module OpenAI
           type agent = { agent_name: String }
 
           class Agent < OpenAI::Internal::Type::BaseModel
+            # The canonical name of the agent that produced this item.
             attr_accessor agent_name: String
 
+            # @param agent_name
+            #   The canonical name of the agent that produced this item.
             def initialize: (agent_name: String) -> void
 
             def to_hash: -> { agent_name: String }
@@ -1893,30 +2526,68 @@ module OpenAI
           }
 
         class McpCall < OpenAI::Internal::Type::BaseModel
+          # The unique ID of the tool call.
           attr_accessor id: String
 
+          # A JSON string of the arguments passed to the tool.
           attr_accessor arguments: String
 
+          # The name of the tool that was run.
           attr_accessor name: String
 
+          # The label of the MCP server running the tool.
           attr_accessor server_label: String
 
+          # The type of the item. Always `mcp_call`.
           attr_accessor type: :mcp_call
 
+          # The agent that produced this item.
           attr_accessor agent: OpenAI::Beta::BetaResponseInputItem::McpCall::Agent?
 
+          # 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.
           attr_accessor approval_request_id: String?
 
+          # The error from the tool call, if any.
           attr_accessor error: OpenAI::Models::Beta::beta_mcp_tool_call_error?
 
+          # The output from the tool call.
           attr_accessor output: String?
 
+          # The status of the tool call. One of `in_progress`, `completed`, `incomplete`,
+          # `calling`, or `failed`.
           attr_reader status: OpenAI::Models::Beta::BetaResponseInputItem::McpCall::status?
 
+          # The status of the tool call. One of `in_progress`, `completed`, `incomplete`,
+          # `calling`, or `failed`.
           def status=: (
             OpenAI::Models::Beta::BetaResponseInputItem::McpCall::status
           ) -> OpenAI::Models::Beta::BetaResponseInputItem::McpCall::status
 
+          # @param id
+          #   The unique ID of the tool call.
+          # @param arguments
+          #   A JSON string of the arguments passed to the tool.
+          # @param name
+          #   The name of the tool that was run.
+          # @param server_label
+          #   The label of the MCP server running the tool.
+          # @param agent
+          #   The agent that produced this item.
+          # @param 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.
+          # @param error
+          #   The error from the tool call, if any.
+          # @param output
+          #   The output from the tool call.
+          # @param status
+          #   The status of the tool call. One of `in_progress`, `completed`, `incomplete`,
+          #   `calling`, or `failed`.
+          # @param type
+          #   The type of the item. Always `mcp_call`.
           def initialize: (
             id: String,
             arguments: String,
@@ -1946,8 +2617,11 @@ module OpenAI
           type agent = { agent_name: String }
 
           class Agent < OpenAI::Internal::Type::BaseModel
+            # The canonical name of the agent that produced this item.
             attr_accessor agent_name: String
 
+            # @param agent_name
+            #   The canonical name of the agent that produced this item.
             def initialize: (agent_name: String) -> void
 
             def to_hash: -> { agent_name: String }
@@ -1976,10 +2650,16 @@ module OpenAI
           }
 
         class CompactionTrigger < OpenAI::Internal::Type::BaseModel
+          # The type of the item. Always `compaction_trigger`.
           attr_accessor type: :compaction_trigger
 
+          # The agent that produced this item.
           attr_accessor agent: OpenAI::Beta::BetaResponseInputItem::CompactionTrigger::Agent?
 
+          # @param agent
+          #   The agent that produced this item.
+          # @param type
+          #   The type of the item. Always `compaction_trigger`.
           def initialize: (
             ?agent: OpenAI::Beta::BetaResponseInputItem::CompactionTrigger::Agent?,
             ?type: :compaction_trigger
@@ -1993,8 +2673,11 @@ module OpenAI
           type agent = { agent_name: String }
 
           class Agent < OpenAI::Internal::Type::BaseModel
+            # The canonical name of the agent that produced this item.
             attr_accessor agent_name: String
 
+            # @param agent_name
+            #   The canonical name of the agent that produced this item.
             def initialize: (agent_name: String) -> void
 
             def to_hash: -> { agent_name: String }
@@ -2009,12 +2692,21 @@ module OpenAI
           }
 
         class ItemReference < OpenAI::Internal::Type::BaseModel
+          # The ID of the item to reference.
           attr_accessor id: String
 
+          # The agent that produced this item.
           attr_accessor agent: OpenAI::Beta::BetaResponseInputItem::ItemReference::Agent?
 
+          # The type of item to reference. Always `item_reference`.
           attr_accessor type: OpenAI::Models::Beta::BetaResponseInputItem::ItemReference::type_?
 
+          # @param id
+          #   The ID of the item to reference.
+          # @param agent
+          #   The agent that produced this item.
+          # @param type
+          #   The type of item to reference. Always `item_reference`.
           def initialize: (
             id: String,
             ?agent: OpenAI::Beta::BetaResponseInputItem::ItemReference::Agent?,
@@ -2030,8 +2722,11 @@ module OpenAI
           type agent = { agent_name: String }
 
           class Agent < OpenAI::Internal::Type::BaseModel
+            # The canonical name of the agent that produced this item.
             attr_accessor agent_name: String
 
+            # @param agent_name
+            #   The canonical name of the agent that produced this item.
             def initialize: (agent_name: String) -> void
 
             def to_hash: -> { agent_name: String }
@@ -2059,18 +2754,36 @@ module OpenAI
           }
 
         class Program < OpenAI::Internal::Type::BaseModel
+          # The unique ID of this program item.
           attr_accessor id: String
 
+          # The stable call ID of the program item.
           attr_accessor call_id: String
 
+          # The JavaScript source executed by programmatic tool calling.
           attr_accessor code: String
 
+          # Opaque program replay fingerprint that must be round-tripped.
           attr_accessor fingerprint: String
 
+          # The item type. Always `program`.
           attr_accessor type: :program
 
+          # The agent that produced this item.
           attr_accessor agent: OpenAI::Beta::BetaResponseInputItem::Program::Agent?
 
+          # @param id
+          #   The unique ID of this program item.
+          # @param call_id
+          #   The stable call ID of the program item.
+          # @param code
+          #   The JavaScript source executed by programmatic tool calling.
+          # @param fingerprint
+          #   Opaque program replay fingerprint that must be round-tripped.
+          # @param agent
+          #   The agent that produced this item.
+          # @param type
+          #   The item type. Always `program`.
           def initialize: (
             id: String,
             call_id: String,
@@ -2092,8 +2805,11 @@ module OpenAI
           type agent = { agent_name: String }
 
           class Agent < OpenAI::Internal::Type::BaseModel
+            # The canonical name of the agent that produced this item.
             attr_accessor agent_name: String
 
+            # @param agent_name
+            #   The canonical name of the agent that produced this item.
             def initialize: (agent_name: String) -> void
 
             def to_hash: -> { agent_name: String }
@@ -2111,18 +2827,36 @@ module OpenAI
           }
 
         class ProgramOutput < OpenAI::Internal::Type::BaseModel
+          # The unique ID of this program output item.
           attr_accessor id: String
 
+          # The call ID of the program item.
           attr_accessor call_id: String
 
+          # The result produced by the program item.
           attr_accessor result: String
 
+          # The terminal status of the program output.
           attr_accessor status: OpenAI::Models::Beta::BetaResponseInputItem::ProgramOutput::status
 
+          # The item type. Always `program_output`.
           attr_accessor type: :program_output
 
+          # The agent that produced this item.
           attr_accessor agent: OpenAI::Beta::BetaResponseInputItem::ProgramOutput::Agent?
 
+          # @param id
+          #   The unique ID of this program output item.
+          # @param call_id
+          #   The call ID of the program item.
+          # @param result
+          #   The result produced by the program item.
+          # @param status
+          #   The terminal status of the program output.
+          # @param agent
+          #   The agent that produced this item.
+          # @param type
+          #   The item type. Always `program_output`.
           def initialize: (
             id: String,
             call_id: String,
@@ -2155,8 +2889,11 @@ module OpenAI
           type agent = { agent_name: String }
 
           class Agent < OpenAI::Internal::Type::BaseModel
+            # The canonical name of the agent that produced this item.
             attr_accessor agent_name: String
 
+            # @param agent_name
+            #   The canonical name of the agent that produced this item.
             def initialize: (agent_name: String) -> void
 
             def to_hash: -> { agent_name: String }