openai 0.103.0 → 0.104.0

data/lib/openai/resources/vector_stores/file_batches.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "../../helpers/resource_polling"
-
 module OpenAI
   module Resources
     class VectorStores
@@ -58,63 +56,6 @@ module OpenAI
           )
         end
 
-        # Create a vector store file batch and wait for processing to finish.
-        #
-        # The returned batch may have a `failed` or `cancelled` status; callers should
-        # inspect its status and file counts. Polling intervals and the overall timeout
-        # are in seconds. Finite timeouts include authentication and request replay
-        # time and disable transport retries so the deadline remains strict. Set
-        # `timeout` to `nil` to wait indefinitely and retain configured transport retries.
-        #
-        # @overload create_and_poll(vector_store_id, attributes: nil, chunking_strategy: nil, file_ids: nil, files: nil, poll_interval: nil, timeout: 1800.0, request_options: {})
-        #
-        # @param vector_store_id [String] The ID of the vector store for which to create a File Batch.
-        #
-        # @param attributes [Hash{Symbol=>String, Float, Boolean}, nil] Attributes to apply to each file in `file_ids`.
-        #
-        # @param chunking_strategy [OpenAI::Models::AutoFileChunkingStrategyParam, OpenAI::Models::StaticFileChunkingStrategyObjectParam] The chunking strategy used to chunk the files.
-        #
-        # @param file_ids [Array<String>] File IDs to add to the vector store.
-        #
-        # @param files [Array<OpenAI::Models::VectorStores::FileBatchCreateParams::File>] File IDs with per-file attributes or chunking strategies.
-        #
-        # @param poll_interval [Integer, Float, nil] How often to retrieve the batch. When omitted, the SDK honors the server's
-        #   polling hint and otherwise waits 5 seconds.
-        #
-        # @param timeout [Integer, Float, nil] Maximum total time to poll. Defaults to 30 minutes. Set to `nil` to wait
-        #   indefinitely.
-        #
-        # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
-        #
-        # @raise [ArgumentError, OpenAI::Errors::PollingError]
-        # @return [OpenAI::Models::VectorStores::VectorStoreFileBatch]
-        def create_and_poll(
-          vector_store_id,
-          attributes: nil,
-          chunking_strategy: nil,
-          file_ids: nil,
-          files: nil,
-          poll_interval: nil,
-          timeout: OpenAI::Internal::Poller::DEFAULT_TIMEOUT,
-          request_options: {}
-        )
-          OpenAI::Internal::Poller.validate!(poll_interval: poll_interval, timeout: timeout)
-
-          params = {request_options: request_options}
-          params[:attributes] = attributes unless attributes.nil?
-          params[:chunking_strategy] = chunking_strategy unless chunking_strategy.nil?
-          params[:file_ids] = file_ids unless file_ids.nil?
-          params[:files] = files unless files.nil?
-          batch = create(vector_store_id, params)
-          poll(
-            batch.id,
-            vector_store_id: vector_store_id,
-            poll_interval: poll_interval,
-            timeout: timeout,
-            request_options: request_options
-          )
-        end
-
         # Retrieves a vector store file batch.
         #
         # @overload retrieve(batch_id, vector_store_id:, request_options: {})
@@ -236,125 +177,6 @@ module OpenAI
           )
         end
 
