openai 0.114.0 → 0.115.0

data/lib/openai/models/beta/agents/session_create_params.rb

@@ -47,6 +47,12 @@ module OpenAI
           #   @return [Hash{Symbol=>String}, nil]
           optional :metadata, OpenAI::Internal::Type::HashOf[String], nil?: true
 
+          # @!attribute review
+          #   Action review mode. Omit to use none.
+          #
+          #   @return [Symbol, OpenAI::Models::Beta::Agents::SessionCreateParams::Review, nil]
+          optional :review, enum: -> { OpenAI::Beta::Agents::SessionCreateParams::Review }
+
           # @!attribute spend_control
           #   Optional spending limit in USD cents. Omission or null creates an unlimited
           #   session.
@@ -66,7 +72,7 @@ module OpenAI
           #   @return [Array<String>, nil]
           optional :vault_ids, OpenAI::Internal::Type::ArrayOf[String], nil?: true
 
-          # @!method initialize(environment:, agent: nil, agent_id: nil, input: nil, metadata: nil, spend_control: nil, vault_ids: nil, request_options: {})
+          # @!method initialize(environment:, agent: nil, agent_id: nil, input: nil, metadata: nil, review: nil, spend_control: 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.
           #
@@ -88,6 +94,9 @@ module OpenAI
           #     Up to 16 string key-value pairs, with keys up to 64 and values up to 512
           #     characters. Omission or null defaults to an empty map.
           #
+          #   @param review [Symbol, OpenAI::Models::Beta::Agents::SessionCreateParams::Review]
+          #     Action review mode. Omit to use none.
+          #
           #   @param spend_control [OpenAI::Models::Beta::Agents::SessionCreateParams::SpendControl, nil]
           #     Optional spending limit in USD cents. Omission or null creates an unlimited
           #     session.
@@ -98,6 +107,27 @@ module OpenAI
           #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
 
           class Agent < OpenAI::Internal::Type::BaseModel
+            # @!attribute compaction
+            #   Context compaction settings. Omit to keep the current settings. A supplied
+            #   object replaces the settings; null or an empty object enables background
+            #   compaction.
+            #
+            #   @return [OpenAI::Models::Beta::Agents::SessionCreateParams::Agent::Compaction, nil]
+            optional(
+              :compaction,
+              -> {
+                OpenAI::Beta::Agents::SessionCreateParams::Agent::Compaction
+              },
+              nil?: true
+            )
+
+            # @!attribute experimental
+            #   Experimental settings to merge by key. Omitted settings keep their current
+            #   values.
+            #
+            #   @return [OpenAI::Models::Beta::Agents::SessionCreateParams::Agent::Experimental, nil]
+            optional :experimental, -> { OpenAI::Beta::Agents::SessionCreateParams::Agent::Experimental }
+
             # @!attribute instructions
             #   Additional instructions appended to the agent's default base instructions. Omit
             #   to leave unchanged.
@@ -154,10 +184,19 @@ module OpenAI
               nil?: true
             )
 
-            # @!method initialize(instructions: nil, model: nil, multi_agent: nil, reasoning: nil, service_tier: nil, text: nil, tools: nil)
+            # @!method initialize(compaction: nil, experimental: nil, instructions: nil, model: nil, multi_agent: nil, reasoning: nil, service_tier: nil, text: nil, tools: nil)
             #   Agent configuration. With `agent_id`, supplied fields override the saved agent
             #   for this session. Without `agent_id`, `model` is required.
             #
+            #   @param compaction [OpenAI::Models::Beta::Agents::SessionCreateParams::Agent::Compaction, nil]
+            #     Context compaction settings. Omit to keep the current settings. A supplied
+            #     object replaces the settings; null or an empty object enables background
+            #     compaction.
+            #
+            #   @param experimental [OpenAI::Models::Beta::Agents::SessionCreateParams::Agent::Experimental]
+            #     Experimental settings to merge by key. Omitted settings keep their current
+            #     values.
+            #
             #   @param instructions [String, nil]
             #     Additional instructions appended to the agent's default base instructions. Omit
             #     to leave unchanged.
