openai 0.110.0 → 0.112.0

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

@@ -654,11 +654,14 @@ module OpenAI
           optional :input_image_mask, -> { OpenAI::Beta::BetaTool::ImageGeneration::InputImageMask }
 
           # @!attribute model
-          #   The image generation model to use. One of `gpt-image-1`, `gpt-image-1-mini`,
-          #   `gpt-image-1.5`, `gpt-image-2`, `gpt-image-2-2026-04-21`,
-          #   `gpt-image-2.5-sunburst`, `gpt-image-2.5-sunburst-2026-09-08`,
-          #   `gpt-image-2.5-flare`, `gpt-image-2.5-flare-2026-09-08`, or
-          #   `chatgpt-image-latest`. Default: `gpt-image-1`.
+          #   The image generation model to use. One of `gpt-image-1-mini`, `gpt-image-1.5`,
+          #   `gpt-image-2`, `gpt-image-2-2026-04-21`, `gpt-image-2.5-sunburst`,
+          #   `gpt-image-2.5-sunburst-2026-09-08`, `gpt-image-2.5-flare`,
+          #   `gpt-image-2.5-flare-2026-09-08`, or `chatgpt-image-latest`. Default:
+          #   `gpt-image-2`.
+          #
+          #   `gpt-image-1` was shut down on October 23, 2026. Use `gpt-image-2.5-sunburst` or
+          #   `gpt-image-2.5-flare` instead.
           #
           #   @return [String, Symbol, OpenAI::Models::Beta::BetaTool::ImageGeneration::Model, nil]
           optional :model, union: -> { OpenAI::Beta::BetaTool::ImageGeneration::Model }
@@ -741,11 +744,14 @@ module OpenAI
           #     `file_id` (string, optional).
           #
           #   @param model [String, Symbol, OpenAI::Models::Beta::BetaTool::ImageGeneration::Model]
-          #     The image generation model to use. One of `gpt-image-1`, `gpt-image-1-mini`,
-          #     `gpt-image-1.5`, `gpt-image-2`, `gpt-image-2-2026-04-21`,
-          #     `gpt-image-2.5-sunburst`, `gpt-image-2.5-sunburst-2026-09-08`,
-          #     `gpt-image-2.5-flare`, `gpt-image-2.5-flare-2026-09-08`, or
-          #     `chatgpt-image-latest`. Default: `gpt-image-1`.
+          #     The image generation model to use. One of `gpt-image-1-mini`, `gpt-image-1.5`,
+          #     `gpt-image-2`, `gpt-image-2-2026-04-21`, `gpt-image-2.5-sunburst`,
+          #     `gpt-image-2.5-sunburst-2026-09-08`, `gpt-image-2.5-flare`,
+          #     `gpt-image-2.5-flare-2026-09-08`, or `chatgpt-image-latest`. Default:
+          #     `gpt-image-2`.
+          #
+          #     `gpt-image-1` was shut down on October 23, 2026. Use `gpt-image-2.5-sunburst` or
+          #     `gpt-image-2.5-flare` instead.
           #
           #   @param moderation [Symbol, OpenAI::Models::Beta::BetaTool::ImageGeneration::Moderation]
           #     Moderation level for the generated image. Default: `auto`.
@@ -859,11 +865,14 @@ module OpenAI
             #     Base64-encoded mask image.
           end
 
-          # The image generation model to use. One of `gpt-image-1`, `gpt-image-1-mini`,
-          # `gpt-image-1.5`, `gpt-image-2`, `gpt-image-2-2026-04-21`,
-          # `gpt-image-2.5-sunburst`, `gpt-image-2.5-sunburst-2026-09-08`,
-          # `gpt-image-2.5-flare`, `gpt-image-2.5-flare-2026-09-08`, or
-          # `chatgpt-image-latest`. Default: `gpt-image-1`.
+          # The image generation model to use. One of `gpt-image-1-mini`, `gpt-image-1.5`,
+          # `gpt-image-2`, `gpt-image-2-2026-04-21`, `gpt-image-2.5-sunburst`,
+          # `gpt-image-2.5-sunburst-2026-09-08`, `gpt-image-2.5-flare`,
+          # `gpt-image-2.5-flare-2026-09-08`, or `chatgpt-image-latest`. Default:
+          # `gpt-image-2`.
+          #
+          # `gpt-image-1` was shut down on October 23, 2026. Use `gpt-image-2.5-sunburst` or
+          # `gpt-image-2.5-flare` instead.
           #
           # @see OpenAI::Models::Beta::BetaTool::ImageGeneration#model
           module Model
