openai 0.99.0 → 0.100.0

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

@@ -30,8 +30,8 @@ module OpenAI
             #   An optional human-readable display name for the template.
             #
             # @param network [OpenAI::Models::Beta::Agents::Environments::TemplateCreateParams::Network, nil]
-            #   Network access policy for the environment. Defaults to disabled for GA requests
-            #   and enabled for beta requests.
+            #   Network access policy for the environment. If omitted, the API version
+            #   determines whether network access is enabled or disabled.
             #
             # @param packages [OpenAI::Models::Beta::Agents::Environments::TemplateCreateParams::Packages, nil]
             #   Packages to install in the environment. Defaults to empty package lists.
@@ -113,8 +113,7 @@ module OpenAI
             #
             # @param network [OpenAI::Models::Beta::Agents::Environments::TemplateUpdateParams::Network, nil]
             #   Network access available after setup completes. Omit to preserve the current
-            #   policy, or pass `null` to reset to disabled for GA requests or enabled for beta
-            #   requests.
+            #   policy, or pass `null` to reset to the default policy.
             #
             # @param packages [OpenAI::Models::Beta::Agents::Environments::TemplateUpdateParams::Packages, nil]
             #   Packages installed before the runtime network policy applies.

data/lib/openai/resources/beta/agents/sessions/turns/items.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Resources
+    class Beta
+      class Agents
+        class Sessions
+          class Turns
+            class Items
+              # Lists items belonging to one root-agent turn, including its interactions with
+              # subagents. See
+              # [inspecting agent output](https://developers.openai.com/api/docs/guides/agents-api/observability).
+              #
+              # @overload list(turn_id, session_id:, after: nil, limit: nil, order: nil, request_options: {})
+              #
+              # @param turn_id [String]
+              #   Path param: The ID of the turn.
+              #
+              # @param session_id [String]
+              #   Path param: The ID of the session that owns the turn.
+              #
+              # @param after [String]
+              #   Query param: Return items after this cursor in the selected order. Pass the
+              #   previous response's last_id, which can differ from the last item's ID.
+              #
+              # @param limit [Integer]
+              #   Query param: The maximum number of resources to return, between 1 and 100.
+              #   Defaults to 20.
+              #
+              # @param order [Symbol, OpenAI::Models::Beta::Agents::Sessions::Turns::ItemListParams::Order]
+              #   Query param: The order in which resources are returned. Defaults to `desc`.
+              #
+              # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+              #
+              # @return [OpenAI::Internal::ConversationCursorPage<OpenAI::Models::Beta::AgentSessionMessage, OpenAI::Models::Beta::AgentReasoningItem, OpenAI::Models::Beta::AgentFunctionCallItem, OpenAI::Models::Beta::AgentSessionItem::FunctionCallOutput, OpenAI::Models::Beta::AgentSessionItem::AgentMessage, OpenAI::Models::Beta::AgentMcpCallItem, OpenAI::Models::Beta::AgentSessionItem::ComputerUseCall, OpenAI::Models::Beta::AgentSessionItem::ComputerUseApprovalRequest, OpenAI::Models::Beta::AgentSessionItem::ComputerUseApprovalRequestResult, OpenAI::Models::Beta::AgentWebSearchCallItem, OpenAI::Models::Beta::AgentCommandExecutionItem, OpenAI::Models::Beta::AgentCreateSubagentCallItem, OpenAI::Models::Beta::AgentSendSubagentInputCallItem, OpenAI::Models::Beta::AgentResumeSubagentCallItem, OpenAI::Models::Beta::AgentWaitForSubagentsCallItem, OpenAI::Models::Beta::AgentInterruptSubagentCallItem, OpenAI::Models::Beta::AgentCloseSubagentCallItem>]
+              #
+              # @see OpenAI::Models::Beta::Agents::Sessions::Turns::ItemListParams
+              def list(turn_id, params)
+                parsed, options = OpenAI::Beta::Agents::Sessions::Turns::ItemListParams.dump_request(params)
+                session_id = parsed.delete(:session_id) do
+                  raise ArgumentError.new("missing required path argument #{_1}")
+                end
+
+                query = OpenAI::Internal::Util.encode_query_params(parsed)
+                @client.request(
+                  method: :get,
+                  path: ["agents/sessions/%1$s/turns/%2$s/items", session_id, turn_id],
+                  query: query,
+                  page: OpenAI::Internal::ConversationCursorPage,
+                  model: OpenAI::Beta::AgentSessionItem,
+                  security: {bearer_auth: true},
+                  options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **options}
+                )
+              end
+
+              # @api private
+              #
+              # @param client [OpenAI::Client]
+              def initialize(client:)
+                @client = client
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -6,6 +6,9 @@ module OpenAI
       class Agents
         class Sessions
           class Turns
