openai 0.67.0 → 0.69.0

data/rbi/openai/models/responses/response_function_tool_call_output_item.rbi

@@ -42,6 +42,16 @@ module OpenAI
         sig { returns(Symbol) }
         attr_accessor :type
 
+        # The execution context that produced this tool call.
+        sig do
+          returns(
+            T.nilable(
+              OpenAI::Responses::ResponseFunctionToolCallOutputItem::Caller::Variants
+            )
+          )
+        end
+        attr_accessor :caller_
+
         # The identifier of the actor that created the item.
         sig { returns(T.nilable(String)) }
         attr_reader :created_by
@@ -57,6 +67,13 @@ module OpenAI
               OpenAI::Responses::ResponseFunctionToolCallOutputItem::Output::Variants,
             status:
               OpenAI::Responses::ResponseFunctionToolCallOutputItem::Status::OrSymbol,
+            caller_:
+              T.nilable(
+                T.any(
+                  OpenAI::Responses::ResponseFunctionToolCallOutputItem::Caller::Direct::OrHash,
+                  OpenAI::Responses::ResponseFunctionToolCallOutputItem::Caller::Program::OrHash
+                )
+              ),
             created_by: String,
             type: Symbol
           ).returns(T.attached_class)
@@ -72,6 +89,8 @@ module OpenAI
           # The status of the item. One of `in_progress`, `completed`, or `incomplete`.
           # Populated when items are returned via API.
           status:,
+          # The execution context that produced this tool call.
+          caller_: nil,
           # The identifier of the actor that created the item.
           created_by: nil,
           # The type of the function tool call output. Always `function_call_output`.
@@ -89,6 +108,10 @@ module OpenAI
               status:
                 OpenAI::Responses::ResponseFunctionToolCallOutputItem::Status::TaggedSymbol,
               type: Symbol,
+              caller_:
+                T.nilable(
+                  OpenAI::Responses::ResponseFunctionToolCallOutputItem::Caller::Variants
+                ),
               created_by: String
             }
           )
@@ -195,6 +218,87 @@ module OpenAI
           def self.values
           end
         end
+
+        # The execution context that produced this tool call.
+        module Caller
+          extend OpenAI::Internal::Type::Union
+
+          Variants =
+            T.type_alias do
+              T.any(
+                OpenAI::Responses::ResponseFunctionToolCallOutputItem::Caller::Direct,
+                OpenAI::Responses::ResponseFunctionToolCallOutputItem::Caller::Program
+              )
+            end
+
+          class Direct < OpenAI::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  OpenAI::Responses::ResponseFunctionToolCallOutputItem::Caller::Direct,
+                  OpenAI::Internal::AnyHash
+                )
+              end
+
+            # The caller type. Always `direct`.
+            sig { returns(Symbol) }
+            attr_accessor :type
+
+            sig { params(type: Symbol).returns(T.attached_class) }
+            def self.new(
+              # The caller type. Always `direct`.
+              type: :direct
+            )
+            end
+
+            sig { override.returns({ type: Symbol }) }
+            def to_hash
+            end
+          end
+
+          class Program < OpenAI::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  OpenAI::Responses::ResponseFunctionToolCallOutputItem::Caller::Program,
+                  OpenAI::Internal::AnyHash
+                )
+              end
+
+            # The call ID of the program item that produced this tool call.
+            sig { returns(String) }
+            attr_accessor :caller_id
+
+            # The caller type. Always `program`.
+            sig { returns(Symbol) }
+            attr_accessor :type
+
+            sig do
+              params(caller_id: String, type: Symbol).returns(T.attached_class)
+            end
+            def self.new(
+              # The call ID of the program item that produced this tool call.
+              caller_id:,
+              # The caller type. Always `program`.
+              type: :program
+            )
+            end
+
+            sig { override.returns({ caller_id: String, type: Symbol }) }
+            def to_hash
+            end
+          end
+
+          sig do
+            override.returns(
+              T::Array[
+                OpenAI::Responses::ResponseFunctionToolCallOutputItem::Caller::Variants
+              ]
+            )
+          end
+          def self.variants
+          end
+        end
       end
     end
   end

data/rbi/openai/models/responses/response_input_file.rbi

@@ -16,9 +16,11 @@ module OpenAI
         sig { returns(Symbol) }
         attr_accessor :type
 