-        # Wait for a vector store file batch to finish processing.
-        #
-        # The returned batch may have a `failed` or `cancelled` status; callers should
-        # inspect its status and file counts. Polling intervals and the overall timeout
-        # are in seconds. Set `timeout` to `nil` to wait indefinitely.
-        #
-        # @overload poll(batch_id, vector_store_id:, poll_interval: nil, timeout: 1800.0, request_options: {})
-        #
-        # @param batch_id [String] The ID of the file batch being retrieved.
-        #
-        # @param vector_store_id [String] The ID of the vector store that the file batch belongs to.
-        #
-        # @param poll_interval [Integer, Float, nil] How often to retrieve the batch. When omitted, the SDK honors the server's
-        #   polling hint and otherwise waits 5 seconds.
-        #
-        # @param timeout [Integer, Float, nil] Maximum total time to poll. Defaults to 30 minutes. Set to `nil` to wait
-        #   indefinitely.
-        #
-        # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
-        #
-        # @raise [ArgumentError, OpenAI::Errors::PollingError]
-        # @return [OpenAI::Models::VectorStores::VectorStoreFileBatch]
-        def poll(
-          batch_id,
-          vector_store_id:,
-          poll_interval: nil,
-          timeout: OpenAI::Internal::Poller::DEFAULT_TIMEOUT,
-          request_options: {}
-        )
-          OpenAI::Helpers::ResourcePolling.poll_vector_store_file_batch(
-            self,
-            batch_id,
-            vector_store_id: vector_store_id,
-            poll_interval: poll_interval,
-            timeout: timeout,
-            request_options: request_options
-          )
-        end
-
-        # Upload files concurrently, create a vector store file batch, and wait for
-        # processing to finish.
-        #
-        # Existing file IDs can be included alongside new uploads. Upload concurrency is
-        # bounded and defaults to 5. Set `max_concurrency` to 1 for sequential uploads.
-        # Inputs are enumerated before requests begin so the 2,000-file API limit can be
-        # checked without orphaning uploads. Stream-backed inputs are safely spooled during
-        # enumeration, including IO objects yielded from block-scoped enumerators.
-        #
-        # @overload upload_and_poll(vector_store_id, files:, file_ids: [], max_concurrency: 5, attributes: nil, chunking_strategy: nil, poll_interval: nil, timeout: 1800.0, request_options: {})
-        #
-        # @param vector_store_id [String] The ID of the vector store for which to create a File Batch.
-        #
-        # @param files [Enumerable<Pathname, StringIO, IO, String, OpenAI::FilePart>] Files to upload.
-        #
-        # @param file_ids [Array<String>] IDs of files that have already been uploaded.
-        #
-        # @param max_concurrency [Integer] Maximum number of simultaneous file uploads.
-        #
-        # @param attributes [Hash{Symbol=>String, Float, Boolean}, nil] Attributes to apply to every file.
-        #
-        # @param chunking_strategy [OpenAI::Models::AutoFileChunkingStrategyParam, OpenAI::Models::StaticFileChunkingStrategyObjectParam] The chunking strategy used to chunk the files.
-        #
-        # @param poll_interval [Integer, Float, nil] How often to retrieve the batch. When omitted, the SDK honors the server's
-        #   polling hint and otherwise waits 5 seconds.
-        #
-        # @param timeout [Integer, Float, nil] Maximum total time to poll. Defaults to 30 minutes. Set to `nil` to wait
-        #   indefinitely.
-        #
-        # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil] Applied to every upload and to the
-        #   batch creation and polling requests. Idempotency keys are scoped to each
-        #   upload and the batch creation.
-        #
-        # @raise [ArgumentError, OpenAI::Errors::PollingError]
-        # @return [OpenAI::Models::VectorStores::VectorStoreFileBatch]
-        def upload_and_poll(
-          vector_store_id,
-          files:,
-          file_ids: [],
-          max_concurrency: 5,
-          attributes: nil,
-          chunking_strategy: nil,
-          poll_interval: nil,
-          timeout: OpenAI::Internal::Poller::DEFAULT_TIMEOUT,
-          request_options: {}
-        )
-          OpenAI::Internal::Poller.validate!(poll_interval: poll_interval, timeout: timeout)
-          request_options_scope = OpenAI::Internal::RequestOptionsScope.new(request_options)
-
-          max_files = OpenAI::Internal::VectorStoreFileUploader::MAX_FILES_PER_BATCH
-          if file_ids.length > max_files
-            raise ArgumentError, "`file_ids` cannot contain more than #{max_files} entries"
-          end
-
-          uploaded = OpenAI::Internal::VectorStoreFileUploader
-            .new(
-              client: @client,
-              max_concurrency: max_concurrency,
-              request_options: request_options
-            )
-            .upload(files, max_files: max_files - file_ids.length)
-
-          if uploaded.empty?
-            raise(
-              ArgumentError,
-              "No `files` provided. Use `create_and_poll` when all files are already uploaded."
-            )
-          end
-
-          create_and_poll(
-            vector_store_id,
-            file_ids: [*file_ids, *uploaded.map(&:id)],
-            attributes: attributes,
-            chunking_strategy: chunking_strategy,
-            poll_interval: poll_interval,
-            timeout: timeout,
-            request_options: request_options_scope.child("file-batch")
-          )
-        end
-
         # @api private
         #
         # @param client [OpenAI::Client]