+            # @return [OpenAI::Resources::Beta::Agents::Sessions::Turns::Items]
+            attr_reader :items
+
             # Retrieves a turn's current status, timestamps, usage, and error. Returns 404 if
             # the turn does not belong to the session. See
             # [session turns](https://developers.openai.com/api/docs/guides/agents-api/sessions/manage#inspect-session-turns).
@@ -80,6 +83,7 @@ module OpenAI
             # @param client [OpenAI::Client]
             def initialize(client:)
               @client = client
+              @items = OpenAI::Resources::Beta::Agents::Sessions::Turns::Items.new(client: client)
             end
           end
         end

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

@@ -85,7 +85,7 @@ module OpenAI
           # the session or streams its events when stream is true. See
           # [running sessions](https://developers.openai.com/api/docs/guides/agents-api/sessions).
           #
-          # @overload create_streaming(environment:, agent: nil, agent_id: nil, input: nil, output_type: nil, metadata: nil, vault_ids: nil, request_options: {})
+          # @overload create_streaming(environment:, agent: nil, agent_id: nil, input: nil, output_type: nil, tool_handlers: {}, metadata: nil, vault_ids: nil, request_options: {})
           #
           # @param environment [OpenAI::Models::Beta::EnvironmentParam::None, OpenAI::Models::Beta::EnvironmentParam::OpenAIHosted, OpenAI::Models::Beta::EnvironmentParam::SelfHosted]
           #   An inline execution environment or a reference to an environment template.
@@ -112,6 +112,7 @@ module OpenAI
           #   The IDs of vaults made available to the session.
           #
           # @param output_type [Class<OpenAI::BaseModel>, nil] Beta: configure and parse a structured answer.
+          # @param tool_handlers [Hash{String=>Proc}] Local handlers for initial-turn function calls (not sent to the API).
           #
           # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
           #
@@ -121,6 +122,7 @@ module OpenAI
           def create_streaming(params)
             params = params.to_h.transform_keys { _1.is_a?(String) ? _1.to_sym : _1 }
             output_type = params.delete(:output_type)
+            tool_handlers = params.delete(:tool_handlers)
             parser = OpenAI::Helpers::Beta::Agents::OutputParser.new(output_type) unless output_type.nil?
             parsed, options = OpenAI::Beta::Agents::SessionCreateParams.dump_request(params)
             unless parsed.fetch(:stream, true)
@@ -140,6 +142,10 @@ module OpenAI
               security: {bearer_auth: true},
               options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **options}
             )
+            if tool_handlers
+              stream.configure_tool_handlers(sessions: self, tool_handlers: tool_handlers, request_options: options)
+            end
+
             stream.configure_output_parser(parser)
           end
 
@@ -274,17 +280,31 @@ module OpenAI
           # @param session_id [String]
           # @param input [String, Array<OpenAI::Models::Beta::AgentSessionInputMessageParam>]
           # @param tool_handlers [Hash{String=>Proc}]
+          # @param on_tool_error [Proc, nil]
+          #   Beta: use with tool_handlers to log or monitor argument parsing, handler
+          #   execution, and output conversion failures locally. Receives ToolError;
+          #   API/transport errors still propagate normally. Ordinary observer errors
+          #   are ignored, and the submitted tool failure stays generic.
           # @param idempotency_key [String, nil] Applies only to the input submission.
           # @param output_type [Class<OpenAI::BaseModel>, nil] Beta: parse output without changing session configuration.
           # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
           # @yieldparam stream [OpenAI::Helpers::Agents::SessionStream]
           # @return [OpenAI::Helpers::Agents::SessionStream]
