openai 0.102.0 → 0.104.0

data/lib/openai/models/video_create_error.rb

@@ -27,7 +27,19 @@ module OpenAI
       #   @return [OpenAI::Models::VideoCreateError::Misalignment, nil]
       optional :misalignment, -> { OpenAI::VideoCreateError::Misalignment }
 
-      # @!method initialize(code:, message:, headers: nil, misalignment: nil)
+      # @!attribute param
+      #   The request parameter associated with the error, or null if none was recorded.
+      #
+      #   @return [String, nil]
+      optional :param, String, nil?: true
+
+      # @!attribute type
+      #   The original error type, or null if it was not recorded.
+      #
+      #   @return [String, nil]
+      optional :type, String, nil?: true
+
+      # @!method initialize(code:, message:, headers: nil, misalignment: nil, param: nil, type: nil)
       #   An error that occurred while generating the response.
       #
       #   @param code [String]
@@ -41,6 +53,12 @@ module OpenAI
       #     any.
       #
       #   @param misalignment [OpenAI::Models::VideoCreateError::Misalignment]
+      #
+      #   @param param [String, nil]
+      #     The request parameter associated with the error, or null if none was recorded.
+      #
+      #   @param type [String, nil]
+      #     The original error type, or null if it was not recorded.
 
       # @see OpenAI::Models::VideoCreateError#misalignment
       class Misalignment < OpenAI::Internal::Type::BaseModel

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

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Webhooks
+      class AgentEnvironmentExpiredWebhookEvent < 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::AgentEnvironmentExpiredWebhookEvent::Data]
+        required :data, -> { OpenAI::Webhooks::AgentEnvironmentExpiredWebhookEvent::Data }
+
+        # @!attribute object
+        #   The object type. Always `event`.
+        #
+        #   @return [Symbol, :event]
+        required :object, const: :event
+
+        # @!attribute type
+        #   The event type. Always `agent.environment.expired`.
+        #
+        #   @return [Symbol, :"agent.environment.expired"]
+        required :type, const: :"agent.environment.expired"
+
+        # @!method initialize(id:, created_at:, data:, object: :event, type: :"agent.environment.expired")
+        #   Sent when an agent environment expires and can no longer resume from a snapshot.
+        #
+        #   @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::AgentEnvironmentExpiredWebhookEvent::Data]
+        #     Identifies the environment whose lifecycle changed.
+        #
+        #   @param object [Symbol, :event]
+        #     The object type. Always `event`.
+        #
+        #   @param type [Symbol, :"agent.environment.expired"]
+        #     The event type. Always `agent.environment.expired`.
+
+        # @see OpenAI::Models::Webhooks::AgentEnvironmentExpiredWebhookEvent#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_suspended_webhook_event.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Webhooks
+      class AgentEnvironmentSuspendedWebhookEvent < 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::AgentEnvironmentSuspendedWebhookEvent::Data]
+        required :data, -> { OpenAI::Webhooks::AgentEnvironmentSuspendedWebhookEvent::Data }
+
+        # @!attribute object
+        #   The object type. Always `event`.
+        #
+        #   @return [Symbol, :event]
+        required :object, const: :event
+
+        # @!attribute type
+        #   The event type. Always `agent.environment.suspended`.
+        #
+        #   @return [Symbol, :"agent.environment.suspended"]
+        required :type, const: :"agent.environment.suspended"
+
+        # @!method initialize(id:, created_at:, data:, object: :event, type: :"agent.environment.suspended")
+        #   Sent when an agent environment is suspended and can resume from a snapshot.
+        #
+        #   @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::AgentEnvironmentSuspendedWebhookEvent::Data]
+        #     Identifies the environment whose lifecycle changed.
+        #
+        #   @param object [Symbol, :event]
+        #     The object type. Always `event`.
+        #
+        #   @param type [Symbol, :"agent.environment.suspended"]
+        #     The event type. Always `agent.environment.suspended`.
+
+        # @see OpenAI::Models::Webhooks::AgentEnvironmentSuspendedWebhookEvent#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,19 +3,24 @@
 module OpenAI
   module Models
     module Webhooks