-        # The detail level of the file to be sent to the model. Use `low` for the default
-        # rendering behavior, or `high` to render the file at higher quality. Defaults to
-        # `low`.
+        # The detail level of the file to be sent to the model. Use `auto` to let the
+        # system select the detail level; for GPT-5.6 and later models, `auto` uses
+        # high-quality rendering, which may increase input token usage. Use `low` for
+        # lower-cost rendering, or `high` to render the file at higher quality. Defaults
+        # to `auto`.
         sig do
           returns(
             T.nilable(OpenAI::Responses::ResponseInputFile::Detail::OrSymbol)
@@ -58,6 +60,26 @@ module OpenAI
         sig { params(filename: String).void }
         attr_writer :filename
 
+        # 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
+          returns(
+            T.nilable(
+              OpenAI::Responses::ResponseInputFile::PromptCacheBreakpoint
+            )
+          )
+        end
+        attr_reader :prompt_cache_breakpoint
+
+        sig do
+          params(
+            prompt_cache_breakpoint:
+              OpenAI::Responses::ResponseInputFile::PromptCacheBreakpoint::OrHash
+          ).void
+        end
+        attr_writer :prompt_cache_breakpoint
+
         # A file input to the model.
         sig do
           params(
@@ -66,13 +88,17 @@ module OpenAI
             file_id: T.nilable(String),
             file_url: String,
             filename: String,
+            prompt_cache_breakpoint:
+              OpenAI::Responses::ResponseInputFile::PromptCacheBreakpoint::OrHash,
             type: Symbol
           ).returns(T.attached_class)
         end
         def self.new(
-          # The detail level of the file to be sent to the model. Use `low` for the default
-          # rendering behavior, or `high` to render the file at higher quality. Defaults to
-          # `low`.
+          # The detail level of the file to be sent to the model. Use `auto` to let the
+          # system select the detail level; for GPT-5.6 and later models, `auto` uses
+          # high-quality rendering, which may increase input token usage. Use `low` for
+          # lower-cost rendering, or `high` to render the file at higher quality. Defaults
+          # to `auto`.
           detail: nil,
           # The content of the file to be sent to the model.
           file_data: nil,
@@ -82,6 +108,10 @@ module OpenAI
           file_url: nil,
           # The name of the file to be sent to the model.
           filename: nil,
+          # 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.
+          prompt_cache_breakpoint: nil,
           # The type of the input item. Always `input_file`.
           type: :input_file
         )
@@ -95,16 +125,20 @@ module OpenAI
               file_data: String,
               file_id: T.nilable(String),
               file_url: String,
-              filename: String
+              filename: String,
+              prompt_cache_breakpoint:
+                OpenAI::Responses::ResponseInputFile::PromptCacheBreakpoint
             }
           )
         end
         def to_hash
         end
 
-        # The detail level of the file to be sent to the model. Use `low` for the default
-        # rendering behavior, or `high` to render the file at higher quality. Defaults to
-        # `low`.
+        # The detail level of the file to be sent to the model. Use `auto` to let the
+        # system select the detail level; for GPT-5.6 and later models, `auto` uses
+        # high-quality rendering, which may increase input token usage. Use `low` for
+        # lower-cost rendering, or `high` to render the file at higher quality. Defaults
+        # to `auto`.
         module Detail
           extend OpenAI::Internal::Type::Enum
 
@@ -114,6 +148,11 @@ module OpenAI
             end
           OrSymbol = T.type_alias { T.any(Symbol, String) }
 
+          AUTO =
+            T.let(
+              :auto,
+              OpenAI::Responses::ResponseInputFile::Detail::TaggedSymbol
+            )
           LOW =
             T.let(
               :low,
@@ -135,6 +174,34 @@ module OpenAI
           def self.values
           end
         end
+
+        class PromptCacheBreakpoint < OpenAI::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                OpenAI::Responses::ResponseInputFile::PromptCacheBreakpoint,
+                OpenAI::Internal::AnyHash
+              )
+            end
+
+          # The breakpoint mode. Always `explicit`.
+          sig { returns(Symbol) }
+          attr_accessor :mode
+
+          # 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 { params(mode: Symbol).returns(T.attached_class) }
+          def self.new(
+            # The breakpoint mode. Always `explicit`.
+            mode: :explicit
+          )
+          end
+
+          sig { override.returns({ mode: Symbol }) }
+          def to_hash
+          end
+        end
       end
     end
   end

data/rbi/openai/models/responses/response_input_file_content.rbi

@@ -16,9 +16,11 @@ module OpenAI
         sig { returns(Symbol) }
         attr_accessor :type
 
