openai 0.103.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/unwrap_webhook_event.rb

@@ -12,15 +12,15 @@ module OpenAI
         # Sent when an agent environment expires and can no longer resume from a snapshot.
         variant :"agent.environment.expired", -> { OpenAI::Webhooks::AgentEnvironmentExpiredWebhookEvent }
 
-        # Sent when an agent environment is suspended and can resume from a snapshot.
-        variant :"agent.environment.suspended", -> { OpenAI::Webhooks::AgentEnvironmentSuspendedWebhookEvent }
-
         # 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 }
 
@@ -108,7 +108,7 @@ module OpenAI
         variant :"safety.warning_issued", -> { OpenAI::Webhooks::SafetyWarningIssuedWebhookEvent }
 
         # @!method self.variants
-        #   @return [Array(OpenAI::Models::Webhooks::AgentEnvironmentExpiredWebhookEvent, OpenAI::Models::Webhooks::AgentEnvironmentSuspendedWebhookEvent, 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_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/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.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require_relative "../../../helpers/agents/session_stream_resource"
+
 module OpenAI
   module Resources
     class Beta
@@ -30,7 +32,7 @@ module OpenAI
           # the session or streams its events when stream is true. See
           # [running sessions](https://developers.openai.com/api/docs/guides/agents-api/sessions).
           #
-          # @overload create(environment:, agent: nil, agent_id: nil, input: nil, metadata: nil, vault_ids: nil, request_options: {})
+          # @overload create(environment:, agent: nil, agent_id: nil, input: nil, metadata: nil, spend_control: nil, vault_ids: nil, request_options: {})
           #
           # @param environment [OpenAI::Models::Beta::EnvironmentParam::None, OpenAI::Models::Beta::EnvironmentParam::OpenAIHosted, OpenAI::Models::Beta::EnvironmentParam::SelfHosted]
           #   An inline execution environment or a reference to an environment template.
@@ -53,6 +55,10 @@ module OpenAI
           #   Up to 16 string key-value pairs, with keys up to 64 and values up to 512
           #   characters. Omission or null defaults to an empty map.
           #
+          # @param spend_control [OpenAI::Models::Beta::Agents::SessionCreateParams::SpendControl, nil]
+          #   Optional spending limit in USD cents. Omission or null creates an unlimited
+          #   session.
+          #
           # @param vault_ids [Array<String>, nil]
           #   The IDs of vaults made available to the session.
           #
@@ -86,7 +92,7 @@ module OpenAI
           # the session or streams its events when stream is true. See
           # [running sessions](https://developers.openai.com/api/docs/guides/agents-api/sessions).
           #
-          # @overload create_streaming(environment:, agent: nil, agent_id: nil, input: nil, output_type: nil, tool_handlers: {}, metadata: nil, vault_ids: nil, request_options: {})
+          # @overload create_streaming(environment:, agent: nil, agent_id: nil, input: nil, output_type: nil, tool_handlers: {}, metadata: nil, spend_control: nil, vault_ids: nil, request_options: {})
           #
           # @param environment [OpenAI::Models::Beta::EnvironmentParam::None, OpenAI::Models::Beta::EnvironmentParam::OpenAIHosted, OpenAI::Models::Beta::EnvironmentParam::SelfHosted]
           #   An inline execution environment or a reference to an environment template.
@@ -109,6 +115,10 @@ module OpenAI
           #   Up to 16 string key-value pairs, with keys up to 64 and values up to 512
           #   characters. Omission or null defaults to an empty map.
           #
+          # @param spend_control [OpenAI::Models::Beta::Agents::SessionCreateParams::SpendControl, nil]
+          #   Optional spending limit in USD cents. Omission or null creates an unlimited
+          #   session.
+          #
           # @param vault_ids [Array<String>, nil]
           #   The IDs of vaults made available to the session.
           #
@@ -182,7 +192,7 @@ module OpenAI
           # settings apply to subsequent turns. Omitted fields are unchanged. See
           # [managing sessions](https://developers.openai.com/api/docs/guides/agents-api/sessions/manage).
           #
-          # @overload update(session_id, agent: nil, metadata: nil, request_options: {})
+          # @overload update(session_id, agent: nil, metadata: nil, spend_control: nil, request_options: {})
           #
           # @param session_id [String]
           #   The ID of the session.
@@ -195,6 +205,10 @@ module OpenAI
           #   Up to 16 string key-value pairs, with keys up to 64 and values up to 512
           #   characters.
           #
+          # @param spend_control [OpenAI::Models::Beta::Agents::SessionUpdateParams::SpendControl, nil]
+          #   Omit to retain the limit; null or a null limit removes it without resetting
+          #   spend.
+          #
           # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
           #
           # @return [OpenAI::Models::Beta::AgentSession]
@@ -226,12 +240,11 @@ module OpenAI
           #   Only return sessions whose root agent has this ID. Omit to return sessions for
           #   all agents.
           #
