openai 0.89.0 → 0.90.0

data/lib/openai/models/beta/agent_output_command_execution_output_delta_event.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Beta
+      class AgentOutputCommandExecutionOutputDeltaEvent < OpenAI::Internal::Type::BaseModel
+        # @!attribute delta
+        #   The output text that was appended.
+        #
+        #   @return [String]
+        required :delta, String
+
+        # @!attribute event_id
+        #   The unique ID of the event.
+        #
+        #   @return [String]
+        required :event_id, String
+
+        # @!attribute item_id
+        #   The ID of the command execution item.
+        #
+        #   @return [String]
+        required :item_id, String
+
+        # @!attribute output_index
+        #   The index of the item in the turn output.
+        #
+        #   @return [Integer]
+        required :output_index, Integer
+
+        # @!attribute session_id
+        #   The ID of the session associated with the event.
+        #
+        #   @return [String]
+        required :session_id, String
+
+        # @!attribute turn_id
+        #   The ID of the turn associated with the event, when applicable.
+        #
+        #   @return [String, nil]
+        required :turn_id, String, nil?: true
+
+        # @!attribute type
+        #   The type of the object. Always `agent.output.command_execution_output.delta`.
+        #
+        #   @return [Symbol, :"agent.output.command_execution_output.delta"]
+        required :type, const: :"agent.output.command_execution_output.delta"
+
+        # @!method initialize(delta:, event_id:, item_id:, output_index:, session_id:, turn_id:, type: :"agent.output.command_execution_output.delta")
+        #   Emitted when command execution produces an output delta.
+        #
+        #   @param delta [String]
+        #     The output text that was appended.
+        #
+        #   @param event_id [String]
+        #     The unique ID of the event.
+        #
+        #   @param item_id [String]
+        #     The ID of the command execution item.
+        #
+        #   @param output_index [Integer]
+        #     The index of the item in the turn output.
+        #
+        #   @param session_id [String]
+        #     The ID of the session associated with the event.
+        #
+        #   @param turn_id [String, nil]
+        #     The ID of the turn associated with the event, when applicable.
+        #
+        #   @param type [Symbol, :"agent.output.command_execution_output.delta"]
+        #     The type of the object. Always `agent.output.command_execution_output.delta`.
+      end
+    end
+  end
+end

data/lib/openai/models/beta/agent_output_item.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Beta
+      # An output item produced by an agent.
+      module AgentOutputItem
+        extend OpenAI::Internal::Type::Union
+
+        discriminator :type
+
+        # An assistant message produced by the agent.
+        variant :message, -> { OpenAI::Beta::AgentSessionAssistantMessage }
+
+        # A reasoning item produced by the agent.
+        variant :reasoning, -> { OpenAI::Beta::AgentReasoningItem }
+
+        # A function call produced by the agent.
+        variant :function_call, -> { OpenAI::Beta::AgentFunctionCallItem }
+
+        # A call to a tool on an MCP server.
+        variant :mcp_call, -> { OpenAI::Beta::AgentMcpCallItem }
+
+        # A web search call produced by the agent.
+        variant :web_search_call, -> { OpenAI::Beta::AgentWebSearchCallItem }
+
+        # A command execution produced by the agent.
+        variant :command_execution, -> { OpenAI::Beta::AgentCommandExecutionItem }
+
+        # A request to spawn a subagent.
+        variant :create_subagent_call, -> { OpenAI::Beta::AgentCreateSubagentCallItem }
+
+        # A request to send input to another agent.
+        variant :send_subagent_input_call, -> { OpenAI::Beta::AgentSendSubagentInputCallItem }
+
+        # A request to resume a subagent.
+        variant :resume_subagent_call, -> { OpenAI::Beta::AgentResumeSubagentCallItem }
+
+        # A request to wait for one or more subagents.
+        variant :wait_for_subagents_call, -> { OpenAI::Beta::AgentWaitForSubagentsCallItem }
+
+        # A request to interrupt a subagent's current turn. The subagent remains available.
+        variant :interrupt_subagent_call, -> { OpenAI::Beta::AgentInterruptSubagentCallItem }
+
+        # A request to close a subagent.
+        variant :close_subagent_call, -> { OpenAI::Beta::AgentCloseSubagentCallItem }
+
+        # @!method self.variants
+        #   @return [Array(OpenAI::Models::Beta::AgentSessionAssistantMessage, OpenAI::Models::Beta::AgentReasoningItem, OpenAI::Models::Beta::AgentFunctionCallItem, OpenAI::Models::Beta::AgentMcpCallItem, OpenAI::Models::Beta::AgentWebSearchCallItem, OpenAI::Models::Beta::AgentCommandExecutionItem, OpenAI::Models::Beta::AgentCreateSubagentCallItem, OpenAI::Models::Beta::AgentSendSubagentInputCallItem, OpenAI::Models::Beta::AgentResumeSubagentCallItem, OpenAI::Models::Beta::AgentWaitForSubagentsCallItem, OpenAI::Models::Beta::AgentInterruptSubagentCallItem, OpenAI::Models::Beta::AgentCloseSubagentCallItem)]
+      end
+    end
+  end
+end

