openai 0.102.0 → 0.104.0

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::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.102.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"
@@ -563,11 +571,13 @@ require_relative "openai/models/beta/agent_session_created_event"
 require_relative "openai/models/beta/agent_session_deleted"
 require_relative "openai/models/beta/agent_session_environment_connected_event"
 require_relative "openai/models/beta/agent_session_environment_disconnected_event"
+require_relative "openai/models/beta/agent_session_environment_expired_event"
 require_relative "openai/models/beta/agent_session_environment_failed_event"
 require_relative "openai/models/beta/agent_session_environment_pending_event"
 require_relative "openai/models/beta/agent_session_environment_ready_event"
 require_relative "openai/models/beta/agent_session_environment_reset_event"
 require_relative "openai/models/beta/agent_session_environment_state"
+require_relative "openai/models/beta/agent_session_environment_suspended_event"
 require_relative "openai/models/beta/agent_session_error_event"
 require_relative "openai/models/beta/agent_session_event"
 require_relative "openai/models/beta/agent_session_failed_event"
@@ -1068,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"
@@ -1091,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"
@@ -1117,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"
@@ -1448,8 +1472,10 @@ require_relative "openai/models/video_remix_params"
 require_relative "openai/models/video_retrieve_params"
 require_relative "openai/models/video_seconds"
 require_relative "openai/models/video_size"
+require_relative "openai/models/webhooks/agent_environment_expired_webhook_event"
 require_relative "openai/models/webhooks/agent_environment_failed_webhook_event"
 require_relative "openai/models/webhooks/agent_environment_ready_webhook_event"
+require_relative "openai/models/webhooks/agent_environment_suspended_webhook_event"
 require_relative "openai/models/webhooks/agent_session_action_required_webhook_event"
 require_relative "openai/models/webhooks/agent_session_created_webhook_event"
 require_relative "openai/models/webhooks/agent_session_failed_webhook_event"
@@ -1485,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"
@@ -1535,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"
@@ -1617,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"
@@ -1632,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"

data/rbi/openai/client.rbi

@@ -149,109 +149,6 @@ module OpenAI
     private def admin_api_key_auth
     end
 