@@ -183,6 +222,45 @@ module OpenAI
             #     resolved tool list must fit within 3 MiB (3,145,728 bytes) of compact UTF-8
             #     JSON.
 
+            # @see OpenAI::Models::Beta::Agents::SessionCreateParams::Agent#compaction
+            class Compaction < OpenAI::Internal::Type::BaseModel
+              # @!attribute async
+              #   Whether to compact context in the background. Omission or null defaults to true.
+              #   Set to false to use blocking compaction. Background compaction may increase
+              #   token usage.
+              #
+              #   @return [Boolean, nil]
+              optional :async, OpenAI::Internal::Type::Boolean, nil?: true
+
+              # @!method initialize(async: nil)
+              #   Context compaction settings. Omit to keep the current settings. A supplied
+              #   object replaces the settings; null or an empty object enables background
+              #   compaction.
+              #
+              #   @param async [Boolean, nil]
+              #     Whether to compact context in the background. Omission or null defaults to true.
+              #     Set to false to use blocking compaction. Background compaction may increase
+              #     token usage.
+            end
+
+            # @see OpenAI::Models::Beta::Agents::SessionCreateParams::Agent#experimental
+            class Experimental < OpenAI::Internal::Type::BaseModel
+              # @!attribute time_awareness
+              #   Whether to give the model periodic current-time reminders. Omit to keep the
+              #   current setting.
+              #
+              #   @return [Boolean, nil]
+              optional :time_awareness, OpenAI::Internal::Type::Boolean
+
+              # @!method initialize(time_awareness: nil)
+              #   Experimental settings to merge by key. Omitted settings keep their current
+              #   values.
+              #
+              #   @param time_awareness [Boolean]
+              #     Whether to give the model periodic current-time reminders. Omit to keep the
+              #     current setting.
+            end
+
             # The service tier used for model requests.
             #
             # @see OpenAI::Models::Beta::Agents::SessionCreateParams::Agent#service_tier
@@ -232,6 +310,20 @@ module OpenAI
             ]
           end
 
+          # Action review mode. Omit to use none.
+          module Review
+            extend OpenAI::Internal::Type::Enum
+
+            # Keep the existing execution behavior without automatic action review.
+            NONE = :none
+
+            # Review eligible actions automatically. Deny manual approval fallbacks.
+            AUTO_REVIEW = :auto_review
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
           class SpendControl < OpenAI::Internal::Type::BaseModel
             # @!attribute limit
             #   Positive USD cents, or null to remove the limit.

data/lib/openai/models/beta/agents/session_list_params.rb

@@ -28,13 +28,22 @@ module OpenAI
           #   @return [Integer, nil]
           optional :limit, Integer
 
+          # @!attribute metadata
+          #   Exact string matches supplied as `metadata[key]=value`. All supplied pairs must
+          #   match. Up to 16 pairs, with keys from 1 to 64 characters and values up to 512
+          #   characters. New sessions and metadata updates may take time to appear in
+          #   filtered results.
+          #
+          #   @return [Hash{Symbol=>String}, nil]
+          optional :metadata, OpenAI::Internal::Type::HashOf[String]
+
           # @!attribute order
           #   The order in which resources are returned. Defaults to `desc`.
           #
           #   @return [Symbol, OpenAI::Models::Beta::Agents::SessionListParams::Order, nil]
           optional :order, enum: -> { OpenAI::Beta::Agents::SessionListParams::Order }
 
-          # @!method initialize(after: nil, agent_id: nil, limit: nil, order: nil, request_options: {})
+          # @!method initialize(after: nil, agent_id: nil, limit: nil, metadata: nil, order: nil, request_options: {})
           #   @param after [String]
           #     Return resources after this resource ID in the selected order.
           #
@@ -45,6 +54,12 @@ module OpenAI
           #   @param limit [Integer]
           #     The maximum number of resources to return, between 1 and 100. Defaults to 20.
           #
