openai 0.101.0 → 0.102.0

data/lib/openai/models/chat/chat_completion_audio_param.rb

@@ -16,7 +16,7 @@ module OpenAI
         #   `ash`, `ballad`, `coral`, `echo`, `fable`, `nova`, `onyx`, `sage`, `shimmer`,
         #   `marin`, and `cedar`. You may also provide a custom voice object with an `id`,
         #   for example `{ "id": "voice_1234" }`. Custom voices must be created from audio
-        #   samples. Voices created from text prompts are supported only in Live.
+        #   samples.
         #
         #   @return [String, Symbol, OpenAI::Models::Chat::ChatCompletionAudioParam::Voice::ID, OpenAI::Models::Chat::ChatCompletionAudioParam::Voice]
         required :voice, union: -> { OpenAI::Chat::ChatCompletionAudioParam::Voice }
@@ -35,7 +35,7 @@ module OpenAI
         #     `ash`, `ballad`, `coral`, `echo`, `fable`, `nova`, `onyx`, `sage`, `shimmer`,
         #     `marin`, and `cedar`. You may also provide a custom voice object with an `id`,
         #     for example `{ "id": "voice_1234" }`. Custom voices must be created from audio
-        #     samples. Voices created from text prompts are supported only in Live.
+        #     samples.
 
         # Specifies the output audio format. Must be one of `wav`, `mp3`, `flac`, `opus`,
         # or `pcm16`.
@@ -59,7 +59,7 @@ module OpenAI
         # `ash`, `ballad`, `coral`, `echo`, `fable`, `nova`, `onyx`, `sage`, `shimmer`,
         # `marin`, and `cedar`. You may also provide a custom voice object with an `id`,
         # for example `{ "id": "voice_1234" }`. Custom voices must be created from audio
-        # samples. Voices created from text prompts are supported only in Live.
+        # samples.
         #
         # @see OpenAI::Models::Chat::ChatCompletionAudioParam#voice
         module Voice

data/lib/openai/models/realtime/realtime_audio_config_output.rb

@@ -28,8 +28,7 @@ module OpenAI
         #   `cedar`. You may also provide a custom voice object with an `id`, for example
         #   `{ "id": "voice_1234" }`. Voice cannot be changed during the session once the
         #   model has responded with audio at least once. Custom voices must be created from
-        #   audio samples. Voices created from text prompts are supported only in Live. We
-        #   recommend `marin` and `cedar` for best quality.
+        #   audio samples. We recommend `marin` and `cedar` for best quality.
         #
         #   @return [String, Symbol, OpenAI::Models::Realtime::RealtimeAudioConfigOutput::Voice::ID, OpenAI::Models::Realtime::RealtimeAudioConfigOutput::Voice, nil]
         optional :voice, union: -> { OpenAI::Realtime::RealtimeAudioConfigOutput::Voice }
@@ -53,16 +52,14 @@ module OpenAI
         #     `cedar`. You may also provide a custom voice object with an `id`, for example
         #     `{ "id": "voice_1234" }`. Voice cannot be changed during the session once the
         #     model has responded with audio at least once. Custom voices must be created from
-        #     audio samples. Voices created from text prompts are supported only in Live. We
-        #     recommend `marin` and `cedar` for best quality.
+        #     audio samples. We recommend `marin` and `cedar` for best quality.
 
         # The voice the model uses to respond. Supported built-in voices are `alloy`,
         # `ash`, `ballad`, `coral`, `echo`, `sage`, `shimmer`, `verse`, `marin`, and
         # `cedar`. You may also provide a custom voice object with an `id`, for example
         # `{ "id": "voice_1234" }`. Voice cannot be changed during the session once the
         # model has responded with audio at least once. Custom voices must be created from
-        # audio samples. Voices created from text prompts are supported only in Live. We
-        # recommend `marin` and `cedar` for best quality.
+        # audio samples. We recommend `marin` and `cedar` for best quality.
         #
         # @see OpenAI::Models::Realtime::RealtimeAudioConfigOutput#voice
         module Voice

data/lib/openai/models/realtime/realtime_response_create_audio_output.rb