data/lib/openai/models/beta/agent_output_item_status.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Beta
+      # The status of an agent output item.
+      module AgentOutputItemStatus
+        extend OpenAI::Internal::Type::Enum
+
+        # The item is in progress.
+        IN_PROGRESS = :in_progress
+
+        # The item is complete.
+        COMPLETED = :completed
+
+        # The item stopped before completing.
+        INCOMPLETE = :incomplete
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/openai/models/beta/agent_reasoning.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Beta
+      class AgentReasoning < OpenAI::Internal::Type::BaseModel
+        # @!attribute effort
+        #   The amount of reasoning effort used by an agent.
+        #
+        #   @return [Symbol, OpenAI::Models::Beta::AgentReasoning::Effort, nil]
+        required :effort, enum: -> { OpenAI::Beta::AgentReasoning::Effort }, nil?: true
+
+        # @!attribute summary
+        #   The reasoning summary format requested from an agent.
+        #
+        #   @return [Symbol, OpenAI::Models::Beta::AgentReasoning::Summary, nil]
+        required :summary, enum: -> { OpenAI::Beta::AgentReasoning::Summary }, nil?: true
+
+        # @!method initialize(effort:, summary:)
+        #   The reasoning configuration used by an agent.
+        #
+        #   @param effort [Symbol, OpenAI::Models::Beta::AgentReasoning::Effort, nil]
+        #     The amount of reasoning effort used by an agent.
+        #
+        #   @param summary [Symbol, OpenAI::Models::Beta::AgentReasoning::Summary, nil]
+        #     The reasoning summary format requested from an agent.
+
+        # The amount of reasoning effort used by an agent.
+        #
+        # @see OpenAI::Models::Beta::AgentReasoning#effort
+        module Effort
+          extend OpenAI::Internal::Type::Enum
+
+          NONE = :none
+          MINIMAL = :minimal
+          LOW = :low
+          MEDIUM = :medium
+          HIGH = :high
+          XHIGH = :xhigh
+          MAX = :max
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # The reasoning summary format requested from an agent.
+        #
+        # @see OpenAI::Models::Beta::AgentReasoning#summary
+        module Summary
+          extend OpenAI::Internal::Type::Enum
+
+          # Returns a concise reasoning summary when supported.
+          CONCISE = :concise
+
+          # Returns a detailed reasoning summary when supported.
+          DETAILED = :detailed
+
+          # Automatically selects the most detailed summary supported by the model.
+          AUTO = :auto
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/openai/models/beta/agent_reasoning_item.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Beta
+      class AgentReasoningItem < OpenAI::Internal::Type::BaseModel
+        # @!attribute id
+        #   The ID of the reasoning item.
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute status
+        #   The status of an agent output item.
+        #
+        #   @return [Symbol, OpenAI::Models::Beta::AgentOutputItemStatus, nil]
+        required :status, enum: -> { OpenAI::Beta::AgentOutputItemStatus }, nil?: true
+
+        # @!attribute summary
+        #   The reasoning summaries produced by the agent.
+        #
+        #   @return [Array<OpenAI::Models::Beta::SummaryText>]
+        required :summary, -> { OpenAI::Internal::Type::ArrayOf[OpenAI::Beta::SummaryText] }
+
+        # @!attribute turn_id
+        #   The ID of the turn that contains this item.
+        #
+        #   @return [String]
+        required :turn_id, String
+
+        # @!attribute type
+        #   The item type. Always `reasoning`.
+        #
+        #   @return [Symbol, :reasoning]
+        required :type, const: :reasoning
+
+        # @!method initialize(id:, status:, summary:, turn_id:, type: :reasoning)
+        #   A reasoning item produced by the agent.
+        #
+        #   @param id [String]
+        #     The ID of the reasoning item.
+        #
+        #   @param status [Symbol, OpenAI::Models::Beta::AgentOutputItemStatus, nil]
+        #     The status of an agent output item.
+        #
+        #   @param summary [Array<OpenAI::Models::Beta::SummaryText>]
+        #     The reasoning summaries produced by the agent.
+        #
+        #   @param turn_id [String]
+        #     The ID of the turn that contains this item.
+        #
+        #   @param type [Symbol, :reasoning]
+        #     The item type. Always `reasoning`.
+      end
+    end
+  end
+end

