openai 0.92.0 → 0.94.0

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

@@ -17,30 +17,65 @@ module OpenAI
         }
 
       class BetaResponseFunctionShellToolCallOutput < OpenAI::Internal::Type::BaseModel
+        # The unique ID of the shell call output. Populated when this item is returned via
+        # API.
         attr_accessor id: String
 
+        # The unique ID of the shell tool call generated by the model.
         attr_accessor call_id: String
 
+        # The maximum length of the shell command output. This is generated by the model
+        # and should be passed back with the raw output.
         attr_accessor max_output_length: Integer?
 
+        # An array of shell call output contents
         attr_accessor output: ::Array[OpenAI::Beta::BetaResponseFunctionShellToolCallOutput::Output]
 
+        # The status of the shell call output. One of `in_progress`, `completed`, or
+        # `incomplete`.
         attr_accessor status: OpenAI::Models::Beta::BetaResponseFunctionShellToolCallOutput::status
 
+        # The type of the shell call output. Always `shell_call_output`.
         attr_accessor type: :shell_call_output
 
+        # The agent that produced this item.
         attr_reader agent: OpenAI::Beta::BetaResponseFunctionShellToolCallOutput::Agent?
 
+        # The agent that produced this item.
         def agent=: (
           OpenAI::Beta::BetaResponseFunctionShellToolCallOutput::Agent
         ) -> OpenAI::Beta::BetaResponseFunctionShellToolCallOutput::Agent
 
+        # The execution context that produced this tool call.
         attr_accessor caller_: OpenAI::Models::Beta::BetaResponseFunctionShellToolCallOutput::caller_?
 
+        # The identifier of the actor that created the item.
         attr_reader created_by: String?
 
+        # The identifier of the actor that created the item.
         def created_by=: (String) -> String
 
+        # @param id
+        #   The unique ID of the shell call output. Populated when this item is returned via
+        #   API.
+        # @param call_id
+        #   The unique ID of the shell tool call generated by the model.
+        # @param max_output_length
+        #   The maximum length of the shell command output. This is generated by the model
+        #   and should be passed back with the raw output.
+        # @param output
+        #   An array of shell call output contents
+        # @param status
+        #   The status of the shell call output. One of `in_progress`, `completed`, or
+        #   `incomplete`.
+        # @param agent
+        #   The agent that produced this item.
+        # @param caller_
+        #   The execution context that produced this tool call.
+        # @param created_by
+        #   The identifier of the actor that created the item.
+        # @param type
+        #   The type of the shell call output. Always `shell_call_output`.
         def initialize: (
           id: String,
           call_id: String,
@@ -74,16 +109,31 @@ module OpenAI
           }
 
         class Output < OpenAI::Internal::Type::BaseModel
+          # Represents either an exit outcome (with an exit code) or a timeout outcome for a
+          # shell call output chunk.
           attr_accessor outcome: OpenAI::Models::Beta::BetaResponseFunctionShellToolCallOutput::Output::outcome
 
+          # The standard error output that was captured.
           attr_accessor stderr: String
 
+          # The standard output that was captured.
           attr_accessor stdout: String
 
+          # The identifier of the actor that created the item.
           attr_reader created_by: String?
 
+          # The identifier of the actor that created the item.
           def created_by=: (String) -> String
 
+          # @param outcome
+          #   Represents either an exit outcome (with an exit code) or a timeout outcome for a
+          #   shell call output chunk.
+          # @param stderr
+          #   The standard error output that was captured.
+          # @param stdout
+          #   The standard output that was captured.
+          # @param created_by
+          #   The identifier of the actor that created the item.
           def initialize: (
             outcome: OpenAI::Models::Beta::BetaResponseFunctionShellToolCallOutput::Output::outcome,
             stderr: String,
@@ -108,8 +158,11 @@ module OpenAI
             type timeout = { ?type: :timeout }
 
             class Timeout < OpenAI::Internal::Type::BaseModel
+              # The outcome type. Always `timeout`.
               attr_accessor type: :timeout
 
+              # @param type
+              #   The outcome type. Always `timeout`.
               def initialize: (?type: :timeout) -> void
 
               def to_hash: -> { ?type: :timeout }
@@ -118,10 +171,16 @@ module OpenAI
             type exit_ = { exit_code: Integer, ?type: :exit }
 
             class Exit < OpenAI::Internal::Type::BaseModel
+              # Exit code from the shell process.
               attr_accessor exit_code: Integer
 
+              # The outcome type. Always `exit`.
               attr_accessor type: :exit
 
+              # @param exit_code
+              #   Exit code from the shell process.
+              # @param type
+              #   The outcome type. Always `exit`.
               def initialize: (exit_code: Integer, ?type: :exit) -> void
 
               def to_hash: -> { exit_code: Integer, ?type: :exit }
@@ -146,8 +205,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 }
@@ -173,10 +235,13 @@ 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
 
             attr_accessor type: :program
 