@@ -28,8 +28,7 @@ module OpenAI
           #   `cedar`. You may also provide a custom voice object with an `id`, for example
           #   `{ "id": "voice_1234" }`. Voice cannot be changed during the session once the
           #   model has responded with audio at least once. Custom voices must be created from
-          #   audio samples. Voices created from text prompts are supported only in Live. We
-          #   recommend `marin` and `cedar` for best quality.
+          #   audio samples. We recommend `marin` and `cedar` for best quality.
           #
           #   @return [String, Symbol, OpenAI::Models::Realtime::RealtimeResponseCreateAudioOutput::Output::Voice::ID, OpenAI::Models::Realtime::RealtimeResponseCreateAudioOutput::Output::Voice, nil]
           optional :voice, union: -> { OpenAI::Realtime::RealtimeResponseCreateAudioOutput::Output::Voice }
@@ -44,16 +43,14 @@ module OpenAI
           #     `cedar`. You may also provide a custom voice object with an `id`, for example
           #     `{ "id": "voice_1234" }`. Voice cannot be changed during the session once the
           #     model has responded with audio at least once. Custom voices must be created from
-          #     audio samples. Voices created from text prompts are supported only in Live. We
-          #     recommend `marin` and `cedar` for best quality.
+          #     audio samples. We recommend `marin` and `cedar` for best quality.
 
           # The voice the model uses to respond. Supported built-in voices are `alloy`,
           # `ash`, `ballad`, `coral`, `echo`, `sage`, `shimmer`, `verse`, `marin`, and
           # `cedar`. You may also provide a custom voice object with an `id`, for example
           # `{ "id": "voice_1234" }`. Voice cannot be changed during the session once the
           # model has responded with audio at least once. Custom voices must be created from
-          # audio samples. Voices created from text prompts are supported only in Live. We
-          # recommend `marin` and `cedar` for best quality.
+          # audio samples. We recommend `marin` and `cedar` for best quality.
           #
           # @see OpenAI::Models::Realtime::RealtimeResponseCreateAudioOutput::Output#voice
           module Voice

data/lib/openai/models/webhooks/agent_environment_failed_webhook_event.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Webhooks
+      class AgentEnvironmentFailedWebhookEvent < OpenAI::Internal::Type::BaseModel
+        # @!attribute id
+        #   The unique ID of the event.
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute created_at
+        #   The Unix timestamp, in seconds, when the event was created.
+        #
+        #   @return [Integer]
+        required :created_at, Integer
+
+        # @!attribute data
+        #   Identifies the environment whose lifecycle changed.
+        #
+        #   @return [OpenAI::Models::Webhooks::AgentEnvironmentFailedWebhookEvent::Data]
+        required :data, -> { OpenAI::Webhooks::AgentEnvironmentFailedWebhookEvent::Data }
+
+        # @!attribute object
+        #   The object type. Always `event`.
+        #
+        #   @return [Symbol, :event]
+        required :object, const: :event
+
+        # @!attribute type
+        #   The event type. Always `agent.environment.failed`.
+        #
+        #   @return [Symbol, :"agent.environment.failed"]
+        required :type, const: :"agent.environment.failed"
+
+        # @!method initialize(id:, created_at:, data:, object: :event, type: :"agent.environment.failed")
+        #   Sent when setup fails for a prewarmed OpenAI-hosted environment before it is
+        #   attached to a session.
+        #
+        #   @param id [String]
+        #     The unique ID of the event.
+        #
+        #   @param created_at [Integer]
+        #     The Unix timestamp, in seconds, when the event was created.
+        #
+        #   @param data [OpenAI::Models::Webhooks::AgentEnvironmentFailedWebhookEvent::Data]
+        #     Identifies the environment whose lifecycle changed.
+        #
+        #   @param object [Symbol, :event]
+        #     The object type. Always `event`.
+        #
+        #   @param type [Symbol, :"agent.environment.failed"]
+        #     The event type. Always `agent.environment.failed`.
+
+        # @see OpenAI::Models::Webhooks::AgentEnvironmentFailedWebhookEvent#data
+        class Data < OpenAI::Internal::Type::BaseModel
+          # @!attribute id
+          #   The ID of the environment.
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!method initialize(id:)
+          #   Identifies the environment whose lifecycle changed.
+          #
+          #   @param id [String]
+          #     The ID of the environment.
+        end
+      end
+    end
+  end
+end