-          def stream(session_id, input:, tool_handlers: {}, idempotency_key: nil, output_type: nil, request_options: {})
+          def stream(
+            session_id,
+            input:,
+            tool_handlers: {},
+            on_tool_error: nil,
+            idempotency_key: nil,
+            output_type: nil,
+            request_options: {}
+          )
             stream = OpenAI::Helpers::Agents::SessionStream.new(
               sessions: self,
               session_id: session_id,
               input: input,
               tool_handlers: tool_handlers,
+              on_tool_error: on_tool_error,
               idempotency_key: idempotency_key,
               output_type: output_type,
               request_options: request_options

data/lib/openai/resources/fine_tuning/jobs.rb

@@ -141,8 +141,13 @@ module OpenAI
         #   Number of fine-tuning jobs to retrieve.
         #
         # @param metadata [Hash{Symbol=>String}, nil]
-        #   Optional metadata filter. To filter, use the syntax `metadata[k]=v`.
-        #   Alternatively, set `metadata=null` to indicate no metadata.
+        #   Optional metadata filter. To filter, use the syntax `metadata[k]=v`. Omitting
+        #   the parameter or passing an empty object applies no metadata filter. An empty
+        #   value, such as `metadata[k]=`, filters for that key with an empty string value.
+        #   To select jobs with null metadata, send the literal query string
+        #   `metadata=null`. Nullable caller types do not specify how a client serializes
+        #   null for a deep-object parameter. Use a raw query parameter if the client omits
+        #   null. Do not combine the two query forms.
         #
         # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
         #

data/lib/openai/resources/images.rb

@@ -104,9 +104,10 @@ module OpenAI
       #   set the output format to `png` or `webp`.
       #
       # @param input_fidelity [Symbol, OpenAI::Models::ImageEditParams::InputFidelity, nil]
-      #   Controls fidelity to the original input image(s). This parameter is supported
-      #   for GPT image models that support input fidelity. `gpt-image-2` and
-      #   `gpt-image-2-2026-04-21` ignore this parameter.
+      #   Control how much effort the model will exert to match the style and features,
+      #   especially facial features, of input images. Supports `high` and `low` on
+      #   `gpt-image-1` and `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For
+      #   `gpt-image-2`, omit this parameter. Defaults to `low` on supported models.
       #
       # @param mask [Pathname, StringIO, IO, String, OpenAI::FilePart]
       #   An additional image whose fully transparent areas (e.g. where alpha is zero)
@@ -238,9 +239,10 @@ module OpenAI
       #   set the output format to `png` or `webp`.
       #
       # @param input_fidelity [Symbol, OpenAI::Models::ImageEditParams::InputFidelity, nil]
-      #   Controls fidelity to the original input image(s). This parameter is supported
-      #   for GPT image models that support input fidelity. `gpt-image-2` and
-      #   `gpt-image-2-2026-04-21` ignore this parameter.
+      #   Control how much effort the model will exert to match the style and features,
+      #   especially facial features, of input images. Supports `high` and `low` on
+      #   `gpt-image-1` and `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For
+      #   `gpt-image-2`, omit this parameter. Defaults to `low` on supported models.
       #
       # @param mask [Pathname, StringIO, IO, String, OpenAI::FilePart]
       #   An additional image whose fully transparent areas (e.g. where alpha is zero)

data/lib/openai/version.rb

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

data/lib/openai.rb

@@ -529,6 +529,7 @@ require_relative "openai/models/beta/agents/sessions/trace_list_params"
 require_relative "openai/models/beta/agents/sessions/turn"
 require_relative "openai/models/beta/agents/sessions/turn_list_params"
 require_relative "openai/models/beta/agents/sessions/turn_retrieve_params"
+require_relative "openai/models/beta/agents/sessions/turns/item_list_params"
 require_relative "openai/models/beta/agents/session_update_params"
 require_relative "openai/models/beta/agents/vault"
 require_relative "openai/models/beta/agents/vault_create_params"
@@ -1534,6 +1535,7 @@ require_relative "openai/resources/beta/agents/sessions/subagents/turns"
 require_relative "openai/resources/beta/agents/sessions/subagents/turns/items"
 require_relative "openai/resources/beta/agents/sessions/traces"
 require_relative "openai/resources/beta/agents/sessions/turns"
+require_relative "openai/resources/beta/agents/sessions/turns/items"
 require_relative "openai/resources/beta/agents/vaults"
 require_relative "openai/resources/beta/agents/vaults/credentials"
 require_relative "openai/resources/beta/assistants"

data/rbi/openai/helpers/agents.rbi

@@ -56,6 +56,7 @@ module OpenAI
               session_id: String,
               input: T.any(String, T::Array[OpenAI::Models::Beta::AgentSessionInputMessageParam::OrHash]),
               tool_handlers: T::Hash[String, OpenAI::Helpers::Agents::ToolHandler],
+              on_tool_error: T.nilable(T.proc.params(failure: OpenAI::Helpers::Beta::Agents::ToolError).void),
               idempotency_key: T.nilable(String),
               output_type: T.nilable(T.class_of(OpenAI::Helpers::StructuredOutput::BaseModel)),
               request_options: T.nilable(OpenAI::RequestOptions::OrHash),
@@ -67,6 +68,7 @@ module OpenAI
             session_id,
             input:,
             tool_handlers: {},
+            on_tool_error: nil,
             idempotency_key: nil,
             output_type: nil,
             request_options: {},

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

@@ -13,11 +13,12 @@ module OpenAI
               name: String,
               arguments: T.class_of(OpenAI::BaseModel),
               description: String,
+              defer_loading: T.nilable(T::Boolean),
               handler: T.proc.params(arguments: T.untyped).returns(OpenAI::Helpers::Agents::ToolOutput)
             )
               .void
           end
