openai 0.92.0 → 0.93.0

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

@@ -10,14 +10,26 @@ module OpenAI
         }
 
       class ResponseMcpCallCompletedEvent < OpenAI::Internal::Type::BaseModel
+        # The ID of the MCP tool call item that completed.
         attr_accessor item_id: String
 
+        # The index of the output item that completed.
         attr_accessor output_index: Integer
 
+        # The sequence number of this event.
         attr_accessor sequence_number: Integer
 
+        # The type of the event. Always 'response.mcp_call.completed'.
         attr_accessor type: :"response.mcp_call.completed"
 
+        # @param item_id
+        #   The ID of the MCP tool call item that completed.
+        # @param output_index
+        #   The index of the output item that completed.
+        # @param sequence_number
+        #   The sequence number of this event.
+        # @param type
+        #   The type of the event. Always 'response.mcp_call.completed'.
         def initialize: (
           item_id: String,
           output_index: Integer,

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

@@ -10,14 +10,26 @@ module OpenAI
         }
 
       class ResponseMcpCallFailedEvent < OpenAI::Internal::Type::BaseModel
+        # The ID of the MCP tool call item that failed.
         attr_accessor item_id: String
 
+        # The index of the output item that failed.
         attr_accessor output_index: Integer
 
+        # The sequence number of this event.
         attr_accessor sequence_number: Integer
 
+        # The type of the event. Always 'response.mcp_call.failed'.
         attr_accessor type: :"response.mcp_call.failed"
 
+        # @param item_id
+        #   The ID of the MCP tool call item that failed.
+        # @param output_index
+        #   The index of the output item that failed.
+        # @param sequence_number
+        #   The sequence number of this event.
+        # @param type
+        #   The type of the event. Always 'response.mcp_call.failed'.
         def initialize: (
           item_id: String,
           output_index: Integer,

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

@@ -10,14 +10,26 @@ module OpenAI
         }
 
       class ResponseMcpCallInProgressEvent < OpenAI::Internal::Type::BaseModel
+        # The unique identifier of the MCP tool call item being processed.
         attr_accessor item_id: String
 
+        # The index of the output item in the response's output array.
         attr_accessor output_index: Integer
 
+        # The sequence number of this event.
         attr_accessor sequence_number: Integer
 
+        # The type of the event. Always 'response.mcp_call.in_progress'.
         attr_accessor type: :"response.mcp_call.in_progress"
 
+        # @param item_id
+        #   The unique identifier of the MCP tool call item being processed.
+        # @param output_index
+        #   The index of the output item in the response's output array.
+        # @param sequence_number
+        #   The sequence number of this event.
+        # @param type
+        #   The type of the event. Always 'response.mcp_call.in_progress'.
         def initialize: (
           item_id: String,
           output_index: Integer,

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

@@ -10,14 +10,26 @@ module OpenAI
         }
 
       class ResponseMcpListToolsCompletedEvent < OpenAI::Internal::Type::BaseModel
+        # The ID of the MCP tool call item that produced this output.
         attr_accessor item_id: String
 
+        # The index of the output item that was processed.
         attr_accessor output_index: Integer
 
+        # The sequence number of this event.
         attr_accessor sequence_number: Integer
 
+        # The type of the event. Always 'response.mcp_list_tools.completed'.
         attr_accessor type: :"response.mcp_list_tools.completed"
 
+        # @param item_id
+        #   The ID of the MCP tool call item that produced this output.
+        # @param output_index
+        #   The index of the output item that was processed.
+        # @param sequence_number
+        #   The sequence number of this event.
+        # @param type
+        #   The type of the event. Always 'response.mcp_list_tools.completed'.
         def initialize: (
           item_id: String,
           output_index: Integer,

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

@@ -10,14 +10,26 @@ module OpenAI
         }
 
       class ResponseMcpListToolsFailedEvent < OpenAI::Internal::Type::BaseModel
+        # The ID of the MCP tool call item that failed.
         attr_accessor item_id: String
 
+        # The index of the output item that failed.
         attr_accessor output_index: Integer
 
+        # The sequence number of this event.
         attr_accessor sequence_number: Integer
 
+        # The type of the event. Always 'response.mcp_list_tools.failed'.
         attr_accessor type: :"response.mcp_list_tools.failed"
 