+          #   @param metadata [Hash{Symbol=>String}]
+          #     Exact string matches supplied as `metadata[key]=value`. All supplied pairs must
+          #     match. Up to 16 pairs, with keys from 1 to 64 characters and values up to 512
+          #     characters. New sessions and metadata updates may take time to appear in
+          #     filtered results.
+          #
           #   @param order [Symbol, OpenAI::Models::Beta::Agents::SessionListParams::Order]
           #     The order in which resources are returned. Defaults to `desc`.
           #

data/lib/openai/models/beta/agents/session_update_params.rb

@@ -15,7 +15,7 @@ module OpenAI
           required :session_id, String
 
           # @!attribute agent
-          #   Model settings for subsequent turns. Omitted fields stay unchanged.
+          #   Agent settings to update on this session. Omitted fields stay unchanged.
           #
           #   @return [OpenAI::Models::Beta::Agents::SessionUpdateParams::Agent, nil]
           optional :agent, -> { OpenAI::Beta::Agents::SessionUpdateParams::Agent }
@@ -28,6 +28,13 @@ module OpenAI
           #   @return [Hash{Symbol=>String}, nil]
           optional :metadata, OpenAI::Internal::Type::HashOf[String], nil?: true
 
+          # @!attribute review
+          #   Default action review for new root turns. Existing turns and their subagents
+          #   keep their review mode.
+          #
+          #   @return [Symbol, OpenAI::Models::Beta::Agents::SessionUpdateParams::Review, nil]
+          optional :review, enum: -> { OpenAI::Beta::Agents::SessionUpdateParams::Review }
+
           # @!attribute spend_control
           #   Omit to retain the limit; null or a null limit removes it without resetting
           #   spend.
@@ -41,17 +48,21 @@ module OpenAI
             nil?: true
           )
 
-          # @!method initialize(session_id:, agent: nil, metadata: nil, spend_control: nil, request_options: {})
+          # @!method initialize(session_id:, agent: nil, metadata: nil, review: nil, spend_control: nil, request_options: {})
           #   @param session_id [String]
           #
           #   @param agent [OpenAI::Models::Beta::Agents::SessionUpdateParams::Agent]
-          #     Model settings for subsequent turns. Omitted fields stay unchanged.
+          #     Agent settings to update on this session. Omitted fields stay unchanged.
           #
           #   @param metadata [Hash{Symbol=>String}, nil]
           #     Replaces all metadata. Omit to leave unchanged, or pass null or {} to clear it.
           #     Up to 16 string key-value pairs, with keys up to 64 and values up to 512
           #     characters.
           #
+          #   @param review [Symbol, OpenAI::Models::Beta::Agents::SessionUpdateParams::Review]
+          #     Default action review for new root turns. Existing turns and their subagents
+          #     keep their review mode.
+          #
           #   @param spend_control [OpenAI::Models::Beta::Agents::SessionUpdateParams::SpendControl, nil]
           #     Omit to retain the limit; null or a null limit removes it without resetting
           #     spend.
@@ -81,8 +92,22 @@ module OpenAI
               nil?: true
             )
 
-            # @!method initialize(model: nil, reasoning: nil, service_tier: nil)
-            #   Model settings for subsequent turns. Omitted fields stay unchanged.
+            # @!attribute tools
+            #   Replaces the session tools. Functions and MCP servers change on the next model
+            #   call. Built-in tools change by the next turn. Omit to keep the current tools, or
+            #   pass null or an empty array to clear them.
+            #
+            #   @return [Array<OpenAI::Models::Beta::AgentToolParam::Function, OpenAI::Models::Beta::AgentToolParam::ToolSearch, OpenAI::Models::Beta::AgentToolParam::ProgrammaticToolCalling, OpenAI::Models::Beta::AgentToolParam::Mcp, OpenAI::Models::Beta::AgentToolParam::WebSearch, OpenAI::Models::Beta::AgentToolParam::ComputerUse, OpenAI::Models::Beta::AgentToolParam::Automations>, nil]
+            optional(
+              :tools,
+              -> {
+                OpenAI::Internal::Type::ArrayOf[union: OpenAI::Beta::AgentToolParam]
+              },
+              nil?: true
+            )
+
+            # @!method initialize(model: nil, reasoning: nil, service_tier: nil, tools: nil)
+            #   Agent settings to update on this session. Omitted fields stay unchanged.
             #
             #   @param model [String]
             #     The model for subsequent turns. Omit to keep the current model.