data/lib/openai/models/webhooks/agent_environment_ready_webhook_event.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Webhooks
+      class AgentEnvironmentReadyWebhookEvent < OpenAI::Internal::Type::BaseModel
+        # @!attribute id
+        #   The unique ID of the event.
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute created_at
+        #   The Unix timestamp, in seconds, when the event was created.
+        #
+        #   @return [Integer]
+        required :created_at, Integer
+
+        # @!attribute data
+        #   Identifies the environment whose lifecycle changed.
+        #
+        #   @return [OpenAI::Models::Webhooks::AgentEnvironmentReadyWebhookEvent::Data]
+        required :data, -> { OpenAI::Webhooks::AgentEnvironmentReadyWebhookEvent::Data }
+
+        # @!attribute object
+        #   The object type. Always `event`.
+        #
+        #   @return [Symbol, :event]
+        required :object, const: :event
+
+        # @!attribute type
+        #   The event type. Always `agent.environment.ready`.
+        #
+        #   @return [Symbol, :"agent.environment.ready"]
+        required :type, const: :"agent.environment.ready"
+
+        # @!method initialize(id:, created_at:, data:, object: :event, type: :"agent.environment.ready")
+        #   Sent when a prewarmed OpenAI-hosted environment finishes setup before being
+        #   attached to a session.
+        #
+        #   @param id [String]
+        #     The unique ID of the event.
+        #
+        #   @param created_at [Integer]
+        #     The Unix timestamp, in seconds, when the event was created.
+        #
+        #   @param data [OpenAI::Models::Webhooks::AgentEnvironmentReadyWebhookEvent::Data]
+        #     Identifies the environment whose lifecycle changed.
+        #
+        #   @param object [Symbol, :event]
+        #     The object type. Always `event`.
+        #
+        #   @param type [Symbol, :"agent.environment.ready"]
+        #     The event type. Always `agent.environment.ready`.
+
+        # @see OpenAI::Models::Webhooks::AgentEnvironmentReadyWebhookEvent#data
+        class Data < OpenAI::Internal::Type::BaseModel
+          # @!attribute id
+          #   The ID of the environment.
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!method initialize(id:)
+          #   Identifies the environment whose lifecycle changed.
+          #
+          #   @param id [String]
+          #     The ID of the environment.
+        end
+      end
+    end
+  end
+end

data/lib/openai/models/webhooks/unwrap_webhook_event.rb

@@ -3,13 +3,19 @@
 module OpenAI
   module Models
     module Webhooks
-      # Sent when an agent session requires an action. Retrieve the session for action
-      # details.
+      # Sent when setup fails for a prewarmed OpenAI-hosted environment before it is
+      # attached to a session.
       module UnwrapWebhookEvent
         extend OpenAI::Internal::Type::Union
 
         discriminator :type
 
+        # Sent when setup fails for a prewarmed OpenAI-hosted environment before it is attached to a session.
+        variant :"agent.environment.failed", -> { OpenAI::Webhooks::AgentEnvironmentFailedWebhookEvent }
+
+        # Sent when a prewarmed OpenAI-hosted environment finishes setup before being attached to a session.
+        variant :"agent.environment.ready", -> { OpenAI::Webhooks::AgentEnvironmentReadyWebhookEvent }
+
         # Sent when an agent session requires an action. Retrieve the session for action details.
         variant :"agent.session.action_required", -> { OpenAI::Webhooks::AgentSessionActionRequiredWebhookEvent }
 
@@ -97,7 +103,7 @@ module OpenAI
         variant :"safety.warning_issued", -> { OpenAI::Webhooks::SafetyWarningIssuedWebhookEvent }
 
         # @!method self.variants