-          # @param limit [Integer, nil]
-          #   The maximum number of resources to return.
+          # @param limit [Integer]
+          #   The maximum number of resources to return, between 1 and 100. Defaults to 20.
           #
           # @param order [Symbol, OpenAI::Models::Beta::Agents::SessionListParams::Order]
-          #   Sort order by the `created_at` timestamp. Use `asc` for ascending order or
-          #   `desc` for descending order. Defaults to `desc`.
+          #   The order in which resources are returned. Defaults to `desc`.
           #
           # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
           #
@@ -280,55 +293,6 @@ module OpenAI
             )
           end
 
-          # Submit input to an idle session and stream one turn through idle or failure.
-          # The caller must be the session's only input writer during iteration.
-          # Handlers run sequentially; failures submit a generic error without exception text.
-          # Input and each tool result use distinct retry-safe idempotency keys.
-          # A block closes the connection on every exit path without cancelling the turn.
-          #
-          # @param session_id [String]
-          # @param input [String, Array<OpenAI::Models::Beta::AgentSessionInputMessageParam>]
-          # @param tool_handlers [Hash{String=>Proc}]
-          # @param on_tool_error [Proc, nil]
-          #   Beta: use with tool_handlers to log or monitor argument parsing, handler
-          #   execution, and output conversion failures locally. Receives ToolError;
-          #   API/transport errors still propagate normally. Ordinary observer errors
-          #   are ignored, and the submitted tool failure stays generic.
-          # @param idempotency_key [String, nil] Applies only to the input submission.
-          # @param output_type [Class<OpenAI::BaseModel>, nil] Beta: parse output without changing session configuration.
-          # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
-          # @yieldparam stream [OpenAI::Helpers::Agents::SessionStream]
-          # @return [OpenAI::Helpers::Agents::SessionStream]
-          def stream(
-            session_id,
-            input:,
-            tool_handlers: {},
-            on_tool_error: nil,
-            idempotency_key: nil,
-            output_type: nil,
-            request_options: {}
-          )
-            stream = OpenAI::Helpers::Agents::SessionStream.new(
-              sessions: self,
-              session_id: session_id,
-              input: input,
-              tool_handlers: tool_handlers,
-              on_tool_error: on_tool_error,
-              idempotency_key: idempotency_key,
-              output_type: output_type,
-              request_options: request_options
-            )
-            return stream unless block_given?
-
-            begin
-              yield stream
-            ensure
-              stream.close
-            end
-
-            stream
-          end
-
           # @api private
           #
           # @param client [OpenAI::Client]

data/lib/openai/resources/beta/agents/vaults/credentials.rb

@@ -122,7 +122,7 @@ module OpenAI
             # values. See
             # [vaults](https://developers.openai.com/api/docs/guides/agents-api/tools/vaults).
             #
-            # @overload list(vault_id, after: nil, limit: nil, order: nil, status: nil, request_options: {})
+            # @overload list(vault_id, after: nil, limit: nil, metadata: nil, order: nil, status: nil, request_options: {})
             #
             # @param vault_id [String]
             #   The ID of the vault.
@@ -130,13 +130,17 @@ module OpenAI
             # @param after [String]
             #   Return resources after this resource ID in the selected order.
             #
-            # @param limit [Integer, nil]
-            #   The maximum number of resources to return. Defaults to 20. Values are clamped
-            #   between 1 and 100.
+            # @param limit [Integer]
+            #   The maximum number of resources to return, between 1 and 100. Defaults to 20.
+            #
+            # @param metadata [Hash{Symbol=>String}]
+            #   Exact string matches supplied as `metadata[key]=value`. All supplied pairs must
+            #   match. Up to 16 pairs, with keys from 1 to 64 characters and values up to 512
+            #   characters. Filtering is eventually consistent; metadata changes may take time
+            #   to appear.
             #
             # @param order [Symbol, OpenAI::Models::Beta::Agents::Vaults::CredentialListParams::Order]
-            #   Sort order by the `created_at` timestamp. Use `asc` for ascending order or
-            #   `desc` for descending order. Defaults to `desc`.
+            #   The order in which resources are returned. Defaults to `desc`.
             #
             # @param status [Symbol, OpenAI::Models::Beta::Agents::VaultStatus, Array<Symbol, OpenAI::Models::Beta::Agents::VaultStatus>]
             #   Filter by one status or a list, such as `status=active` or

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

@@ -63,21 +63,60 @@ module OpenAI
             )
           end
 