@@ -92,6 +117,11 @@ module OpenAI
             #
             #   @param service_tier [Symbol, OpenAI::Models::Beta::Agents::SessionUpdateParams::Agent::ServiceTier, nil]
             #     Omit to keep the current tier. Null resets it to auto.
+            #
+            #   @param tools [Array<OpenAI::Models::Beta::AgentToolParam::Function, OpenAI::Models::Beta::AgentToolParam::ToolSearch, OpenAI::Models::Beta::AgentToolParam::ProgrammaticToolCalling, OpenAI::Models::Beta::AgentToolParam::Mcp, OpenAI::Models::Beta::AgentToolParam::WebSearch, OpenAI::Models::Beta::AgentToolParam::ComputerUse, OpenAI::Models::Beta::AgentToolParam::Automations>, nil]
+            #     Replaces the session tools. Functions and MCP servers change on the next model
+            #     call. Built-in tools change by the next turn. Omit to keep the current tools, or
+            #     pass null or an empty array to clear them.
 
             # @see OpenAI::Models::Beta::Agents::SessionUpdateParams::Agent#reasoning
             class Reasoning < OpenAI::Internal::Type::BaseModel
@@ -159,6 +189,21 @@ module OpenAI
             end
           end
 
+          # Default action review for new root turns. Existing turns and their subagents
+          # keep their review mode.
+          module Review
+            extend OpenAI::Internal::Type::Enum
+
+            # Keep the existing execution behavior without automatic action review.
+            NONE = :none
+
+            # Review eligible actions automatically. Deny manual approval fallbacks.
+            AUTO_REVIEW = :auto_review
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
           class SpendControl < OpenAI::Internal::Type::BaseModel
             # @!attribute limit
             #   Positive USD cents, or null to remove the limit.

data/lib/openai/models/beta/assistant_update_params.rb

@@ -310,11 +310,29 @@ module OpenAI
 
           # @!group
 
+          # @deprecated Announced shutdown date: 2026-12-11. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_5 = :"gpt-5"
+          # @deprecated Announced shutdown date: 2026-12-11. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_5_MINI = :"gpt-5-mini"
+          # @deprecated Announced shutdown date: 2026-12-11. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_5_NANO = :"gpt-5-nano"
+          # @deprecated Announced shutdown date: 2026-12-11. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_5_2025_08_07 = :"gpt-5-2025-08-07"
+          # @deprecated Announced shutdown date: 2026-12-11. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_5_MINI_2025_08_07 = :"gpt-5-mini-2025-08-07"
+          # @deprecated Announced shutdown date: 2026-12-11. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_5_NANO_2025_08_07 = :"gpt-5-nano-2025-08-07"
           # @deprecated Announced shutdown date: 2027-01-14. See
           # https://developers.openai.com/api/docs/deprecations for details and recommended

data/lib/openai/models/beta/beta_response.rb

@@ -319,6 +319,23 @@ module OpenAI
         #   @return [OpenAI::Models::Beta::BetaResponseTextConfig, nil]
         optional :text, -> { OpenAI::Beta::BetaResponseTextConfig }
 
+        # @!attribute tool_usage
+        #   Usage reported by hosted tools, separate from base model `usage`. The field can
+        #   be omitted when tool usage is unavailable. When present, tool families with no
+        #   recorded usage have zero counts.
+        #
+        #   `image_gen` sums available token counts across image generation calls. Calls
+        #   with missing or incomplete usage records may be skipped. Output token details
+        #   and cached input counts can be omitted. An omitted cache count means cache usage
+        #   is unknown.
+        #
+        #   `web_search.num_requests` counts billable searches. Discounted searches and
+        #   actions such as opening a page are excluded. Use billing records to reconcile
+        #   final charges.
+        #
+        #   @return [OpenAI::Models::Beta::BetaResponse::ToolUsage, nil]
+        optional :tool_usage, -> { OpenAI::Beta::BetaResponse::ToolUsage }
+
         # @!attribute top_logprobs
         #   An integer between 0 and 20 specifying the maximum number of most likely tokens
         #   to return at each token position, each with an associated log probability. In