+            # @param caller_id
+            #   The call ID of the program item that produced this tool call.
             def initialize: (caller_id: String, ?type: :program) -> void
 
             def to_hash: -> { caller_id: String, ?type: :program }

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

@@ -18,36 +18,73 @@ module OpenAI
         }
 
       class BetaResponseFunctionToolCall < OpenAI::Internal::Type::BaseModel
+        # A JSON string of the arguments to pass to the function.
         attr_accessor arguments: String
 
+        # The unique ID of the function tool call generated by the model.
         attr_accessor call_id: String
 
+        # The name of the function to run.
         attr_accessor name: String
 
+        # The type of the function tool call. Always `function_call`.
         attr_accessor type: :function_call
 
+        # The unique ID of the function tool call.
         attr_reader id: String?
 
+        # The unique ID of the function tool call.
         def id=: (String) -> String
 
+        # The agent that produced this item.
         attr_accessor agent: OpenAI::Beta::BetaResponseFunctionToolCall::Agent?
 
+        # Whether the function tool call runs asynchronously.
         attr_reader async: bool?
 
+        # Whether the function tool call runs asynchronously.
         def async=: (bool) -> bool
 
+        # The execution context that produced this tool call.
         attr_accessor caller_: OpenAI::Models::Beta::BetaResponseFunctionToolCall::caller_?
 
+        # The namespace of the function to run.
         attr_reader namespace: String?
 
+        # The namespace of the function to run.
         def namespace=: (String) -> String
 
+        # The status of the item. One of `in_progress`, `completed`, or `incomplete`.
+        # Populated when items are returned via API.
         attr_reader status: OpenAI::Models::Beta::BetaResponseFunctionToolCall::status?
 
+        # The status of the item. One of `in_progress`, `completed`, or `incomplete`.
+        # Populated when items are returned via API.
         def status=: (
           OpenAI::Models::Beta::BetaResponseFunctionToolCall::status
         ) -> OpenAI::Models::Beta::BetaResponseFunctionToolCall::status
 
+        # @param arguments
+        #   A JSON string of the arguments to pass to the function.
+        # @param call_id
+        #   The unique ID of the function tool call generated by the model.
+        # @param name
+        #   The name of the function to run.
+        # @param id
+        #   The unique ID of the function tool call.
+        # @param agent
+        #   The agent that produced this item.
+        # @param async
+        #   Whether the function tool call runs asynchronously.
+        # @param caller_
+        #   The execution context that produced this tool call.
+        # @param namespace
+        #   The namespace of the function to run.
+        # @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. Always `function_call`.
         def initialize: (
           arguments: String,
           call_id: String,
@@ -77,8 +114,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 }
@@ -104,10 +144,13 @@ 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
 
             attr_accessor type: :program
 
+            # @param caller_id
+            #   The call ID of the program item that produced this tool call.
             def initialize: (caller_id: String, ?type: :program) -> void
 
             def to_hash: -> { caller_id: String, ?type: :program }

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

@@ -19,20 +19,51 @@ module OpenAI
         }
 
       class BetaResponseFunctionToolCallItem < OpenAI::Models::Beta::BetaResponseFunctionToolCall
+        # The unique ID of the function tool call.
         def id: -> String
 
+        # The unique ID of the function tool call.
         def id=: (String _) -> String
 
+        # The status of the item. One of `in_progress`, `completed`, or `incomplete`.
+        # Populated when items are returned via API.
         def status: -> OpenAI::Models::Beta::BetaResponseFunctionToolCallItem::status
 
+        # The status of the item. One of `in_progress`, `completed`, or `incomplete`.
+        # Populated when items are returned via API.
         def status=: (
           OpenAI::Models::Beta::BetaResponseFunctionToolCallItem::status _
         ) -> OpenAI::Models::Beta::BetaResponseFunctionToolCallItem::status
 
+        # The identifier of the actor that created the item.
         def created_by: -> String?
 
+        # The identifier of the actor that created the item.
         def created_by=: (String _) -> String
 
+        # @param arguments
+        #   A JSON string of the arguments to pass to the function.
+        # @param call_id
+        #   The unique ID of the function tool call generated by the model.
+        # @param name
+        #   The name of the function to run.
+        # @param id
+        #   The unique ID of the function tool call.
+        # @param status
+        #   The status of the item. One of `in_progress`, `completed`, or `incomplete`.
+        #   Populated when items are returned via API.
+        # @param agent
+        #   The agent that produced this item.
+        # @param async
+        #   Whether the function tool call runs asynchronously.
+        # @param caller_
+        #   The execution context that produced this tool call.
+        # @param namespace
+        #   The namespace of the function to run.
+        # @param created_by
+        #   The identifier of the actor that created the item.
+        # @param type
+        #   The type of the function tool call. Always `function_call`.
         def initialize: (
           arguments: String,
           call_id: String,

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

@@ -18,34 +18,72 @@ module OpenAI
         }
 
       class BetaResponseFunctionToolCallOutputItem < OpenAI::Internal::Type::BaseModel