data/lib/openai/resources/vector_stores/files.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "../../helpers/resource_polling"
-
 module OpenAI
   module Resources
     class VectorStores
@@ -51,58 +49,6 @@ module OpenAI
           )
         end
 
-        # Attach a file to a vector store and wait for processing to finish.
-        #
-        # The returned file may have a `failed` or `cancelled` status; callers should
-        # inspect the status and `last_error`. Polling intervals and the overall timeout
-        # are in seconds. Finite timeouts include authentication and request replay
-        # time and disable transport retries so the deadline remains strict. Set
-        # `timeout` to `nil` to wait indefinitely and retain configured transport retries.
-        #
-        # @overload create_and_poll(vector_store_id, file_id:, attributes: nil, chunking_strategy: nil, poll_interval: nil, timeout: 1800.0, request_options: {})
-        #
-        # @param vector_store_id [String] The ID of the vector store for which to create a File.
-        #
-        # @param file_id [String] A File ID to attach to the vector store.
-        #
-        # @param attributes [Hash{Symbol=>String, Float, Boolean}, nil] Attributes to attach to the vector store file.
-        #
-        # @param chunking_strategy [OpenAI::Models::AutoFileChunkingStrategyParam, OpenAI::Models::StaticFileChunkingStrategyObjectParam] The chunking strategy used to chunk the file.
-        #
-        # @param poll_interval [Integer, Float, nil] How often to retrieve the file. When omitted, the SDK honors the server's
-        #   polling hint and otherwise waits 5 seconds.
-        #
-        # @param timeout [Integer, Float, nil] Maximum total time to poll. Defaults to 30 minutes. Set to `nil` to wait
-        #   indefinitely.
-        #
-        # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
-        #
-        # @raise [ArgumentError, OpenAI::Errors::PollingError]
-        # @return [OpenAI::Models::VectorStores::VectorStoreFile]
-        def create_and_poll(
-          vector_store_id,
-          file_id:,
-          attributes: nil,
-          chunking_strategy: nil,
-          poll_interval: nil,
-          timeout: OpenAI::Internal::Poller::DEFAULT_TIMEOUT,
-          request_options: {}
-        )
-          OpenAI::Internal::Poller.validate!(poll_interval: poll_interval, timeout: timeout)
-
-          params = {file_id: file_id, request_options: request_options}
-          params[:attributes] = attributes unless attributes.nil?
-          params[:chunking_strategy] = chunking_strategy unless chunking_strategy.nil?
-          file = create(vector_store_id, params)
-          poll(
-            file.id,
-            vector_store_id: vector_store_id,
-            poll_interval: poll_interval,
-            timeout: timeout,
-            request_options: request_options
-          )
-        end
-
         # Retrieves a vector store file.
         #
         # @overload retrieve(file_id, vector_store_id:, request_options: {})
@@ -257,140 +203,6 @@ module OpenAI
           )
         end
 
