openai 0.89.0 → 0.91.0

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

@@ -109,6 +109,12 @@ module OpenAI
           -> { OpenAI::Beta::BetaResponsesServerEvent::BetaResponseCodeInterpreterCallWsInterpreting }
         )
 
+        # Emitted when new summary content is sampled for a compaction trigger. Contains no summary content.
+        variant(
+          :"response.compaction.compacting",
+          -> { OpenAI::Beta::BetaResponsesServerEvent::BetaResponseCompactionWsCompacting }
+        )
+
         # Emitted when the model response is complete.
         variant :"response.completed", -> { OpenAI::Beta::BetaResponsesServerEvent::BetaResponseWsCompleted }
 
@@ -651,6 +657,38 @@ module OpenAI
           #     The type of the event. Always `response.code_interpreter_call.interpreting`.
         end
 
+        class BetaResponseCompactionWsCompacting < OpenAI::Models::Beta::BetaResponseCompactionCompactingEvent
+          # @!attribute stream_id
+          #   The WebSocket lane that emitted this event. This field is present when the
+          #   originating `response.create` event supplied a `stream_id`.
+          #
+          #   @return [String, nil]
+          optional :stream_id, String
+
+          # @!method initialize(item_id:, output_index:, sequence_number:, agent: nil, stream_id: nil, type: :"response.compaction.compacting")
+          #   Emitted when new summary content is sampled for a compaction trigger. Contains
+          #   no summary content.
+          #
+          #   @param item_id [String]
+          #     The ID of the compaction output item.
+          #
+          #   @param output_index [Integer]
+          #     The index of the compaction output item.
+          #
+          #   @param sequence_number [Integer]
+          #     The sequence number of the event that was emitted.
+          #
+          #   @param agent [OpenAI::Models::Beta::BetaResponseCompactionCompactingEvent::Agent]
+          #     The agent that owns this multi-agent streaming event.
+          #
+          #   @param stream_id [String]
+          #     The WebSocket lane that emitted this event. This field is present when the
+          #     originating `response.create` event supplied a `stream_id`.
+          #
+          #   @param type [Symbol, :"response.compaction.compacting"]
+          #     The type of the event, always `response.compaction.compacting`.
+        end
+
         class BetaResponseWsCompleted < OpenAI::Models::Beta::BetaResponseCompletedEvent
           # @!attribute stream_id
           #   The WebSocket lane that emitted this event. This field is present when the
@@ -2536,7 +2574,7 @@ module OpenAI
         end
 
         # @!method self.variants