+        # The unique ID of the function call tool output.
         attr_accessor id: String
 
+        # The output from the function call generated by your code. Can be a string or an
+        # list of output content.
         attr_accessor output: OpenAI::Models::Beta::BetaResponseFunctionToolCallOutputItem::output
 
+        # 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::BetaResponseFunctionToolCallOutputItem::status
 
+        # The type of the function tool call output. Always `function_call_output`.
         attr_accessor type: :function_call_output
 
+        # The agent that produced this item.
         attr_accessor agent: OpenAI::Beta::BetaResponseFunctionToolCallOutputItem::Agent?
 
+        # The unique ID of the function tool call generated by the model.
         attr_reader call_id: String?
 
+        # The unique ID of the function tool call generated by the model.
         def call_id=: (String) -> String
 
+        # The execution context that produced this tool call.
         attr_accessor caller_: OpenAI::Models::Beta::BetaResponseFunctionToolCallOutputItem::caller_?
 
+        # The identifier of the actor that created the item.
         attr_reader created_by: String?
 
+        # The identifier of the actor that created the item.
         def created_by=: (String) -> String
 
+        # The name of the tool that produced the output.
         attr_reader name: String?
 
+        # The name of the tool that produced the output.
         def name=: (String) -> String
 
+        # The namespace of the tool that produced the output.
         attr_reader namespace: String?
 
+        # The namespace of the tool that produced the output.
         def namespace=: (String) -> String
 
+        # @param id
+        #   The unique ID of the function call tool output.
+        # @param output
+        #   The output from the function call generated by your code. Can be a string or an
+        #   list of output content.
+        # @param status
+        #   The status of the item. One of `in_progress`, `completed`, or `incomplete`.
+        #   Populated when items are 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 created_by
+        #   The identifier of the actor that created the item.
+        # @param name
+        #   The name of the tool that produced the output.
+        # @param namespace
+        #   The namespace of the tool that produced the output.
+        # @param type
+        #   The type of the function tool call output. Always `function_call_output`.
         def initialize: (
           id: String,
           output: OpenAI::Models::Beta::BetaResponseFunctionToolCallOutputItem::output,
@@ -110,8 +148,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 }
@@ -127,8 +168,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 }
@@ -137,10 +181,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 }

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

@@ -13,16 +13,33 @@ module OpenAI
         }
 
       class BetaResponseFunctionWebSearch < OpenAI::Internal::Type::BaseModel
+        # The unique ID of the web search tool call.
         attr_accessor id: String
 
+        # An object describing the specific action taken in this web search call. Includes
+        # details on how the model used the web (search, open_page, find_in_page).
         attr_accessor action: OpenAI::Models::Beta::BetaResponseFunctionWebSearch::action
 
+        # The status of the web search tool call.
         attr_accessor status: OpenAI::Models::Beta::BetaResponseFunctionWebSearch::status
 
+        # The type of the web search tool call. Always `web_search_call`.
         attr_accessor type: :web_search_call
 
+        # The agent that produced this item.
         attr_accessor agent: OpenAI::Beta::BetaResponseFunctionWebSearch::Agent?
 
+        # @param id
+        #   The unique ID of the web search tool call.
+        # @param action
+        #   An object describing the specific action taken in this web search call. Includes
+        #   details on how the model used the web (search, open_page, find_in_page).
+        # @param status
+        #   The status of the web search tool call.
+        # @param agent
+        #   The agent that produced this item.
+        # @param type
+        #   The type of the web search tool call. Always `web_search_call`.
         def initialize: (
           id: String,
           action: OpenAI::Models::Beta::BetaResponseFunctionWebSearch::action,
@@ -56,22 +73,37 @@ module OpenAI
             }
 
           class Search < OpenAI::Internal::Type::BaseModel
+            # The action type.
             attr_accessor type: :search
 
+            # The search queries.
             attr_reader queries: ::Array[String]?
 
+            # The search queries.
             def queries=: (::Array[String]) -> ::Array[String]
 
+            # The search query.
             attr_reader query: String?
 
+            # The search query.
             def query=: (String) -> String
 
+            # The sources used in the search.
             attr_reader sources: ::Array[OpenAI::Beta::BetaResponseFunctionWebSearch::Action::Search::Source]?
 
+            # The sources used in the search.
             def sources=: (
               ::Array[OpenAI::Beta::BetaResponseFunctionWebSearch::Action::Search::Source]
             ) -> ::Array[OpenAI::Beta::BetaResponseFunctionWebSearch::Action::Search::Source]
 