@@ -904,6 +913,8 @@ module OpenAI
 
             # @!group
 
+            # @deprecated GPT Image 1 was shut down on October 23, 2026. Use gpt-image-2.5-sunburst or
+            # gpt-image-2.5-flare instead.
             GPT_IMAGE_1 = :"gpt-image-1"
             GPT_IMAGE_1_MINI = :"gpt-image-1-mini"
             GPT_IMAGE_2 = :"gpt-image-2"

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

@@ -27,6 +27,9 @@ module OpenAI
         # Browser use in an OpenAI-hosted session.
         variant :computer_use, -> { OpenAI::Beta::PersistedAgentTool::ComputerUse }
 
+        # Lets the agent manage its own scheduled wakeups.
+        variant :automations, -> { OpenAI::Beta::PersistedAgentTool::Automations }
+
         class Function < OpenAI::Internal::Type::BaseModel
           # @!attribute defer_loading
           #   Whether the function is deferred and discovered through tool search.
@@ -347,8 +350,22 @@ module OpenAI
           #     The type of the object. Always `computer_use`.
         end
 
+        class Automations < OpenAI::Internal::Type::BaseModel
+          # @!attribute type
+          #   The type of the object. Always `automations`.
+          #
+          #   @return [Symbol, :automations]
+          required :type, const: :automations
+
+          # @!method initialize(type: :automations)
+          #   Lets the agent manage its own scheduled wakeups.
+          #
+          #   @param type [Symbol, :automations]
+          #     The type of the object. Always `automations`.
+        end
+
         # @!method self.variants
-        #   @return [Array(OpenAI::Models::Beta::PersistedAgentTool::Function, OpenAI::Models::Beta::PersistedAgentTool::ToolSearch, OpenAI::Models::Beta::PersistedAgentTool::ProgrammaticToolCalling, OpenAI::Models::Beta::PersistedAgentTool::Mcp, OpenAI::Models::Beta::PersistedAgentTool::WebSearch, OpenAI::Models::Beta::PersistedAgentTool::ComputerUse)]
+        #   @return [Array(OpenAI::Models::Beta::PersistedAgentTool::Function, OpenAI::Models::Beta::PersistedAgentTool::ToolSearch, OpenAI::Models::Beta::PersistedAgentTool::ProgrammaticToolCalling, OpenAI::Models::Beta::PersistedAgentTool::Mcp, OpenAI::Models::Beta::PersistedAgentTool::WebSearch, OpenAI::Models::Beta::PersistedAgentTool::ComputerUse, OpenAI::Models::Beta::PersistedAgentTool::Automations)]
       end
     end
   end

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

@@ -27,6 +27,9 @@ module OpenAI
         # Browser use in an OpenAI-hosted session.
         variant :computer_use, -> { OpenAI::Beta::PersistedAgentToolParam::ComputerUse }
 
+        # Lets the agent manage its own scheduled wakeups.
+        variant :automations, -> { OpenAI::Beta::PersistedAgentToolParam::Automations }
+
         class Function < OpenAI::Internal::Type::BaseModel
           # @!attribute description
           #   A description of what the function does.
@@ -373,8 +376,22 @@ module OpenAI
           #     The type of the object. Always `computer_use`.
         end
 
+        class Automations < OpenAI::Internal::Type::BaseModel
+          # @!attribute type
+          #   The type of the object. Always `automations`.
+          #
+          #   @return [Symbol, :automations]
+          required :type, const: :automations
+
+          # @!method initialize(type: :automations)
+          #   Lets the agent manage its own scheduled wakeups.
+          #
+          #   @param type [Symbol, :automations]
+          #     The type of the object. Always `automations`.
+        end
+
         # @!method self.variants