-          def initialize(name:, arguments:, description: "", &handler)
+          def initialize(name:, arguments:, description: "", defer_loading: nil, &handler)
           end
 
           sig { returns(OpenAI::Internal::AnyHash) }
@@ -29,9 +30,13 @@ module OpenAI
           end
 
           sig {
-            params(arguments: T.any(String, OpenAI::Internal::AnyHash)).returns(OpenAI::Helpers::Agents::ToolOutput)
+            params(
+              arguments: T.any(String, OpenAI::Internal::AnyHash),
+              report_stage: T.nilable(T.proc.params(stage: Symbol).void)
+            )
+              .returns(OpenAI::Helpers::Agents::ToolOutput)
           }
-          def call(arguments)
+          def call(arguments, &report_stage)
           end
         end
       end

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

@@ -0,0 +1,19 @@
+# typed: strong
+
+module OpenAI
+  module Helpers
+    module Beta
+      module Agents
+        # Beta, local-only tool failure diagnostic.
+        class ToolError
+          sig { returns(StandardError) }
+          attr_reader :error
+          sig { returns(String) }
+          attr_reader :tool_name, :session_id, :turn_id, :call_id
+          sig { returns(Symbol) }
+          attr_reader :stage
+        end
+      end
+    end
+  end
+end

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

@@ -139,6 +139,18 @@ module OpenAI
           sig { params(parser: T.nilable(OutputParser)).returns(T.self_type) }
           def configure_output_parser(parser)
           end
+
+          # @api private
+          sig do
+            params(
+              sessions: OpenAI::Resources::Beta::Agents::Sessions,
+              tool_handlers: T::Hash[String, OpenAI::Helpers::Agents::ToolHandler],
+              request_options: T.untyped
+            )
+              .returns(T.self_type)
+          end
+          def configure_tool_handlers(sessions:, tool_handlers:, request_options:)
+          end
         end
       end
     end

data/rbi/openai/models/admin/organization/usage_audio_speeches_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::UsageAudioSpeechesResponse::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)) }
@@ -327,6 +340,10 @@ module OpenAI
 
                     api_key_id: T.nilable(String),
 
+                    api_source: T.nilable(
+                      OpenAI::Models::Admin::Organization::UsageAudioSpeechesResponse::Data::Result::OrganizationUsageCompletionsResult::APISource::OrSymbol
+                    ),
+
                     batch: T.nilable(T::Boolean),
 
                     input_audio_tokens: Integer,
@@ -386,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,
@@ -462,6 +485,9 @@ module OpenAI
                       object: Symbol,
                       output_tokens: Integer,
                       api_key_id: T.nilable(String),
+                      api_source: T.nilable(
+                        OpenAI::Models::Admin::Organization::UsageAudioSpeechesResponse::Data::Result::OrganizationUsageCompletionsResult::APISource::TaggedSymbol
+                      ),
                       batch: T.nilable(T::Boolean),
                       input_audio_tokens: Integer,
                       input_cache_write_12h_tokens: Integer,
@@ -486,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::UsageAudioSpeechesResponse::Data::Result::OrganizationUsageCompletionsResult::APISource
+                    )
+                  }
+                  OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                  AGENTS_API = T.let(
+                    :agents_api,
+                    OpenAI::Models::Admin::Organization::UsageAudioSpeechesResponse::Data::Result::OrganizationUsageCompletionsResult::APISource::TaggedSymbol
+                  )
+                  UNLABELED = T.let(
+                    :unlabeled,
+                    OpenAI::Models::Admin::Organization::UsageAudioSpeechesResponse::Data::Result::OrganizationUsageCompletionsResult::APISource::TaggedSymbol
+                  )
+
+                  sig {
+                    override.returns(
+                      T::Array[
+                        OpenAI::Models::Admin::Organization::UsageAudioSpeechesResponse::Data::Result::OrganizationUsageCompletionsResult::APISource::TaggedSymbol
+                      ]
+                    )
+                  }
+                  def self.values
+                  end
+                end
               end
 
               class OrganizationUsageEmbeddingsResult < OpenAI::Internal::Type::BaseModel