data/lib/openai/models/beta/agent_reasoning_param.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Beta
+      class AgentReasoningParam < OpenAI::Internal::Type::BaseModel
+        # @!attribute effort
+        #   The amount of reasoning effort the model should use.
+        #
+        #   @return [Symbol, OpenAI::Models::Beta::AgentReasoningParam::Effort, nil]
+        optional :effort, enum: -> { OpenAI::Beta::AgentReasoningParam::Effort }, nil?: true
+
+        # @!attribute summary
+        #   The reasoning summary format requested from the model.
+        #
+        #   @return [Symbol, OpenAI::Models::Beta::AgentReasoningParam::Summary, nil]
+        optional :summary, enum: -> { OpenAI::Beta::AgentReasoningParam::Summary }, nil?: true
+
+        # @!method initialize(effort: nil, summary: nil)
+        #   Reasoning configuration for the agent.
+        #
+        #   @param effort [Symbol, OpenAI::Models::Beta::AgentReasoningParam::Effort, nil]
+        #     The amount of reasoning effort the model should use.
+        #
+        #   @param summary [Symbol, OpenAI::Models::Beta::AgentReasoningParam::Summary, nil]
+        #     The reasoning summary format requested from the model.
+
+        # The amount of reasoning effort the model should use.
+        #
+        # @see OpenAI::Models::Beta::AgentReasoningParam#effort
+        module Effort
+          extend OpenAI::Internal::Type::Enum
+
+          NONE = :none
+          MINIMAL = :minimal
+          LOW = :low
+          MEDIUM = :medium
+          HIGH = :high
+          XHIGH = :xhigh
+          MAX = :max
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # The reasoning summary format requested from the model.
+        #
+        # @see OpenAI::Models::Beta::AgentReasoningParam#summary
+        module Summary
+          extend OpenAI::Internal::Type::Enum
+
+          # Returns a concise reasoning summary when supported.
+          CONCISE = :concise
+
+          # Returns a detailed reasoning summary when supported.
+          DETAILED = :detailed
+
+          # Automatically selects the most detailed summary supported by the model.
+          AUTO = :auto
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/openai/models/beta/agent_resume_subagent_call_item.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Beta
+      class AgentResumeSubagentCallItem < OpenAI::Internal::Type::BaseModel
+        # @!attribute id
+        #   The ID of the tool call item.
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute recipient_agent_id
+        #   The ID of the agent to resume.
+        #
+        #   @return [String]
+        required :recipient_agent_id, String
+
+        # @!attribute sender_agent_id
+        #   The ID of the agent requesting the resume.
+        #
+        #   @return [String]
+        required :sender_agent_id, String
+
+        # @!attribute status
+        #   The status of the tool call.
+        #
+        #   @return [Symbol, OpenAI::Models::Beta::AgentFunctionCallStatus]
+        required :status, enum: -> { OpenAI::Beta::AgentFunctionCallStatus }
+
+        # @!attribute turn_id
+        #   The ID of the turn that contains this item.
+        #
+        #   @return [String]
+        required :turn_id, String
+
+        # @!attribute type
+        #   The item type. Always `resume_subagent_call`.
+        #
+        #   @return [Symbol, :resume_subagent_call]
+        required :type, const: :resume_subagent_call
+
+        # @!method initialize(id:, recipient_agent_id:, sender_agent_id:, status:, turn_id:, type: :resume_subagent_call)
+        #   A request to resume a subagent.
+        #
+        #   @param id [String]
+        #     The ID of the tool call item.
+        #
+        #   @param recipient_agent_id [String]
+        #     The ID of the agent to resume.
+        #
+        #   @param sender_agent_id [String]
+        #     The ID of the agent requesting the resume.
+        #
+        #   @param status [Symbol, OpenAI::Models::Beta::AgentFunctionCallStatus]
+        #     The status of the tool call.
+        #
+        #   @param turn_id [String]
+        #     The ID of the turn that contains this item.
+        #
+        #   @param type [Symbol, :resume_subagent_call]
+        #     The item type. Always `resume_subagent_call`.
+      end
+    end
+  end
+end