-        #   @return [Array(OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseWsError, OpenAI::Models::Beta::BetaResponseSteerAcceptedEvent, OpenAI::Models::Beta::BetaResponseSteerPendingEvent, OpenAI::Models::Beta::BetaResponseSteerFailedEvent, OpenAI::Models::Beta::BetaResponseInjectCreatedEvent, OpenAI::Models::Beta::BetaResponseInjectFailedEvent, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseAudioWsDelta, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseAudioWsDone, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseAudioTranscriptWsDelta, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseAudioTranscriptWsDone, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseCodeInterpreterCallCodeWsDelta, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseCodeInterpreterCallCodeWsDone, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseCodeInterpreterCallWsCompleted, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseCodeInterpreterCallInWsProgress, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseCodeInterpreterCallWsInterpreting, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseWsCompleted, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseContentPartWsAdded, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseContentPartWsDone, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseWsCreated, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseFileSearchCallWsCompleted, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseFileSearchCallInWsProgress, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseFileSearchCallWsSearching, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseFunctionCallArgumentsWsDelta, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseFunctionCallArgumentsWsDone, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseShellCallCommandWsAdded, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseShellCallCommandWsDelta, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseShellCallCommandWsDone, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseShellCallOutputContentWsDelta, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseShellCallOutputContentWsDone, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseInWsProgress, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseWsFailed, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseWsIncomplete, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseOutputItemWsAdded, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseOutputItemWsDone, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseReasoningSummaryPartWsAdded, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseReasoningSummaryPartWsDone, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseReasoningSummaryTextWsDelta, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseReasoningSummaryTextWsDone, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseReasoningTextWsDelta, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseReasoningTextWsDone, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseRefusalWsDelta, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseRefusalWsDone, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseTextWsDelta, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseTextWsDone, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseWebSearchCallWsCompleted, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseWebSearchCallInWsProgress, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseWebSearchCallWsSearching, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseImageGenCallWsCompleted, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseImageGenCallWsGenerating, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseImageGenCallInWsProgress, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseImageGenCallPartialWsImage, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseMcpCallArgumentsWsDelta, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseMcpCallArgumentsWsDone, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseMcpCallWsCompleted, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseMcpCallWsFailed, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseMcpCallInWsProgress, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseMcpListToolsWsCompleted, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseMcpListToolsWsFailed, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseMcpListToolsInWsProgress, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseOutputTextAnnotationWsAdded, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseWsQueued, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseCustomToolCallInputWsDelta, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseCustomToolCallInputWsDone)]
+        #   @return [Array(OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseWsError, OpenAI::Models::Beta::BetaResponseSteerAcceptedEvent, OpenAI::Models::Beta::BetaResponseSteerPendingEvent, OpenAI::Models::Beta::BetaResponseSteerFailedEvent, OpenAI::Models::Beta::BetaResponseInjectCreatedEvent, OpenAI::Models::Beta::BetaResponseInjectFailedEvent, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseAudioWsDelta, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseAudioWsDone, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseAudioTranscriptWsDelta, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseAudioTranscriptWsDone, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseCodeInterpreterCallCodeWsDelta, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseCodeInterpreterCallCodeWsDone, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseCodeInterpreterCallWsCompleted, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseCodeInterpreterCallInWsProgress, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseCodeInterpreterCallWsInterpreting, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseCompactionWsCompacting, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseWsCompleted, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseContentPartWsAdded, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseContentPartWsDone, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseWsCreated, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseFileSearchCallWsCompleted, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseFileSearchCallInWsProgress, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseFileSearchCallWsSearching, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseFunctionCallArgumentsWsDelta, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseFunctionCallArgumentsWsDone, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseShellCallCommandWsAdded, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseShellCallCommandWsDelta, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseShellCallCommandWsDone, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseShellCallOutputContentWsDelta, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseShellCallOutputContentWsDone, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseInWsProgress, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseWsFailed, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseWsIncomplete, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseOutputItemWsAdded, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseOutputItemWsDone, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseReasoningSummaryPartWsAdded, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseReasoningSummaryPartWsDone, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseReasoningSummaryTextWsDelta, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseReasoningSummaryTextWsDone, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseReasoningTextWsDelta, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseReasoningTextWsDone, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseRefusalWsDelta, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseRefusalWsDone, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseTextWsDelta, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseTextWsDone, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseWebSearchCallWsCompleted, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseWebSearchCallInWsProgress, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseWebSearchCallWsSearching, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseImageGenCallWsCompleted, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseImageGenCallWsGenerating, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseImageGenCallInWsProgress, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseImageGenCallPartialWsImage, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseMcpCallArgumentsWsDelta, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseMcpCallArgumentsWsDone, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseMcpCallWsCompleted, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseMcpCallWsFailed, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseMcpCallInWsProgress, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseMcpListToolsWsCompleted, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseMcpListToolsWsFailed, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseMcpListToolsInWsProgress, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseOutputTextAnnotationWsAdded, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseWsQueued, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseCustomToolCallInputWsDelta, OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseCustomToolCallInputWsDone)]
       end
     end
 

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

