openai 0.98.0 → 0.100.0

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

@@ -194,6 +194,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::UsageCompletionsResponse::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)) }
@@ -206,7 +219,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
 
@@ -318,10 +340,16 @@ module OpenAI
 
                     api_key_id: T.nilable(String),
 
+                    api_source: T.nilable(
+                      OpenAI::Models::Admin::Organization::UsageCompletionsResponse::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,
@@ -375,6 +403,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,
@@ -382,7 +416,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.
@@ -446,8 +485,12 @@ module OpenAI
                       object: Symbol,
                       output_tokens: Integer,
                       api_key_id: T.nilable(String),
+                      api_source: T.nilable(
+                        OpenAI::Models::Admin::Organization::UsageCompletionsResponse::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,
@@ -469,6 +512,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::UsageCompletionsResponse::Data::Result::OrganizationUsageCompletionsResult::APISource
+                    )
+                  }
+                  OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                  AGENTS_API = T.let(
+                    :agents_api,
+                    OpenAI::Models::Admin::Organization::UsageCompletionsResponse::Data::Result::OrganizationUsageCompletionsResult::APISource::TaggedSymbol
+                  )
+                  UNLABELED = T.let(
+                    :unlabeled,
+                    OpenAI::Models::Admin::Organization::UsageCompletionsResponse::Data::Result::OrganizationUsageCompletionsResult::APISource::TaggedSymbol
+                  )
+
+                  sig {
+                    override.returns(
+                      T::Array[
+                        OpenAI::Models::Admin::Organization::UsageCompletionsResponse::Data::Result::OrganizationUsageCompletionsResult::APISource::TaggedSymbol
+                      ]
+                    )
+                  }
+                  def self.values
+                  end
+                end
               end
 
               class OrganizationUsageEmbeddingsResult < OpenAI::Internal::Type::BaseModel
@@ -1250,6 +1327,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::UsageCompletionsResponse::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)) }
@@ -1280,6 +1370,10 @@ module OpenAI
 
                     api_key_id: T.nilable(String),
 
+                    api_source: T.nilable(
+                      OpenAI::Models::Admin::Organization::UsageCompletionsResponse::Data::Result::OrganizationUsageWebSearchesResult::APISource::OrSymbol
+                    ),
+
                     context_level: T.nilable(String),
 
                     model: T.nilable(String),
@@ -1304,6 +1398,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,
@@ -1331,6 +1431,9 @@ module OpenAI
                       num_requests: Integer,
                       object: Symbol,
                       api_key_id: T.nilable(String),
+                      api_source: T.nilable(
+                        OpenAI::Models::Admin::Organization::UsageCompletionsResponse::Data::Result::OrganizationUsageWebSearchesResult::APISource::TaggedSymbol
+                      ),
                       context_level: T.nilable(String),
                       model: T.nilable(String),
                       project_id: T.nilable(String),
@@ -1341,6 +1444,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::UsageCompletionsResponse::Data::Result::OrganizationUsageWebSearchesResult::APISource
+                    )
+                  }
+                  OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                  AGENTS_API = T.let(
+                    :agents_api,
+                    OpenAI::Models::Admin::Organization::UsageCompletionsResponse::Data::Result::OrganizationUsageWebSearchesResult::APISource::TaggedSymbol
+                  )
+                  UNLABELED = T.let(
+                    :unlabeled,
+                    OpenAI::Models::Admin::Organization::UsageCompletionsResponse::Data::Result::OrganizationUsageWebSearchesResult::APISource::TaggedSymbol
+                  )
+
+                  sig {
+                    override.returns(
+                      T::Array[
+                        OpenAI::Models::Admin::Organization::UsageCompletionsResponse::Data::Result::OrganizationUsageWebSearchesResult::APISource::TaggedSymbol
+                      ]
+                    )
+                  }
+                  def self.values
+                  end
+                end
               end
 
               class OrganizationCostsResult < OpenAI::Internal::Type::BaseModel
