openai 0.111.0 → 0.112.0

data/sig/openai/models/chat/chat_completion_content_part_input_audio.rbs

@@ -85,17 +85,48 @@ module OpenAI
           end
         end
 
-        type prompt_cache_breakpoint = { ?mode: :explicit }
+        type prompt_cache_breakpoint =
+          {
+            ?mode: :explicit,
+            ?ttl: OpenAI::Models::Chat::ChatCompletionContentPartInputAudio::PromptCacheBreakpoint::ttl
+          }
 
         class PromptCacheBreakpoint < OpenAI::Internal::Type::BaseModel
           # The breakpoint mode. Always `explicit`.
           attr_accessor mode: :explicit
 
+          # The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          attr_reader ttl: OpenAI::Models::Chat::ChatCompletionContentPartInputAudio::PromptCacheBreakpoint::ttl?
+
+          # The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          def ttl=: (
+            OpenAI::Models::Chat::ChatCompletionContentPartInputAudio::PromptCacheBreakpoint::ttl
+          ) -> OpenAI::Models::Chat::ChatCompletionContentPartInputAudio::PromptCacheBreakpoint::ttl
+
+          # @param ttl
+          #   The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
           # @param mode
           #   The breakpoint mode. Always `explicit`.
-          def initialize: (?mode: :explicit) -> void
+          def initialize: (
+            ?ttl: OpenAI::Models::Chat::ChatCompletionContentPartInputAudio::PromptCacheBreakpoint::ttl,
+            ?mode: :explicit
+          ) -> void
+
+          def to_hash: -> {
+            ?mode: :explicit,
+            ?ttl: OpenAI::Models::Chat::ChatCompletionContentPartInputAudio::PromptCacheBreakpoint::ttl
+          }
 
-          def to_hash: -> { ?mode: :explicit }
+          type ttl = :"30m" | :"12h"
+
+          module Ttl
+            extend OpenAI::Internal::Type::Enum
+
+            TTL_30M: :"30m"
+            TTL_12H: :"12h"
+
+            def self?.values: -> ::Array[OpenAI::Models::Chat::ChatCompletionContentPartInputAudio::PromptCacheBreakpoint::ttl]
+          end
         end
       end
     end

data/sig/openai/models/chat/chat_completion_content_part_text.rbs

@@ -49,17 +49,48 @@ module OpenAI
           ?prompt_cache_breakpoint: OpenAI::Chat::ChatCompletionContentPartText::PromptCacheBreakpoint
         }
 
-        type prompt_cache_breakpoint = { ?mode: :explicit }
+        type prompt_cache_breakpoint =
+          {
+            ?mode: :explicit,
+            ?ttl: OpenAI::Models::Chat::ChatCompletionContentPartText::PromptCacheBreakpoint::ttl
+          }
 
         class PromptCacheBreakpoint < OpenAI::Internal::Type::BaseModel
           # The breakpoint mode. Always `explicit`.
           attr_accessor mode: :explicit
 
+          # The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          attr_reader ttl: OpenAI::Models::Chat::ChatCompletionContentPartText::PromptCacheBreakpoint::ttl?
+
+          # The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          def ttl=: (
+            OpenAI::Models::Chat::ChatCompletionContentPartText::PromptCacheBreakpoint::ttl
+          ) -> OpenAI::Models::Chat::ChatCompletionContentPartText::PromptCacheBreakpoint::ttl
+
+          # @param ttl
+          #   The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
           # @param mode
           #   The breakpoint mode. Always `explicit`.
-          def initialize: (?mode: :explicit) -> void
+          def initialize: (
+            ?ttl: OpenAI::Models::Chat::ChatCompletionContentPartText::PromptCacheBreakpoint::ttl,
+            ?mode: :explicit
+          ) -> void
+
+          def to_hash: -> {
+            ?mode: :explicit,
+            ?ttl: OpenAI::Models::Chat::ChatCompletionContentPartText::PromptCacheBreakpoint::ttl
+          }
+
+          type ttl = :"30m" | :"12h"
+
+          module Ttl
+            extend OpenAI::Internal::Type::Enum
+
+            TTL_30M: :"30m"
+            TTL_12H: :"12h"
 