-      # Sent when setup fails for a prewarmed OpenAI-hosted environment before it is
-      # attached to a session.
+      # Sent when an agent environment expires and can no longer resume from a snapshot.
       module UnwrapWebhookEvent
         extend OpenAI::Internal::Type::Union
 
         discriminator :type
 
+        # Sent when an agent environment expires and can no longer resume from a snapshot.
+        variant :"agent.environment.expired", -> { OpenAI::Webhooks::AgentEnvironmentExpiredWebhookEvent }
+
         # 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 environment is suspended and can resume from a snapshot.
+        variant :"agent.environment.suspended", -> { OpenAI::Webhooks::AgentEnvironmentSuspendedWebhookEvent }
+
         # Sent when an agent session requires an action. Retrieve the session for action details.
         variant :"agent.session.action_required", -> { OpenAI::Webhooks::AgentSessionActionRequiredWebhookEvent }
 
@@ -103,7 +108,7 @@ module OpenAI
         variant :"safety.warning_issued", -> { OpenAI::Webhooks::SafetyWarningIssuedWebhookEvent }
 
         # @!method self.variants
-        #   @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)]
+        #   @return [Array(OpenAI::Models::Webhooks::AgentEnvironmentExpiredWebhookEvent, OpenAI::Models::Webhooks::AgentEnvironmentFailedWebhookEvent, OpenAI::Models::Webhooks::AgentEnvironmentReadyWebhookEvent, OpenAI::Models::Webhooks::AgentEnvironmentSuspendedWebhookEvent, 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

@@ -64,6 +64,8 @@ module OpenAI
           VIDEO_FAILED = :"video.failed"
           AGENT_ENVIRONMENT_READY = :"agent.environment.ready"
           AGENT_ENVIRONMENT_FAILED = :"agent.environment.failed"
+          AGENT_ENVIRONMENT_SUSPENDED = :"agent.environment.suspended"
+          AGENT_ENVIRONMENT_EXPIRED = :"agent.environment.expired"
           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_endpoint_with_secret.rb

@@ -90,15 +90,6 @@ module OpenAI
         #
         #   @param object [Symbol, :webhook_endpoint]
         #     The object type, which is always webhook_endpoint.
-
-        # Keep diagnostics safe without changing field access or serialization.
-        def to_s = deep_to_h.merge(signing_secret: "[REDACTED]").to_s
-
-        def inspect
-          converted = self.class.recursively_to_h(self, convert: true)
-          converted[:signing_secret] = "[REDACTED]"
-          "#<#{self.class}:0x#{object_id.to_s(16)} #{converted}>"
-        end
       end
     end
   end

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

@@ -50,6 +50,8 @@ module OpenAI
           VIDEO_FAILED = :"video.failed"
           AGENT_ENVIRONMENT_READY = :"agent.environment.ready"
           AGENT_ENVIRONMENT_FAILED = :"agent.environment.failed"
+          AGENT_ENVIRONMENT_SUSPENDED = :"agent.environment.suspended"
+          AGENT_ENVIRONMENT_EXPIRED = :"agent.environment.expired"
           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

@@ -71,6 +71,8 @@ module OpenAI
           VIDEO_FAILED = :"video.failed"
           AGENT_ENVIRONMENT_READY = :"agent.environment.ready"
           AGENT_ENVIRONMENT_FAILED = :"agent.environment.failed"
+          AGENT_ENVIRONMENT_SUSPENDED = :"agent.environment.suspended"
+          AGENT_ENVIRONMENT_EXPIRED = :"agent.environment.expired"
           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/admin/organization/external_storage.rb

@@ -10,7 +10,7 @@ module OpenAI
           # @overload create(project_id:, provider:, request_options: {})
           #
           # @param project_id [String]
-          # @param provider [OpenAI::Models::Admin::Organization::ExternalStorageCreateParams::Provider::Aws, OpenAI::Models::Admin::Organization::ExternalStorageCreateParams::Provider::Azure, OpenAI::Models::Admin::Organization::ExternalStorageCreateParams::Provider::Gcp]
+          # @param provider [OpenAI::Models::Admin::Organization::ExternalStorageCreateParams::Provider::Aws, OpenAI::Models::Admin::Organization::ExternalStorageCreateParams::Provider::Azure, OpenAI::Models::Admin::Organization::ExternalStorageCreateParams::Provider::Gcp, OpenAI::Models::Admin::Organization::ExternalStorageCreateParams::Provider::Oci]
           # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
           #
           # @return [OpenAI::Models::Admin::Organization::ExternalStorageConfiguration]

