openai 0.89.0 → 0.91.0

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

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

@@ -0,0 +1,339 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Beta
+      class AgentSession < OpenAI::Internal::Type::BaseModel
+        # @!attribute id
+        #   The ID of the session.
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute agent
+        #   The agent running in the session.
+        #
+        #   @return [OpenAI::Models::Beta::AgentSession::Agent]
+        required :agent, -> { OpenAI::Beta::AgentSession::Agent }
+
+        # @!attribute created_at
+        #   The Unix timestamp, in seconds, when the session was created.
+        #
+        #   @return [Integer]
+        required :created_at, Integer
+
+        # @!attribute environment
+        #   The execution environment for the session.
+        #
+        #   @return [OpenAI::Models::Beta::Environment::None, OpenAI::Models::Beta::Environment::OpenAIHosted, OpenAI::Models::Beta::Environment::SelfHosted]
+        required :environment, union: -> { OpenAI::Beta::Environment }
+
+        # @!attribute error
+        #   The error that caused the session to fail, if any.
+        #
+        #   @return [String, nil]
+        required :error, String, nil?: true
+
+        # @!attribute last_active_at
+        #   The Unix timestamp, in seconds, when the session was last active.
+        #
+        #   @return [Integer]
+        required :last_active_at, Integer
+
+        # @!attribute metadata
+        #   Custom string key-value pairs attached to the session.
+        #
+        #   @return [Hash{Symbol=>String}]
+        required :metadata, OpenAI::Internal::Type::HashOf[String]
+
+        # @!attribute object
+        #   The object type. Always `agent.session`.
+        #
+        #   @return [Symbol, :"agent.session"]
+        required :object, const: :"agent.session"
+
+        # @!attribute required_actions
+        #   Actions that must be completed before the session can continue.
+        #
+        #   @return [Array<OpenAI::Models::Beta::AgentSession::RequiredAction::FunctionCall, OpenAI::Models::Beta::AgentSession::RequiredAction::EnvironmentConnection>]
+        required(
+          :required_actions,
+          -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Beta::AgentSession::RequiredAction] }
+        )
+
+        # @!attribute status
+        #   The current status of the session.
+        #
+        #   @return [Symbol, OpenAI::Models::Beta::AgentSession::Status]
+        required :status, enum: -> { OpenAI::Beta::AgentSession::Status }
+
+        # @!attribute usage
+        #   Recorded token usage for a session or turn. Usage is best effort and may change.
+        #
+        #   @return [OpenAI::Models::Beta::TokenUsage, nil]
+        required :usage, -> { OpenAI::Beta::TokenUsage }, nil?: true
+
+        # @!attribute vault_ids
+        #   The IDs of vaults made available to the session.
+        #
+        #   @return [Array<String>]
+        required :vault_ids, OpenAI::Internal::Type::ArrayOf[String]
+
+        # @!method initialize(id:, agent:, created_at:, environment:, error:, last_active_at:, metadata:, required_actions:, status:, usage:, vault_ids:, object: :"agent.session")
+        #   A Managed Agents session.
+        #
+        #   @param id [String]
+        #     The ID of the session.
+        #
+        #   @param agent [OpenAI::Models::Beta::AgentSession::Agent]
+        #     The agent running in the session.
+        #
+        #   @param created_at [Integer]
+        #     The Unix timestamp, in seconds, when the session was created.
+        #
+        #   @param environment [OpenAI::Models::Beta::Environment::None, OpenAI::Models::Beta::Environment::OpenAIHosted, OpenAI::Models::Beta::Environment::SelfHosted]
+        #     The execution environment for the session.
+        #
+        #   @param error [String, nil]
+        #     The error that caused the session to fail, if any.
+        #
+        #   @param last_active_at [Integer]
+        #     The Unix timestamp, in seconds, when the session was last active.
+        #
+        #   @param metadata [Hash{Symbol=>String}]
+        #     Custom string key-value pairs attached to the session.
+        #
+        #   @param required_actions [Array<OpenAI::Models::Beta::AgentSession::RequiredAction::FunctionCall, OpenAI::Models::Beta::AgentSession::RequiredAction::EnvironmentConnection>]
+        #     Actions that must be completed before the session can continue.
+        #
+        #   @param status [Symbol, OpenAI::Models::Beta::AgentSession::Status]
+        #     The current status of the session.
+        #
+        #   @param usage [OpenAI::Models::Beta::TokenUsage, nil]
+        #     Recorded token usage for a session or turn. Usage is best effort and may change.
+        #
+        #   @param vault_ids [Array<String>]
+        #     The IDs of vaults made available to the session.
+        #
+        #   @param object [Symbol, :"agent.session"]
+        #     The object type. Always `agent.session`.
+
+        # @see OpenAI::Models::Beta::AgentSession#agent
+        class Agent < OpenAI::Internal::Type::BaseModel
+          # @!attribute id
+          #   The ID of the agent.
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute instructions
+          #   Custom instructions appended to the agent's default base instructions.
+          #
+          #   @return [String, nil]
+          required :instructions, String, nil?: true
+
+          # @!attribute model
+          #   The model used by the agent.
+          #
+          #   @return [String]
+          required :model, String
+
+          # @!attribute multi_agent
+          #   Configuration for creating and coordinating subagents.
+          #
+          #   @return [OpenAI::Models::Beta::MultiAgentConfig]
+          required :multi_agent, -> { OpenAI::Beta::MultiAgentConfig }
+
+          # @!attribute name
+          #   The reusable agent's name when the session was created, or null if no name was
+          #   saved. Later changes to the agent's name do not affect this value.
+          #
+          #   @return [String, nil]
+          required :name, String, nil?: true
+
+          # @!attribute reasoning
+          #   The agent's reasoning configuration.
+          #
+          #   @return [OpenAI::Models::Beta::AgentReasoning]
+          required :reasoning, -> { OpenAI::Beta::AgentReasoning }
+
+          # @!attribute service_tier
+          #   The effective service-tier policy for model requests. Defaults to `auto`.
+          #
+          #   @return [Symbol, OpenAI::Models::Beta::AgentSession::Agent::ServiceTier]
+          required :service_tier, enum: -> { OpenAI::Beta::AgentSession::Agent::ServiceTier }
+
+          # @!attribute text
+          #   Configuration for text generated by the agent.
+          #
+          #   @return [OpenAI::Models::Beta::AgentText]
+          required :text, -> { OpenAI::Beta::AgentText }
+
+          # @!attribute tools
+          #   Tools available to the agent.
+          #
+          #   @return [Array<OpenAI::Models::Beta::AgentTool::Function, OpenAI::Models::Beta::AgentTool::ProgrammaticToolCalling, OpenAI::Models::Beta::AgentTool::Mcp, OpenAI::Models::Beta::AgentTool::WebSearch>]
+          required :tools, -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Beta::AgentTool] }
+
+          # @!method initialize(id:, instructions:, model:, multi_agent:, name:, reasoning:, service_tier:, text:, tools:)
+          #   The agent running in the session.
+          #
+          #   @param id [String]
+          #     The ID of the agent.
+          #
+          #   @param instructions [String, nil]
+          #     Custom instructions appended to the agent's default base instructions.
+          #
+          #   @param model [String]
+          #     The model used by the agent.
+          #
+          #   @param multi_agent [OpenAI::Models::Beta::MultiAgentConfig]
+          #     Configuration for creating and coordinating subagents.
+          #
+          #   @param name [String, nil]
+          #     The reusable agent's name when the session was created, or null if no name was
+          #     saved. Later changes to the agent's name do not affect this value.
+          #
+          #   @param reasoning [OpenAI::Models::Beta::AgentReasoning]
+          #     The agent's reasoning configuration.
+          #
+          #   @param service_tier [Symbol, OpenAI::Models::Beta::AgentSession::Agent::ServiceTier]
+          #     The effective service-tier policy for model requests. Defaults to `auto`.
+          #
+          #   @param text [OpenAI::Models::Beta::AgentText]
+          #     Configuration for text generated by the agent.
+          #
+          #   @param tools [Array<OpenAI::Models::Beta::AgentTool::Function, OpenAI::Models::Beta::AgentTool::ProgrammaticToolCalling, OpenAI::Models::Beta::AgentTool::Mcp, OpenAI::Models::Beta::AgentTool::WebSearch>]
+          #     Tools available to the agent.
+
+          # The effective service-tier policy for model requests. Defaults to `auto`.
+          #
+          # @see OpenAI::Models::Beta::AgentSession::Agent#service_tier
+          module ServiceTier
+            extend OpenAI::Internal::Type::Enum
+
+            AUTO = :auto
+            DEFAULT = :default
+            FLEX = :flex
+            PRIORITY = :priority
+            FAST = :fast
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+
+        # An action that must be completed before a session can continue.
+        module RequiredAction
+          extend OpenAI::Internal::Type::Union
+
+          discriminator :type
+
+          # Run a function tool and submit its result.
+          variant :function_call, -> { OpenAI::Beta::AgentSession::RequiredAction::FunctionCall }
+
+          # Reconnect a session environment.
+          variant :environment_connection, -> { OpenAI::Beta::AgentSession::RequiredAction::EnvironmentConnection }
+
+          class FunctionCall < OpenAI::Internal::Type::BaseModel
+            # @!attribute arguments
+            #   The arguments supplied by the model.
+            #
+            #   @return [Object]
+            required :arguments, OpenAI::Internal::Type::Unknown
+
+            # @!attribute call_id
+            #   The ID to include when submitting the function result.
+            #
+            #   @return [String]
+            required :call_id, String
+
+            # @!attribute name
+            #   The function name.
+            #
+            #   @return [String]
+            required :name, String
+
+            # @!attribute turn_id
+            #   The ID of the turn that requested the function call.
+            #
+            #   @return [String]
+            required :turn_id, String
+
+            # @!attribute type
+            #   The type of the object. Always `function_call`.
+            #
+            #   @return [Symbol, :function_call]
+            required :type, const: :function_call
+
+            # @!method initialize(arguments:, call_id:, name:, turn_id:, type: :function_call)
+            #   Run a function tool and submit its result.
+            #
+            #   @param arguments [Object]
+            #     The arguments supplied by the model.
+            #
+            #   @param call_id [String]
+            #     The ID to include when submitting the function result.
+            #
+            #   @param name [String]
+            #     The function name.
+            #
+            #   @param turn_id [String]
+            #     The ID of the turn that requested the function call.
+            #
+            #   @param type [Symbol, :function_call]
+            #     The type of the object. Always `function_call`.
+          end
+
+          class EnvironmentConnection < OpenAI::Internal::Type::BaseModel
+            # @!attribute environment_id
+            #   The ID of the environment to reconnect.
+            #
+            #   @return [String]
+            required :environment_id, String
+
+            # @!attribute type
+            #   The type of the object. Always `environment_connection`.
+            #
+            #   @return [Symbol, :environment_connection]
+            required :type, const: :environment_connection
+
+            # @!method initialize(environment_id:, type: :environment_connection)
+            #   Reconnect a session environment.
+            #
+            #   @param environment_id [String]
+            #     The ID of the environment to reconnect.
+            #
+            #   @param type [Symbol, :environment_connection]
+            #     The type of the object. Always `environment_connection`.
+          end
+
+          # @!method self.variants
+          #   @return [Array(OpenAI::Models::Beta::AgentSession::RequiredAction::FunctionCall, OpenAI::Models::Beta::AgentSession::RequiredAction::EnvironmentConnection)]
+        end
+
+        # The current status of the session.
+        #
+        # @see OpenAI::Models::Beta::AgentSession#status
+        module Status
+          extend OpenAI::Internal::Type::Enum
+
+          # The session has no turn in progress and is ready for input. A hosted environment may still be provisioning.
+          IDLE = :idle
+
+          # The session is processing a turn.
+          IN_PROGRESS = :in_progress
+
+          # The session is waiting for one or more required actions.
+          REQUIRES_ACTION = :requires_action
+
+          # The session failed.
+          FAILED = :failed
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Beta
+      class AgentSessionAssistantMessage < OpenAI::Internal::Type::BaseModel
+        # @!attribute id
+        #   The ID of the message.
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute content
+        #   The content of the message.
+        #
+        #   @return [Array<OpenAI::Models::Beta::OutputText>]
+        required :content, -> { OpenAI::Internal::Type::ArrayOf[OpenAI::Beta::OutputText] }
+
+        # @!attribute phase
+        #   The phase of an assistant message.
+        #
+        #   @return [Symbol, OpenAI::Models::Beta::AgentSessionAssistantMessage::Phase, nil]
+        required :phase, enum: -> { OpenAI::Beta::AgentSessionAssistantMessage::Phase }, nil?: true
+
+        # @!attribute role
+        #   The role of the message author. Always `assistant`.
+        #
+        #   @return [Symbol, :assistant]
+        required :role, const: :assistant
+
+        # @!attribute status
+        #   The status of the message.
+        #
+        #   @return [Symbol, OpenAI::Models::Beta::AgentOutputItemStatus]
+        required :status, enum: -> { OpenAI::Beta::AgentOutputItemStatus }
+
+        # @!attribute turn_id
+        #   The ID of the turn that contains this item.
+        #
+        #   @return [String]
+        required :turn_id, String
+
+        # @!attribute type
+        #   The item type. Always `message`.
+        #
+        #   @return [Symbol, :message]
+        required :type, const: :message
+
+        # @!method initialize(id:, content:, phase:, status:, turn_id:, role: :assistant, type: :message)
+        #   An assistant message produced by the agent.
+        #
+        #   @param id [String]
+        #     The ID of the message.
+        #
+        #   @param content [Array<OpenAI::Models::Beta::OutputText>]
+        #     The content of the message.
+        #
+        #   @param phase [Symbol, OpenAI::Models::Beta::AgentSessionAssistantMessage::Phase, nil]
+        #     The phase of an assistant message.
+        #
+        #   @param status [Symbol, OpenAI::Models::Beta::AgentOutputItemStatus]
+        #     The status of the message.
+        #
+        #   @param turn_id [String]
+        #     The ID of the turn that contains this item.
+        #
+        #   @param role [Symbol, :assistant]
+        #     The role of the message author. Always `assistant`.
+        #
+        #   @param type [Symbol, :message]
+        #     The item type. Always `message`.
+
+        # The phase of an assistant message.
+        #
+        # @see OpenAI::Models::Beta::AgentSessionAssistantMessage#phase
+        module Phase
+          extend OpenAI::Internal::Type::Enum
+
+          # Commentary produced while the agent works.
+          COMMENTARY = :commentary
+
+          # The agent's final answer.
+          FINAL_ANSWER = :final_answer
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end