openai 0.111.0 → 0.113.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5c3a397f39a65a401262afe470818b903373e6f5ce1d23cc525d594e60230c99
-  data.tar.gz: b1e4d78ffe270f88e1f4867df5560c4979e13a6a9f7a208fe26d46b5b6150ffa
+  metadata.gz: 0eae0c57cd325d109de04f4df3df293bde2f816e040ac3c0b1ec7bb608413d67
+  data.tar.gz: 14b51d57e7d641c062772563060130bd4a7f9a8ce00940125452e2f0e7a95e28
 SHA512:
-  metadata.gz: df7fcc802346afe0280fb0554e394ce27979725a8ed91dc8d49fa070c0fa4db0f5ff29e4d18ba8c880ce955b6bbd53c43232551dd3e3533724a4066d705e75a4
-  data.tar.gz: 0107cb35d2a615a182bea31a4f58fd191412966f92189521fbae596ff75bf485d998556ad2e6d801ba0456d9a01b74859ceffd2eee96ec8fbc1eb27c50d40a76
+  metadata.gz: 3f2a4f11fb6fba7da961eb45aee74bdb69fb755e9c3ca49d809ab7c123d2ad870d8da5ba7302883491f66547ef71918e36b9f96ea178681c9cdfa99b139b0439
+  data.tar.gz: aac404f91cfe8c4babce9f83c6c2dc4aa00e8442e7e4859b4a4706a64e88a92adceefcea34e1b89d6588ab23d84bbce74fb92475ee000a411d1a4050ed713364