-          def to_hash: -> { ?mode: :explicit }
+            def self?.values: -> ::Array[OpenAI::Models::Chat::ChatCompletionContentPartText::PromptCacheBreakpoint::ttl]
+          end
         end
       end
     end

data/sig/openai/models/conversations/computer_screenshot_content.rbs

@@ -80,17 +80,48 @@ module OpenAI
           def self?.values: -> ::Array[OpenAI::Models::Conversations::ComputerScreenshotContent::detail]
         end
 
-        type prompt_cache_breakpoint = { ?mode: :explicit }
+        type prompt_cache_breakpoint =
+          {
+            ?mode: :explicit,
+            ?ttl: OpenAI::Models::Conversations::ComputerScreenshotContent::PromptCacheBreakpoint::ttl
+          }
 
         class PromptCacheBreakpoint < OpenAI::Internal::Type::BaseModel
           # The breakpoint mode. Always `explicit`.
           attr_accessor mode: :explicit
 
+          # The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          attr_reader ttl: OpenAI::Models::Conversations::ComputerScreenshotContent::PromptCacheBreakpoint::ttl?
+
+          # The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          def ttl=: (
+            OpenAI::Models::Conversations::ComputerScreenshotContent::PromptCacheBreakpoint::ttl
+          ) -> OpenAI::Models::Conversations::ComputerScreenshotContent::PromptCacheBreakpoint::ttl
+
+          # @param ttl
+          #   The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
           # @param mode
           #   The breakpoint mode. Always `explicit`.
-          def initialize: (?mode: :explicit) -> void
+          def initialize: (
+            ?ttl: OpenAI::Models::Conversations::ComputerScreenshotContent::PromptCacheBreakpoint::ttl,
+            ?mode: :explicit
+          ) -> void
+
+          def to_hash: -> {
+            ?mode: :explicit,
+            ?ttl: OpenAI::Models::Conversations::ComputerScreenshotContent::PromptCacheBreakpoint::ttl
+          }
+
+          type ttl = :"30m" | :"12h"
+
+          module Ttl
+            extend OpenAI::Internal::Type::Enum
+
+            TTL_30M: :"30m"
+            TTL_12H: :"12h"
 
-          def to_hash: -> { ?mode: :explicit }
+            def self?.values: -> ::Array[OpenAI::Models::Conversations::ComputerScreenshotContent::PromptCacheBreakpoint::ttl]
+          end
         end
       end
     end

data/sig/openai/models/image_edit_params.rbs

@@ -79,11 +79,14 @@ module OpenAI
       # content type.
       def mask=: (OpenAI::Internal::file_input) -> OpenAI::Internal::file_input
 
-      # The GPT image model to use for image editing (`gpt-image-1`, `gpt-image-1-mini`,
+      # The GPT image model to use for image editing (`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`).
+      #
+      # `gpt-image-1` was shut down on October 23, 2026. Use `gpt-image-2.5-sunburst` or
+      # `gpt-image-2.5-flare` instead.
       attr_accessor model: OpenAI::Models::ImageEditParams::model?
 
       # The number of images to generate. Must be between 1 and 10.
@@ -191,11 +194,14 @@ module OpenAI
       #   metadata. Use `OpenAI::FilePart` when you need to override the filename or
       #   content type.
       # @param model
-      #   The GPT image model to use for image editing (`gpt-image-1`, `gpt-image-1-mini`,
+      #   The GPT image model to use for image editing (`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`).
+      #
+      #   `gpt-image-1` was shut down on October 23, 2026. Use `gpt-image-2.5-sunburst` or
+      #   `gpt-image-2.5-flare` instead.
       # @param n
       #   The number of images to generate. Must be between 1 and 10.
       # @param output_compression

data/sig/openai/models/image_generate_params.rbs

@@ -39,10 +39,13 @@ module OpenAI
       attr_accessor background: OpenAI::Models::ImageGenerateParams::background?
 
       # The GPT image model to use for image generation. Specify a model explicitly.