+          # Updates the name or metadata of an active vault. Omitted fields remain
+          # unchanged. See
+          # [vaults](https://developers.openai.com/api/docs/guides/agents-api/tools/vaults).
+          #
+          # @overload update(vault_id, metadata: nil, name: nil, request_options: {})
+          #
+          # @param vault_id [String]
+          #   The ID of the vault.
+          #
+          # @param metadata [Hash{Symbol=>String}]
+          #   Replaces all metadata. Omit to leave unchanged, or pass {} to clear it. Up to 16
+          #   string key-value pairs, with keys up to 64 and values up to 512 characters.
+          #
+          # @param name [String, nil]
+          #   A replacement name. Omit to leave unchanged, or pass null to clear it. The name
+          #   is trimmed before storage. It must contain 1 to 256 UTF-8 bytes after trimming.
+          #
+          # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [OpenAI::Models::Beta::Agents::Vault]
+          #
+          # @see OpenAI::Models::Beta::Agents::VaultUpdateParams
+          def update(vault_id, params = {})
+            parsed, options = OpenAI::Beta::Agents::VaultUpdateParams.dump_request(params)
+            @client.request(
+              method: :post,
+              path: ["vaults/%1$s", vault_id],
+              headers: {"openai-beta" => "agents=v1"},
+              body: parsed,
+              model: OpenAI::Beta::Agents::Vault,
+              security: {bearer_auth: true},
+              options: options
+            )
+          end
+
           # Lists vaults using ID-based pagination. See
           # [vaults](https://developers.openai.com/api/docs/guides/agents-api/tools/vaults).
           #
-          # @overload list(after: nil, limit: nil, order: nil, status: nil, request_options: {})
+          # @overload list(after: nil, limit: nil, metadata: nil, order: nil, status: nil, request_options: {})
           #
           # @param after [String]
           #   Return resources after this resource ID in the selected order.
           #
-          # @param limit [Integer, nil]
-          #   The maximum number of resources to return. Defaults to 20. Values are clamped
-          #   between 1 and 100.
+          # @param limit [Integer]
+          #   The maximum number of resources to return, between 1 and 100. Defaults to 20.
+          #
+          # @param metadata [Hash{Symbol=>String}]
+          #   Exact string matches supplied as `metadata[key]=value`. All supplied pairs must
+          #   match. Up to 16 pairs, with keys from 1 to 64 characters and values up to 512
+          #   characters. Filtering is eventually consistent; metadata changes may take time
+          #   to appear.
           #
           # @param order [Symbol, OpenAI::Models::Beta::Agents::VaultListParams::Order]
-          #   Sort order by the `created_at` timestamp. Use `asc` for ascending order or
-          #   `desc` for descending order. Defaults to `desc`.
+          #   The order in which resources are returned. Defaults to `desc`.
           #
           # @param status [Symbol, OpenAI::Models::Beta::Agents::VaultStatus, Array<Symbol, OpenAI::Models::Beta::Agents::VaultStatus>]
           #   Filter by one status or a list, such as `status=active` or

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

@@ -47,7 +47,8 @@ module OpenAI
         #   verbosity.
         #
         # @param tools [Array<OpenAI::Models::Beta::PersistedAgentToolParam::Function, OpenAI::Models::Beta::PersistedAgentToolParam::ToolSearch, OpenAI::Models::Beta::PersistedAgentToolParam::ProgrammaticToolCalling, OpenAI::Models::Beta::PersistedAgentToolParam::Mcp, OpenAI::Models::Beta::PersistedAgentToolParam::WebSearch, OpenAI::Models::Beta::PersistedAgentToolParam::ComputerUse>, nil]
-        #   Tools available to the agent. Defaults to an empty list.
+        #   Tools available to the agent. Defaults to an empty list. The tool list must fit
+        #   within 3 MiB (3,145,728 bytes) of compact UTF-8 JSON.
         #
         # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -128,7 +129,8 @@ module OpenAI
         #   Configuration for text generated by the agent.
         #
         # @param tools [Array<OpenAI::Models::Beta::PersistedAgentToolParam::Function, OpenAI::Models::Beta::PersistedAgentToolParam::ToolSearch, OpenAI::Models::Beta::PersistedAgentToolParam::ProgrammaticToolCalling, OpenAI::Models::Beta::PersistedAgentToolParam::Mcp, OpenAI::Models::Beta::PersistedAgentToolParam::WebSearch, OpenAI::Models::Beta::PersistedAgentToolParam::ComputerUse>, nil]
-        #   Tools available to the agent.
+        #   Replaces the tool list. Omit to leave it unchanged, or pass null to clear it.
+        #   The replacement must fit within 3 MiB (3,145,728 bytes) of compact UTF-8 JSON.
         #
         # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -156,8 +158,8 @@ module OpenAI
         # @param after [String]
         #   Return resources after this resource ID in the selected order.
         #
-        # @param limit [Integer, nil]
-        #   The maximum number of resources to return.
+        # @param limit [Integer]
+        #   The maximum number of resources to return, between 1 and 100. Defaults to 20.
         #
         # @param order [Symbol, OpenAI::Models::Beta::AgentListParams::Order]
         #   The order in which resources are returned. Defaults to `desc`.