data/lib/openai/resources/admin/organization/projects/api_keys.rb

@@ -36,6 +36,67 @@ module OpenAI
               )
             end
 
+            # Updates the scopes and/or expiration of an existing API key in the project,
+            # including a service-account-owned key. Requires permission to write project API
+            # keys.
+            #
+            # Provide at least one of `scopes` or `expires_in_seconds`. Omitted fields stay
+            # unchanged; neither field accepts `null`. Both changes are saved together.
+            #
+            # `scopes` replaces the key's scope restrictions using the same scope identifiers
+            # as the dashboard. An empty array means All permissions, subject to the owner's
+            # effective access; it does not mean no access. Use `["api.all.read"]` for
+            # read-only access or specific scopes such as `["api.files.read"]` for restricted
+            # access. This does not change user or service-account roles or grant admin
+            # permissions. Scope changes follow the same authentication-cache propagation as
+            # dashboard edits.
+            #
+            # Provide `expires_in_seconds` to set the expiration relative to this request. The
+            # value must satisfy the organization's and project's expiry policies. Expired
+            # keys cannot be updated. Retrying resets the expiration relative to the new
+            # request. The response contains only the redacted key, not its secret.
+            #
+            # @overload update(api_key_id, project_id:, expires_in_seconds: nil, scopes: nil, request_options: {})
+            #
+            # @param api_key_id [String]
+            #   Path param: The ID of the API key.
+            #
+            # @param project_id [String]
+            #   Path param: The ID of the project.
+            #
+            # @param expires_in_seconds [Integer]
+            #   Body param: Number of seconds from this request until the API key expires. Must
+            #   comply with the organization and project expiry policies. Expired keys cannot be
+            #   updated. Retrying resets the expiry relative to the new request. Omit to keep
+            #   the current expiration.
+            #
+            # @param scopes [Array<String>]
+            #   Body param: Replace the API key scope restrictions. Omit to leave scopes
+            #   unchanged. An empty array removes key restrictions (All permissions), subject to
+            #   the owner's effective permissions. Use ["api.all.read"] for read-only access.
+            #   Scopes do not change the owner's roles or grant administrative permissions.
+            #
+            # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+            #
+            # @return [OpenAI::Models::Admin::Organization::Projects::ProjectAPIKey]
+            #
+            # @see OpenAI::Models::Admin::Organization::Projects::APIKeyUpdateParams
+            def update(api_key_id, params)
+              parsed, options = OpenAI::Admin::Organization::Projects::APIKeyUpdateParams.dump_request(params)
+              project_id = parsed.delete(:project_id) do
+                raise ArgumentError.new("missing required path argument #{_1}")
+              end
+
+              @client.request(
+                method: :post,
+                path: ["organization/projects/%1$s/api_keys/%2$s", project_id, api_key_id],
+                body: parsed,
+                model: OpenAI::Admin::Organization::Projects::ProjectAPIKey,
+                security: {admin_api_key_auth: true},
+                options: options
+              )
+            end
+
             # Returns a list of API keys in the project.
             #
             # @overload list(project_id, after: nil, limit: nil, owner_project_access: nil, request_options: {})

data/lib/openai/resources/admin/organization/usage.rb

@@ -298,6 +298,73 @@ module OpenAI
             )
           end
 