-      # Supported models include `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`,
+      # Supported models include `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`, and `chatgpt-image-latest`.
+      #
+      # `gpt-image-1` was shut down on October 23, 2026. Use `gpt-image-2.5-sunburst` or
+      # `gpt-image-2.5-flare` instead.
       attr_accessor model: OpenAI::Models::ImageGenerateParams::model?
 
       # Control the content-moderation level for images generated by the GPT image
@@ -134,10 +137,13 @@ module OpenAI
       #   set the output format to `png` or `webp`.
       # @param model
       #   The GPT image model to use for image generation. Specify a model explicitly.
-      #   Supported models include `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`,
+      #   Supported models include `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`, and `chatgpt-image-latest`.
+      #
+      #   `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
       #   Control the content-moderation level for images generated by the GPT image
       #   models. Must be either `low` for less restrictive filtering or `auto` (default

data/sig/openai/models/live/client_delegation.rbs

@@ -1,17 +1,44 @@
 module OpenAI
   module Models
     module Live
-      type client_delegation = { ?type: :client }
+      type client_delegation =
+        { ?type: :client, ?acknowledgement_delay_ms: Integer }
 
       class ClientDelegation < OpenAI::Internal::Type::BaseModel
         # The delegation owner. Always `client` for tasks handled by your application.
         attr_accessor type: :client
 
+        # Milliseconds to wait before requesting an automatic spoken acknowledgement for a
+        # delegation. The model may still speak before this delay. Any commentary or
+        # thinking appended to the session cancels all pending acknowledgements, including
+        # those for other delegations. Defaults to 400 for Decisions sessions and 0
+        # (request immediately) for other sessions. Omission in a session update preserves
+        # the current value. Updates apply to subsequent delegations.
+        attr_reader acknowledgement_delay_ms: Integer?
+
+        # Milliseconds to wait before requesting an automatic spoken acknowledgement for a
+        # delegation. The model may still speak before this delay. Any commentary or
+        # thinking appended to the session cancels all pending acknowledgements, including
+        # those for other delegations. Defaults to 400 for Decisions sessions and 0
+        # (request immediately) for other sessions. Omission in a session update preserves
+        # the current value. Updates apply to subsequent delegations.
+        def acknowledgement_delay_ms=: (Integer) -> Integer
+
+        # @param acknowledgement_delay_ms
+        #   Milliseconds to wait before requesting an automatic spoken acknowledgement for a
+        #   delegation. The model may still speak before this delay. Any commentary or
+        #   thinking appended to the session cancels all pending acknowledgements, including
+        #   those for other delegations. Defaults to 400 for Decisions sessions and 0
+        #   (request immediately) for other sessions. Omission in a session update preserves
+        #   the current value. Updates apply to subsequent delegations.
         # @param type
         #   The delegation owner. Always `client` for tasks handled by your application.
-        def initialize: (?type: :client) -> void
+        def initialize: (
+          ?acknowledgement_delay_ms: Integer,
+          ?type: :client
+        ) -> void
 
-        def to_hash: -> { ?type: :client }
+        def to_hash: -> { ?type: :client, ?acknowledgement_delay_ms: Integer }
       end
     end
   end

data/sig/openai/models/live/decision_assistant_message.rbs