-        # Wait for a vector store file to finish processing.
-        #
-        # The returned file may have a `failed` or `cancelled` status; callers should
-        # inspect the status and `last_error`. Polling intervals and the overall timeout
-        # are in seconds. Set `timeout` to `nil` to wait indefinitely.
-        #
-        # @overload poll(file_id, vector_store_id:, poll_interval: nil, timeout: 1800.0, request_options: {})
-        #
-        # @param file_id [String] The ID of the file being retrieved.
-        #
-        # @param vector_store_id [String] The ID of the vector store that the file belongs to.
-        #
-        # @param poll_interval [Integer, Float, nil] How often to retrieve the file. When omitted, the SDK honors the server's
-        #   polling hint and otherwise waits 5 seconds.
-        #
-        # @param timeout [Integer, Float, nil] Maximum total time to poll. Defaults to 30 minutes. Set to `nil` to wait
-        #   indefinitely.
-        #
-        # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
-        #
-        # @raise [ArgumentError, OpenAI::Errors::PollingError]
-        # @return [OpenAI::Models::VectorStores::VectorStoreFile]
-        def poll(
-          file_id,
-          vector_store_id:,
-          poll_interval: nil,
-          timeout: OpenAI::Internal::Poller::DEFAULT_TIMEOUT,
-          request_options: {}
-        )
-          OpenAI::Helpers::ResourcePolling.poll_vector_store_file(
-            self,
-            file_id,
-            vector_store_id: vector_store_id,
-            poll_interval: poll_interval,
-            timeout: timeout,
-            request_options: request_options
-          )
-        end
-
-        # Upload a file and attach it to a vector store.
-        #
-        # Processing continues asynchronously; use {#upload_and_poll} to wait until the
-        # file is ready.
-        #
-        # @overload upload(vector_store_id, file:, attributes: nil, chunking_strategy: nil, request_options: {})
-        #
-        # @param vector_store_id [String] The ID of the vector store to attach the file to.
-        #
-        # @param file [Pathname, StringIO, IO, String, OpenAI::FilePart] The file to upload.
-        #
-        # @param attributes [Hash{Symbol=>String, Float, Boolean}, nil] Attributes to attach to the vector store file.
-        #
-        # @param chunking_strategy [OpenAI::Models::AutoFileChunkingStrategyParam, OpenAI::Models::StaticFileChunkingStrategyObjectParam] The chunking strategy used to chunk the file.
-        #
-        # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil] Applied to the upload and attach
-        #   requests. Idempotency keys are scoped to each operation.
-        #
-        # @return [OpenAI::Models::VectorStores::VectorStoreFile]
-        def upload(
-          vector_store_id,
-          file:,
-          attributes: nil,
-          chunking_strategy: nil,
-          request_options: {}
-        )
-          request_options_scope = OpenAI::Internal::RequestOptionsScope.new(request_options)
-          uploaded = @client.files.create(
-            file: file,
-            purpose: :assistants,
-            request_options: request_options_scope.child("file-upload")
-          )
-          params = {
-            file_id: uploaded.id,
-            request_options: request_options_scope.child("vector-store-file")
-          }
-          params[:attributes] = attributes unless attributes.nil?
-          params[:chunking_strategy] = chunking_strategy unless chunking_strategy.nil?
-          create(vector_store_id, params)
-        end
-
-        # Upload a file, attach it to a vector store, and wait for processing to
-        # finish.
-        #
-        # The returned file may have a `failed` or `cancelled` status; callers should
-        # inspect the status and `last_error`.
-        #
-        # @overload upload_and_poll(vector_store_id, file:, attributes: nil, chunking_strategy: nil, poll_interval: nil, timeout: 1800.0, request_options: {})
-        #
-        # @param vector_store_id [String] The ID of the vector store to attach the file to.
-        #
-        # @param file [Pathname, StringIO, IO, String, OpenAI::FilePart] The file to upload.
-        #
-        # @param attributes [Hash{Symbol=>String, Float, Boolean}, nil] Attributes to attach to the vector store file.
-        #
-        # @param chunking_strategy [OpenAI::Models::AutoFileChunkingStrategyParam, OpenAI::Models::StaticFileChunkingStrategyObjectParam] The chunking strategy used to chunk the file.
-        #
-        # @param poll_interval [Integer, Float, nil] How often to retrieve the file. When omitted, the SDK honors the server's
-        #   polling hint and otherwise waits 5 seconds.
-        #
-        # @param timeout [Integer, Float, nil] Maximum total time to poll. Defaults to 30 minutes. Set to `nil` to wait
-        #   indefinitely.
-        #
-        # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil] Applied to the upload, attach,
-        #   and polling requests. Idempotency keys are scoped to each write.
-        #
-        # @raise [ArgumentError, OpenAI::Errors::PollingError]
-        # @return [OpenAI::Models::VectorStores::VectorStoreFile]
-        def upload_and_poll(
-          vector_store_id,
-          file:,
-          attributes: nil,
-          chunking_strategy: nil,
-          poll_interval: nil,
-          timeout: OpenAI::Internal::Poller::DEFAULT_TIMEOUT,
-          request_options: {}
-        )
-          OpenAI::Internal::Poller.validate!(poll_interval: poll_interval, timeout: timeout)
-
-          attached = upload(
-            vector_store_id,
-            file: file,
-            attributes: attributes,
-            chunking_strategy: chunking_strategy,
-            request_options: request_options
-          )
-          poll(
-            attached.id,
-            vector_store_id: vector_store_id,
-            poll_interval: poll_interval,
-            timeout: timeout,
-            request_options: request_options
-          )
-        end
-
         # Retrieve the parsed contents of a vector store file.
         #
         # @overload content(file_id, vector_store_id:, request_options: {})