+          # Get Decisions API usage details for the organization.
+          #
+          # @overload decisions(start_time:, api_key_ids: nil, batch: nil, bucket_width: nil, end_time: nil, group_by: nil, limit: nil, models: nil, page: nil, project_ids: nil, user_ids: nil, request_options: {})
+          #
+          # @param start_time [Integer]
+          #   Start time (Unix seconds) of the query time range, inclusive.
+          #
+          # @param api_key_ids [Array<String>, nil]
+          #   Return only usage for these API keys.
+          #
+          # @param batch [Boolean, nil]
+          #   If `true`, return batch jobs only. If `false`, return non-batch jobs only. By
+          #   default, return both.
+          #
+          # @param bucket_width [Symbol, OpenAI::Models::Admin::Organization::UsageDecisionsParams::BucketWidth, nil]
+          #   Width of each time bucket in response. Currently `1m`, `1h` and `1d` are
+          #   supported, default to `1d`.
+          #
+          # @param end_time [Integer, nil]
+          #   End time (Unix seconds) of the query time range, exclusive.
+          #
+          # @param group_by [Array<Symbol, OpenAI::Models::Admin::Organization::UsageDecisionsParams::GroupBy>, nil]
+          #   Group the usage data by the specified fields. Support fields include
+          #   `project_id`, `user_id`, `api_key_id`, `model`, `batch`, `service_tier`,
+          #   `api_source` or any combination of them. When grouped by `api_source`, results
+          #   use `agents_api` for attributed Agents API activity and `unlabeled` for all
+          #   other activity. Without source grouping, `api_source` is null.
+          #
+          # @param limit [Integer, nil]
+          #   Specifies the number of buckets to return.
+          #
+          #   - `bucket_width=1d`: default: 7, max: 31
+          #   - `bucket_width=1h`: default: 24, max: 168
+          #   - `bucket_width=1m`: default: 60, max: 1440
+          #
+          # @param models [Array<String>, nil]
+          #   Return only usage for these models.
+          #
+          # @param page [String, nil]
+          #   A cursor for use in pagination. Corresponding to the `next_page` field from the
+          #   previous response.
+          #
+          # @param project_ids [Array<String>, nil]
+          #   Return only usage for these projects.
+          #
+          # @param user_ids [Array<String>, nil]
+          #   Return only usage for these users.
+          #
+          # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [OpenAI::Models::Admin::Organization::UsageDecisionsResponse]
+          #
+          # @see OpenAI::Models::Admin::Organization::UsageDecisionsParams
+          def decisions(params)
+            parsed, options = OpenAI::Admin::Organization::UsageDecisionsParams.dump_request(params)
+            # Nil optional filters mean unset; empty query values fail backend parsing.
+            query = OpenAI::Internal::Util.encode_query_params(parsed.compact)
+            @client.request(
+              method: :get,
+              path: "organization/usage/decisions",
+              query: query,
+              model: OpenAI::Models::Admin::Organization::UsageDecisionsResponse,
+              security: {admin_api_key_auth: true},
+              options: options
+            )
+          end
+
           # Get embeddings usage details for the organization.
           #
           # @overload embeddings(start_time:, api_key_ids: nil, bucket_width: nil, end_time: nil, group_by: nil, limit: nil, models: nil, page: nil, project_ids: nil, user_ids: nil, request_options: {})

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

@@ -26,7 +26,8 @@ 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.
+        #   Custom voices must be created from audio samples. Voices created from text
+        #   prompts are supported only in Live.
         #
         # @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
-        # 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.
+        # Creates a voice from a text prompt or from a consent recording and an audio
+        # sample.
         #
-        # Send `name`, `audio_sample`, and the `consent` recording ID as multipart form
-        # data. The optional `type` defaults to `audio_sample`.
+        # 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.
         #
-        # 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.
+        # 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.
         #
         # @overload create(body:, request_options: {})
         #
-        # @param body [OpenAI::Models::Audio::VoiceCreateParams::Body::AudioSample]
+        # @param body [OpenAI::Models::Audio::VoiceCreateParams::Body::AudioSample, OpenAI::Models::Audio::VoiceCreateParams::Body::Prompt]
         #   Creates a voice from a consent recording and an audio sample. Requires
         #   multipart/form-data.
         #

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

@@ -8,37 +8,9 @@ module OpenAI
       class Agents
         class Environments
           class Files