-        #   @return [Array(OpenAI::Models::Webhooks::AgentSessionActionRequiredWebhookEvent, OpenAI::Models::Webhooks::AgentSessionCreatedWebhookEvent, OpenAI::Models::Webhooks::AgentSessionFailedWebhookEvent, OpenAI::Models::Webhooks::AgentSessionIdleWebhookEvent, OpenAI::Models::Webhooks::AgentSessionInProgressWebhookEvent, OpenAI::Models::Webhooks::BatchCancelledWebhookEvent, OpenAI::Models::Webhooks::BatchCompletedWebhookEvent, OpenAI::Models::Webhooks::BatchExpiredWebhookEvent, OpenAI::Models::Webhooks::BatchFailedWebhookEvent, OpenAI::Models::Webhooks::EvalRunCanceledWebhookEvent, OpenAI::Models::Webhooks::EvalRunFailedWebhookEvent, OpenAI::Models::Webhooks::EvalRunSucceededWebhookEvent, OpenAI::Models::Webhooks::FineTuningJobCancelledWebhookEvent, OpenAI::Models::Webhooks::FineTuningJobFailedWebhookEvent, OpenAI::Models::Webhooks::FineTuningJobSucceededWebhookEvent, OpenAI::Models::Webhooks::LiveCallIncomingWebhookEvent, OpenAI::Models::Webhooks::LiveTransportIncomingWebhookEvent, OpenAI::Models::Webhooks::RealtimeCallIncomingWebhookEvent, OpenAI::Models::Webhooks::ResponseCancelledWebhookEvent, OpenAI::Models::Webhooks::ResponseCompletedWebhookEvent, OpenAI::Models::Webhooks::ResponseFailedWebhookEvent, OpenAI::Models::Webhooks::ResponseIncompleteWebhookEvent, OpenAI::Models::Webhooks::SafetyAlertCreatedWebhookEvent, OpenAI::Models::Webhooks::SafetyDeactivationIssuedWebhookEvent, OpenAI::Models::Webhooks::SafetyOrgAlertCreatedWebhookEvent, OpenAI::Models::Webhooks::SafetyWarningIssuedWebhookEvent)]
+        #   @return [Array(OpenAI::Models::Webhooks::AgentEnvironmentFailedWebhookEvent, OpenAI::Models::Webhooks::AgentEnvironmentReadyWebhookEvent, OpenAI::Models::Webhooks::AgentSessionActionRequiredWebhookEvent, OpenAI::Models::Webhooks::AgentSessionCreatedWebhookEvent, OpenAI::Models::Webhooks::AgentSessionFailedWebhookEvent, OpenAI::Models::Webhooks::AgentSessionIdleWebhookEvent, OpenAI::Models::Webhooks::AgentSessionInProgressWebhookEvent, OpenAI::Models::Webhooks::BatchCancelledWebhookEvent, OpenAI::Models::Webhooks::BatchCompletedWebhookEvent, OpenAI::Models::Webhooks::BatchExpiredWebhookEvent, OpenAI::Models::Webhooks::BatchFailedWebhookEvent, OpenAI::Models::Webhooks::EvalRunCanceledWebhookEvent, OpenAI::Models::Webhooks::EvalRunFailedWebhookEvent, OpenAI::Models::Webhooks::EvalRunSucceededWebhookEvent, OpenAI::Models::Webhooks::FineTuningJobCancelledWebhookEvent, OpenAI::Models::Webhooks::FineTuningJobFailedWebhookEvent, OpenAI::Models::Webhooks::FineTuningJobSucceededWebhookEvent, OpenAI::Models::Webhooks::LiveCallIncomingWebhookEvent, OpenAI::Models::Webhooks::LiveTransportIncomingWebhookEvent, OpenAI::Models::Webhooks::RealtimeCallIncomingWebhookEvent, OpenAI::Models::Webhooks::ResponseCancelledWebhookEvent, OpenAI::Models::Webhooks::ResponseCompletedWebhookEvent, OpenAI::Models::Webhooks::ResponseFailedWebhookEvent, OpenAI::Models::Webhooks::ResponseIncompleteWebhookEvent, OpenAI::Models::Webhooks::SafetyAlertCreatedWebhookEvent, OpenAI::Models::Webhooks::SafetyDeactivationIssuedWebhookEvent, OpenAI::Models::Webhooks::SafetyOrgAlertCreatedWebhookEvent, OpenAI::Models::Webhooks::SafetyWarningIssuedWebhookEvent)]
       end
     end
   end