@@ -358,7 +375,7 @@ module OpenAI
         #   @return [String, nil]
         optional :user, String
 
-        # @!method initialize(id:, access_programs:, created_at:, error:, incomplete_details:, instructions:, metadata:, model:, output:, parallel_tool_calls:, temperature:, tool_choice:, tools:, top_p:, background: nil, completed_at: nil, conversation: nil, max_output_tokens: nil, max_tool_calls: nil, moderation: nil, previous_response_id: nil, prompt: nil, prompt_cache_diagnostics: nil, prompt_cache_key: nil, prompt_cache_options: nil, prompt_cache_retention: nil, reasoning: nil, safety_identifier: nil, service_tier: nil, status: nil, text: nil, top_logprobs: nil, truncation: nil, usage: nil, user: nil, object: :response)
+        # @!method initialize(id:, access_programs:, created_at:, error:, incomplete_details:, instructions:, metadata:, model:, output:, parallel_tool_calls:, temperature:, tool_choice:, tools:, top_p:, background: nil, completed_at: nil, conversation: nil, max_output_tokens: nil, max_tool_calls: nil, moderation: nil, previous_response_id: nil, prompt: nil, prompt_cache_diagnostics: nil, prompt_cache_key: nil, prompt_cache_options: nil, prompt_cache_retention: nil, reasoning: nil, safety_identifier: nil, service_tier: nil, status: nil, text: nil, tool_usage: nil, top_logprobs: nil, truncation: nil, usage: nil, user: nil, object: :response)
         #   @param id [String]
         #     Unique identifier for this Response.
         #
@@ -566,6 +583,20 @@ module OpenAI
         #     - [Text inputs and outputs](https://developers.openai.com/api/docs/guides/text)
         #     - [Structured Outputs](https://developers.openai.com/api/docs/guides/structured-outputs)
         #
+        #   @param tool_usage [OpenAI::Models::Beta::BetaResponse::ToolUsage]
+        #     Usage reported by hosted tools, separate from base model `usage`. The field can
+        #     be omitted when tool usage is unavailable. When present, tool families with no
+        #     recorded usage have zero counts.
+        #
+        #     `image_gen` sums available token counts across image generation calls. Calls
+        #     with missing or incomplete usage records may be skipped. Output token details
+        #     and cached input counts can be omitted. An omitted cache count means cache usage
+        #     is unknown.
+        #
+        #     `web_search.num_requests` counts billable searches. Discounted searches and
+        #     actions such as opening a page are excluded. Use billing records to reconcile
+        #     final charges.
+        #
         #   @param top_logprobs [Integer, nil]
         #     An integer between 0 and 20 specifying the maximum number of most likely tokens
         #     to return at each token position, each with an associated log probability. In
@@ -942,6 +973,9 @@ module OpenAI
           # replacements.
           GPT_5_4_NANO = :"gpt-5.4-nano"
           GPT_5_4_MINI_2026_03_17 = :"gpt-5.4-mini-2026-03-17"
+          # @deprecated Announced shutdown date: 2027-04-01. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_5_4_NANO_2026_03_17 = :"gpt-5.4-nano-2026-03-17"
           # @deprecated Announced shutdown date: 2026-08-10. See
           # https://developers.openai.com/api/docs/deprecations for details and recommended
@@ -959,6 +993,9 @@ module OpenAI
           # https://developers.openai.com/api/docs/deprecations for details and recommended
           # replacements.
           GPT_5_1 = :"gpt-5.1"
+          # @deprecated Announced shutdown date: 2027-04-01. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_5_1_2025_11_13 = :"gpt-5.1-2025-11-13"
           # @deprecated Announced shutdown date: 2026-07-23. See
           # https://developers.openai.com/api/docs/deprecations for details and recommended
@@ -2108,6 +2145,192 @@ module OpenAI
           #   @return [Array<Symbol>]
         end
 