@@ -1377,6 +1514,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::UsageCompletionsResponse::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)) }
@@ -1397,6 +1547,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(
@@ -1405,6 +1560,10 @@ module OpenAI
 
                     api_key_id: T.nilable(String),
 
+                    api_source: T.nilable(
+                      OpenAI::Models::Admin::Organization::UsageCompletionsResponse::Data::Result::OrganizationCostsResult::APISource::OrSymbol
+                    ),
+
                     line_item: T.nilable(String),
 
                     project_id: T.nilable(String),
@@ -1413,6 +1572,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)
@@ -1426,6 +1587,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,
@@ -1442,6 +1609,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
@@ -1452,10 +1623,14 @@ module OpenAI
                       object: Symbol,
                       amount: OpenAI::Models::Admin::Organization::UsageCompletionsResponse::Data::Result::OrganizationCostsResult::Amount,
                       api_key_id: T.nilable(String),
+                      api_source: T.nilable(
+                        OpenAI::Models::Admin::Organization::UsageCompletionsResponse::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
@@ -1514,6 +1689,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::UsageCompletionsResponse::Data::Result::OrganizationCostsResult::APISource
+                    )
+                  }
+                  OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                  AGENTS_API = T.let(
+                    :agents_api,
+                    OpenAI::Models::Admin::Organization::UsageCompletionsResponse::Data::Result::OrganizationCostsResult::APISource::TaggedSymbol
+                  )
+                  UNLABELED = T.let(
+                    :unlabeled,
+                    OpenAI::Models::Admin::Organization::UsageCompletionsResponse::Data::Result::OrganizationCostsResult::APISource::TaggedSymbol
+                  )
+
+                  sig {
+                    override.returns(
+                      T::Array[
+                        OpenAI::Models::Admin::Organization::UsageCompletionsResponse::Data::Result::OrganizationCostsResult::APISource::TaggedSymbol
+                      ]
+                    )
+                  }
+                  def self.values
+                  end
+                end
               end
 
               sig {

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

@@ -45,8 +45,13 @@ module OpenAI
           sig { params(end_time: Integer).void }
           attr_writer :end_time
 
-          # Group the costs by the specified fields. Support fields include `project_id`,
-          # `line_item`, `api_key_id` and any combination of them.
+          # Group the costs by the specified fields. Supported fields include `project_id`,
+          # `user_id`, `line_item`, `api_key_id`, and `api_source`. Support for combining
+          # `user_id` with `project_id` grouping or the `project_ids` filter depends on the
+          # organization and requested time range. Unsupported combinations return HTTP 400.
+          # 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::UsageCostsParams::GroupBy::OrSymbol])) }
           attr_reader :group_by
 
@@ -124,8 +129,13 @@ module OpenAI
             # End time (Unix seconds) of the query time range, exclusive.
             end_time: nil,
 
-            # Group the costs by the specified fields. Support fields include `project_id`,
-            # `line_item`, `api_key_id` and any combination of them.
+            # Group the costs by the specified fields. Supported fields include `project_id`,
+            # `user_id`, `line_item`, `api_key_id`, and `api_source`. Support for combining
+            # `user_id` with `project_id` grouping or the `project_ids` filter depends on the
+            # organization and requested time range. Unsupported combinations return HTTP 400.
+            # 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,
 
             # A limit on the number of buckets to be returned. Limit can range between 1 and
@@ -190,8 +200,10 @@ module OpenAI
             OrSymbol = T.type_alias { T.any(Symbol, String) }
 
             PROJECT_ID = T.let(:project_id, OpenAI::Admin::Organization::UsageCostsParams::GroupBy::TaggedSymbol)
+            USER_ID = T.let(:user_id, OpenAI::Admin::Organization::UsageCostsParams::GroupBy::TaggedSymbol)
             LINE_ITEM = T.let(:line_item, OpenAI::Admin::Organization::UsageCostsParams::GroupBy::TaggedSymbol)
             API_KEY_ID = T.let(:api_key_id, OpenAI::Admin::Organization::UsageCostsParams::GroupBy::TaggedSymbol)
+            API_SOURCE = T.let(:api_source, OpenAI::Admin::Organization::UsageCostsParams::GroupBy::TaggedSymbol)
 
             sig { override.returns(T::Array[OpenAI::Admin::Organization::UsageCostsParams::GroupBy::TaggedSymbol]) }
             def self.values