data/lib/openai/models/webhooks/webhook_create_params.rb

@@ -62,6 +62,8 @@ module OpenAI
           REALTIME_CALL_INCOMING = :"realtime.call.incoming"
           VIDEO_COMPLETED = :"video.completed"
           VIDEO_FAILED = :"video.failed"
+          AGENT_ENVIRONMENT_READY = :"agent.environment.ready"
+          AGENT_ENVIRONMENT_FAILED = :"agent.environment.failed"
           AGENT_SESSION_CREATED = :"agent.session.created"
           AGENT_SESSION_ACTION_REQUIRED = :"agent.session.action_required"
           AGENT_SESSION_IN_PROGRESS = :"agent.session.in_progress"

data/lib/openai/models/webhooks/webhook_test_params.rb

@@ -48,6 +48,8 @@ module OpenAI
           REALTIME_CALL_INCOMING = :"realtime.call.incoming"
           VIDEO_COMPLETED = :"video.completed"
           VIDEO_FAILED = :"video.failed"
+          AGENT_ENVIRONMENT_READY = :"agent.environment.ready"
+          AGENT_ENVIRONMENT_FAILED = :"agent.environment.failed"
           AGENT_SESSION_CREATED = :"agent.session.created"
           AGENT_SESSION_ACTION_REQUIRED = :"agent.session.action_required"
           AGENT_SESSION_IN_PROGRESS = :"agent.session.in_progress"

data/lib/openai/models/webhooks/webhook_update_params.rb

@@ -69,6 +69,8 @@ module OpenAI
           REALTIME_CALL_INCOMING = :"realtime.call.incoming"
           VIDEO_COMPLETED = :"video.completed"
           VIDEO_FAILED = :"video.failed"
+          AGENT_ENVIRONMENT_READY = :"agent.environment.ready"
+          AGENT_ENVIRONMENT_FAILED = :"agent.environment.failed"
           AGENT_SESSION_CREATED = :"agent.session.created"
           AGENT_SESSION_ACTION_REQUIRED = :"agent.session.action_required"
           AGENT_SESSION_IN_PROGRESS = :"agent.session.in_progress"

data/lib/openai/resources/audio/speech.rb

@@ -26,8 +26,7 @@ module OpenAI
         #   object with an `id`, for example `{ "id": "voice_1234" }`. Previews of the
         #   voices are available in the
         #   [Text to speech guide](https://developers.openai.com/api/docs/guides/text-to-speech#voice-options).
-        #   Custom voices must be created from audio samples. Voices created from text
-        #   prompts are supported only in Live.
+        #   Custom voices must be created from audio samples.
         #
         # @param instructions [String]
         #   Control the voice of your generated audio with additional instructions. Does not

data/lib/openai/resources/audio/voices.rb

@@ -5,21 +5,21 @@ module OpenAI
     class Audio
       # Turn audio into text or text into audio.
       class Voices
-        # Creates a voice from a text prompt or from a consent recording and an audio
-        # sample.
+        # Create a custom voice you can use for audio output (for example, in
+        # Text-to-Speech and the Realtime API). This requires an audio sample and a
+        # previously uploaded consent recording.
         #
-        # For prompt-based creation, send `type: "prompt"` with a `name` and `prompt` as
-        # JSON or multipart form data. For creation from an audio sample, send
-        # `type: "audio_sample"` with a `name`, `audio_sample`, and `consent` recording ID
-        # as multipart form data. The type defaults to `audio_sample` when omitted.
+        # Send `name`, `audio_sample`, and the `consent` recording ID as multipart form
+        # data. The optional `type` defaults to `audio_sample`.
         #