data/lib/openai/models/beta/agent_retrieve_params.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Beta
+      # @see OpenAI::Resources::Beta::Agents#retrieve
+      class AgentRetrieveParams < OpenAI::Internal::Type::BaseModel
+        extend OpenAI::Internal::Type::RequestParameters::Converter
+        include OpenAI::Internal::Type::RequestParameters
+
+        # @!attribute agent_id
+        #
+        #   @return [String]
+        required :agent_id, String
+
+        # @!method initialize(agent_id:, request_options: {})
+        #   @param agent_id [String]
+        #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/openai/models/beta/agent_send_subagent_input_call_item.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Beta
+      class AgentSendSubagentInputCallItem < OpenAI::Internal::Type::BaseModel
+        # @!attribute id
+        #   The ID of the tool call item.
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute content
+        #   The input sent to the receiving agent.
+        #
+        #   @return [Array<OpenAI::Models::Beta::OutputText, OpenAI::Models::Beta::AgentContent::EncryptedContent>]
+        required :content, -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Beta::AgentContent] }
+
+        # @!attribute recipient_agent_id
+        #   The ID of the agent receiving the input.
+        #
+        #   @return [String]
+        required :recipient_agent_id, String
+
+        # @!attribute sender_agent_id
+        #   The ID of the agent sending the input.
+        #
+        #   @return [String]
+        required :sender_agent_id, String
+
+        # @!attribute status
+        #   The status of the tool call.
+        #
+        #   @return [Symbol, OpenAI::Models::Beta::AgentFunctionCallStatus]
+        required :status, enum: -> { OpenAI::Beta::AgentFunctionCallStatus }
+
+        # @!attribute turn_id
+        #   The ID of the turn that contains this item.
+        #
+        #   @return [String]
+        required :turn_id, String
+
+        # @!attribute type
+        #   The item type. Always `send_subagent_input_call`.
+        #
+        #   @return [Symbol, :send_subagent_input_call]
+        required :type, const: :send_subagent_input_call
+
+        # @!method initialize(id:, content:, recipient_agent_id:, sender_agent_id:, status:, turn_id:, type: :send_subagent_input_call)
+        #   A request to send input to another agent.
+        #
+        #   @param id [String]
+        #     The ID of the tool call item.
+        #
+        #   @param content [Array<OpenAI::Models::Beta::OutputText, OpenAI::Models::Beta::AgentContent::EncryptedContent>]
+        #     The input sent to the receiving agent.
+        #
+        #   @param recipient_agent_id [String]
+        #     The ID of the agent receiving the input.
+        #
+        #   @param sender_agent_id [String]
+        #     The ID of the agent sending the input.
+        #
+        #   @param status [Symbol, OpenAI::Models::Beta::AgentFunctionCallStatus]
+        #     The status of the tool call.
+        #
+        #   @param turn_id [String]
+        #     The ID of the turn that contains this item.
+        #
+        #   @param type [Symbol, :send_subagent_input_call]
+        #     The item type. Always `send_subagent_input_call`.
+      end
+    end
+  end
+end