@@ -1267,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::UsageAudioSpeechesResponse::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)) }
@@ -1297,6 +1370,10 @@ module OpenAI
 
                     api_key_id: T.nilable(String),
 
+                    api_source: T.nilable(
+                      OpenAI::Models::Admin::Organization::UsageAudioSpeechesResponse::Data::Result::OrganizationUsageWebSearchesResult::APISource::OrSymbol
+                    ),
+
                     context_level: T.nilable(String),
 
                     model: T.nilable(String),
@@ -1321,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,
@@ -1348,6 +1431,9 @@ module OpenAI
                       num_requests: Integer,
                       object: Symbol,
                       api_key_id: T.nilable(String),
+                      api_source: T.nilable(
+                        OpenAI::Models::Admin::Organization::UsageAudioSpeechesResponse::Data::Result::OrganizationUsageWebSearchesResult::APISource::TaggedSymbol
+                      ),
                       context_level: T.nilable(String),
                       model: T.nilable(String),
                       project_id: T.nilable(String),
@@ -1358,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::UsageAudioSpeechesResponse::Data::Result::OrganizationUsageWebSearchesResult::APISource
+                    )
+                  }
+                  OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                  AGENTS_API = T.let(
+                    :agents_api,
+                    OpenAI::Models::Admin::Organization::UsageAudioSpeechesResponse::Data::Result::OrganizationUsageWebSearchesResult::APISource::TaggedSymbol
+                  )
+                  UNLABELED = T.let(
+                    :unlabeled,
+                    OpenAI::Models::Admin::Organization::UsageAudioSpeechesResponse::Data::Result::OrganizationUsageWebSearchesResult::APISource::TaggedSymbol
+                  )
+
+                  sig {
+                    override.returns(
+                      T::Array[
+                        OpenAI::Models::Admin::Organization::UsageAudioSpeechesResponse::Data::Result::OrganizationUsageWebSearchesResult::APISource::TaggedSymbol
+                      ]
+                    )
+                  }
+                  def self.values
+                  end
+                end
               end
 
               class OrganizationCostsResult < OpenAI::Internal::Type::BaseModel
@@ -1394,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::UsageAudioSpeechesResponse::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)) }
@@ -1414,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(
@@ -1422,6 +1560,10 @@ module OpenAI
 
                     api_key_id: T.nilable(String),
 
+                    api_source: T.nilable(
+                      OpenAI::Models::Admin::Organization::UsageAudioSpeechesResponse::Data::Result::OrganizationCostsResult::APISource::OrSymbol
+                    ),
+
                     line_item: T.nilable(String),
 
                     project_id: T.nilable(String),
@@ -1430,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)
@@ -1443,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,
@@ -1459,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
@@ -1469,10 +1623,14 @@ module OpenAI
                       object: Symbol,
                       amount: OpenAI::Models::Admin::Organization::UsageAudioSpeechesResponse::Data::Result::OrganizationCostsResult::Amount,
                       api_key_id: T.nilable(String),
+                      api_source: T.nilable(
+                        OpenAI::Models::Admin::Organization::UsageAudioSpeechesResponse::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
@@ -1531,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::UsageAudioSpeechesResponse::Data::Result::OrganizationCostsResult::APISource
+                    )
+                  }
+                  OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                  AGENTS_API = T.let(
+                    :agents_api,
+                    OpenAI::Models::Admin::Organization::UsageAudioSpeechesResponse::Data::Result::OrganizationCostsResult::APISource::TaggedSymbol
+                  )
+                  UNLABELED = T.let(
+                    :unlabeled,
+                    OpenAI::Models::Admin::Organization::UsageAudioSpeechesResponse::Data::Result::OrganizationCostsResult::APISource::TaggedSymbol
+                  )
+
+                  sig {
+                    override.returns(
+                      T::Array[
+                        OpenAI::Models::Admin::Organization::UsageAudioSpeechesResponse::Data::Result::OrganizationCostsResult::APISource::TaggedSymbol
+                      ]
+                    )
+                  }
+                  def self.values
+                  end
+                end
               end
 
               sig {