-        # Returns the saved voice's metadata. Voices created from text prompts are
-        # supported only in Live, not in Realtime or the speech endpoint. The response
-        # does not include preview audio.
+        # Returns the saved voice's metadata. See the
+        # [custom voices guide](https://developers.openai.com/api/docs/guides/text-to-speech#custom-voices)
+        # for requirements and best practices. Custom voices are limited to eligible
+        # customers.
         #
         # @overload create(body:, request_options: {})
         #
-        # @param body [OpenAI::Models::Audio::VoiceCreateParams::Body::AudioSample, OpenAI::Models::Audio::VoiceCreateParams::Body::Prompt]
+        # @param body [OpenAI::Models::Audio::VoiceCreateParams::Body::AudioSample]
         #   Creates a voice from a consent recording and an audio sample. Requires
         #   multipart/form-data.
         #

data/lib/openai/resources/beta/agents/environments/files.rb

@@ -59,10 +59,11 @@ module OpenAI
               @client.request(
                 method: :post,
                 path: ["agents/environments/%1$s/files", environment_id],
+                headers: {"openai-beta" => "agents=v1"},
                 body: parsed[:hosted_environment_file_param],
                 model: OpenAI::Beta::Agents::Environments::EnvironmentFile,
                 security: {bearer_auth: true},
-                options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **options}
+                options: options
               )
             end
 
@@ -99,10 +100,11 @@ module OpenAI
                 method: :get,
                 path: ["agents/environments/%1$s/files", environment_id],
                 query: query,
+                headers: {"openai-beta" => "agents=v1"},
                 page: OpenAI::Internal::TokenPage,
                 model: OpenAI::Beta::Agents::Environments::EnvironmentFile,
                 security: {bearer_auth: true},
-                options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **options}
+                options: options
               )
             end
 

data/lib/openai/resources/beta/agents/environments/templates.rb

@@ -56,10 +56,11 @@ module OpenAI
               @client.request(
                 method: :post,
                 path: "agents/environments/templates",
+                headers: {"openai-beta" => "agents=v1"},
                 body: parsed,
                 model: OpenAI::Beta::Agents::Environments::EnvironmentTemplate,
                 security: {bearer_auth: true},
-                options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **options}
+                options: options
               )
             end
 
@@ -81,9 +82,10 @@ module OpenAI
               @client.request(
                 method: :get,
                 path: ["agents/environments/templates/%1$s", environment_template_id],
+                headers: {"openai-beta" => "agents=v1"},
                 model: OpenAI::Beta::Agents::Environments::EnvironmentTemplate,
                 security: {bearer_auth: true},
-                options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **params[:request_options].to_h}
+                options: params[:request_options]
               )
             end
 
@@ -137,10 +139,11 @@ module OpenAI
               @client.request(
                 method: :post,
                 path: ["agents/environments/templates/%1$s", environment_template_id],
+                headers: {"openai-beta" => "agents=v1"},
                 body: parsed,
                 model: OpenAI::Beta::Agents::Environments::EnvironmentTemplate,
                 security: {bearer_auth: true},
-                options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **options}
+                options: options
               )
             end
 
@@ -170,10 +173,11 @@ module OpenAI
                 method: :get,
                 path: "agents/environments/templates",
                 query: query,
+                headers: {"openai-beta" => "agents=v1"},
                 page: OpenAI::Internal::CursorPage,
                 model: OpenAI::Beta::Agents::Environments::EnvironmentTemplate,
                 security: {bearer_auth: true},
-                options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **options}
+                options: options
               )
             end
 
@@ -195,9 +199,10 @@ module OpenAI
               @client.request(
                 method: :delete,
                 path: ["agents/environments/templates/%1$s", environment_template_id],
+                headers: {"openai-beta" => "agents=v1"},
                 model: OpenAI::Beta::Agents::Environments::EnvironmentTemplateDeleted,
                 security: {bearer_auth: true},
-                options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **params[:request_options].to_h}
+                options: params[:request_options]
               )
             end
 

data/lib/openai/resources/beta/agents/environments.rb

