openai 0.98.0 → 0.100.0

data/rbi/openai/models/admin/organization/usage_code_interpreter_sessions_response.rbi

@@ -198,6 +198,19 @@ module OpenAI
                 sig { returns(T.nilable(String)) }
                 attr_accessor :api_key_id
 
+                # When grouped by `api_source`, `agents_api` identifies attributed Agents API
+                # activity and `unlabeled` includes all records without published source
+                # attribution, including historical and unknown origins. Unlabeled does not imply
+                # direct API usage. Without source grouping, this field is null.
+                sig {
+                  returns(
+                    T.nilable(
+                      OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationUsageCompletionsResult::APISource::TaggedSymbol
+                    )
+                  )
+                }
+                attr_accessor :api_source
+
                 # When `group_by=batch`, this field tells whether the grouped usage result is
                 # batch or not.
                 sig { returns(T.nilable(T::Boolean)) }
@@ -210,7 +223,16 @@ module OpenAI
                 sig { params(input_audio_tokens: Integer).void }
                 attr_writer :input_audio_tokens
 
-                # The aggregated number of input tokens written to the cache.
+                # The aggregated number of input tokens written to the cache with a 12-hour
+                # retention period.
+                sig { returns(T.nilable(Integer)) }
+                attr_reader :input_cache_write_12h_tokens
+
+                sig { params(input_cache_write_12h_tokens: Integer).void }
+                attr_writer :input_cache_write_12h_tokens
+
+                # The aggregated number of input tokens written to the cache with a 30-minute
+                # retention period.
                 sig { returns(T.nilable(Integer)) }
                 attr_reader :input_cache_write_tokens
 
@@ -322,10 +344,16 @@ module OpenAI
 
                     api_key_id: T.nilable(String),
 
+                    api_source: T.nilable(
+                      OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationUsageCompletionsResult::APISource::OrSymbol
+                    ),
+
                     batch: T.nilable(T::Boolean),
 
                     input_audio_tokens: Integer,
 
+                    input_cache_write_12h_tokens: Integer,
+
                     input_cache_write_tokens: Integer,
 
                     input_cached_audio_tokens: Integer,
@@ -379,6 +407,12 @@ module OpenAI
                   # usage result.
                   api_key_id: nil,
 
+                  # When grouped by `api_source`, `agents_api` identifies attributed Agents API
+                  # activity and `unlabeled` includes all records without published source
+                  # attribution, including historical and unknown origins. Unlabeled does not imply
+                  # direct API usage. Without source grouping, this field is null.
+                  api_source: nil,
+
                   # When `group_by=batch`, this field tells whether the grouped usage result is
                   # batch or not.
                   batch: nil,
@@ -386,7 +420,12 @@ module OpenAI
                   # The aggregated number of uncached audio input tokens used.
                   input_audio_tokens: nil,
 
-                  # The aggregated number of input tokens written to the cache.
+                  # The aggregated number of input tokens written to the cache with a 12-hour
+                  # retention period.
+                  input_cache_write_12h_tokens: nil,
+
+                  # The aggregated number of input tokens written to the cache with a 30-minute
+                  # retention period.
                   input_cache_write_tokens: nil,
 
                   # The aggregated number of cached audio input tokens used.
@@ -450,8 +489,12 @@ module OpenAI
                       object: Symbol,
                       output_tokens: Integer,
                       api_key_id: T.nilable(String),
+                      api_source: T.nilable(
+                        OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationUsageCompletionsResult::APISource::TaggedSymbol
+                      ),
                       batch: T.nilable(T::Boolean),
                       input_audio_tokens: Integer,
+                      input_cache_write_12h_tokens: Integer,
                       input_cache_write_tokens: Integer,
                       input_cached_audio_tokens: Integer,
                       input_cached_image_tokens: Integer,
@@ -473,6 +516,40 @@ module OpenAI
                 def to_hash
                 end
 
+                # When grouped by `api_source`, `agents_api` identifies attributed Agents API
+                # activity and `unlabeled` includes all records without published source
+                # attribution, including historical and unknown origins. Unlabeled does not imply
+                # direct API usage. Without source grouping, this field is null.
+                module APISource
+                  extend OpenAI::Internal::Type::Enum
+
+                  TaggedSymbol = T.type_alias {
+                    T.all(
+                      Symbol,
+                      OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationUsageCompletionsResult::APISource
+                    )
+                  }
+                  OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                  AGENTS_API = T.let(
+                    :agents_api,
+                    OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationUsageCompletionsResult::APISource::TaggedSymbol
+                  )
+                  UNLABELED = T.let(
+                    :unlabeled,
+                    OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationUsageCompletionsResult::APISource::TaggedSymbol
+                  )
+
+                  sig {
+                    override.returns(
+                      T::Array[
+                        OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationUsageCompletionsResult::APISource::TaggedSymbol
+                      ]
+                    )
+                  }
+                  def self.values
+                  end
+                end
               end
 
               class OrganizationUsageEmbeddingsResult < OpenAI::Internal::Type::BaseModel