data/lib/openai/resources/webhooks.rb

@@ -200,12 +200,12 @@ module OpenAI
       # Validates that the given payload was sent by OpenAI and parses the payload.
       #
       # @param payload [String] The raw webhook payload as a string
-      # @param headers [Hash] The webhook headers
-      # @param webhook_secret [String, nil] The webhook secret (optional, will use client webhook secret or ENV["OPENAI_WEBHOOK_SECRET"] if not provided)
       #
-      # @return [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]
+      # @param headers [Hash{String, Symbol=>String}] The raw HTTP headers that came with the payload
       #
-      # @raise [ArgumentError] if signature verification fails
+      # @param webhook_secret [String, nil] The webhook signing key
+      #
+      # @return [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]
       def unwrap(
         payload,
         headers = {},
@@ -219,12 +219,13 @@ module OpenAI
 
       # Validates whether or not the webhook payload was sent by OpenAI.
       #
-      # @param payload [String] The webhook payload as a string
-      # @param headers [Hash] The webhook headers
-      # @param webhook_secret [String, nil] The webhook secret (optional, will use client webhook secret or ENV["OPENAI_WEBHOOK_SECRET"] if not provided)
-      # @param tolerance [Integer] Maximum age of the webhook in seconds (default: 300 = 5 minutes)
+      # @param payload [String] The raw webhook payload as a string
+      #
+      # @param headers [Hash{String, Symbol=>String}] The raw HTTP headers that came with the payload
       #
-      # @raise [ArgumentError] if the signature is invalid
+      # @param webhook_secret [String, nil] The webhook signing key
+      #
+      # @param tolerance [Integer] Maximum age of the webhook in seconds
       def verify_signature(
         payload,
         headers,
@@ -253,20 +254,10 @@ module OpenAI
         end
 
         signature_header, timestamp_header, webhook_id = normalized_headers.values_at(*header_names)
+        raise ArgumentError, "Missing required webhook-signature header" if signature_header.nil?
+        raise ArgumentError, "Missing required webhook-timestamp header" if timestamp_header.nil?
+        raise ArgumentError, "Missing required webhook-id header" if webhook_id.nil?
 
-        if signature_header.nil?
-          raise ArgumentError, "Missing required webhook-signature header"
-        end
-
-        if timestamp_header.nil?
-          raise ArgumentError, "Missing required webhook-timestamp header"
-        end
-
-        if webhook_id.nil?
-          raise ArgumentError, "Missing required webhook-id header"
-        end
-
-        # Validate timestamp to prevent replay attacks
         begin
           timestamp_seconds = timestamp_header.to_i
         rescue ArgumentError
@@ -282,14 +273,10 @@ module OpenAI
           raise OpenAI::Errors::InvalidWebhookSignatureError, "Webhook timestamp is too new"
         end
 
-        # Extract signatures from v1,<base64> format
-        # The signature header can have multiple values, separated by spaces.
-        # Each value is in the format v1,<base64>. We should accept if any match.
         signatures = signature_header.split.map do |part|
           part.start_with?("v1,") ? part[3..] : part
         end
 
-        # Decode the secret if it starts with whsec_
         decoded_secret = if webhook_secret.start_with?("whsec_")
           webhook_secret[6..].unpack1("m0")
         else
@@ -298,13 +285,10 @@ module OpenAI
 
         raise ArgumentError, "The webhook secret must not be empty" if decoded_secret.empty?
 
-        # Create the signed payload: {webhook_id}.{timestamp}.{payload}
         signed_payload = "#{webhook_id}.#{timestamp_header}.#{payload}"
 
-        # Compute HMAC-SHA256 signature
         expected_signature = [OpenSSL::HMAC.digest("sha256", decoded_secret, signed_payload)].pack("m0")
 
-        # Accept if any signature matches using timing-safe comparison
         return if signatures.any? { |signature| OpenSSL.secure_compare(expected_signature, signature) }
 
         raise(

data/lib/openai/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module OpenAI
-  VERSION = "0.103.0"
+  VERSION = "0.104.0"
 end

data/lib/openai.rb

@@ -152,10 +152,12 @@ require_relative "openai/models/beta/beta_response_audio_transcript_delta_event"
 require_relative "openai/models/beta/beta_response_audio_done_event"
 require_relative "openai/models/beta/beta_response_audio_delta_event"
 require_relative "openai/models/reasoning_effort"
+require_relative "openai/helpers/models/chat/parsed"
 require_relative "openai/models/chat/chat_completion_message"
 require_relative "openai/models/responses/response_input_file"
 require_relative "openai/models/responses/response_input_image"
 require_relative "openai/models/responses/response_input_text"
+require_relative "openai/helpers/models/responses/parsed"
 require_relative "openai/models/responses/response_output_text"
 require_relative "openai/models/responses/response_output_refusal"
 require_relative "openai/models/graders/score_model_grader"
@@ -288,6 +290,7 @@ require_relative "openai/models/admin/organization/invite_delete_params"
 require_relative "openai/models/admin/organization/invite_delete_response"
 require_relative "openai/models/admin/organization/invite_list_params"
 require_relative "openai/models/admin/organization/invite_retrieve_params"
+require_relative "openai/models/admin/organization/oci_external_storage_provider"
 require_relative "openai/models/admin/organization/organization_data_retention"
 require_relative "openai/models/admin/organization/organization_spend_alert"
 require_relative "openai/models/admin/organization/organization_spend_alert_deleted"
@@ -304,6 +307,8 @@ require_relative "openai/models/admin/organization/projects/api_key_delete_param
 require_relative "openai/models/admin/organization/projects/api_key_delete_response"
 require_relative "openai/models/admin/organization/projects/api_key_list_params"
 require_relative "openai/models/admin/organization/projects/api_key_retrieve_params"
+require_relative "openai/models/admin/organization/projects/api_key_update_params"
+require_relative "openai/models/admin/organization/projects/api_key_update_scopes_params"
 require_relative "openai/models/admin/organization/projects/certificate_activate_params"
 require_relative "openai/models/admin/organization/projects/certificate_activate_response"
 require_relative "openai/models/admin/organization/projects/certificate_deactivate_params"
@@ -408,6 +413,8 @@ require_relative "openai/models/admin/organization/usage_completions_params"
 require_relative "openai/models/admin/organization/usage_completions_response"
 require_relative "openai/models/admin/organization/usage_costs_params"
 require_relative "openai/models/admin/organization/usage_costs_response"
+require_relative "openai/models/admin/organization/usage_decisions_params"
+require_relative "openai/models/admin/organization/usage_decisions_response"
 require_relative "openai/models/admin/organization/usage_embeddings_params"
 require_relative "openai/models/admin/organization/usage_embeddings_response"
 require_relative "openai/models/admin/organization/usage_file_search_calls_params"
@@ -556,6 +563,7 @@ require_relative "openai/models/beta/agents/vaults/mcp_oauth_token_endpoint_auth
 require_relative "openai/models/beta/agents/vaults/mcp_oauth_token_endpoint_auth_rotate_param"
 require_relative "openai/models/beta/agents/vault_status"
 require_relative "openai/models/beta/agents/vault_status_filter"
+require_relative "openai/models/beta/agents/vault_update_params"
 require_relative "openai/models/beta/agent_send_subagent_input_call_item"
 require_relative "openai/models/beta/agent_session"
 require_relative "openai/models/beta/agent_session_assistant_message"
@@ -1070,6 +1078,15 @@ require_relative "openai/models/live/commentary_appended_event"
 require_relative "openai/models/live/commentary_append_event"
 require_relative "openai/models/live/custom_voice"
 require_relative "openai/models/live/data_channel_config"
+require_relative "openai/models/live/decision_create_event"
+require_relative "openai/models/live/decision_event"
+require_relative "openai/models/live/decision_item_created_event"
+require_relative "openai/models/live/decision_item_create_event"
+require_relative "openai/models/live/decision_item_deleted_event"
+require_relative "openai/models/live/decision_item_delete_event"
+require_relative "openai/models/live/decisions_delegation_config"
+require_relative "openai/models/live/decisions_delegation_update_config"
+require_relative "openai/models/live/decision_trigger"
 require_relative "openai/models/live/delegation_created_event"
 require_relative "openai/models/live/error"
 require_relative "openai/models/live/error_event"
@@ -1093,6 +1110,9 @@ require_relative "openai/models/live/live_create_response"
 require_relative "openai/models/live/media_session_config"
 require_relative "openai/models/live/media_session_fork_config"
 require_relative "openai/models/live/output_audio_delta_event"
+require_relative "openai/models/live/output_audio_fixture_played_event"
+require_relative "openai/models/live/output_audio_fixture_play_event"
+require_relative "openai/models/live/output_audio_fixture_playing_event"
 require_relative "openai/models/live/output_transcript_delta_event"
 require_relative "openai/models/live/response_create_event"
 require_relative "openai/models/live/response_event"
@@ -1119,6 +1139,8 @@ require_relative "openai/models/live/session_updated_event"
 require_relative "openai/models/live/session_update_event"
 require_relative "openai/models/live/session_usage"
 require_relative "openai/models/live/session_usage_updated_event"
+require_relative "openai/models/live/sideband_client_event"
+require_relative "openai/models/live/sideband_server_event"
 require_relative "openai/models/live/thinking_appended_event"
 require_relative "openai/models/live/thinking_append_event"
 require_relative "openai/models/metadata"
@@ -1489,6 +1511,7 @@ require_relative "openai/models/webhooks/webhook_endpoint"
 require_relative "openai/models/webhooks/webhook_endpoint_list"
 require_relative "openai/models/webhooks/webhook_endpoint_test_result"
 require_relative "openai/models/webhooks/webhook_endpoint_with_secret"
+require_relative "openai/helpers/models/webhooks/webhook_endpoint_with_secret"
 require_relative "openai/models/webhooks/webhook_event_type_list"
 require_relative "openai/models/webhooks/webhook_list_params"
 require_relative "openai/models/webhooks/webhook_retrieve_params"
@@ -1539,9 +1562,11 @@ require_relative "openai/resources/batches"
 require_relative "openai/resources/beta"
 require_relative "openai/resources/beta/agents"
 require_relative "openai/resources/beta/agents/environments"
+require_relative "openai/helpers/beta/agents/files"
 require_relative "openai/resources/beta/agents/environments/files"
 require_relative "openai/resources/beta/agents/environments/templates"
 require_relative "openai/resources/beta/agents/sessions"
+require_relative "openai/helpers/beta/agents/artifacts"
 require_relative "openai/resources/beta/agents/sessions/artifacts"
 require_relative "openai/resources/beta/agents/sessions/events"
 require_relative "openai/resources/beta/agents/sessions/items"
@@ -1621,6 +1646,10 @@ require_relative "openai/resources/vector_stores/files"
 require_relative "openai/resources/videos"
 require_relative "openai/resources/webhooks"
 require_relative "openai/resources/webhooks/event_types"
+require_relative "openai/helpers/models/responses/response"
+require_relative "openai/helpers/files"
+require_relative "openai/helpers/vector_stores/file_batches"
+require_relative "openai/helpers/vector_stores/files"
 require_relative "openai/helpers/streaming/response_events"
 require_relative "openai/helpers/streaming/response_stream"
 require_relative "openai/helpers/streaming/exceptions"
@@ -1636,3 +1665,5 @@ require_relative "openai/helpers/beta/agents/creation_stream"
 require_relative "openai/helpers/agents/session_stream"
 require_relative "openai/helpers/beta/agents/function_tool"
 require_relative "openai/helpers/agents/message"
+
+require_relative "openai/helpers/admin/organization/projects/api_keys"