@@ -11,6 +11,47 @@ module OpenAI
           # @return [OpenAI::Resources::Beta::Agents::Environments::Templates]
           attr_reader :templates
 
+          # Creates an OpenAI-hosted environment before creating a session. Requires access
+          # to the prewarming beta.
+          #
+          # @overload create(environment:, vault_ids: nil, idempotency_key: nil, request_options: {})
+          #
+          # @param environment [OpenAI::Models::Beta::Agents::EnvironmentCreateParams::Environment]
+          #   Body param: The required hosting type and its configuration.
+          #
+          # @param vault_ids [Array<String>, nil]
+          #   Body param: The IDs of up to 10 vaults made available to an OpenAI-hosted
+          #   environment.
+          #
+          # @param idempotency_key [String]
+          #   Header param: Deduplicates creation for 24 hours within the authenticated
+          #   organization, project, and creator. Retry the same JSON parameters with the same
+          #   key to retrieve the original environment in its current state. Different
+          #   parameters or an incomplete hosted creation return 409. Deleted environments are
+          #   not recreated. After retention expires, the key may create a new environment.
+          #   Without this header, each request creates a new environment.
+          #
+          # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [OpenAI::Models::Beta::Agents::EnvironmentInfo]
+          #
+          # @see OpenAI::Models::Beta::Agents::EnvironmentCreateParams
+          def create(params)
+            parsed, options = OpenAI::Beta::Agents::EnvironmentCreateParams.dump_request(params)
+            header_params = {idempotency_key: "idempotency-key"}
+            @client.request(
+              method: :post,
+              path: "agents/environments",
+              headers: {"openai-beta" => "agents=v1"}.merge(
+                parsed.slice(*header_params.keys).transform_keys(header_params)
+              ),
+              body: parsed.except(*header_params.keys),
+              model: OpenAI::Beta::Agents::EnvironmentInfo,
+              security: {bearer_auth: true},
+              options: options
+            )
+          end
+
           # Retrieves an execution environment's connection status and safe installed
           # metadata. See
           # [environment lifecycle](https://developers.openai.com/api/docs/guides/agents-api/environments/lifecycle).
@@ -29,9 +70,47 @@ module OpenAI
             @client.request(
               method: :get,
               path: ["agents/environments/%1$s", environment_id],
+              headers: {"openai-beta" => "agents=v1"},
+              model: OpenAI::Beta::Agents::EnvironmentInfo,
+              security: {bearer_auth: true},
+              options: params[:request_options]
+            )
+          end
+
+          # Lists OpenAI-hosted environments owned by the authenticated principal. Requires
+          # access to the prewarming beta.
+          #
+          # @overload list(after: nil, limit: nil, order: nil, type: nil, request_options: {})
+          #
+          # @param after [String]
+          #   Return environments after this environment ID in the selected order.
+          #
+          # @param limit [Integer]
+          #   The maximum number of environments to return, between 1 and 100. Defaults to 20.
+          #
+          # @param order [Symbol, OpenAI::Models::Beta::Agents::EnvironmentListParams::Order]
+          #   The order in which environments are returned. Defaults to `desc`.
+          #
+          # @param type [Symbol, OpenAI::Models::Beta::Agents::EnvironmentListParams::Type]
+          #   The hosting type to list. Defaults to `openai_hosted`.
+          #
+          # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [OpenAI::Internal::CursorPage<OpenAI::Models::Beta::Agents::EnvironmentInfo>]
+          #
+          # @see OpenAI::Models::Beta::Agents::EnvironmentListParams
+          def list(params = {})
+            parsed, options = OpenAI::Beta::Agents::EnvironmentListParams.dump_request(params)
+            query = OpenAI::Internal::Util.encode_query_params(parsed)
+            @client.request(
+              method: :get,
+              path: "agents/environments",
+              query: query,
+              headers: {"openai-beta" => "agents=v1"},
+              page: OpenAI::Internal::CursorPage,
               model: OpenAI::Beta::Agents::EnvironmentInfo,
               security: {bearer_auth: true},
-              options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **params[:request_options].to_h}
+              options: options
             )
           end
 