-        #   @return [Array(OpenAI::Models::Beta::PersistedAgentToolParam::Function, OpenAI::Models::Beta::PersistedAgentToolParam::ToolSearch, OpenAI::Models::Beta::PersistedAgentToolParam::ProgrammaticToolCalling, OpenAI::Models::Beta::PersistedAgentToolParam::Mcp, OpenAI::Models::Beta::PersistedAgentToolParam::WebSearch, OpenAI::Models::Beta::PersistedAgentToolParam::ComputerUse)]
+        #   @return [Array(OpenAI::Models::Beta::PersistedAgentToolParam::Function, OpenAI::Models::Beta::PersistedAgentToolParam::ToolSearch, OpenAI::Models::Beta::PersistedAgentToolParam::ProgrammaticToolCalling, OpenAI::Models::Beta::PersistedAgentToolParam::Mcp, OpenAI::Models::Beta::PersistedAgentToolParam::WebSearch, OpenAI::Models::Beta::PersistedAgentToolParam::ComputerUse, OpenAI::Models::Beta::PersistedAgentToolParam::Automations)]
       end
     end
   end

data/lib/openai/models/chat/chat_completion_content_part.rb

@@ -99,13 +99,35 @@ module OpenAI
             #   @return [Symbol, :explicit]
             required :mode, const: :explicit
 
-            # @!method initialize(mode: :explicit)
+            # @!attribute ttl
+            #   The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+            #
+            #   @return [Symbol, OpenAI::Models::Chat::ChatCompletionContentPart::File::PromptCacheBreakpoint::Ttl, nil]
+            optional :ttl, enum: -> { OpenAI::Chat::ChatCompletionContentPart::File::PromptCacheBreakpoint::Ttl }
+
+            # @!method initialize(ttl: nil, mode: :explicit)
             #   Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
             #   from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
             #   token block.
             #
+            #   @param ttl [Symbol, OpenAI::Models::Chat::ChatCompletionContentPart::File::PromptCacheBreakpoint::Ttl]
+            #     The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+            #
             #   @param mode [Symbol, :explicit]
             #     The breakpoint mode. Always `explicit`.
+
+            # The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+            #
+            # @see OpenAI::Models::Chat::ChatCompletionContentPart::File::PromptCacheBreakpoint#ttl
+            module Ttl
+              extend OpenAI::Internal::Type::Enum
+
+              TTL_30M = :"30m"
+              TTL_12H = :"12h"
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
           end
         end
 

data/lib/openai/models/chat/chat_completion_content_part_image.rb

@@ -88,13 +88,35 @@ module OpenAI
           #   @return [Symbol, :explicit]
           required :mode, const: :explicit
 
-          # @!method initialize(mode: :explicit)
+          # @!attribute ttl
+          #   The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          #
+          #   @return [Symbol, OpenAI::Models::Chat::ChatCompletionContentPartImage::PromptCacheBreakpoint::Ttl, nil]
+          optional :ttl, enum: -> { OpenAI::Chat::ChatCompletionContentPartImage::PromptCacheBreakpoint::Ttl }
+
+          # @!method initialize(ttl: nil, mode: :explicit)
           #   Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
           #   from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
           #   token block.
           #
+          #   @param ttl [Symbol, OpenAI::Models::Chat::ChatCompletionContentPartImage::PromptCacheBreakpoint::Ttl]
+          #     The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          #
           #   @param mode [Symbol, :explicit]
           #     The breakpoint mode. Always `explicit`.
+
+          # The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          #
+          # @see OpenAI::Models::Chat::ChatCompletionContentPartImage::PromptCacheBreakpoint#ttl
+          module Ttl
+            extend OpenAI::Internal::Type::Enum
+
+            TTL_30M = :"30m"
+            TTL_12H = :"12h"
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
         end
       end
     end