-        # The detail level of the file to be sent to the model. Use `low` for the default
-        # rendering behavior, or `high` to render the file at higher quality. Defaults to
-        # `low`.
+        # The detail level of the file to be sent to the model. Use `auto` to let the
+        # system select the detail level; for GPT-5.6 and later models, `auto` uses
+        # high-quality rendering, which may increase input token usage. Use `low` for
+        # lower-cost rendering, or `high` to render the file at higher quality. Defaults
+        # to `auto`.
         sig do
           returns(
             T.nilable(
@@ -52,6 +54,28 @@ module OpenAI
         sig { returns(T.nilable(String)) }
         attr_accessor :filename
 
+        # 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
+          returns(
+            T.nilable(
+              OpenAI::Responses::ResponseInputFileContent::PromptCacheBreakpoint
+            )
+          )
+        end
+        attr_reader :prompt_cache_breakpoint
+
+        sig do
+          params(
+            prompt_cache_breakpoint:
+              T.nilable(
+                OpenAI::Responses::ResponseInputFileContent::PromptCacheBreakpoint::OrHash
+              )
+          ).void
+        end
+        attr_writer :prompt_cache_breakpoint
+
         # A file input to the model.
         sig do
           params(
@@ -61,13 +85,19 @@ module OpenAI
             file_id: T.nilable(String),
             file_url: T.nilable(String),
             filename: T.nilable(String),
+            prompt_cache_breakpoint:
+              T.nilable(
+                OpenAI::Responses::ResponseInputFileContent::PromptCacheBreakpoint::OrHash
+              ),
             type: Symbol
           ).returns(T.attached_class)
         end
         def self.new(
-          # The detail level of the file to be sent to the model. Use `low` for the default
-          # rendering behavior, or `high` to render the file at higher quality. Defaults to
-          # `low`.
+          # The detail level of the file to be sent to the model. Use `auto` to let the
+          # system select the detail level; for GPT-5.6 and later models, `auto` uses
+          # high-quality rendering, which may increase input token usage. Use `low` for
+          # lower-cost rendering, or `high` to render the file at higher quality. Defaults
+          # to `auto`.
           detail: nil,
           # The base64-encoded data of the file to be sent to the model.
           file_data: nil,
@@ -77,6 +107,10 @@ module OpenAI
           file_url: nil,
           # The name of the file to be sent to the model.
           filename: nil,
+          # 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.
+          prompt_cache_breakpoint: nil,
           # The type of the input item. Always `input_file`.
           type: :input_file
         )
@@ -91,16 +125,22 @@ module OpenAI
               file_data: T.nilable(String),
               file_id: T.nilable(String),
               file_url: T.nilable(String),
-              filename: T.nilable(String)
+              filename: T.nilable(String),
+              prompt_cache_breakpoint:
+                T.nilable(
+                  OpenAI::Responses::ResponseInputFileContent::PromptCacheBreakpoint
+                )
             }
           )
         end
         def to_hash
         end
 
-        # The detail level of the file to be sent to the model. Use `low` for the default
-        # rendering behavior, or `high` to render the file at higher quality. Defaults to
-        # `low`.
+        # The detail level of the file to be sent to the model. Use `auto` to let the
+        # system select the detail level; for GPT-5.6 and later models, `auto` uses
+        # high-quality rendering, which may increase input token usage. Use `low` for
+        # lower-cost rendering, or `high` to render the file at higher quality. Defaults
+        # to `auto`.
         module Detail
           extend OpenAI::Internal::Type::Enum
 
@@ -110,6 +150,11 @@ module OpenAI
             end
           OrSymbol = T.type_alias { T.any(Symbol, String) }
 
+          AUTO =
+            T.let(
+              :auto,
+              OpenAI::Responses::ResponseInputFileContent::Detail::TaggedSymbol
+            )
           LOW =
             T.let(
               :low,
@@ -131,6 +176,34 @@ module OpenAI
           def self.values
           end
         end
+
+        class PromptCacheBreakpoint < OpenAI::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                OpenAI::Responses::ResponseInputFileContent::PromptCacheBreakpoint,
+                OpenAI::Internal::AnyHash
+              )
+            end
+
+          # The breakpoint mode. Always `explicit`.
+          sig { returns(Symbol) }
+          attr_accessor :mode
+
+          # 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 { params(mode: Symbol).returns(T.attached_class) }
+          def self.new(
+            # The breakpoint mode. Always `explicit`.
+            mode: :explicit
+          )
+          end
+
+          sig { override.returns({ mode: Symbol }) }
+          def to_hash
+          end
+        end
       end
     end
   end

data/rbi/openai/models/responses/response_input_image.rbi

@@ -30,6 +30,26 @@ module OpenAI
         sig { returns(T.nilable(String)) }
         attr_accessor :image_url
 
+        # 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
+          returns(
+            T.nilable(
+              OpenAI::Responses::ResponseInputImage::PromptCacheBreakpoint
+            )
+          )
+        end
+        attr_reader :prompt_cache_breakpoint
+
+        sig do
+          params(
+            prompt_cache_breakpoint:
+              OpenAI::Responses::ResponseInputImage::PromptCacheBreakpoint::OrHash
+          ).void
+        end
+        attr_writer :prompt_cache_breakpoint
+
         # An image input to the model. Learn about
         # [image inputs](https://platform.openai.com/docs/guides/vision).
         sig do