+        # @param item_id
+        #   The ID of the MCP tool call item that failed.
+        # @param output_index
+        #   The index of the output item that failed.
+        # @param sequence_number
+        #   The sequence number of this event.
+        # @param type
+        #   The type of the event. Always 'response.mcp_list_tools.failed'.
         def initialize: (
           item_id: String,
           output_index: Integer,

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

@@ -10,14 +10,26 @@ module OpenAI
         }
 
       class ResponseMcpListToolsInProgressEvent < OpenAI::Internal::Type::BaseModel
+        # The ID of the MCP tool call item that is being processed.
         attr_accessor item_id: String
 
+        # The index of the output item that is being processed.
         attr_accessor output_index: Integer
 
+        # The sequence number of this event.
         attr_accessor sequence_number: Integer
 
+        # The type of the event. Always 'response.mcp_list_tools.in_progress'.
         attr_accessor type: :"response.mcp_list_tools.in_progress"
 
+        # @param item_id
+        #   The ID of the MCP tool call item that is being processed.
+        # @param output_index
+        #   The index of the output item that is being processed.
+        # @param sequence_number
+        #   The sequence number of this event.
+        # @param type
+        #   The type of the event. Always 'response.mcp_list_tools.in_progress'.
         def initialize: (
           item_id: String,
           output_index: Integer,

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

@@ -5,12 +5,21 @@ module OpenAI
         { data: String, transcript: String, ?type: :output_audio }
 
       class ResponseOutputAudio < OpenAI::Internal::Type::BaseModel
+        # Base64-encoded audio data from the model.
         attr_accessor data: String
 
+        # The transcript of the audio data from the model.
         attr_accessor transcript: String
 
+        # The type of the output audio. Always `output_audio`.
         attr_accessor type: :output_audio
 
+        # @param data
+        #   Base64-encoded audio data from the model.
+        # @param transcript
+        #   The transcript of the audio data from the model.
+        # @param type
+        #   The type of the output audio. Always `output_audio`.
         def initialize: (
           data: String,
           transcript: String,

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

@@ -44,16 +44,31 @@ module OpenAI
           }
 
         class Program < OpenAI::Internal::Type::BaseModel
+          # The unique ID of the 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 type of the item. Always `program`.
           attr_accessor type: :program
 
+          # @param id
+          #   The unique ID of the 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 type
+          #   The type of the item. Always `program`.
           def initialize: (
             id: String,
             call_id: String,
@@ -81,16 +96,31 @@ module OpenAI
           }
 
         class ProgramOutput < OpenAI::Internal::Type::BaseModel
+          # The unique ID of the 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 item.
           attr_accessor status: OpenAI::Models::Responses::ResponseOutputItem::ProgramOutput::status
 
+          # The type of the item. Always `program_output`.
           attr_accessor type: :program_output
 
+          # @param id
+          #   The unique ID of the 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 item.
+          # @param type
+          #   The type of the item. Always `program_output`.
           def initialize: (
             id: String,
             call_id: String,
@@ -128,14 +158,26 @@ module OpenAI
           }
 
         class AdditionalTools < OpenAI::Internal::Type::BaseModel
+          # The unique ID of the additional tools item.
           attr_accessor id: String
 
+          # The role that provided the additional tools.
           attr_accessor role: OpenAI::Models::Responses::ResponseOutputItem::AdditionalTools::role
 
+          # The additional tool definitions made available at this item.
           attr_accessor tools: ::Array[OpenAI::Models::Responses::tool]
 
+          # The type of the item. Always `additional_tools`.
           attr_accessor type: :additional_tools
 
+          # @param id
+          #   The unique ID of the additional tools item.
+          # @param role
+          #   The role that provided the additional tools.
+          # @param tools
+          #   The additional tool definitions made available at this item.
+          # @param type
+          #   The type of the item. Always `additional_tools`.
           def initialize: (
             id: String,
             role: OpenAI::Models::Responses::ResponseOutputItem::AdditionalTools::role,
@@ -191,26 +233,58 @@ 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::Responses::ResponseOutputItem::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::Responses::ResponseOutputItem::ImageGenerationCall::action?
 
+          # The background setting used for generation.
           attr_accessor background: OpenAI::Models::Responses::ResponseOutputItem::ImageGenerationCall::background?
 
+          # The output format used for generation.
           attr_accessor output_format: OpenAI::Models::Responses::ResponseOutputItem::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::Responses::ResponseOutputItem::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::Responses::ResponseOutputItem::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 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?,
@@ -324,16 +398,31 @@ 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::Responses::ResponseOutputItem::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::Responses::ResponseOutputItem::LocalShellCall::status
 
+          # The type of the local shell call. Always `local_shell_call`.
           attr_accessor type: :local_shell_call
 
+          # @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 type
+          #   The type of the local shell call. Always `local_shell_call`.
           def initialize: (
             id: String,
             action: OpenAI::Responses::ResponseOutputItem::LocalShellCall::Action,
@@ -361,18 +450,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],
@@ -414,14 +521,26 @@ 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 status of the item. One of `in_progress`, `completed`, or `incomplete`.
           attr_accessor status: OpenAI::Models::Responses::ResponseOutputItem::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 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,
@@ -463,28 +582,63 @@ 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
 
+          # 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::Responses::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::Responses::ResponseOutputItem::McpCall::status?
 
+          # The status of the tool call. One of `in_progress`, `completed`, `incomplete`,
+          # `calling`, or `failed`.
           def status=: (
             OpenAI::Models::Responses::ResponseOutputItem::McpCall::status
           ) -> OpenAI::Models::Responses::ResponseOutputItem::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 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,
@@ -535,16 +689,31 @@ 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::Responses::ResponseOutputItem::McpListTools::Tool]
 
+          # The type of the item. Always `mcp_list_tools`.
           attr_accessor type: :mcp_list_tools
 
+          # 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 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,
@@ -570,14 +739,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,
@@ -604,16 +785,31 @@ 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
 
+          # @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 type
+          #   The type of the item. Always `mcp_approval_request`.
           def initialize: (
             id: String,
             arguments: String,
@@ -641,16 +837,31 @@ module OpenAI
           }
 
         class McpApprovalResponse < OpenAI::Internal::Type::BaseModel
+          # The unique ID of the approval response
           attr_accessor id: String
 
+          # 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
 
+          # Optional reason for the decision.
           attr_accessor reason: String?
 
+          # @param id
+          #   The unique ID of the approval response
+          # @param approval_request_id
+          #   The ID of the approval request being answered.
+          # @param approve
+          #   Whether the request was approved.
+          # @param reason
+          #   Optional reason for the decision.
+          # @param type
+          #   The type of the item. Always `mcp_approval_response`.
           def initialize: (
             id: String,
             approval_request_id: String,

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

@@ -10,14 +10,32 @@ module OpenAI
         }
 
       class ResponseOutputItemAddedEvent < OpenAI::Internal::Type::BaseModel
+        # The output item that was added. For reasoning items, `encrypted_content` may be
+        # incomplete while the item is in progress. Use the reasoning item from the
+        # corresponding `response.output_item.done` event when passing it as input to a
+        # subsequent request.
         attr_accessor item: OpenAI::Models::Responses::response_output_item
 
+        # The index of the output item that was added.
         attr_accessor output_index: Integer
 
+        # The sequence number of this event.
         attr_accessor sequence_number: Integer
 
+        # The type of the event. Always `response.output_item.added`.
         attr_accessor type: :"response.output_item.added"
 
+        # @param item
+        #   The output item that was added. For reasoning items, `encrypted_content` may be
+        #   incomplete while the item is in progress. Use the reasoning item from the
+        #   corresponding `response.output_item.done` event when passing it as input to a
+        #   subsequent request.
+        # @param output_index
+        #   The index of the output item that was added.
+        # @param sequence_number
+        #   The sequence number of this event.
+        # @param type
+        #   The type of the event. Always `response.output_item.added`.
         def initialize: (
           item: OpenAI::Models::Responses::response_output_item,
           output_index: Integer,

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

@@ -10,14 +10,26 @@ module OpenAI
         }
 
       class ResponseOutputItemDoneEvent < OpenAI::Internal::Type::BaseModel
+        # The output item that was marked done.
         attr_accessor item: OpenAI::Models::Responses::response_output_item
 
+        # The index of the output item that was marked done.
         attr_accessor output_index: Integer
 
+        # The sequence number of this event.
         attr_accessor sequence_number: Integer
 
+        # The type of the event. Always `response.output_item.done`.
         attr_accessor type: :"response.output_item.done"
 
+        # @param item
+        #   The output item that was marked done.
+        # @param output_index
+        #   The index of the output item that was marked done.
+        # @param sequence_number
+        #   The sequence number of this event.
+        # @param type
+        #   The type of the event. Always `response.output_item.done`.
         def initialize: (
           item: OpenAI::Models::Responses::response_output_item,
           output_index: Integer,