-    # @api private
-    sig do
-      override
-        .params(
-          request: OpenAI::Internal::Transport::BaseClient::RequestInput,
-          redirect_count: Integer,
-          retry_count: Integer
-        )
-        .returns(OpenAI::Internal::Transport::BaseClient::RequestInput)
-    end
-    private def prepare_request(request, redirect_count:, retry_count:)
-    end
-
-    # @api private
-    sig do
-      override
-        .params(
-          request: OpenAI::Internal::Transport::BaseClient::RequestInput,
-          original_request: OpenAI::Internal::Transport::BaseClient::RequestInput
-        )
-        .returns(OpenAI::Internal::Transport::BaseClient::RequestInput)
-    end
-    private def validate_prepared_request(request, original_request:)
-    end
-
-    # @api private
-    sig do
-      override
-        .params(
-          request: OpenAI::Internal::Transport::BaseClient::RequestInput,
-          delay: Float
-        )
-        .void
-    end
-    private def validate_retry_delay!(request, delay:)
-    end
-
-    # @api private
-    sig { params(identity: T.untyped).returns(T::Boolean) }
-    private def x509_identity?(identity)
-    end
-
-    # @api private
-    sig { params(transport: T.untyped).returns(T::Boolean) }
-    private def x509_transport?(transport)
-    end
-
-    # @api private
-    sig { params(options: T::Hash[Symbol, T.untyped]).returns(T.self_type) }
-    private def copy_with_workload_identity_auth(options)
-    end
-
-    # @api private
-    sig { params(authenticator: OpenAI::Auth::WorkloadIdentityAuth).void }
-    def adopt_workload_identity_auth!(authenticator)
-    end
-
-    # Returns a new client with the supplied options overridden.
-    sig do
-      params(
-        api_key: T.nilable(String),
-        admin_api_key: T.nilable(String),
-        workload_identity: T.nilable(T.any(OpenAI::Auth::WorkloadIdentity, OpenAI::Auth::X509WorkloadIdentity)),
-        organization: T.nilable(String),
-        project: T.nilable(String),
-        webhook_secret: T.nilable(String),
-        provider: T.nilable(OpenAI::Provider),
-        base_url: T.nilable(String),
-        data_residency: T.nilable(T.any(Symbol, String)),
-        default_headers: T.nilable(T::Hash[String, T.nilable(String)]),
-        max_retries: Integer,
-        timeout: T.nilable(Float),
-        initial_retry_delay: Float,
-        max_retry_delay: Float,
-        http_client: T.untyped,
-        logger: T.untyped,
-        log_level: T.nilable(T.any(Symbol, String)),
-        on_retry: T.nilable(T.proc.params(event: OpenAI::RetryEvent).void)
-      )
-        .returns(T.self_type)
-    end
-    def with_options(
-      api_key: T.unsafe(nil),
-      admin_api_key: T.unsafe(nil),
-      workload_identity: T.unsafe(nil),
-      organization: T.unsafe(nil),
-      project: T.unsafe(nil),
-      webhook_secret: T.unsafe(nil),
-      provider: T.unsafe(nil),
-      base_url: T.unsafe(nil),
-      data_residency: T.unsafe(nil),
-      default_headers: T.unsafe(nil),
-      max_retries: T.unsafe(nil),
-      timeout: T.unsafe(nil),
-      initial_retry_delay: T.unsafe(nil),
-      max_retry_delay: T.unsafe(nil),
-      http_client: T.unsafe(nil),
-      logger: T.unsafe(nil),
-      log_level: T.unsafe(nil),
-      on_retry: T.unsafe(nil)
-    )
-    end
-
     # Creates and returns a new client for interacting with the API.
     sig do
       params(

data/rbi/openai/helpers/admin/organization/projects/api_keys.rbi

@@ -0,0 +1,25 @@
+# typed: strong
+
+module OpenAI
+  module Resources
+    class Admin
+      class Organization
+        class Projects
+          class APIKeys
+            sig do
+              params(
+                api_key_id: String,
+                project_id: String,
+                scopes: T::Array[String],
+                request_options: OpenAI::RequestOptions::OrHash
+              )
+                .returns(OpenAI::Admin::Organization::Projects::ProjectAPIKey)
+            end
+            def update_scopes(api_key_id, project_id:, scopes:, request_options: {})
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/openai/helpers/beta/agents/artifacts.rbi

@@ -27,3 +27,28 @@ module OpenAI
     end
   end
 end
+
+module OpenAI
+  module Resources
+
+    class Beta
+
+      class Agents
+
+        class Sessions
+
+          class Artifacts
+            # Beta result-scoped downloads.
+            sig {
+              params(result: OpenAI::Helpers::Beta::Agents::TurnResult).returns(
+                OpenAI::Helpers::Beta::Agents::ResultArtifacts
+              )
+            }
+            def for_result(result)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/openai/helpers/beta/agents/files.rbi

@@ -63,3 +63,51 @@ module OpenAI
     end
   end
 end
+
+module OpenAI
+  module Resources
+
+    class Beta
+
+      class Agents
+
+        class Environments
+
+          class Files
+            # Beta file helpers.
+            sig {
+              params(files: T::Hash[String, T.any(String, Pathname)], request_options: OpenAI::RequestOptions::OrHash)
+                .returns(OpenAI::Helpers::Beta::Agents::PreparedFiles)
+            }
+            def prepare(files, request_options: {})
+            end
+
+            sig {
+              params(
+                directory: T.any(String, Pathname),
+                destination: String,
+                include: T::Array[String],
+                request_options: OpenAI::RequestOptions::OrHash
+              )
+                .returns(OpenAI::Helpers::Beta::Agents::PreparedFiles)
+            }
+            def prepare_directory(directory, destination:, include:, request_options: {})
+            end
+
+            sig {
+              params(
+                environment_id: String,
+                file: T.any(String, Pathname),
+                path: String,
+                request_options: OpenAI::RequestOptions::OrHash
+              )
+                .returns(OpenAI::Helpers::Beta::Agents::PreparedFiles)
+            }
+            def upload(environment_id, file:, path:, request_options: {})
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/openai/helpers/client_runtime.rbi

@@ -0,0 +1,108 @@
+# typed: strong
+
+module OpenAI
+  class Client < OpenAI::Internal::Transport::BaseClient
+    # @api private
+    sig do
+      override
+        .params(
+          request: OpenAI::Internal::Transport::BaseClient::RequestInput,
+          redirect_count: Integer,
+          retry_count: Integer
+        )
+        .returns(OpenAI::Internal::Transport::BaseClient::RequestInput)
+    end
+    private def prepare_request(request, redirect_count:, retry_count:)
+    end
+
+    # @api private
+    sig do
+      override
+        .params(
+          request: OpenAI::Internal::Transport::BaseClient::RequestInput,
+          original_request: OpenAI::Internal::Transport::BaseClient::RequestInput
+        )
+        .returns(OpenAI::Internal::Transport::BaseClient::RequestInput)
+    end
+    private def validate_prepared_request(request, original_request:)
+    end
+
+    # @api private
+    sig do
+      override
+        .params(
+          request: OpenAI::Internal::Transport::BaseClient::RequestInput,
+          delay: Float
+        )
+        .void
+    end
+    private def validate_retry_delay!(request, delay:)
+    end
+
+    # @api private
+    sig { params(identity: T.untyped).returns(T::Boolean) }
+    private def x509_identity?(identity)
+    end
+
+    # @api private
+    sig { params(transport: T.untyped).returns(T::Boolean) }
+    private def x509_transport?(transport)
+    end
+
+    # @api private
+    sig { params(options: T::Hash[Symbol, T.untyped]).returns(T.self_type) }
+    private def copy_with_workload_identity_auth(options)
+    end
+
+    # @api private
+    sig { params(authenticator: OpenAI::Auth::WorkloadIdentityAuth).void }
+    def adopt_workload_identity_auth!(authenticator)
+    end
+
+    # Returns a new client with the supplied options overridden.
+    sig do
+      params(
+        api_key: T.nilable(String),
+        admin_api_key: T.nilable(String),
+        workload_identity: T.nilable(T.any(OpenAI::Auth::WorkloadIdentity, OpenAI::Auth::X509WorkloadIdentity)),
+        organization: T.nilable(String),
+        project: T.nilable(String),
+        webhook_secret: T.nilable(String),
+        provider: T.nilable(OpenAI::Provider),
+        base_url: T.nilable(String),
+        data_residency: T.nilable(T.any(Symbol, String)),
+        default_headers: T.nilable(T::Hash[String, T.nilable(String)]),
+        max_retries: Integer,
+        timeout: T.nilable(Float),
+        initial_retry_delay: Float,
+        max_retry_delay: Float,
+        http_client: T.untyped,
+        logger: T.untyped,
+        log_level: T.nilable(T.any(Symbol, String)),
+        on_retry: T.nilable(T.proc.params(event: OpenAI::RetryEvent).void)
+      )
+        .returns(T.self_type)
+    end
+    def with_options(
+      api_key: T.unsafe(nil),
+      admin_api_key: T.unsafe(nil),
+      workload_identity: T.unsafe(nil),
+      organization: T.unsafe(nil),
+      project: T.unsafe(nil),
+      webhook_secret: T.unsafe(nil),
+      provider: T.unsafe(nil),
+      base_url: T.unsafe(nil),
+      data_residency: T.unsafe(nil),
+      default_headers: T.unsafe(nil),
+      max_retries: T.unsafe(nil),
+      timeout: T.unsafe(nil),
+      initial_retry_delay: T.unsafe(nil),
+      max_retry_delay: T.unsafe(nil),
+      http_client: T.unsafe(nil),
+      logger: T.unsafe(nil),
+      log_level: T.unsafe(nil),
+      on_retry: T.unsafe(nil)
+    )
+    end
+  end
+end

data/rbi/openai/helpers/files.rbi

@@ -0,0 +1,25 @@
+# typed: strong
+
+module OpenAI
+  module Resources
+    class Files
+      # Wait for an uploaded file to finish processing.
+      sig do
+        params(
+          file_id: String,
+          poll_interval: T.nilable(T.any(Integer, Float)),
+          timeout: T.nilable(T.any(Integer, Float)),
+          request_options: OpenAI::RequestOptions::OrHash
+        )
+          .returns(OpenAI::FileObject)
+      end
+      def wait_for_processing(
+        file_id,
+        poll_interval: nil,
+        timeout: OpenAI::Internal::Poller::DEFAULT_TIMEOUT,
+        request_options: {}
+      )
+      end
+    end
+  end
+end

data/rbi/openai/helpers/models/chat/parsed.rbi

@@ -0,0 +1,21 @@
+# typed: strong
+
+module OpenAI
+  module Models
+    module Chat
+      class ChatCompletionMessage < OpenAI::Internal::Type::BaseModel
+        # The parsed contents of the message, if JSON schema is specified.
+        sig { returns(T.nilable(T.anything)) }
+        attr_accessor :parsed
+      end
+
+      class ChatCompletionMessageFunctionToolCall < OpenAI::Internal::Type::BaseModel
+        class Function < OpenAI::Internal::Type::BaseModel
+          # The parsed contents of the arguments.
+          sig { returns(T.anything) }
+          attr_accessor :parsed
+        end
+      end
+    end
+  end
+end

data/rbi/openai/helpers/models/responses/parsed.rbi

@@ -0,0 +1,19 @@
+# typed: strong
+
+module OpenAI
+  module Models
+    module Responses
+      class ResponseOutputText < OpenAI::Internal::Type::BaseModel
+        # The parsed contents of the output, if JSON schema is specified.
+        sig { returns(T.anything) }
+        attr_accessor :parsed
+      end
+
+      class ResponseFunctionToolCall < OpenAI::Internal::Type::BaseModel
+        # The parsed contents of the arguments.
+        sig { returns(T.anything) }
+        attr_accessor :parsed
+      end
+    end
+  end
+end

data/rbi/openai/helpers/models/responses/response.rbi

@@ -0,0 +1,15 @@
+# typed: true
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Responses
+      class Response < OpenAI::Internal::Type::BaseModel
+        # Concatenates text from all output messages.
+        sig { returns(String) }
+        def output_text
+        end
+      end
+    end
+  end
+end