data/lib/openai/resources/beta/agents/sessions/artifacts.rb

@@ -39,9 +39,10 @@ module OpenAI
               @client.request(
                 method: :get,
                 path: ["agents/sessions/%1$s/artifacts/%2$s", session_id, artifact_id],
+                headers: {"openai-beta" => "agents=v1"},
                 model: OpenAI::Beta::Agents::Sessions::SessionArtifact,
                 security: {bearer_auth: true},
-                options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **options}
+                options: options
               )
             end
 
@@ -77,10 +78,11 @@ module OpenAI
                 method: :get,
                 path: ["agents/sessions/%1$s/artifacts", session_id],
                 query: query,
+                headers: {"openai-beta" => "agents=v1"},
                 page: OpenAI::Internal::CursorPage,
                 model: OpenAI::Beta::Agents::Sessions::SessionArtifact,
                 security: {bearer_auth: true},
-                options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **options}
+                options: options
               )
             end
 
@@ -110,9 +112,10 @@ module OpenAI
               @client.request(
                 method: :delete,
                 path: ["agents/sessions/%1$s/artifacts/%2$s", session_id, artifact_id],
+                headers: {"openai-beta" => "agents=v1"},
                 model: OpenAI::Beta::Agents::Sessions::SessionArtifactDeleted,
                 security: {bearer_auth: true},
-                options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **options}
+                options: options
               )
             end
 
@@ -142,10 +145,10 @@ module OpenAI
               @client.request(
                 method: :get,
                 path: ["agents/sessions/%1$s/artifacts/%2$s/content", session_id, artifact_id],
-                headers: {"accept" => "application/octet-stream"},
+                headers: {"openai-beta" => "agents=v1", "accept" => "application/octet-stream"},
                 model: StringIO,
                 security: {bearer_auth: true},
-                options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **options}
+                options: options
               )
             end
 

data/lib/openai/resources/beta/agents/sessions/events.rb

@@ -37,11 +37,13 @@ module OpenAI
               @client.request(
                 method: :post,
                 path: ["agents/sessions/%1$s/events", session_id],
-                headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+                headers: {"openai-beta" => "agents=v1"}.merge(
+                  parsed.slice(*header_params.keys).transform_keys(header_params)
+                ),
                 body: parsed.except(*header_params.keys),
                 model: NilClass,
                 security: {bearer_auth: true},
-                options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **options}
+                options: options
               )
             end
 
@@ -62,11 +64,15 @@ module OpenAI
               @client.request(
                 method: :get,
                 path: ["agents/sessions/%1$s/events", session_id],
-                headers: {"accept" => "text/event-stream", "accept-encoding" => "identity"},
+                headers: {
+                  "openai-beta" => "agents=v1",
+                  "accept" => "text/event-stream",
+                  "accept-encoding" => "identity"
+                },
                 stream: OpenAI::Internal::Stream,
                 model: OpenAI::Beta::AgentSessionEvent,
                 security: {bearer_auth: true},
-                options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **params[:request_options].to_h}
+                options: params[:request_options]
               )
             end
 

data/lib/openai/resources/beta/agents/sessions/items.rb

@@ -36,10 +36,11 @@ module OpenAI
                 method: :get,
                 path: ["agents/sessions/%1$s/items", session_id],
                 query: query,
+                headers: {"openai-beta" => "agents=v1"},
                 page: OpenAI::Internal::CursorPage,
                 model: OpenAI::Beta::AgentSessionItem,
                 security: {bearer_auth: true},
-                options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **options}
+                options: options
               )
             end
 

data/lib/openai/resources/beta/agents/sessions/subagents/items.rb

@@ -44,10 +44,11 @@ module OpenAI
                   method: :get,
                   path: ["agents/sessions/%1$s/subagents/%2$s/items", session_id, subagent_id],
                   query: query,
+                  headers: {"openai-beta" => "agents=v1"},
                   page: OpenAI::Internal::CursorPage,
                   model: OpenAI::Beta::AgentSessionItem,
                   security: {bearer_auth: true},
-                  options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **options}
+                  options: options
                 )
               end