+        # @see OpenAI::Models::Beta::BetaResponse#tool_usage
+        class ToolUsage < OpenAI::Internal::Type::BaseModel
+          # @!attribute image_gen
+          #   Aggregated usage statistics for image generation tool calls.
+          #
+          #   @return [OpenAI::Models::Beta::BetaResponse::ToolUsage::ImageGen]
+          required :image_gen, -> { OpenAI::Beta::BetaResponse::ToolUsage::ImageGen }
+
+          # @!attribute web_search
+          #   Aggregated billable usage statistics for web search tool calls.
+          #
+          #   @return [OpenAI::Models::Beta::BetaResponse::ToolUsage::WebSearch]
+          required :web_search, -> { OpenAI::Beta::BetaResponse::ToolUsage::WebSearch }
+
+          # @!method initialize(image_gen:, web_search:)
+          #   Usage reported by hosted tools, separate from base model `usage`. The field can
+          #   be omitted when tool usage is unavailable. When present, tool families with no
+          #   recorded usage have zero counts.
+          #
+          #   `image_gen` sums available token counts across image generation calls. Calls
+          #   with missing or incomplete usage records may be skipped. Output token details
+          #   and cached input counts can be omitted. An omitted cache count means cache usage
+          #   is unknown.
+          #
+          #   `web_search.num_requests` counts billable searches. Discounted searches and
+          #   actions such as opening a page are excluded. Use billing records to reconcile
+          #   final charges.
+          #
+          #   @param image_gen [OpenAI::Models::Beta::BetaResponse::ToolUsage::ImageGen]
+          #     Aggregated usage statistics for image generation tool calls.
+          #
+          #   @param web_search [OpenAI::Models::Beta::BetaResponse::ToolUsage::WebSearch]
+          #     Aggregated billable usage statistics for web search tool calls.
+
+          # @see OpenAI::Models::Beta::BetaResponse::ToolUsage#image_gen
+          class ImageGen < OpenAI::Internal::Type::BaseModel
+            # @!attribute input_tokens
+            #   The number of tokens (images and text) in the input prompt.
+            #
+            #   @return [Integer]
+            required :input_tokens, Integer
+
+            # @!attribute input_tokens_details
+            #   The input tokens detailed information for the image generation.
+            #
+            #   @return [OpenAI::Models::Beta::BetaResponse::ToolUsage::ImageGen::InputTokensDetails]
+            required :input_tokens_details, -> { OpenAI::Beta::BetaResponse::ToolUsage::ImageGen::InputTokensDetails }
+
+            # @!attribute output_tokens
+            #   The number of output tokens generated by the model.
+            #
+            #   @return [Integer]
+            required :output_tokens, Integer
+
+            # @!attribute total_tokens
+            #   The total number of tokens (images and text) used for the image generation.
+            #
+            #   @return [Integer]
+            required :total_tokens, Integer
+
+            # @!attribute cached_tokens
+            #
+            #   @return [Integer, nil]
+            optional :cached_tokens, Integer
+
+            # @!attribute cached_tokens_details
+            #
+            #   @return [OpenAI::Models::Beta::BetaResponse::ToolUsage::ImageGen::CachedTokensDetails, nil]
+            optional(
+              :cached_tokens_details,
+              -> { OpenAI::Beta::BetaResponse::ToolUsage::ImageGen::CachedTokensDetails }
+            )
+
+            # @!attribute output_tokens_details
+            #   The output token details for the image generation.
+            #
+            #   @return [OpenAI::Models::Beta::BetaResponse::ToolUsage::ImageGen::OutputTokensDetails, nil]
+            optional(
+              :output_tokens_details,
+              -> { OpenAI::Beta::BetaResponse::ToolUsage::ImageGen::OutputTokensDetails }
+            )
+
+            # @!method initialize(input_tokens:, input_tokens_details:, output_tokens:, total_tokens:, cached_tokens: nil, cached_tokens_details: nil, output_tokens_details: nil)
+            #   Aggregated usage statistics for image generation tool calls.
+            #
+            #   @param input_tokens [Integer]
+            #     The number of tokens (images and text) in the input prompt.
+            #
+            #   @param input_tokens_details [OpenAI::Models::Beta::BetaResponse::ToolUsage::ImageGen::InputTokensDetails]
+            #     The input tokens detailed information for the image generation.
+            #
+            #   @param output_tokens [Integer]
+            #     The number of output tokens generated by the model.
+            #
+            #   @param total_tokens [Integer]
+            #     The total number of tokens (images and text) used for the image generation.
+            #
+            #   @param cached_tokens [Integer]
+            #
+            #   @param cached_tokens_details [OpenAI::Models::Beta::BetaResponse::ToolUsage::ImageGen::CachedTokensDetails]
+            #
+            #   @param output_tokens_details [OpenAI::Models::Beta::BetaResponse::ToolUsage::ImageGen::OutputTokensDetails]
+            #     The output token details for the image generation.
+
+            # @see OpenAI::Models::Beta::BetaResponse::ToolUsage::ImageGen#input_tokens_details
+            class InputTokensDetails < OpenAI::Internal::Type::BaseModel
+              # @!attribute image_tokens
+              #   The number of image tokens in the input prompt.
+              #
+              #   @return [Integer]
+              required :image_tokens, Integer
+
+              # @!attribute text_tokens
+              #   The number of text tokens in the input prompt.
+              #
+              #   @return [Integer]
+              required :text_tokens, Integer
+
+              # @!method initialize(image_tokens:, text_tokens:)
+              #   The input tokens detailed information for the image generation.
+              #
+              #   @param image_tokens [Integer]
+              #     The number of image tokens in the input prompt.
+              #
+              #   @param text_tokens [Integer]
+              #     The number of text tokens in the input prompt.
+            end
+
+            # @see OpenAI::Models::Beta::BetaResponse::ToolUsage::ImageGen#cached_tokens_details
+            class CachedTokensDetails < OpenAI::Internal::Type::BaseModel
+              # @!attribute cached_image_tokens
+              #
+              #   @return [Integer]
+              required :cached_image_tokens, Integer
+
+              # @!attribute cached_text_tokens
+              #
+              #   @return [Integer]
+              required :cached_text_tokens, Integer
+
+              # @!method initialize(cached_image_tokens:, cached_text_tokens:)
+              #   @param cached_image_tokens [Integer]
+              #   @param cached_text_tokens [Integer]
+            end
+
+            # @see OpenAI::Models::Beta::BetaResponse::ToolUsage::ImageGen#output_tokens_details
+            class OutputTokensDetails < OpenAI::Internal::Type::BaseModel
+              # @!attribute image_tokens
+              #   The number of image output tokens generated by the model.
+              #
+              #   @return [Integer]
+              required :image_tokens, Integer
+
+              # @!attribute text_tokens
+              #   The number of text output tokens generated by the model.
+              #
+              #   @return [Integer]
+              required :text_tokens, Integer
+
+              # @!method initialize(image_tokens:, text_tokens:)
+              #   The output token details for the image generation.
+              #
+              #   @param image_tokens [Integer]
+              #     The number of image output tokens generated by the model.
+              #
+              #   @param text_tokens [Integer]
+              #     The number of text output tokens generated by the model.
+            end
+          end
+
+          # @see OpenAI::Models::Beta::BetaResponse::ToolUsage#web_search
+          class WebSearch < OpenAI::Internal::Type::BaseModel
+            # @!attribute num_requests
+            #   The number of billable web search requests issued.
+            #
+            #   @return [Integer]
+            required :num_requests, Integer
+
+            # @!method initialize(num_requests:)
+            #   Aggregated billable usage statistics for web search tool calls.
+            #
+            #   @param num_requests [Integer]
+            #     The number of billable web search requests issued.
+          end
+        end
+
         # The truncation strategy to use for the model response.
         #
         # - `auto`: If the input to this Response exceeds the model's context window size,