@@ -0,0 +1,134 @@
+module OpenAI
+  module Models
+    module Live
+      type decision_assistant_message =
+        {
+          content: OpenAI::Models::Live::DecisionAssistantMessage::content,
+          ?role: :assistant,
+          ?id: String?,
+          ?phase: OpenAI::Models::Live::DecisionAssistantMessage::phase?,
+          ?type: OpenAI::Models::Live::DecisionAssistantMessage::type_
+        }
+
+      class DecisionAssistantMessage < OpenAI::Internal::Type::BaseModel
+        # The text input to the model.
+        attr_accessor content: OpenAI::Models::Live::DecisionAssistantMessage::content
+
+        attr_accessor role: :assistant
+
+        # The unique ID of this message item.
+        attr_accessor id: String?
+
+        # Labels an `assistant` message as intermediate commentary (`commentary`) or the
+        # final answer (`final_answer`). For models like `gpt-5.3-codex` and beyond, when
+        # sending follow-up requests, preserve and resend phase on all assistant messages
+        # — dropping it can degrade performance. Not used for user messages.
+        attr_accessor phase: OpenAI::Models::Live::DecisionAssistantMessage::phase?
+
+        attr_reader type: OpenAI::Models::Live::DecisionAssistantMessage::type_?
+
+        def type=: (
+          OpenAI::Models::Live::DecisionAssistantMessage::type_
+        ) -> OpenAI::Models::Live::DecisionAssistantMessage::type_
+
+        # @param content
+        #   The text input to the model.
+        # @param id
+        #   The unique ID of this message item.
+        # @param phase
+        #   Labels an `assistant` message as intermediate commentary (`commentary`) or the
+        #   final answer (`final_answer`). For models like `gpt-5.3-codex` and beyond, when
+        #   sending follow-up requests, preserve and resend phase on all assistant messages
+        #   — dropping it can degrade performance. Not used for user messages.
+        def initialize: (
+          content: OpenAI::Models::Live::DecisionAssistantMessage::content,
+          ?id: String?,
+          ?phase: OpenAI::Models::Live::DecisionAssistantMessage::phase?,
+          ?type: OpenAI::Models::Live::DecisionAssistantMessage::type_,
+          ?role: :assistant
+        ) -> void
+
+        def to_hash: -> {
+          content: OpenAI::Models::Live::DecisionAssistantMessage::content,
+          ?role: :assistant,
+          ?id: String?,
+          ?phase: OpenAI::Models::Live::DecisionAssistantMessage::phase?,
+          ?type: OpenAI::Models::Live::DecisionAssistantMessage::type_
+        }
+
+        type content =
+          String
+          | ::Array[OpenAI::Models::Live::DecisionAssistantMessage::Content::part]
+
+        module Content
+          extend OpenAI::Internal::Type::Union
+
+          type part =
+            OpenAI::Live::DecisionAssistantMessage::Content::Part::OutputText
+            | OpenAI::Live::DecisionAssistantMessage::Content::Part::Refusal
+
+          module Part
+            extend OpenAI::Internal::Type::Union
+
+            type output_text = { text: String, ?type: :output_text }
+
+            class OutputText < OpenAI::Internal::Type::BaseModel
+              # The text content.
+              attr_accessor text: String
+
+              attr_accessor type: :output_text
+
+              # @param text
+              #   The text content.
+              def initialize: (text: String, ?type: :output_text) -> void
+
+              def to_hash: -> { text: String, ?type: :output_text }
+            end
+
+            type refusal = { refusal: String, ?type: :refusal }
+
+            class Refusal < OpenAI::Internal::Type::BaseModel
+              # The refusal text.
+              attr_accessor refusal: String
+
+              attr_accessor type: :refusal
+
+              # @param refusal
+              #   The refusal text.
+              def initialize: (refusal: String, ?type: :refusal) -> void
+
+              def to_hash: -> { refusal: String, ?type: :refusal }
+            end
+
+            def self?.variants: -> ::Array[OpenAI::Models::Live::DecisionAssistantMessage::Content::part]
+          end
+
+          def self?.variants: -> ::Array[OpenAI::Models::Live::DecisionAssistantMessage::content]
+
+          PartsArray: OpenAI::Internal::Type::Converter
+        end
+
+        type phase = :commentary | :final_answer
+
+        module Phase
+          extend OpenAI::Internal::Type::Enum
+
+          COMMENTARY: :commentary
+          FINAL_ANSWER: :final_answer
+
+          def self?.values: -> ::Array[OpenAI::Models::Live::DecisionAssistantMessage::phase]
+        end
+
+        type type_ = :message
+
+        module Type
+          extend OpenAI::Internal::Type::Enum
+
+          MESSAGE: :message
+
+          def self?.values: -> ::Array[OpenAI::Models::Live::DecisionAssistantMessage::type_]
+        end
+      end
+    end
+  end
+end