@@ -1254,6 +1331,19 @@ module OpenAI
                 sig { returns(T.nilable(String)) }
                 attr_accessor :api_key_id
 
+                # When grouped by `api_source`, `agents_api` identifies attributed Agents API
+                # activity and `unlabeled` includes all records without published source
+                # attribution, including historical and unknown origins. Unlabeled does not imply
+                # direct API usage. Without source grouping, this field is null.
+                sig {
+                  returns(
+                    T.nilable(
+                      OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationUsageWebSearchesResult::APISource::TaggedSymbol
+                    )
+                  )
+                }
+                attr_accessor :api_source
+
                 # When `group_by=context_level`, this field provides the search context size of
                 # the grouped usage result.
                 sig { returns(T.nilable(String)) }
@@ -1284,6 +1374,10 @@ module OpenAI
 
                     api_key_id: T.nilable(String),
 
+                    api_source: T.nilable(
+                      OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationUsageWebSearchesResult::APISource::OrSymbol
+                    ),
+
                     context_level: T.nilable(String),
 
                     model: T.nilable(String),
@@ -1308,6 +1402,12 @@ module OpenAI
                   # usage result.
                   api_key_id: nil,
 
+                  # When grouped by `api_source`, `agents_api` identifies attributed Agents API
+                  # activity and `unlabeled` includes all records without published source
+                  # attribution, including historical and unknown origins. Unlabeled does not imply
+                  # direct API usage. Without source grouping, this field is null.
+                  api_source: nil,
+
                   # When `group_by=context_level`, this field provides the search context size of
                   # the grouped usage result.
                   context_level: nil,
@@ -1335,6 +1435,9 @@ module OpenAI
                       num_requests: Integer,
                       object: Symbol,
                       api_key_id: T.nilable(String),
+                      api_source: T.nilable(
+                        OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationUsageWebSearchesResult::APISource::TaggedSymbol
+                      ),
                       context_level: T.nilable(String),
                       model: T.nilable(String),
                       project_id: T.nilable(String),
@@ -1345,6 +1448,40 @@ module OpenAI
                 def to_hash
                 end
 
+                # When grouped by `api_source`, `agents_api` identifies attributed Agents API
+                # activity and `unlabeled` includes all records without published source
+                # attribution, including historical and unknown origins. Unlabeled does not imply
+                # direct API usage. Without source grouping, this field is null.
+                module APISource
+                  extend OpenAI::Internal::Type::Enum
+
+                  TaggedSymbol = T.type_alias {
+                    T.all(
+                      Symbol,
+                      OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationUsageWebSearchesResult::APISource
+                    )
+                  }
+                  OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                  AGENTS_API = T.let(
+                    :agents_api,
+                    OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationUsageWebSearchesResult::APISource::TaggedSymbol
+                  )
+                  UNLABELED = T.let(
+                    :unlabeled,
+                    OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationUsageWebSearchesResult::APISource::TaggedSymbol
+                  )
+
+                  sig {
+                    override.returns(
+                      T::Array[
+                        OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationUsageWebSearchesResult::APISource::TaggedSymbol
+                      ]
+                    )
+                  }
+                  def self.values
+                  end
+                end
               end
 
               class OrganizationCostsResult < OpenAI::Internal::Type::BaseModel
@@ -1381,6 +1518,19 @@ module OpenAI
                 sig { returns(T.nilable(String)) }
                 attr_accessor :api_key_id
 
+                # When grouped by `api_source`, `agents_api` identifies attributed Agents API
+                # activity and `unlabeled` includes all records without published source
+                # attribution, including historical and unknown origins. Unlabeled does not imply
+                # direct API usage. Without source grouping, this field is null.
+                sig {
+                  returns(
+                    T.nilable(
+                      OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationCostsResult::APISource::TaggedSymbol
+                    )
+                  )
+                }
+                attr_accessor :api_source
+
                 # When `group_by=line_item`, this field provides the line item of the grouped
                 # costs result.
                 sig { returns(T.nilable(String)) }
@@ -1401,6 +1551,11 @@ module OpenAI
                 sig { returns(T.nilable(T.any(String, OpenAI::Admin::Organization::CostQuantityUnit::OrSymbol))) }
                 attr_accessor :quantity_unit
 