data/lib/openai/models/beta/beta_response_configuration_update_item.rb

@@ -28,9 +28,15 @@ module OpenAI
         #   @return [OpenAI::Models::Beta::BetaResponseConfigurationUpdateItem::Reasoning, nil]
         optional :reasoning, -> { OpenAI::Beta::BetaResponseConfigurationUpdateItem::Reasoning }
 
-        # @!method initialize(id:, agent: nil, reasoning: nil, type: :configuration_update)
-        #   A configuration update that applies to subsequent responses until it is replaced
-        #   by another configuration update.
+        # @!attribute text
+        #   The text output configuration for subsequent responses.
+        #
+        #   @return [OpenAI::Models::Beta::BetaResponseConfigurationUpdateItem::Text, nil]
+        optional :text, -> { OpenAI::Beta::BetaResponseConfigurationUpdateItem::Text }
+
+        # @!method initialize(id:, agent: nil, reasoning: nil, text: nil, type: :configuration_update)
+        #   A configuration update for subsequent responses. Each setting stays in effect
+        #   until a later update replaces that setting.
         #
         #   @param id [String]
         #     The unique ID of the configuration update item.
@@ -41,6 +47,9 @@ module OpenAI
         #   @param reasoning [OpenAI::Models::Beta::BetaResponseConfigurationUpdateItem::Reasoning]
         #     The reasoning configuration applied by this update.
         #
