openai 0.111.0 → 0.113.0

data/rbi/openai/models/conversations/computer_screenshot_content.rbi

@@ -130,18 +130,36 @@ module OpenAI
           sig { returns(Symbol) }
           attr_accessor :mode
 
+          # The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          sig {
+            returns(
+              T.nilable(OpenAI::Conversations::ComputerScreenshotContent::PromptCacheBreakpoint::Ttl::TaggedSymbol)
+            )
+          }
+          attr_reader :ttl
+
+          sig {
+            params(ttl: OpenAI::Conversations::ComputerScreenshotContent::PromptCacheBreakpoint::Ttl::OrSymbol).void
+          }
+          attr_writer :ttl
+
           # 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.
           sig do
             params(
 
+              ttl: OpenAI::Conversations::ComputerScreenshotContent::PromptCacheBreakpoint::Ttl::OrSymbol,
+
               mode: Symbol
             )
               .returns(T.attached_class)
           end
           def self.new(
 
+            # The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+            ttl: nil,
+
             # The breakpoint mode. Always `explicit`.
 
             mode: :explicit
@@ -150,12 +168,41 @@ module OpenAI
 
           sig do
             override.returns(
-              {mode: Symbol}
+              {
+                mode: Symbol,
+                ttl: OpenAI::Conversations::ComputerScreenshotContent::PromptCacheBreakpoint::Ttl::TaggedSymbol
+              }
             )
           end
           def to_hash
           end
 
+          # The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          module Ttl
+            extend OpenAI::Internal::Type::Enum
+
+            TaggedSymbol = T.type_alias {
+              T.all(Symbol, OpenAI::Conversations::ComputerScreenshotContent::PromptCacheBreakpoint::Ttl)
+            }
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            TTL_30M = T.let(
+              :"30m",
+              OpenAI::Conversations::ComputerScreenshotContent::PromptCacheBreakpoint::Ttl::TaggedSymbol
+            )
+            TTL_12H = T.let(
+              :"12h",
+              OpenAI::Conversations::ComputerScreenshotContent::PromptCacheBreakpoint::Ttl::TaggedSymbol
+            )
+
+            sig {
+              override.returns(
+                T::Array[OpenAI::Conversations::ComputerScreenshotContent::PromptCacheBreakpoint::Ttl::TaggedSymbol]
+              )
+            }
+            def self.values
+            end
+          end
         end
 
       end

data/rbi/openai/models/image_edit_params.rbi

@@ -68,11 +68,14 @@ module OpenAI
       sig { params(mask: OpenAI::Internal::FileInput).void }
       attr_writer :mask
 
-      # 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.
       sig { returns(T.nilable(T.any(String, OpenAI::ImageModel::OrSymbol))) }
       attr_accessor :model
 
@@ -230,11 +233,14 @@ module OpenAI
         # content type.
         mask: nil,
 
-        # 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.
         model: nil,
 
         # The number of images to generate. Must be between 1 and 10.
@@ -390,11 +396,14 @@ module OpenAI
         end
       end
 
-      # 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.
       module Model
         extend OpenAI::Internal::Type::Union
 

data/rbi/openai/models/image_generate_params.rbi

@@ -33,10 +33,13 @@ module OpenAI
       attr_accessor :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.
       sig { returns(T.nilable(T.any(String, OpenAI::ImageModel::OrSymbol))) }
       attr_accessor :model
 
@@ -175,10 +178,13 @@ module OpenAI
         background: nil,
 
         # 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.
         model: nil,
 
         # Control the content-moderation level for images generated by the GPT image
@@ -302,10 +308,13 @@ module OpenAI
       end
 
       # 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.
       module Model
         extend OpenAI::Internal::Type::Union
 

data/rbi/openai/models/live/client_delegation.rbi

@@ -18,17 +18,39 @@ module OpenAI
         sig { returns(Symbol) }
         attr_accessor :type
 
+        # 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.
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :acknowledgement_delay_ms
+
+        sig { params(acknowledgement_delay_ms: Integer).void }
+        attr_writer :acknowledgement_delay_ms
+
         # Delegate tasks to your application. The Live session emits delegation events
         # that your backend handles.
         sig do
           params(
 
+            acknowledgement_delay_ms: Integer,
+
             type: Symbol
           )
             .returns(T.attached_class)
         end
         def self.new(
 
+          # 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.
+          acknowledgement_delay_ms: nil,
+
           # The delegation owner. Always `client` for tasks handled by your application.
 
           type: :client
@@ -37,7 +59,7 @@ module OpenAI
 
         sig do
           override.returns(
-            {type: Symbol}
+            {type: Symbol, acknowledgement_delay_ms: Integer}
           )
         end
         def to_hash

data/rbi/openai/models/live/commentary_append_event.rbi

@@ -36,7 +36,7 @@ module OpenAI
         attr_accessor :event_id
 
         # Provide context the Live model can communicate to the user, optionally for an
-        # existing client delegation.
+        # existing client delegation. Rejected while an audio fixture is active.
         sig do
           params(
 

data/rbi/openai/models/live/decision_assistant_message.rbi

@@ -0,0 +1,247 @@
+# typed: strong
+
+module OpenAI
+  module Models
+
+    module Live
+
+      class DecisionAssistantMessage < OpenAI::Internal::Type::BaseModel
+
+        OrHash = T.type_alias do
+          T.any(
+            OpenAI::Live::DecisionAssistantMessage,
+            OpenAI::Internal::AnyHash
+          )
+        end
+
+        # The text input to the model.
+        sig { returns(OpenAI::Live::DecisionAssistantMessage::Content::Variants) }
+        attr_accessor :content
+
+        sig { returns(Symbol) }
+        attr_accessor :role
+
+        # The unique ID of this message item.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :id
+
+        # 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.
+        sig { returns(T.nilable(OpenAI::Live::DecisionAssistantMessage::Phase::OrSymbol)) }
+        attr_accessor :phase
+
+        sig { returns(T.nilable(OpenAI::Live::DecisionAssistantMessage::Type::OrSymbol)) }
+        attr_reader :type
+
+        sig { params(type: OpenAI::Live::DecisionAssistantMessage::Type::OrSymbol).void }
+        attr_writer :type
+
+        sig do
+          params(
+
+            content: OpenAI::Live::DecisionAssistantMessage::Content::Variants,
+
+            id: T.nilable(String),
+
+            phase: T.nilable(OpenAI::Live::DecisionAssistantMessage::Phase::OrSymbol),
+
+            type: OpenAI::Live::DecisionAssistantMessage::Type::OrSymbol,
+
+            role: Symbol
+          )
+            .returns(T.attached_class)
+        end
+        def self.new(
+
+          # The text input to the model.
+          content:,
+
+          # The unique ID of this message item.
+          id: nil,
+
+          # 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.
+          phase: nil,
+
+          type: nil,
+
+          role: :assistant
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              content: OpenAI::Live::DecisionAssistantMessage::Content::Variants,
+              role: Symbol,
+              id: T.nilable(String),
+              phase: T.nilable(OpenAI::Live::DecisionAssistantMessage::Phase::OrSymbol),
+              type: OpenAI::Live::DecisionAssistantMessage::Type::OrSymbol
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # The text input to the model.
+        module Content
+          extend OpenAI::Internal::Type::Union
+
+          Variants = T.type_alias {
+            T.any(String, T::Array[OpenAI::Live::DecisionAssistantMessage::Content::Part::Variants])
+          }
+
+          module Part
+            extend OpenAI::Internal::Type::Union
+
+            Variants = T.type_alias {
+              T.any(
+                OpenAI::Live::DecisionAssistantMessage::Content::Part::OutputText,
+                OpenAI::Live::DecisionAssistantMessage::Content::Part::Refusal
+              )
+            }
+
+            class OutputText < OpenAI::Internal::Type::BaseModel
+              OrHash = T.type_alias do
+                T.any(
+                  OpenAI::Live::DecisionAssistantMessage::Content::Part::OutputText,
+                  OpenAI::Internal::AnyHash
+                )
+              end
+
+              # The text content.
+              sig { returns(String) }
+              attr_accessor :text
+
+              sig { returns(Symbol) }
+              attr_accessor :type
+
+              sig do
+                params(
+
+                  text: String,
+
+                  type: Symbol
+                )
+                  .returns(T.attached_class)
+              end
+              def self.new(
+
+                # The text content.
+                text:,
+
+                type: :output_text
+              )
+              end
+
+              sig do
+                override.returns(
+                  {text: String, type: Symbol}
+                )
+              end
+              def to_hash
+              end
+
+            end
+
+            class Refusal < OpenAI::Internal::Type::BaseModel
+              OrHash = T.type_alias do
+                T.any(
+                  OpenAI::Live::DecisionAssistantMessage::Content::Part::Refusal,
+                  OpenAI::Internal::AnyHash
+                )
+              end
+
+              # The refusal text.
+              sig { returns(String) }
+              attr_accessor :refusal
+
+              sig { returns(Symbol) }
+              attr_accessor :type
+
+              sig do
+                params(
+
+                  refusal: String,
+
+                  type: Symbol
+                )
+                  .returns(T.attached_class)
+              end
+              def self.new(
+
+                # The refusal text.
+                refusal:,
+
+                type: :refusal
+              )
+              end
+
+              sig do
+                override.returns(
+                  {refusal: String, type: Symbol}
+                )
+              end
+              def to_hash
+              end
+
+            end
+
+            sig { override.returns(T::Array[OpenAI::Live::DecisionAssistantMessage::Content::Part::Variants]) }
+            def self.variants
+            end
+
+          end
+
+          sig { override.returns(T::Array[OpenAI::Live::DecisionAssistantMessage::Content::Variants]) }
+          def self.variants
+          end
+
+          PartsArray = T.let(
+            OpenAI::Internal::Type::ArrayOf[union: OpenAI::Live::DecisionAssistantMessage::Content::Part],
+            OpenAI::Internal::Type::Converter
+          )
+
+        end
+
+        # 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.
+        module Phase
+          extend OpenAI::Internal::Type::Enum
+
+          TaggedSymbol = T.type_alias { T.all(Symbol, OpenAI::Live::DecisionAssistantMessage::Phase) }
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          COMMENTARY = T.let(:commentary, OpenAI::Live::DecisionAssistantMessage::Phase::TaggedSymbol)
+          FINAL_ANSWER = T.let(:final_answer, OpenAI::Live::DecisionAssistantMessage::Phase::TaggedSymbol)
+
+          sig { override.returns(T::Array[OpenAI::Live::DecisionAssistantMessage::Phase::TaggedSymbol]) }
+          def self.values
+          end
+        end
+
+        module Type
+          extend OpenAI::Internal::Type::Enum
+
+          TaggedSymbol = T.type_alias { T.all(Symbol, OpenAI::Live::DecisionAssistantMessage::Type) }
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          MESSAGE = T.let(:message, OpenAI::Live::DecisionAssistantMessage::Type::TaggedSymbol)
+
+          sig { override.returns(T::Array[OpenAI::Live::DecisionAssistantMessage::Type::TaggedSymbol]) }
+          def self.values
+          end
+        end
+
+      end
+
+    end
+
+  end
+end

data/rbi/openai/models/live/decision_choice_option.rbi

@@ -0,0 +1,67 @@
+# typed: strong
+
+module OpenAI
+  module Models
+
+    module Live
+
+      class DecisionChoiceOption < OpenAI::Internal::Type::BaseModel
+
+        OrHash = T.type_alias do
+          T.any(
+            OpenAI::Live::DecisionChoiceOption,
+            OpenAI::Internal::AnyHash
+          )
+        end
+
+        sig { returns(T.any(String, T::Boolean)) }
+        attr_accessor :value
+
+        sig { returns(T.nilable(String)) }
+        attr_reader :description
+
+        sig { params(description: String).void }
+        attr_writer :description
+
+        sig do
+          params(
+
+            value: T.any(String, T::Boolean),
+
+            description: String
+          )
+            .returns(T.attached_class)
+        end
+        def self.new(
+
+          value:,
+
+          description: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {value: T.any(String, T::Boolean), description: String}
+          )
+        end
+        def to_hash
+        end
+
+        module Value
+          extend OpenAI::Internal::Type::Union
+
+          Variants = T.type_alias { T.any(String, T::Boolean) }
+
+          sig { override.returns(T::Array[OpenAI::Live::DecisionChoiceOption::Value::Variants]) }
+          def self.variants
+          end
+
+        end
+
+      end
+
+    end
+
+  end
+end

data/rbi/openai/models/live/decision_developer_message.rbi

@@ -0,0 +1,109 @@
+# typed: strong
+
+module OpenAI
+  module Models
+
+    module Live
+
+      class DecisionDeveloperMessage < OpenAI::Internal::Type::BaseModel
+
+        OrHash = T.type_alias do
+          T.any(
+            OpenAI::Live::DecisionDeveloperMessage,
+            OpenAI::Internal::AnyHash
+          )
+        end
+
+        # The text input to the model.
+        sig { returns(OpenAI::Live::DecisionDeveloperMessage::Content::Variants) }
+        attr_accessor :content
+
+        sig { returns(Symbol) }
+        attr_accessor :role
+
+        # The unique ID of this message item.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :id
+
+        sig { returns(T.nilable(OpenAI::Live::DecisionDeveloperMessage::Type::OrSymbol)) }
+        attr_reader :type
+
+        sig { params(type: OpenAI::Live::DecisionDeveloperMessage::Type::OrSymbol).void }
+        attr_writer :type
+
+        sig do
+          params(
+
+            content: OpenAI::Live::DecisionDeveloperMessage::Content::Variants,
+
+            id: T.nilable(String),
+
+            type: OpenAI::Live::DecisionDeveloperMessage::Type::OrSymbol,
+
+            role: Symbol
+          )
+            .returns(T.attached_class)
+        end
+        def self.new(
+
+          # The text input to the model.
+          content:,
+
+          # The unique ID of this message item.
+          id: nil,
+
+          type: nil,
+
+          role: :developer
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              content: OpenAI::Live::DecisionDeveloperMessage::Content::Variants,
+              role: Symbol,
+              id: T.nilable(String),
+              type: OpenAI::Live::DecisionDeveloperMessage::Type::OrSymbol
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # The text input to the model.
+        module Content
+          extend OpenAI::Internal::Type::Union
+
+          Variants = T.type_alias { T.any(String, T::Array[OpenAI::Live::DecisionInputText]) }
+
+          sig { override.returns(T::Array[OpenAI::Live::DecisionDeveloperMessage::Content::Variants]) }
+          def self.variants
+          end
+
+          DecisionInputTextArray = T.let(
+            OpenAI::Internal::Type::ArrayOf[OpenAI::Live::DecisionInputText],
+            OpenAI::Internal::Type::Converter
+          )
+
+        end
+
+        module Type
+          extend OpenAI::Internal::Type::Enum
+
+          TaggedSymbol = T.type_alias { T.all(Symbol, OpenAI::Live::DecisionDeveloperMessage::Type) }
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          MESSAGE = T.let(:message, OpenAI::Live::DecisionDeveloperMessage::Type::TaggedSymbol)
+
+          sig { override.returns(T::Array[OpenAI::Live::DecisionDeveloperMessage::Type::TaggedSymbol]) }
+          def self.values
+          end
+        end
+
+      end
+
+    end
+
+  end
+end