-            # Upload selected local files for a new hosted environment (beta).
-            # @return [OpenAI::Helpers::Beta::Agents::PreparedFiles]
-            def prepare(files, request_options: {})
-              OpenAI::Helpers::Beta::Agents::FilePreparation
-                .new(client: @client, environment_files: self)
-                .prepare(files, request_options: request_options)
-            end
-
-            # Upload an explicitly selected directory snapshot (beta).
-            # @return [OpenAI::Helpers::Beta::Agents::PreparedFiles]
-            def prepare_directory(directory, destination:, include:, request_options: {})
-              OpenAI::Helpers::Beta::Agents::FilePreparation
-                .new(client: @client, environment_files: self)
-                .prepare_directory(
-                  directory,
-                  destination: destination,
-                  include: include,
-                  request_options: request_options
-                )
-            end
-
-            # Upload and stage a local file in an existing environment (beta).
-            # @return [OpenAI::Helpers::Beta::Agents::PreparedFiles]
-            def upload(environment_id, file:, path:, request_options: {})
-              OpenAI::Helpers::Beta::Agents::FilePreparation
-                .new(client: @client, environment_files: self)
-                .upload(environment_id, file: file, path: path, request_options: request_options)
-            end
-
-            # Copies inline bytes or a Files API file into a connected execution environment.
-            # See
+            # Copies inline bytes or a Files API file into a connected execution environment,
+            # replacing an existing regular file at the same path. Upload between turns and
+            # wait for success before starting the next turn. See
             # [environment files](https://developers.openai.com/api/docs/guides/agents-api/environments/files).
             #
             # @overload create(environment_id, hosted_environment_file_param:, request_options: {})

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

@@ -83,13 +83,13 @@ module OpenAI
           # @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.
+          #   Return resources after this resource ID in the selected order.
           #
           # @param limit [Integer]
-          #   The maximum number of environments to return, between 1 and 100. Defaults to 20.
+          #   The maximum number of resources 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`.
+          #   The order in which resources are returned. Defaults to `desc`.
           #
           # @param type [Symbol, OpenAI::Models::Beta::Agents::EnvironmentListParams::Type]
           #   The hosting type to list. Defaults to `openai_hosted`.

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

@@ -8,12 +8,6 @@ module OpenAI
       class Agents
         class Sessions
           class Artifacts
-            # Access artifacts from exactly this completed turn (beta).
-            # @return [OpenAI::Helpers::Beta::Agents::ResultArtifacts]
-            def for_result(result)
-              OpenAI::Helpers::Beta::Agents::ResultArtifacts.new(artifacts: self, client: @client, result: result)
-            end
-
             # Retrieves immutable metadata for one durable session artifact. See
             # [session artifacts](https://developers.openai.com/api/docs/guides/agents-api/environments/files#openai-hosted-artifacts).
             #
@@ -54,17 +48,17 @@ module OpenAI
             # @param session_id [String]
             #   The ID of the session.
             #
-            # @param after [String, nil]
-            #   Return artifacts after this immutable artifact ID.
+            # @param after [String]
+            #   Return resources after this resource ID in the selected order.
             #
             # @param environment_id [String, nil]
             #   Restrict the listing to artifacts produced by this environment.
             #
-            # @param limit [Integer, nil]
-            #   The maximum number of artifacts to return, between 1 and 100.
+            # @param limit [Integer]
+            #   The maximum number of resources to return, between 1 and 100. Defaults to 20.
             #
             # @param order [Symbol, OpenAI::Models::Beta::Agents::Sessions::ArtifactListParams::Order]
-            #   Sort by creation time and ID. Defaults to descending.
+            #   The order in which resources are returned. Defaults to `desc`.
             #
             # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
             #

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

@@ -57,7 +57,7 @@ module OpenAI
             #
             # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
             #