+        #   @param text [OpenAI::Models::Beta::BetaResponseConfigurationUpdateItem::Text]
+        #     The text output configuration for subsequent responses.
+        #
         #   @param type [Symbol, :configuration_update]
         #     The item type. Always `configuration_update`.
 
@@ -98,6 +107,58 @@ module OpenAI
             #   @return [Array<Symbol>]
           end
         end
+
+        # @see OpenAI::Models::Beta::BetaResponseConfigurationUpdateItem#text
+        class Text < OpenAI::Internal::Type::BaseModel
+          # @!attribute format_
+          #   Use a JSON schema for structured output or text to return to plain text.
+          #
+          #   @return [OpenAI::Models::Beta::BetaResponseConfigurationUpdateItem::Text::Format::Text, OpenAI::Models::Beta::BetaResponseFormatTextJSONSchemaConfig]
+          required(
+            :format_,
+            union: -> { OpenAI::Beta::BetaResponseConfigurationUpdateItem::Text::Format },
+            api_name: :format
+          )
+
+          # @!method initialize(format_:)
+          #   The text output configuration for subsequent responses.
+          #
+          #   @param format_ [OpenAI::Models::Beta::BetaResponseConfigurationUpdateItem::Text::Format::Text, OpenAI::Models::Beta::BetaResponseFormatTextJSONSchemaConfig]
+          #     Use a JSON schema for structured output or text to return to plain text.
+
+          # Use a JSON schema for structured output or text to return to plain text.
+          #
+          # @see OpenAI::Models::Beta::BetaResponseConfigurationUpdateItem::Text#format_
+          module Format
+            extend OpenAI::Internal::Type::Union
+
+            discriminator :type
+
+            # Default response format. Used to generate text responses.
+            variant :text, -> { OpenAI::Beta::BetaResponseConfigurationUpdateItem::Text::Format::Text }
+
+            # JSON Schema response format. Used to generate structured JSON responses.
+            # Learn more about [Structured Outputs](https://developers.openai.com/api/docs/guides/structured-outputs).
+            variant :json_schema, -> { OpenAI::Beta::BetaResponseFormatTextJSONSchemaConfig }
+
+            class Text < OpenAI::Internal::Type::BaseModel
+              # @!attribute type
+              #   The type of response format being defined. Always `text`.
+              #
+              #   @return [Symbol, :text]
+              required :type, const: :text
+
+              # @!method initialize(type: :text)
+              #   Default response format. Used to generate text responses.
+              #
+              #   @param type [Symbol, :text]
+              #     The type of response format being defined. Always `text`.
+            end
+
+            # @!method self.variants
+            #   @return [Array(OpenAI::Models::Beta::BetaResponseConfigurationUpdateItem::Text::Format::Text, OpenAI::Models::Beta::BetaResponseFormatTextJSONSchemaConfig)]
+          end
+        end
       end
     end