+                # When `group_by=user_id`, this field provides the user ID of the grouped costs
+                # result.
+                sig { returns(T.nilable(String)) }
+                attr_accessor :user_id
+
                 # The aggregated costs details of the specific time bucket.
                 sig do
                   params(
@@ -1409,6 +1564,10 @@ module OpenAI
 
                     api_key_id: T.nilable(String),
 
+                    api_source: T.nilable(
+                      OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationCostsResult::APISource::OrSymbol
+                    ),
+
                     line_item: T.nilable(String),
 
                     project_id: T.nilable(String),
@@ -1417,6 +1576,8 @@ module OpenAI
 
                     quantity_unit: T.nilable(T.any(String, OpenAI::Admin::Organization::CostQuantityUnit::OrSymbol)),
 
+                    user_id: T.nilable(String),
+
                     object: Symbol
                   )
                     .returns(T.attached_class)
@@ -1430,6 +1591,12 @@ module OpenAI
                   # costs result.
                   api_key_id: nil,
 
+                  # When grouped by `api_source`, `agents_api` identifies attributed Agents API
+                  # activity and `unlabeled` includes all records without published source
+                  # attribution, including historical and unknown origins. Unlabeled does not imply
+                  # direct API usage. Without source grouping, this field is null.
+                  api_source: nil,
+
                   # When `group_by=line_item`, this field provides the line item of the grouped
                   # costs result.
                   line_item: nil,
@@ -1446,6 +1613,10 @@ module OpenAI
                   # result, this field is `null`.
                   quantity_unit: nil,
 
+                  # When `group_by=user_id`, this field provides the user ID of the grouped costs
+                  # result.
+                  user_id: nil,
+
                   object: :"organization.costs.result"
                 )
                 end
@@ -1456,10 +1627,14 @@ module OpenAI
                       object: Symbol,
                       amount: OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationCostsResult::Amount,
                       api_key_id: T.nilable(String),
+                      api_source: T.nilable(
+                        OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationCostsResult::APISource::TaggedSymbol
+                      ),
                       line_item: T.nilable(String),
                       project_id: T.nilable(String),
                       quantity: T.nilable(Float),
-                      quantity_unit: T.nilable(T.any(String, OpenAI::Admin::Organization::CostQuantityUnit::OrSymbol))
+                      quantity_unit: T.nilable(T.any(String, OpenAI::Admin::Organization::CostQuantityUnit::OrSymbol)),
+                      user_id: T.nilable(String)
                     }
                   )
                 end
@@ -1518,6 +1693,41 @@ module OpenAI
                   end
 
                 end
+
+                # When grouped by `api_source`, `agents_api` identifies attributed Agents API
+                # activity and `unlabeled` includes all records without published source
+                # attribution, including historical and unknown origins. Unlabeled does not imply
+                # direct API usage. Without source grouping, this field is null.
+                module APISource
+                  extend OpenAI::Internal::Type::Enum
+
+                  TaggedSymbol = T.type_alias {
+                    T.all(
+                      Symbol,
+                      OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationCostsResult::APISource
+                    )
+                  }
+                  OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                  AGENTS_API = T.let(
+                    :agents_api,
+                    OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationCostsResult::APISource::TaggedSymbol
+                  )
+                  UNLABELED = T.let(
+                    :unlabeled,
+                    OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationCostsResult::APISource::TaggedSymbol
+                  )
+
+                  sig {
+                    override.returns(
+                      T::Array[
+                        OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationCostsResult::APISource::TaggedSymbol
+                      ]
+                    )
+                  }
+                  def self.values
+                  end
+                end
               end
 
               sig {

data/rbi/openai/models/admin/organization/usage_completions_params.rbi

@@ -54,8 +54,10 @@ module OpenAI
           attr_writer :end_time
 
           # Group the usage data by the specified fields. Support fields include
-          # `project_id`, `user_id`, `api_key_id`, `model`, `batch`, `service_tier` or any
-          # combination of them.
+          # `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.
           sig { returns(T.nilable(T::Array[OpenAI::Admin::Organization::UsageCompletionsParams::GroupBy::OrSymbol])) }
           attr_reader :group_by
 
@@ -153,8 +155,10 @@ module OpenAI
             end_time: nil,
 
             # Group the usage data by the specified fields. Support fields include
-            # `project_id`, `user_id`, `api_key_id`, `model`, `batch`, `service_tier` or any
-            # combination of them.
+            # `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.
             group_by: nil,
 
             # Specifies the number of buckets to return.
@@ -247,6 +251,7 @@ module OpenAI
               :service_tier,
               OpenAI::Admin::Organization::UsageCompletionsParams::GroupBy::TaggedSymbol
             )
+            API_SOURCE = T.let(:api_source, OpenAI::Admin::Organization::UsageCompletionsParams::GroupBy::TaggedSymbol)
 
             sig {
               override.returns(T::Array[OpenAI::Admin::Organization::UsageCompletionsParams::GroupBy::TaggedSymbol])