data/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## [0.113.0](https://github.com/openai/openai-ruby/compare/v0.112.0...v0.113.0) (2026-10-26)
+
+
+### Features
+
+* **api:** add gpt-6.1-terra model identifier ([#972](https://github.com/openai/openai-ruby/issues/972)) ([6b91123](https://github.com/openai/openai-ruby/commit/6b911234dfacea4c9e4fcc183e8b8363d3060bd3))
+
+## [0.112.0](https://github.com/openai/openai-ruby/compare/v0.111.0...v0.112.0) (2026-10-25)
+
+
+### Features
+
+* **api:** add delegation controls and prompt cache lifetimes ([#963](https://github.com/openai/openai-ruby/issues/963)) ([09f5d62](https://github.com/openai/openai-ruby/commit/09f5d62b7b5ef9b8c07ccb9a8197c6611280bb87))
+* **api:** expand Live Decision item and question types. **Breaking change in a minor release.** Live Decision item events now include messages and function/custom-tool calls and outputs. The public `OpenAI::Models::Live::DecisionItemCreateEvent::Item` and `OpenAI::Models::Live::DecisionItemCreatedEvent::Item` constants have been removed; constructing them now raises `NameError`. For user messages, replace them with `OpenAI::Models::Live::DecisionUserMessage` and `OpenAI::Models::Live::DecisionStoredUserMessage`, respectively. For example, use `OpenAI::Models::Live::DecisionUserMessage.new(content: "Hello")` for a create-event user message. Handle tool-item variants separately instead of assuming every event item has message fields. ([#967](https://github.com/openai/openai-ruby/issues/967)) ([58986a7](https://github.com/openai/openai-ruby/commit/58986a75919752ceaafc0fe2bc145f66e236f39e))
+
 ## [0.111.0](https://github.com/openai/openai-ruby/compare/v0.110.0...v0.111.0) (2026-10-22)
 
 

data/README.md

@@ -15,7 +15,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "openai", "~> 0.111.0"
+gem "openai", "~> 0.113.0"
 ```
 
 <!-- x-release-please-end -->

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

@@ -75,7 +75,7 @@ module OpenAI
         # @!attribute tools
         #   Tools available to the agent.
         #
-        #   @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>]
         required :tools, -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Beta::PersistedAgentTool] }
 
         # @!attribute updated_at
@@ -118,7 +118,7 @@ module OpenAI
         #   @param text [OpenAI::Models::Beta::AgentText]
         #     The resolved configuration for text generated by the agent.
         #
-        #   @param tools [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>]
+        #   @param tools [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>]
         #     Tools available to the agent.
         #
         #   @param updated_at [Integer]

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

@@ -64,7 +64,7 @@ module OpenAI
         #   Tools available to the agent. Defaults to an empty list. The tool list must fit
         #   within 3 MiB (3,145,728 bytes) of compact UTF-8 JSON.
         #
-        #   @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>, nil]
+        #   @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>, nil]
         optional(
           :tools,
           -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Beta::PersistedAgentToolParam] },
@@ -100,7 +100,7 @@ module OpenAI
         #     Configuration for generated text. Defaults to the `text` format and medium
         #     verbosity.
         #
-        #   @param tools [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>, nil]
+        #   @param tools [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>, nil]
         #     Tools available to the agent. Defaults to an empty list. The tool list must fit
         #     within 3 MiB (3,145,728 bytes) of compact UTF-8 JSON.
         #

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

@@ -185,7 +185,7 @@ module OpenAI
           # @!attribute tools
           #   Tools available to the agent.
           #
-          #   @return [Array<OpenAI::Models::Beta::AgentTool::Function, OpenAI::Models::Beta::AgentTool::ProgrammaticToolCalling, OpenAI::Models::Beta::AgentTool::Mcp, OpenAI::Models::Beta::AgentTool::WebSearch, OpenAI::Models::Beta::AgentTool::ComputerUse>]
+          #   @return [Array<OpenAI::Models::Beta::AgentTool::Function, OpenAI::Models::Beta::AgentTool::ProgrammaticToolCalling, OpenAI::Models::Beta::AgentTool::Mcp, OpenAI::Models::Beta::AgentTool::WebSearch, OpenAI::Models::Beta::AgentTool::ComputerUse, OpenAI::Models::Beta::AgentTool::Automations>]
           required :tools, -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Beta::AgentTool] }
 
           # @!method initialize(id:, instructions:, model:, multi_agent:, name:, reasoning:, service_tier:, text:, tools:)
@@ -216,7 +216,7 @@ module OpenAI
           #   @param text [OpenAI::Models::Beta::AgentText]
           #     Configuration for text generated by the agent.
           #
-          #   @param tools [Array<OpenAI::Models::Beta::AgentTool::Function, OpenAI::Models::Beta::AgentTool::ProgrammaticToolCalling, OpenAI::Models::Beta::AgentTool::Mcp, OpenAI::Models::Beta::AgentTool::WebSearch, OpenAI::Models::Beta::AgentTool::ComputerUse>]
+          #   @param tools [Array<OpenAI::Models::Beta::AgentTool::Function, OpenAI::Models::Beta::AgentTool::ProgrammaticToolCalling, OpenAI::Models::Beta::AgentTool::Mcp, OpenAI::Models::Beta::AgentTool::WebSearch, OpenAI::Models::Beta::AgentTool::ComputerUse, OpenAI::Models::Beta::AgentTool::Automations>]
           #     Tools available to the agent.
 
           # The effective service-tier policy for model requests. Defaults to `auto`.

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

@@ -24,6 +24,9 @@ module OpenAI
         # Browser use in an OpenAI-hosted session.
         variant :computer_use, -> { OpenAI::Beta::AgentTool::ComputerUse }
 
+        # Lets the agent manage its own scheduled wakeups.
+        variant :automations, -> { OpenAI::Beta::AgentTool::Automations }
+
         class Function < OpenAI::Internal::Type::BaseModel
           # @!attribute defer_loading
           #   Whether the function is deferred and discovered through tool search.
@@ -332,8 +335,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::AgentTool::Function, OpenAI::Models::Beta::AgentTool::ProgrammaticToolCalling, OpenAI::Models::Beta::AgentTool::Mcp, OpenAI::Models::Beta::AgentTool::WebSearch, OpenAI::Models::Beta::AgentTool::ComputerUse)]
+        #   @return [Array(OpenAI::Models::Beta::AgentTool::Function, OpenAI::Models::Beta::AgentTool::ProgrammaticToolCalling, OpenAI::Models::Beta::AgentTool::Mcp, OpenAI::Models::Beta::AgentTool::WebSearch, OpenAI::Models::Beta::AgentTool::ComputerUse, OpenAI::Models::Beta::AgentTool::Automations)]
       end
     end
   end

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

@@ -27,6 +27,9 @@ module OpenAI
         # Browser use in an OpenAI-hosted session.
         variant :computer_use, -> { OpenAI::Beta::AgentToolParam::ComputerUse }
 
+        # Lets the agent manage its own scheduled wakeups.
+        variant :automations, -> { OpenAI::Beta::AgentToolParam::Automations }
+
         class Function < OpenAI::Internal::Type::BaseModel
           # @!attribute description
           #   A description of what the function does.
@@ -383,8 +386,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::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)]
+        #   @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)]
       end
     end
   end

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

@@ -69,7 +69,7 @@ module OpenAI
         #   Replaces the tool list. Omit to leave it unchanged, or pass null to clear it.
         #   The replacement must fit within 3 MiB (3,145,728 bytes) of compact UTF-8 JSON.
         #
-        #   @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>, nil]
+        #   @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>, nil]
         optional(
           :tools,
           -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Beta::PersistedAgentToolParam] },
@@ -107,7 +107,7 @@ module OpenAI
         #   @param text [OpenAI::Models::Beta::AgentTextParam, nil]
         #     Configuration for text generated by the agent.
         #
-        #   @param tools [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>, nil]
+        #   @param tools [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>, nil]
         #     Replaces the tool list. Omit to leave it unchanged, or pass null to clear it.
         #     The replacement must fit within 3 MiB (3,145,728 bytes) of compact UTF-8 JSON.
         #

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

@@ -145,7 +145,7 @@ module OpenAI
             #   resolved tool list must fit within 3 MiB (3,145,728 bytes) of compact UTF-8
             #   JSON.
             #
-            #   @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>, nil]
+            #   @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,
               -> {
@@ -178,7 +178,7 @@ module OpenAI
             #   @param text [OpenAI::Models::Beta::AgentTextParam, nil]
             #     Configuration for text generated by the agent.
             #
-            #   @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>, nil]
+            #   @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]
             #     Tools available to the agent. Omit to inherit, or pass null to clear them. The
             #     resolved tool list must fit within 3 MiB (3,145,728 bytes) of compact UTF-8
             #     JSON.

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

@@ -698,6 +698,8 @@ module OpenAI
 
           variant const: -> { OpenAI::Models::Beta::BetaResponse::Model::GPT_6_1_SOL }
 
+          variant const: -> { OpenAI::Models::Beta::BetaResponse::Model::GPT_6_1_TERRA }
+
           variant const: -> { OpenAI::Models::Beta::BetaResponse::Model::GPT_6_SOL }
 
           variant const: -> { OpenAI::Models::Beta::BetaResponse::Model::GPT_6_LUNA }
@@ -925,6 +927,7 @@ module OpenAI
 
           GPT_6_ASTRA = :"gpt-6-astra"
           GPT_6_1_SOL = :"gpt-6.1-sol"
+          GPT_6_1_TERRA = :"gpt-6.1-terra"
           GPT_6_SOL = :"gpt-6-sol"
           GPT_6_LUNA = :"gpt-6-luna"
           GPT_5_6_SOL = :"gpt-5.6-sol"

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

@@ -108,13 +108,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::Beta::BetaResponseInputFile::PromptCacheBreakpoint::Ttl, nil]
+          optional :ttl, enum: -> { OpenAI::Beta::BetaResponseInputFile::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::Beta::BetaResponseInputFile::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::Beta::BetaResponseInputFile::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/beta/beta_response_input_file_content.rb

@@ -112,13 +112,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::Beta::BetaResponseInputFileContent::PromptCacheBreakpoint::Ttl, nil]
+          optional :ttl, enum: -> { OpenAI::Beta::BetaResponseInputFileContent::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::Beta::BetaResponseInputFileContent::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::Beta::BetaResponseInputFileContent::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/beta/beta_response_input_image.rb

@@ -85,13 +85,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::Beta::BetaResponseInputImage::PromptCacheBreakpoint::Ttl, nil]
+          optional :ttl, enum: -> { OpenAI::Beta::BetaResponseInputImage::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::Beta::BetaResponseInputImage::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::Beta::BetaResponseInputImage::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/beta/beta_response_input_image_content.rb

@@ -89,13 +89,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::Beta::BetaResponseInputImageContent::PromptCacheBreakpoint::Ttl, nil]
+          optional :ttl, enum: -> { OpenAI::Beta::BetaResponseInputImageContent::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::Beta::BetaResponseInputImageContent::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::Beta::BetaResponseInputImageContent::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/beta/beta_response_input_text.rb

@@ -46,13 +46,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::Beta::BetaResponseInputText::PromptCacheBreakpoint::Ttl, nil]
+          optional :ttl, enum: -> { OpenAI::Beta::BetaResponseInputText::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::Beta::BetaResponseInputText::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::Beta::BetaResponseInputText::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/beta/beta_response_input_text_content.rb

@@ -50,13 +50,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::Beta::BetaResponseInputTextContent::PromptCacheBreakpoint::Ttl, nil]
+          optional :ttl, enum: -> { OpenAI::Beta::BetaResponseInputTextContent::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::Beta::BetaResponseInputTextContent::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::Beta::BetaResponseInputTextContent::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/beta/beta_response_item.rb

@@ -354,13 +354,40 @@ 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::Beta::BetaResponseItem::AgentMessage::Content::ComputerScreenshot::PromptCacheBreakpoint::Ttl, nil]
+                optional(
+                  :ttl,
+                  enum: -> {
+                    OpenAI::Beta::BetaResponseItem::AgentMessage::Content::ComputerScreenshot::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::Beta::BetaResponseItem::AgentMessage::Content::ComputerScreenshot::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::Beta::BetaResponseItem::AgentMessage::Content::ComputerScreenshot::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/beta/beta_response_output_item.rb

@@ -353,13 +353,40 @@ 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::Beta::BetaResponseOutputItem::AgentMessage::Content::ComputerScreenshot::PromptCacheBreakpoint::Ttl, nil]
+                optional(
+                  :ttl,
+                  enum: -> {
+                    OpenAI::Beta::BetaResponseOutputItem::AgentMessage::Content::ComputerScreenshot::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::Beta::BetaResponseOutputItem::AgentMessage::Content::ComputerScreenshot::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::Beta::BetaResponseOutputItem::AgentMessage::Content::ComputerScreenshot::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/beta/beta_response_tool_search_output_item_param.rb

@@ -781,11 +781,14 @@ module OpenAI
             )
 
             # @!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::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::Model, nil]
             optional(
@@ -883,11 +886,14 @@ module OpenAI
             #     `file_id` (string, optional).
             #
             #   @param model [String, Symbol, OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::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::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::Moderation]
             #     Moderation level for the generated image. Default: `auto`.
@@ -1001,11 +1007,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::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration#model
             module Model
@@ -1087,6 +1096,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/beta_responses_client_event.rb

@@ -901,6 +901,8 @@ module OpenAI
 
             variant const: -> { OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Model::GPT_6_1_SOL }
 
+            variant const: -> { OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Model::GPT_6_1_TERRA }
+
             variant const: -> { OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Model::GPT_6_SOL }
 
             variant const: -> { OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Model::GPT_6_LUNA }
@@ -1312,6 +1314,7 @@ module OpenAI
 
             GPT_6_ASTRA = :"gpt-6-astra"
             GPT_6_1_SOL = :"gpt-6.1-sol"
+            GPT_6_1_TERRA = :"gpt-6.1-terra"
             GPT_6_SOL = :"gpt-6-sol"
             GPT_6_LUNA = :"gpt-6-luna"
             GPT_5_6_SOL = :"gpt-5.6-sol"