-            # @return [OpenAI::Internal::Stream<OpenAI::Models::Beta::AgentSessionErrorEvent, OpenAI::Models::Beta::AgentSessionEnvironmentReadyEvent, OpenAI::Models::Beta::AgentSessionEnvironmentResetEvent, OpenAI::Models::Beta::AgentOutputCommandExecutionOutputDeltaEvent, OpenAI::Models::Beta::AgentSessionCreatedEvent, OpenAI::Models::Beta::AgentSessionTurnCreatedEvent, OpenAI::Models::Beta::AgentSessionTurnInProgressEvent, OpenAI::Models::Beta::AgentSessionTurnCompletedEvent, OpenAI::Models::Beta::AgentSessionTurnFailedEvent, OpenAI::Models::Beta::AgentSessionTurnCancelledEvent, OpenAI::Models::Beta::AgentSessionTurnItemAddedEvent, OpenAI::Models::Beta::AgentSessionIdleEvent, OpenAI::Models::Beta::AgentSessionInProgressEvent, OpenAI::Models::Beta::AgentSessionRequiresActionEvent, OpenAI::Models::Beta::AgentSessionFailedEvent, OpenAI::Models::Beta::AgentSessionEnvironmentPendingEvent, OpenAI::Models::Beta::AgentSessionEnvironmentConnectedEvent, OpenAI::Models::Beta::AgentSessionEnvironmentDisconnectedEvent, OpenAI::Models::Beta::AgentSessionEnvironmentFailedEvent, OpenAI::Models::Beta::AgentSessionSubagentCreatedEvent, OpenAI::Models::Beta::AgentSessionSubagentActiveEvent, OpenAI::Models::Beta::AgentSessionSubagentClosedEvent, OpenAI::Models::Beta::AgentSessionTurnItemDoneEvent, OpenAI::Models::Beta::AgentSessionTurnContentPartAddedEvent, OpenAI::Models::Beta::AgentSessionTurnContentPartDoneEvent, OpenAI::Models::Beta::AgentSessionTurnOutputTextDeltaEvent, OpenAI::Models::Beta::AgentSessionTurnOutputTextDoneEvent, OpenAI::Models::Beta::AgentSessionTurnReasoningSummaryPartAddedEvent, OpenAI::Models::Beta::AgentSessionTurnReasoningSummaryPartDoneEvent, OpenAI::Models::Beta::AgentSessionTurnReasoningSummaryTextDeltaEvent, OpenAI::Models::Beta::AgentSessionTurnReasoningSummaryTextDoneEvent>]
+            # @return [OpenAI::Internal::Stream<OpenAI::Models::Beta::AgentSessionErrorEvent, OpenAI::Models::Beta::AgentSessionEnvironmentReadyEvent, OpenAI::Models::Beta::AgentSessionEnvironmentSuspendedEvent, OpenAI::Models::Beta::AgentSessionEnvironmentExpiredEvent, OpenAI::Models::Beta::AgentSessionEnvironmentResetEvent, OpenAI::Models::Beta::AgentOutputCommandExecutionOutputDeltaEvent, OpenAI::Models::Beta::AgentSessionCreatedEvent, OpenAI::Models::Beta::AgentSessionTurnCreatedEvent, OpenAI::Models::Beta::AgentSessionTurnInProgressEvent, OpenAI::Models::Beta::AgentSessionTurnCompletedEvent, OpenAI::Models::Beta::AgentSessionTurnFailedEvent, OpenAI::Models::Beta::AgentSessionTurnCancelledEvent, OpenAI::Models::Beta::AgentSessionTurnItemAddedEvent, OpenAI::Models::Beta::AgentSessionIdleEvent, OpenAI::Models::Beta::AgentSessionInProgressEvent, OpenAI::Models::Beta::AgentSessionRequiresActionEvent, OpenAI::Models::Beta::AgentSessionFailedEvent, OpenAI::Models::Beta::AgentSessionEnvironmentPendingEvent, OpenAI::Models::Beta::AgentSessionEnvironmentConnectedEvent, OpenAI::Models::Beta::AgentSessionEnvironmentDisconnectedEvent, OpenAI::Models::Beta::AgentSessionEnvironmentFailedEvent, OpenAI::Models::Beta::AgentSessionSubagentCreatedEvent, OpenAI::Models::Beta::AgentSessionSubagentActiveEvent, OpenAI::Models::Beta::AgentSessionSubagentClosedEvent, OpenAI::Models::Beta::AgentSessionTurnItemDoneEvent, OpenAI::Models::Beta::AgentSessionTurnContentPartAddedEvent, OpenAI::Models::Beta::AgentSessionTurnContentPartDoneEvent, OpenAI::Models::Beta::AgentSessionTurnOutputTextDeltaEvent, OpenAI::Models::Beta::AgentSessionTurnOutputTextDoneEvent, OpenAI::Models::Beta::AgentSessionTurnReasoningSummaryPartAddedEvent, OpenAI::Models::Beta::AgentSessionTurnReasoningSummaryPartDoneEvent, OpenAI::Models::Beta::AgentSessionTurnReasoningSummaryTextDeltaEvent, OpenAI::Models::Beta::AgentSessionTurnReasoningSummaryTextDoneEvent>]
             #
             # @see OpenAI::Models::Beta::Agents::Sessions::EventStreamParams
             def stream_streaming(session_id, params = {})