@@ -0,0 +1,246 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Beta
+      # The execution environment for a session.
+      module Environment
+        extend OpenAI::Internal::Type::Union
+
+        discriminator :type
+
+        # The session talks to CCA without selecting or provisioning an execution environment.
+        variant :none, -> { OpenAI::Beta::Environment::None }
+
+        # An environment hosted by OpenAI.
+        variant :openai_hosted, -> { OpenAI::Beta::Environment::OpenAIHosted }
+
+        # An environment hosted by the application.
+        variant :self_hosted, -> { OpenAI::Beta::Environment::SelfHosted }
+
+        class None < OpenAI::Internal::Type::BaseModel
+          # @!attribute type
+          #   The type of the object. Always `none`.
+          #
+          #   @return [Symbol, :none]
+          required :type, const: :none
+
+          # @!method initialize(type: :none)
+          #   The session talks to CCA without selecting or provisioning an execution
+          #   environment.
+          #
+          #   @param type [Symbol, :none]
+          #     The type of the object. Always `none`.
+        end
+
+        class OpenAIHosted < OpenAI::Internal::Type::BaseModel
+          # @!attribute id
+          #   The public ID of the environment.
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute capability_directories
+          #   Directories that contain capabilities exposed to the agent.
+          #
+          #   @return [Array<String>]
+          required :capability_directories, OpenAI::Internal::Type::ArrayOf[String]
+
+          # @!attribute files
+          #   Files available in the environment, excluding their contents.
+          #
+          #   @return [Array<OpenAI::Models::Beta::HostedEnvironmentFileID, OpenAI::Models::Beta::HostedEnvironmentFile::Inline>]
+          required :files, -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Beta::HostedEnvironmentFile] }
+
+          # @!attribute network
+          #   The effective network access policy for the environment.
+          #
+          #   @return [OpenAI::Models::Beta::Environment::OpenAIHosted::Network]
+          required :network, -> { OpenAI::Beta::Environment::OpenAIHosted::Network }
+
+          # @!attribute packages
+          #   Packages installed in the environment.
+          #
+          #   @return [OpenAI::Models::Beta::Environment::OpenAIHosted::Packages]
+          required :packages, -> { OpenAI::Beta::Environment::OpenAIHosted::Packages }
+
+          # @!attribute plugins
+          #   Plugins installed in the environment, excluding their archive contents.
+          #
+          #   @return [Array<OpenAI::Models::Beta::HostedPlugin>]
+          required :plugins, -> { OpenAI::Internal::Type::ArrayOf[OpenAI::Beta::HostedPlugin] }
+
+          # @!attribute skills
+          #   Skills installed in the environment, excluding their archive contents.
+          #
+          #   @return [Array<OpenAI::Models::Beta::HostedSkillReference, OpenAI::Models::Beta::HostedSkill::Inline>]
+          required :skills, -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Beta::HostedSkill] }
+
+          # @!attribute type
+          #   The type of the object. Always `openai_hosted`.
+          #
+          #   @return [Symbol, :openai_hosted]
+          required :type, const: :openai_hosted
+
+          # @!method initialize(id:, capability_directories:, files:, network:, packages:, plugins:, skills:, type: :openai_hosted)
+          #   An environment hosted by OpenAI.
+          #
+          #   @param id [String]
+          #     The public ID of the environment.
+          #
+          #   @param capability_directories [Array<String>]
+          #     Directories that contain capabilities exposed to the agent.
+          #
+          #   @param files [Array<OpenAI::Models::Beta::HostedEnvironmentFileID, OpenAI::Models::Beta::HostedEnvironmentFile::Inline>]
+          #     Files available in the environment, excluding their contents.
+          #
+          #   @param network [OpenAI::Models::Beta::Environment::OpenAIHosted::Network]
+          #     The effective network access policy for the environment.
+          #
+          #   @param packages [OpenAI::Models::Beta::Environment::OpenAIHosted::Packages]
+          #     Packages installed in the environment.
+          #
+          #   @param plugins [Array<OpenAI::Models::Beta::HostedPlugin>]
+          #     Plugins installed in the environment, excluding their archive contents.
+          #
+          #   @param skills [Array<OpenAI::Models::Beta::HostedSkillReference, OpenAI::Models::Beta::HostedSkill::Inline>]
+          #     Skills installed in the environment, excluding their archive contents.
+          #
+          #   @param type [Symbol, :openai_hosted]
+          #     The type of the object. Always `openai_hosted`.
+
+          # @see OpenAI::Models::Beta::Environment::OpenAIHosted#network
+          class Network < OpenAI::Internal::Type::BaseModel
+            # @!attribute access
+            #   The environment's network access mode.
+            #
+            #   @return [Symbol, OpenAI::Models::Beta::Environment::OpenAIHosted::Network::Access]
+            required :access, enum: -> { OpenAI::Beta::Environment::OpenAIHosted::Network::Access }
+
+            # @!attribute allowed_domains
+            #   Domains the environment may access when network access is restricted.
+            #
+            #   @return [Array<String>]
+            required :allowed_domains, OpenAI::Internal::Type::ArrayOf[String]
+
+            # @!method initialize(access:, allowed_domains:)
+            #   The effective network access policy for the environment.
+            #
+            #   @param access [Symbol, OpenAI::Models::Beta::Environment::OpenAIHosted::Network::Access]
+            #     The environment's network access mode.
+            #
+            #   @param allowed_domains [Array<String>]
+            #     Domains the environment may access when network access is restricted.
+
+            # The environment's network access mode.
+            #
+            # @see OpenAI::Models::Beta::Environment::OpenAIHosted::Network#access
+            module Access
+              extend OpenAI::Internal::Type::Enum
+
+              # Allows unrestricted network access.
+              ENABLED = :enabled
+
+              # Disables network access.
+              DISABLED = :disabled
+
+              # Allows access only to configured domains.
+              RESTRICTED = :restricted
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+          end
+
+          # @see OpenAI::Models::Beta::Environment::OpenAIHosted#packages
+          class Packages < OpenAI::Internal::Type::BaseModel
+            # @!attribute npm
+            #   npm packages installed globally in the environment.
+            #
+            #   @return [Array<String>]
+            required :npm, OpenAI::Internal::Type::ArrayOf[String]
+
+            # @!attribute python
+            #   Python packages installed in the environment.
+            #
+            #   @return [Array<String>]
+            required :python, OpenAI::Internal::Type::ArrayOf[String]
+
+            # @!attribute system_
+            #   System packages installed in the environment.
+            #
+            #   @return [Array<String>]
+            required :system_, OpenAI::Internal::Type::ArrayOf[String], api_name: :system
+
+            # @!method initialize(npm:, python:, system_:)
+            #   Packages installed in the environment.
+            #
+            #   @param npm [Array<String>]
+            #     npm packages installed globally in the environment.
+            #
+            #   @param python [Array<String>]
+            #     Python packages installed in the environment.
+            #
+            #   @param system_ [Array<String>]
+            #     System packages installed in the environment.
+          end
+        end
+
+        class SelfHosted < OpenAI::Internal::Type::BaseModel
+          # @!attribute id
+          #   The public ID of the environment.
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute capability_directories
+          #   Directories that contain capabilities exposed to the agent.
+          #
+          #   @return [Array<String>]
+          required :capability_directories, OpenAI::Internal::Type::ArrayOf[String]
+
+          # @!attribute remote_url
+          #   Pass this URL unchanged to `codex exec-server --remote` when connecting this
+          #   environment.
+          #
+          #   @return [String]
+          required :remote_url, String
+
+          # @!attribute type
+          #   The type of the object. Always `self_hosted`.
+          #
+          #   @return [Symbol, :self_hosted]
+          required :type, const: :self_hosted
+
+          # @!attribute workspace_directory
+          #   The absolute project directory inside the environment. Defaults to `/workspace`.
+          #
+          #   @return [String]
+          required :workspace_directory, String
+
+          # @!method initialize(id:, capability_directories:, remote_url:, workspace_directory:, type: :self_hosted)
+          #   An environment hosted by the application.
+          #
+          #   @param id [String]
+          #     The public ID of the environment.
+          #
+          #   @param capability_directories [Array<String>]
+          #     Directories that contain capabilities exposed to the agent.
+          #
+          #   @param remote_url [String]
+          #     Pass this URL unchanged to `codex exec-server --remote` when connecting this
+          #     environment.
+          #
+          #   @param workspace_directory [String]
+          #     The absolute project directory inside the environment. Defaults to `/workspace`.
+          #
+          #   @param type [Symbol, :self_hosted]
+          #     The type of the object. Always `self_hosted`.
+        end
+
+        # @!method self.variants
+        #   @return [Array(OpenAI::Models::Beta::Environment::None, OpenAI::Models::Beta::Environment::OpenAIHosted, OpenAI::Models::Beta::Environment::SelfHosted)]
+      end
+    end
+  end
+end

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