data/sig/openai/models/live/decision_choice_option.rbs

@@ -0,0 +1,37 @@
+module OpenAI
+  module Models
+    module Live
+      type decision_choice_option =
+        {
+          value: OpenAI::Models::Live::DecisionChoiceOption::value,
+          ?description: String
+        }
+
+      class DecisionChoiceOption < OpenAI::Internal::Type::BaseModel
+        attr_accessor value: OpenAI::Models::Live::DecisionChoiceOption::value
+
+        attr_reader description: String?
+
+        def description=: (String) -> String
+
+        def initialize: (
+          value: OpenAI::Models::Live::DecisionChoiceOption::value,
+          ?description: String
+        ) -> void
+
+        def to_hash: -> {
+          value: OpenAI::Models::Live::DecisionChoiceOption::value,
+          ?description: String
+        }
+
+        type value = String | bool
+
+        module Value
+          extend OpenAI::Internal::Type::Union
+
+          def self?.variants: -> ::Array[OpenAI::Models::Live::DecisionChoiceOption::value]
+        end
+      end
+    end
+  end
+end

data/sig/openai/models/live/decision_developer_message.rbs

@@ -0,0 +1,67 @@
+module OpenAI
+  module Models
+    module Live
+      type decision_developer_message =
+        {
+          content: OpenAI::Models::Live::DecisionDeveloperMessage::content,
+          ?role: :developer,
+          ?id: String?,
+          ?type: OpenAI::Models::Live::DecisionDeveloperMessage::type_
+        }
+
+      class DecisionDeveloperMessage < OpenAI::Internal::Type::BaseModel
+        # The text input to the model.
+        attr_accessor content: OpenAI::Models::Live::DecisionDeveloperMessage::content
+
+        attr_accessor role: :developer
+
+        # The unique ID of this message item.
+        attr_accessor id: String?
+
+        attr_reader type: OpenAI::Models::Live::DecisionDeveloperMessage::type_?
+
+        def type=: (
+          OpenAI::Models::Live::DecisionDeveloperMessage::type_
+        ) -> OpenAI::Models::Live::DecisionDeveloperMessage::type_
+
+        # @param content
+        #   The text input to the model.
+        # @param id
+        #   The unique ID of this message item.
+        def initialize: (
+          content: OpenAI::Models::Live::DecisionDeveloperMessage::content,
+          ?id: String?,
+          ?type: OpenAI::Models::Live::DecisionDeveloperMessage::type_,
+          ?role: :developer
+        ) -> void
+
+        def to_hash: -> {
+          content: OpenAI::Models::Live::DecisionDeveloperMessage::content,
+          ?role: :developer,
+          ?id: String?,
+          ?type: OpenAI::Models::Live::DecisionDeveloperMessage::type_
+        }
+
+        type content = String | ::Array[OpenAI::Live::DecisionInputText]
+
+        module Content
+          extend OpenAI::Internal::Type::Union
+
+          def self?.variants: -> ::Array[OpenAI::Models::Live::DecisionDeveloperMessage::content]
+
+          DecisionInputTextArray: OpenAI::Internal::Type::Converter
+        end
+
+        type type_ = :message
+
+        module Type
+          extend OpenAI::Internal::Type::Enum
+
+          MESSAGE: :message
+
+          def self?.values: -> ::Array[OpenAI::Models::Live::DecisionDeveloperMessage::type_]
+        end
+      end
+    end
+  end
+end

data/sig/openai/models/live/decision_input_text.rbs

@@ -0,0 +1,20 @@
+module OpenAI
+  module Models
+    module Live
+      type decision_input_text = { text: String, ?type: :input_text }
+
+      class DecisionInputText < OpenAI::Internal::Type::BaseModel
+        # The text input to the model.
+        attr_accessor text: String
+
+        attr_accessor type: :input_text
+
+        # @param text
+        #   The text input to the model.
+        def initialize: (text: String, ?type: :input_text) -> void
+
+        def to_hash: -> { text: String, ?type: :input_text }
+      end
+    end
+  end
+end