+            # @param queries
+            #   The search queries.
+            # @param query
+            #   The search query.
+            # @param sources
+            #   The sources used in the search.
+            # @param type
+            #   The action type.
             def initialize: (
               ?queries: ::Array[String],
               ?query: String,
@@ -89,10 +121,16 @@ module OpenAI
             type source = { ?type: :url, url: String }
 
             class Source < OpenAI::Internal::Type::BaseModel
+              # The type of source. Always `url`.
               attr_accessor type: :url
 
+              # The URL of the source.
               attr_accessor url: String
 
+              # @param url
+              #   The URL of the source.
+              # @param type
+              #   The type of source. Always `url`.
               def initialize: (url: String, ?type: :url) -> void
 
               def to_hash: -> { ?type: :url, url: String }
@@ -102,10 +140,16 @@ module OpenAI
           type open_page = { ?type: :open_page, ?url: String? }
 
           class OpenPage < OpenAI::Internal::Type::BaseModel
+            # The action type.
             attr_accessor type: :open_page
 
+            # The URL opened by the model.
             attr_accessor url: String?
 
+            # @param url
+            #   The URL opened by the model.
+            # @param type
+            #   The action type.
             def initialize: (?url: String?, ?type: :open_page) -> void
 
             def to_hash: -> { ?type: :open_page, ?url: String? }
@@ -115,12 +159,21 @@ module OpenAI
             { pattern: String, ?type: :find_in_page, url: String }
 
           class FindInPage < OpenAI::Internal::Type::BaseModel
+            # The pattern or text to search for within the page.
             attr_accessor pattern: String
 
+            # The action type.
             attr_accessor type: :find_in_page
 
+            # The URL of the page searched for the pattern.
             attr_accessor url: String
 
+            # @param pattern
+            #   The pattern or text to search for within the page.
+            # @param url
+            #   The URL of the page searched for the pattern.
+            # @param type
+            #   The action type.
             def initialize: (
               pattern: String,
               url: String,
@@ -155,8 +208,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 }

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

@@ -13,16 +13,31 @@ module OpenAI
         }
 
       class BetaResponseImageGenCallCompletedEvent < OpenAI::Internal::Type::BaseModel
+        # The unique identifier of the image generation 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.image_generation_call.completed'.
         attr_accessor type: :"response.image_generation_call.completed"
 
+        # The agent that owns this multi-agent streaming event.
         attr_accessor agent: OpenAI::Beta::BetaResponseImageGenCallCompletedEvent::Agent?
 
+        # @param item_id
+        #   The unique identifier of the image generation 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 agent
+        #   The agent that owns this multi-agent streaming event.
+        # @param type
+        #   The type of the event. Always 'response.image_generation_call.completed'.
         def initialize: (
           item_id: String,
           output_index: Integer,
@@ -42,8 +57,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 }

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

@@ -13,16 +13,31 @@ module OpenAI
         }
 
       class BetaResponseImageGenCallGeneratingEvent < OpenAI::Internal::Type::BaseModel
+        # The unique identifier of the image generation 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 the image generation item being processed.
         attr_accessor sequence_number: Integer
 
+        # The type of the event. Always 'response.image_generation_call.generating'.
         attr_accessor type: :"response.image_generation_call.generating"
 
+        # The agent that owns this multi-agent streaming event.
         attr_accessor agent: OpenAI::Beta::BetaResponseImageGenCallGeneratingEvent::Agent?
 
+        # @param item_id
+        #   The unique identifier of the image generation 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 the image generation item being processed.
+        # @param agent
+        #   The agent that owns this multi-agent streaming event.
+        # @param type
+        #   The type of the event. Always 'response.image_generation_call.generating'.
         def initialize: (
           item_id: String,
           output_index: Integer,
@@ -42,8 +57,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 }

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

@@ -13,16 +13,31 @@ module OpenAI
         }
 
       class BetaResponseImageGenCallInProgressEvent < OpenAI::Internal::Type::BaseModel
+        # The unique identifier of the image generation 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 the image generation item being processed.
         attr_accessor sequence_number: Integer
 
+        # The type of the event. Always 'response.image_generation_call.in_progress'.
         attr_accessor type: :"response.image_generation_call.in_progress"
 
+        # The agent that owns this multi-agent streaming event.
         attr_accessor agent: OpenAI::Beta::BetaResponseImageGenCallInProgressEvent::Agent?
 
+        # @param item_id
+        #   The unique identifier of the image generation 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 the image generation item being processed.
+        # @param agent
+        #   The agent that owns this multi-agent streaming event.
+        # @param type
+        #   The type of the event. Always 'response.image_generation_call.in_progress'.
         def initialize: (
           item_id: String,
           output_index: Integer,
@@ -42,8 +57,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 }