data/lib/openai/models/chat/chat_completion_content_part_input_audio.rb

@@ -86,13 +86,35 @@ module OpenAI
           #   @return [Symbol, :explicit]
           required :mode, const: :explicit
 
-          # @!method initialize(mode: :explicit)
+          # @!attribute ttl
+          #   The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          #
+          #   @return [Symbol, OpenAI::Models::Chat::ChatCompletionContentPartInputAudio::PromptCacheBreakpoint::Ttl, nil]
+          optional :ttl, enum: -> { OpenAI::Chat::ChatCompletionContentPartInputAudio::PromptCacheBreakpoint::Ttl }
+
+          # @!method initialize(ttl: nil, mode: :explicit)
           #   Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
           #   from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
           #   token block.
           #
+          #   @param ttl [Symbol, OpenAI::Models::Chat::ChatCompletionContentPartInputAudio::PromptCacheBreakpoint::Ttl]
+          #     The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          #
           #   @param mode [Symbol, :explicit]
           #     The breakpoint mode. Always `explicit`.
+
+          # The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          #
+          # @see OpenAI::Models::Chat::ChatCompletionContentPartInputAudio::PromptCacheBreakpoint#ttl
+          module Ttl
+            extend OpenAI::Internal::Type::Enum
+
+            TTL_30M = :"30m"
+            TTL_12H = :"12h"
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
         end
       end
     end

data/lib/openai/models/chat/chat_completion_content_part_text.rb

@@ -49,13 +49,35 @@ module OpenAI
           #   @return [Symbol, :explicit]
           required :mode, const: :explicit
 
-          # @!method initialize(mode: :explicit)
+          # @!attribute ttl
+          #   The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          #
+          #   @return [Symbol, OpenAI::Models::Chat::ChatCompletionContentPartText::PromptCacheBreakpoint::Ttl, nil]
+          optional :ttl, enum: -> { OpenAI::Chat::ChatCompletionContentPartText::PromptCacheBreakpoint::Ttl }
+
+          # @!method initialize(ttl: nil, mode: :explicit)
           #   Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
           #   from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
           #   token block.
           #
+          #   @param ttl [Symbol, OpenAI::Models::Chat::ChatCompletionContentPartText::PromptCacheBreakpoint::Ttl]
+          #     The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          #
           #   @param mode [Symbol, :explicit]
           #     The breakpoint mode. Always `explicit`.
+
+          # The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          #
+          # @see OpenAI::Models::Chat::ChatCompletionContentPartText::PromptCacheBreakpoint#ttl
+          module Ttl
+            extend OpenAI::Internal::Type::Enum
+
+            TTL_30M = :"30m"
+            TTL_12H = :"12h"
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
         end
       end
     end

data/lib/openai/models/conversations/computer_screenshot_content.rb

@@ -87,13 +87,35 @@ module OpenAI
           #   @return [Symbol, :explicit]
           required :mode, const: :explicit
 
-          # @!method initialize(mode: :explicit)
+          # @!attribute ttl
+          #   The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          #
+          #   @return [Symbol, OpenAI::Models::Conversations::ComputerScreenshotContent::PromptCacheBreakpoint::Ttl, nil]
+          optional :ttl, enum: -> { OpenAI::Conversations::ComputerScreenshotContent::PromptCacheBreakpoint::Ttl }
+
+          # @!method initialize(ttl: nil, mode: :explicit)
           #   Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
           #   from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
           #   token block.
           #
+          #   @param ttl [Symbol, OpenAI::Models::Conversations::ComputerScreenshotContent::PromptCacheBreakpoint::Ttl]
+          #     The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          #
           #   @param mode [Symbol, :explicit]
           #     The breakpoint mode. Always `explicit`.
+
+          # The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          #
+          # @see OpenAI::Models::Conversations::ComputerScreenshotContent::PromptCacheBreakpoint#ttl
+          module Ttl
+            extend OpenAI::Internal::Type::Enum
+
+            TTL_30M = :"30m"
+            TTL_12H = :"12h"
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
         end
       end
     end