@@ -0,0 +1,269 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Beta
+      # The execution environment and optional reusable template for a session.
+      module EnvironmentParam
+        extend OpenAI::Internal::Type::Union
+
+        discriminator :type
+
+        # Runs the agent without an execution environment.
+        variant :none, -> { OpenAI::Beta::EnvironmentParam::None }
+
+        # An OpenAI-hosted environment, optionally based on a reusable template.
+        variant :openai_hosted, -> { OpenAI::Beta::EnvironmentParam::OpenAIHosted }
+
+        # An application-hosted environment configured inline.
+        variant :self_hosted, -> { OpenAI::Beta::EnvironmentParam::SelfHosted }
+
+        class None < OpenAI::Internal::Type::BaseModel
+          # @!attribute type
+          #   The type of the object. Always `none`.
+          #
+          #   @return [Symbol, :none]
+          required :type, const: :none
+
+          # @!method initialize(type: :none)
+          #   Runs the agent without an execution environment.
+          #
+          #   @param type [Symbol, :none]
+          #     The type of the object. Always `none`.
+        end
+
+        class OpenAIHosted < OpenAI::Internal::Type::BaseModel
+          # @!attribute type
+          #   The type of the object. Always `openai_hosted`.
+          #
+          #   @return [Symbol, :openai_hosted]
+          required :type, const: :openai_hosted
+
+          # @!attribute capability_directories
+          #   Directories that contain capabilities exposed to the agent. Defaults to an empty
+          #   list.
+          #
+          #   @return [Array<String>, nil]
+          optional :capability_directories, OpenAI::Internal::Type::ArrayOf[String], nil?: true
+
+          # @!attribute env
+          #   Environment variables made available to the agent.
+          #
+          #   @return [Hash{Symbol=>String}, nil]
+          optional :env, OpenAI::Internal::Type::HashOf[String], nil?: true
+
+          # @!attribute environment_template_id
+          #   A reusable hosted template applied before inline session configuration. Omitted
+          #   fields inherit the template; network overrides cannot broaden its policy.
+          #
+          #   @return [String, nil]
+          optional :environment_template_id, String
+
+          # @!attribute files
+          #   Files available before the agent starts. Defaults to an empty list.
+          #
+          #   @return [Array<OpenAI::Models::Beta::HostedEnvironmentFileParam::FileID, OpenAI::Models::Beta::HostedEnvironmentFileParam::Inline>, nil]
+          optional(
+            :files,
+            -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Beta::HostedEnvironmentFileParam] },
+            nil?: true
+          )
+
+          # @!attribute network
+          #   Network access for an OpenAI-hosted environment.
+          #
+          #   @return [OpenAI::Models::Beta::EnvironmentParam::OpenAIHosted::Network, nil]
+          optional :network, -> { OpenAI::Beta::EnvironmentParam::OpenAIHosted::Network }, nil?: true
+
+          # @!attribute packages
+          #   Packages to install in an OpenAI-hosted environment.
+          #
+          #   @return [OpenAI::Models::Beta::EnvironmentParam::OpenAIHosted::Packages, nil]
+          optional :packages, -> { OpenAI::Beta::EnvironmentParam::OpenAIHosted::Packages }, nil?: true
+
+          # @!attribute plugins
+          #   Plugins provided as inline ZIP archives. Defaults to an empty list.
+          #
+          #   @return [Array<OpenAI::Models::Beta::HostedPluginParam>, nil]
+          optional(
+            :plugins,
+            -> {
+              OpenAI::Internal::Type::ArrayOf[OpenAI::Beta::HostedPluginParam]
+            },
+            nil?: true
+          )
+
+          # @!attribute setup_commands
+          #   Ordered, confidential setup commands. Command bodies are never returned.
+          #
+          #   @return [Array<OpenAI::Models::Beta::SetupCommandParam>, nil]
+          optional(
+            :setup_commands,
+            -> { OpenAI::Internal::Type::ArrayOf[OpenAI::Beta::SetupCommandParam] },
+            nil?: true
+          )
+
+          # @!attribute skills
+          #   Skills referenced by ID or provided as inline ZIP archives. Defaults to an empty
+          #   list.
+          #
+          #   @return [Array<OpenAI::Models::Beta::HostedSkillParam::SkillReference, OpenAI::Models::Beta::HostedSkillParam::Inline>, nil]
+          optional(
+            :skills,
+            -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Beta::HostedSkillParam] },
+            nil?: true
+          )
+
+          # @!method initialize(capability_directories: nil, env: nil, environment_template_id: nil, files: nil, network: nil, packages: nil, plugins: nil, setup_commands: nil, skills: nil, type: :openai_hosted)
+          #   An OpenAI-hosted environment, optionally based on a reusable template.
+          #
+          #   @param capability_directories [Array<String>, nil]
+          #     Directories that contain capabilities exposed to the agent. Defaults to an empty
+          #     list.
+          #
+          #   @param env [Hash{Symbol=>String}, nil]
+          #     Environment variables made available to the agent.
+          #
+          #   @param environment_template_id [String]
+          #     A reusable hosted template applied before inline session configuration. Omitted
+          #     fields inherit the template; network overrides cannot broaden its policy.
+          #
+          #   @param files [Array<OpenAI::Models::Beta::HostedEnvironmentFileParam::FileID, OpenAI::Models::Beta::HostedEnvironmentFileParam::Inline>, nil]
+          #     Files available before the agent starts. Defaults to an empty list.
+          #
+          #   @param network [OpenAI::Models::Beta::EnvironmentParam::OpenAIHosted::Network, nil]
+          #     Network access for an OpenAI-hosted environment.
+          #
+          #   @param packages [OpenAI::Models::Beta::EnvironmentParam::OpenAIHosted::Packages, nil]
+          #     Packages to install in an OpenAI-hosted environment.
+          #
+          #   @param plugins [Array<OpenAI::Models::Beta::HostedPluginParam>, nil]
+          #     Plugins provided as inline ZIP archives. Defaults to an empty list.
+          #
+          #   @param setup_commands [Array<OpenAI::Models::Beta::SetupCommandParam>, nil]
+          #     Ordered, confidential setup commands. Command bodies are never returned.
+          #
+          #   @param skills [Array<OpenAI::Models::Beta::HostedSkillParam::SkillReference, OpenAI::Models::Beta::HostedSkillParam::Inline>, nil]
+          #     Skills referenced by ID or provided as inline ZIP archives. Defaults to an empty
+          #     list.
+          #
+          #   @param type [Symbol, :openai_hosted]
+          #     The type of the object. Always `openai_hosted`.
+
+          # @see OpenAI::Models::Beta::EnvironmentParam::OpenAIHosted#network
+          class Network < OpenAI::Internal::Type::BaseModel
+            # @!attribute access
+            #   The environment's network access mode.
+            #
+            #   @return [Symbol, OpenAI::Models::Beta::EnvironmentParam::OpenAIHosted::Network::Access]
+            required :access, enum: -> { OpenAI::Beta::EnvironmentParam::OpenAIHosted::Network::Access }
+
+            # @!attribute allowed_domains
+            #   Domains the environment may access when network access is restricted.
+            #
+            #   @return [Array<String>, nil]
+            optional :allowed_domains, OpenAI::Internal::Type::ArrayOf[String], nil?: true
+
+            # @!method initialize(access:, allowed_domains: nil)
+            #   Network access for an OpenAI-hosted environment.
+            #
+            #   @param access [Symbol, OpenAI::Models::Beta::EnvironmentParam::OpenAIHosted::Network::Access]
+            #     The environment's network access mode.
+            #
+            #   @param allowed_domains [Array<String>, nil]
+            #     Domains the environment may access when network access is restricted.
+
+            # The environment's network access mode.
+            #
+            # @see OpenAI::Models::Beta::EnvironmentParam::OpenAIHosted::Network#access
+            module Access
+              extend OpenAI::Internal::Type::Enum
+
+              # Allows unrestricted network access, matching an omitted network policy.
+              ENABLED = :enabled
+
+              # Disables network access.
+              DISABLED = :disabled
+
+              # Allows access only to configured domains.
+              RESTRICTED = :restricted
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+          end
+
+          # @see OpenAI::Models::Beta::EnvironmentParam::OpenAIHosted#packages
+          class Packages < OpenAI::Internal::Type::BaseModel
+            # @!attribute npm
+            #   npm packages to install globally. Defaults to an empty list.
+            #
+            #   @return [Array<String>, nil]
+            optional :npm, OpenAI::Internal::Type::ArrayOf[String], nil?: true
+
+            # @!attribute python
+            #   Python packages to install. Defaults to an empty list.
+            #
+            #   @return [Array<String>, nil]
+            optional :python, OpenAI::Internal::Type::ArrayOf[String], nil?: true
+
+            # @!attribute system_
+            #   System packages to install. Defaults to an empty list.
+            #
+            #   @return [Array<String>, nil]
+            optional :system_, OpenAI::Internal::Type::ArrayOf[String], api_name: :system, nil?: true
+
+            # @!method initialize(npm: nil, python: nil, system_: nil)
+            #   Packages to install in an OpenAI-hosted environment.
+            #
+            #   @param npm [Array<String>, nil]
+            #     npm packages to install globally. Defaults to an empty list.
+            #
+            #   @param python [Array<String>, nil]
+            #     Python packages to install. Defaults to an empty list.
+            #
+            #   @param system_ [Array<String>, nil]
+            #     System packages to install. Defaults to an empty list.
+          end
+        end
+
+        class SelfHosted < OpenAI::Internal::Type::BaseModel
+          # @!attribute type
+          #   The type of the object. Always `self_hosted`.
+          #
+          #   @return [Symbol, :self_hosted]
+          required :type, const: :self_hosted
+
+          # @!attribute workspace_directory
+          #   Absolute project directory inside the self-hosted environment.
+          #
+          #   @return [String]
+          required :workspace_directory, String
+
+          # @!attribute capability_directories
+          #   Directories that contain capabilities exposed to the agent. Defaults to an empty
+          #   list.
+          #
+          #   @return [Array<String>, nil]
+          optional :capability_directories, OpenAI::Internal::Type::ArrayOf[String], nil?: true
+
+          # @!method initialize(workspace_directory:, capability_directories: nil, type: :self_hosted)
+          #   An application-hosted environment configured inline.
+          #
+          #   @param workspace_directory [String]
+          #     Absolute project directory inside the self-hosted environment.
+          #
+          #   @param capability_directories [Array<String>, nil]
+          #     Directories that contain capabilities exposed to the agent. Defaults to an empty
+          #     list.
+          #
+          #   @param type [Symbol, :self_hosted]
+          #     The type of the object. Always `self_hosted`.
+        end
+
+        # @!method self.variants
+        #   @return [Array(OpenAI::Models::Beta::EnvironmentParam::None, OpenAI::Models::Beta::EnvironmentParam::OpenAIHosted, OpenAI::Models::Beta::EnvironmentParam::SelfHosted)]
+      end
+    end
+  end
+end

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

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Beta
+      # Metadata for a file materialized in an OpenAI-hosted execution environment.
+      module HostedEnvironmentFile
+        extend OpenAI::Internal::Type::Union
+
+        discriminator :type
+
+        # A file copied from the OpenAI Files API.
+        variant :file_id, -> { OpenAI::Beta::HostedEnvironmentFileID }
+
+        # A file supplied inline when the session was created.
+        variant :inline, -> { OpenAI::Beta::HostedEnvironmentFile::Inline }
+
+        class Inline < OpenAI::Internal::Type::BaseModel
+          # @!attribute id
+          #   The session-scoped ID of the file in the execution environment.
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute path
+          #   The file's absolute path inside the environment.
+          #
+          #   @return [String]
+          required :path, String
+
+          # @!attribute size_bytes
+          #   The decoded file size in bytes.
+          #
+          #   @return [Integer]
+          required :size_bytes, Integer
+
+          # @!attribute type
+          #   The type of the object. Always `inline`.
+          #
+          #   @return [Symbol, :inline]
+          required :type, const: :inline
+
+          # @!method initialize(id:, path:, size_bytes:, type: :inline)
+          #   A file supplied inline when the session was created.
+          #
+          #   @param id [String]
+          #     The session-scoped ID of the file in the execution environment.
+          #
+          #   @param path [String]
+          #     The file's absolute path inside the environment.
+          #
+          #   @param size_bytes [Integer]
+          #     The decoded file size in bytes.
+          #
+          #   @param type [Symbol, :inline]
+          #     The type of the object. Always `inline`.
+        end
+
+        # @!method self.variants
+        #   @return [Array(OpenAI::Models::Beta::HostedEnvironmentFileID, OpenAI::Models::Beta::HostedEnvironmentFile::Inline)]
+      end
+    end
+  end
+end