@@ -37,6 +57,8 @@ module OpenAI
             detail: OpenAI::Responses::ResponseInputImage::Detail::OrSymbol,
             file_id: T.nilable(String),
             image_url: T.nilable(String),
+            prompt_cache_breakpoint:
+              OpenAI::Responses::ResponseInputImage::PromptCacheBreakpoint::OrHash,
             type: Symbol
           ).returns(T.attached_class)
         end
@@ -49,6 +71,10 @@ module OpenAI
           # The URL of the image to be sent to the model. A fully qualified URL or base64
           # encoded image in a data URL.
           image_url: nil,
+          # 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.
+          prompt_cache_breakpoint: nil,
           # The type of the input item. Always `input_image`.
           type: :input_image
         )
@@ -60,7 +86,9 @@ module OpenAI
               detail: OpenAI::Responses::ResponseInputImage::Detail::OrSymbol,
               type: Symbol,
               file_id: T.nilable(String),
-              image_url: T.nilable(String)
+              image_url: T.nilable(String),
+              prompt_cache_breakpoint:
+                OpenAI::Responses::ResponseInputImage::PromptCacheBreakpoint
             }
           )
         end
@@ -109,6 +137,34 @@ module OpenAI
           def self.values
           end
         end
+
+        class PromptCacheBreakpoint < OpenAI::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                OpenAI::Responses::ResponseInputImage::PromptCacheBreakpoint,
+                OpenAI::Internal::AnyHash
+              )
+            end
+
+          # The breakpoint mode. Always `explicit`.
+          sig { returns(Symbol) }
+          attr_accessor :mode
+
+          # 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 { params(mode: Symbol).returns(T.attached_class) }
+          def self.new(
+            # The breakpoint mode. Always `explicit`.
+            mode: :explicit
+          )
+          end
+
+          sig { override.returns({ mode: Symbol }) }
+          def to_hash
+          end
+        end
       end
     end
   end

data/rbi/openai/models/responses/response_input_image_content.rbi

@@ -36,6 +36,28 @@ module OpenAI
         sig { returns(T.nilable(String)) }
         attr_accessor :image_url
 
+        # 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
+          returns(
+            T.nilable(
+              OpenAI::Responses::ResponseInputImageContent::PromptCacheBreakpoint
+            )
+          )
+        end
+        attr_reader :prompt_cache_breakpoint
+
+        sig do
+          params(
+            prompt_cache_breakpoint:
+              T.nilable(
+                OpenAI::Responses::ResponseInputImageContent::PromptCacheBreakpoint::OrHash
+              )
+          ).void
+        end
+        attr_writer :prompt_cache_breakpoint
+
         # An image input to the model. Learn about
         # [image inputs](https://platform.openai.com/docs/guides/vision)
         sig do
@@ -46,6 +68,10 @@ module OpenAI
               ),
             file_id: T.nilable(String),
             image_url: T.nilable(String),
+            prompt_cache_breakpoint:
+              T.nilable(
+                OpenAI::Responses::ResponseInputImageContent::PromptCacheBreakpoint::OrHash
+              ),
             type: Symbol
           ).returns(T.attached_class)
         end
@@ -58,6 +84,10 @@ module OpenAI
           # The URL of the image to be sent to the model. A fully qualified URL or base64
           # encoded image in a data URL.
           image_url: nil,
+          # 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.
+          prompt_cache_breakpoint: nil,
           # The type of the input item. Always `input_image`.
           type: :input_image
         )
@@ -72,7 +102,11 @@ module OpenAI
                   OpenAI::Responses::ResponseInputImageContent::Detail::OrSymbol
                 ),
               file_id: T.nilable(String),
-              image_url: T.nilable(String)
+              image_url: T.nilable(String),
+              prompt_cache_breakpoint:
+                T.nilable(
+                  OpenAI::Responses::ResponseInputImageContent::PromptCacheBreakpoint
+                )
             }
           )
         end
@@ -124,6 +158,34 @@ module OpenAI
           def self.values
           end
         end
+
+        class PromptCacheBreakpoint < OpenAI::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                OpenAI::Responses::ResponseInputImageContent::PromptCacheBreakpoint,
+                OpenAI::Internal::AnyHash
+              )
+            end
+
+          # The breakpoint mode. Always `explicit`.
+          sig { returns(Symbol) }
+          attr_accessor :mode
+
+          # 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 { params(mode: Symbol).returns(T.attached_class) }
+          def self.new(
+            # The breakpoint mode. Always `explicit`.
+            mode: :explicit
+          )
+          end
+
+          sig { override.returns({ mode: Symbol }) }
+          def to_hash
+          end
+        end
       end
     end
   end