openai 0.68.0 → 0.69.0

data/rbi/openai/models/responses/response_input_text.rbi

@@ -20,19 +20,87 @@ module OpenAI
         sig { returns(Symbol) }
         attr_accessor :type
 
+        # 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::ResponseInputText::PromptCacheBreakpoint
+            )
+          )
+        end
+        attr_reader :prompt_cache_breakpoint
+
+        sig do
+          params(
+            prompt_cache_breakpoint:
+              OpenAI::Responses::ResponseInputText::PromptCacheBreakpoint::OrHash
+          ).void
+        end
+        attr_writer :prompt_cache_breakpoint
+
         # A text input to the model.
-        sig { params(text: String, type: Symbol).returns(T.attached_class) }
+        sig do
+          params(
+            text: String,
+            prompt_cache_breakpoint:
+              OpenAI::Responses::ResponseInputText::PromptCacheBreakpoint::OrHash,
+            type: Symbol
+          ).returns(T.attached_class)
+        end
         def self.new(
           # The text input to the model.
           text:,
+          # 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_text`.
           type: :input_text
         )
         end
 
-        sig { override.returns({ text: String, type: Symbol }) }
+        sig do
+          override.returns(
+            {
+              text: String,
+              type: Symbol,
+              prompt_cache_breakpoint:
+                OpenAI::Responses::ResponseInputText::PromptCacheBreakpoint
+            }
+          )
+        end
         def to_hash
         end
+
+        class PromptCacheBreakpoint < OpenAI::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                OpenAI::Responses::ResponseInputText::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_text_content.rbi

@@ -20,19 +20,93 @@ module OpenAI
         sig { returns(Symbol) }
         attr_accessor :type
 
+        # 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::ResponseInputTextContent::PromptCacheBreakpoint
+            )
+          )
+        end
+        attr_reader :prompt_cache_breakpoint
+
+        sig do
+          params(
+            prompt_cache_breakpoint:
+              T.nilable(
+                OpenAI::Responses::ResponseInputTextContent::PromptCacheBreakpoint::OrHash
+              )
+          ).void
+        end
+        attr_writer :prompt_cache_breakpoint
+
         # A text input to the model.
-        sig { params(text: String, type: Symbol).returns(T.attached_class) }
+        sig do
+          params(
+            text: String,
+            prompt_cache_breakpoint:
+              T.nilable(
+                OpenAI::Responses::ResponseInputTextContent::PromptCacheBreakpoint::OrHash
+              ),
+            type: Symbol
+          ).returns(T.attached_class)
+        end
         def self.new(
           # The text input to the model.
           text:,
+          # 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_text`.
           type: :input_text
         )
         end
 
-        sig { override.returns({ text: String, type: Symbol }) }
+        sig do
+          override.returns(
+            {
+              text: String,
+              type: Symbol,
+              prompt_cache_breakpoint:
+                T.nilable(
+                  OpenAI::Responses::ResponseInputTextContent::PromptCacheBreakpoint
+                )
+            }
+          )
+        end
         def to_hash
         end
+
+        class PromptCacheBreakpoint < OpenAI::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                OpenAI::Responses::ResponseInputTextContent::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_item.rbi

@@ -22,6 +22,8 @@ module OpenAI
               OpenAI::Responses::ResponseToolSearchOutputItem,
               OpenAI::Responses::ResponseItem::AdditionalTools,
               OpenAI::Responses::ResponseReasoningItem,
+              OpenAI::Responses::ResponseItem::Program,
+              OpenAI::Responses::ResponseItem::ProgramOutput,
               OpenAI::Responses::ResponseCompactionItem,
               OpenAI::Responses::ResponseItem::ImageGenerationCall,
               OpenAI::Responses::ResponseCodeInterpreterToolCall,
@@ -83,6 +85,7 @@ module OpenAI
                     OpenAI::Responses::ComputerUsePreviewTool::OrHash,
                     OpenAI::Responses::Tool::Mcp::OrHash,
                     OpenAI::Responses::Tool::CodeInterpreter::OrHash,
+                    OpenAI::Responses::Tool::ProgrammaticToolCalling::OrHash,
                     OpenAI::Responses::Tool::ImageGeneration::OrHash,
                     OpenAI::Responses::Tool::LocalShell::OrHash,
                     OpenAI::Responses::FunctionShellTool::OrHash,
@@ -189,6 +192,181 @@ module OpenAI
           end
         end
 
+        class Program < OpenAI::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                OpenAI::Responses::ResponseItem::Program,
+                OpenAI::Internal::AnyHash
+              )
+            end
+
+          # The unique ID of the program item.
+          sig { returns(String) }
+          attr_accessor :id
+
+          # The stable call ID of the program item.
+          sig { returns(String) }
+          attr_accessor :call_id
+
+          # The JavaScript source executed by programmatic tool calling.
+          sig { returns(String) }
+          attr_accessor :code
+
+          # Opaque program replay fingerprint that must be round-tripped.
+          sig { returns(String) }
+          attr_accessor :fingerprint
+
+          # The type of the item. Always `program`.
+          sig { returns(Symbol) }
+          attr_accessor :type
+
+          sig do
+            params(
+              id: String,
+              call_id: String,
+              code: String,
+              fingerprint: String,
+              type: Symbol
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # The unique ID of the program item.
+            id:,
+            # The stable call ID of the program item.
+            call_id:,
+            # The JavaScript source executed by programmatic tool calling.
+            code:,
+            # Opaque program replay fingerprint that must be round-tripped.
+            fingerprint:,
+            # The type of the item. Always `program`.
+            type: :program
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                id: String,
+                call_id: String,
+                code: String,
+                fingerprint: String,
+                type: Symbol
+              }
+            )
+          end
+          def to_hash
+          end
+        end
+
+        class ProgramOutput < OpenAI::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                OpenAI::Responses::ResponseItem::ProgramOutput,
+                OpenAI::Internal::AnyHash
+              )
+            end
+
+          # The unique ID of the program output item.
+          sig { returns(String) }
+          attr_accessor :id
+
+          # The call ID of the program item.
+          sig { returns(String) }
+          attr_accessor :call_id
+
+          # The result produced by the program item.
+          sig { returns(String) }
+          attr_accessor :result
+
+          # The terminal status of the program output item.
+          sig do
+            returns(
+              OpenAI::Responses::ResponseItem::ProgramOutput::Status::TaggedSymbol
+            )
+          end
+          attr_accessor :status
+
+          # The type of the item. Always `program_output`.
+          sig { returns(Symbol) }
+          attr_accessor :type
+
+          sig do
+            params(
+              id: String,
+              call_id: String,
+              result: String,
+              status:
+                OpenAI::Responses::ResponseItem::ProgramOutput::Status::OrSymbol,
+              type: Symbol
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # The unique ID of the program output item.
+            id:,
+            # The call ID of the program item.
+            call_id:,
+            # The result produced by the program item.
+            result:,
+            # The terminal status of the program output item.
+            status:,
+            # The type of the item. Always `program_output`.
+            type: :program_output
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                id: String,
+                call_id: String,
+                result: String,
+                status:
+                  OpenAI::Responses::ResponseItem::ProgramOutput::Status::TaggedSymbol,
+                type: Symbol
+              }
+            )
+          end
+          def to_hash
+          end
+
+          # The terminal status of the program output item.
+          module Status
+            extend OpenAI::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  OpenAI::Responses::ResponseItem::ProgramOutput::Status
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            COMPLETED =
+              T.let(
+                :completed,
+                OpenAI::Responses::ResponseItem::ProgramOutput::Status::TaggedSymbol
+              )
+            INCOMPLETE =
+              T.let(
+                :incomplete,
+                OpenAI::Responses::ResponseItem::ProgramOutput::Status::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  OpenAI::Responses::ResponseItem::ProgramOutput::Status::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+        end
+
         class ImageGenerationCall < OpenAI::Internal::Type::BaseModel
           OrHash =
             T.type_alias do

data/rbi/openai/models/responses/response_item_list.rbi

@@ -52,6 +52,8 @@ module OpenAI
                   OpenAI::Responses::ResponseToolSearchOutputItem::OrHash,
                   OpenAI::Responses::ResponseItem::AdditionalTools::OrHash,
                   OpenAI::Responses::ResponseReasoningItem::OrHash,
+                  OpenAI::Responses::ResponseItem::Program::OrHash,
+                  OpenAI::Responses::ResponseItem::ProgramOutput::OrHash,
                   OpenAI::Responses::ResponseCompactionItem::OrHash,
                   OpenAI::Responses::ResponseItem::ImageGenerationCall::OrHash,
                   OpenAI::Responses::ResponseCodeInterpreterToolCall::OrHash,

data/rbi/openai/models/responses/response_output_item.rbi

@@ -18,6 +18,8 @@ module OpenAI
               OpenAI::Responses::ResponseComputerToolCall,
               OpenAI::Responses::ResponseComputerToolCallOutputItem,
               OpenAI::Responses::ResponseReasoningItem,
+              OpenAI::Responses::ResponseOutputItem::Program,
+              OpenAI::Responses::ResponseOutputItem::ProgramOutput,
               OpenAI::Responses::ResponseToolSearchCall,
               OpenAI::Responses::ResponseToolSearchOutputItem,
               OpenAI::Responses::ResponseOutputItem::AdditionalTools,
@@ -39,6 +41,181 @@ module OpenAI
             )
           end
 
+        class Program < OpenAI::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                OpenAI::Responses::ResponseOutputItem::Program,
+                OpenAI::Internal::AnyHash
+              )
+            end
+
+          # The unique ID of the program item.
+          sig { returns(String) }
+          attr_accessor :id
+
+          # The stable call ID of the program item.
+          sig { returns(String) }
+          attr_accessor :call_id
+
+          # The JavaScript source executed by programmatic tool calling.
+          sig { returns(String) }
+          attr_accessor :code
+
+          # Opaque program replay fingerprint that must be round-tripped.
+          sig { returns(String) }
+          attr_accessor :fingerprint
+
+          # The type of the item. Always `program`.
+          sig { returns(Symbol) }
+          attr_accessor :type
+
+          sig do
+            params(
+              id: String,
+              call_id: String,
+              code: String,
+              fingerprint: String,
+              type: Symbol
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # The unique ID of the program item.
+            id:,
+            # The stable call ID of the program item.
+            call_id:,
+            # The JavaScript source executed by programmatic tool calling.
+            code:,
+            # Opaque program replay fingerprint that must be round-tripped.
+            fingerprint:,
+            # The type of the item. Always `program`.
+            type: :program
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                id: String,
+                call_id: String,
+                code: String,
+                fingerprint: String,
+                type: Symbol
+              }
+            )
+          end
+          def to_hash
+          end
+        end
+
+        class ProgramOutput < OpenAI::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                OpenAI::Responses::ResponseOutputItem::ProgramOutput,
+                OpenAI::Internal::AnyHash
+              )
+            end
+
+          # The unique ID of the program output item.
+          sig { returns(String) }
+          attr_accessor :id
+
+          # The call ID of the program item.
+          sig { returns(String) }
+          attr_accessor :call_id
+
+          # The result produced by the program item.
+          sig { returns(String) }
+          attr_accessor :result
+
+          # The terminal status of the program output item.
+          sig do
+            returns(
+              OpenAI::Responses::ResponseOutputItem::ProgramOutput::Status::TaggedSymbol
+            )
+          end
+          attr_accessor :status
+
+          # The type of the item. Always `program_output`.
+          sig { returns(Symbol) }
+          attr_accessor :type
+
+          sig do
+            params(
+              id: String,
+              call_id: String,
+              result: String,
+              status:
+                OpenAI::Responses::ResponseOutputItem::ProgramOutput::Status::OrSymbol,
+              type: Symbol
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # The unique ID of the program output item.
+            id:,
+            # The call ID of the program item.
+            call_id:,
+            # The result produced by the program item.
+            result:,
+            # The terminal status of the program output item.
+            status:,
+            # The type of the item. Always `program_output`.
+            type: :program_output
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                id: String,
+                call_id: String,
+                result: String,
+                status:
+                  OpenAI::Responses::ResponseOutputItem::ProgramOutput::Status::TaggedSymbol,
+                type: Symbol
+              }
+            )
+          end
+          def to_hash
+          end
+
+          # The terminal status of the program output item.
+          module Status
+            extend OpenAI::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  OpenAI::Responses::ResponseOutputItem::ProgramOutput::Status
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            COMPLETED =
+              T.let(
+                :completed,
+                OpenAI::Responses::ResponseOutputItem::ProgramOutput::Status::TaggedSymbol
+              )
+            INCOMPLETE =
+              T.let(
+                :incomplete,
+                OpenAI::Responses::ResponseOutputItem::ProgramOutput::Status::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  OpenAI::Responses::ResponseOutputItem::ProgramOutput::Status::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+        end
+
         class AdditionalTools < OpenAI::Internal::Type::BaseModel
           OrHash =
             T.type_alias do
@@ -82,6 +259,7 @@ module OpenAI
                     OpenAI::Responses::ComputerUsePreviewTool::OrHash,
                     OpenAI::Responses::Tool::Mcp::OrHash,
                     OpenAI::Responses::Tool::CodeInterpreter::OrHash,
+                    OpenAI::Responses::Tool::ProgrammaticToolCalling::OrHash,
                     OpenAI::Responses::Tool::ImageGeneration::OrHash,
                     OpenAI::Responses::Tool::LocalShell::OrHash,
                     OpenAI::Responses::FunctionShellTool::OrHash,

data/rbi/openai/models/responses/response_output_item_added_event.rbi

@@ -41,6 +41,8 @@ module OpenAI
                 OpenAI::Responses::ResponseComputerToolCall::OrHash,
                 OpenAI::Responses::ResponseComputerToolCallOutputItem::OrHash,
                 OpenAI::Responses::ResponseReasoningItem::OrHash,
+                OpenAI::Responses::ResponseOutputItem::Program::OrHash,
+                OpenAI::Responses::ResponseOutputItem::ProgramOutput::OrHash,
                 OpenAI::Responses::ResponseToolSearchCall::OrHash,
                 OpenAI::Responses::ResponseToolSearchOutputItem::OrHash,
                 OpenAI::Responses::ResponseOutputItem::AdditionalTools::OrHash,

data/rbi/openai/models/responses/response_output_item_done_event.rbi

@@ -41,6 +41,8 @@ module OpenAI
                 OpenAI::Responses::ResponseComputerToolCall::OrHash,
                 OpenAI::Responses::ResponseComputerToolCallOutputItem::OrHash,
                 OpenAI::Responses::ResponseReasoningItem::OrHash,
+                OpenAI::Responses::ResponseOutputItem::Program::OrHash,
+                OpenAI::Responses::ResponseOutputItem::ProgramOutput::OrHash,
                 OpenAI::Responses::ResponseToolSearchCall::OrHash,
                 OpenAI::Responses::ResponseToolSearchOutputItem::OrHash,
                 OpenAI::Responses::ResponseOutputItem::AdditionalTools::OrHash,

data/rbi/openai/models/responses/response_reasoning_summary_part_done_event.rbi

@@ -48,6 +48,25 @@ module OpenAI
         sig { returns(Symbol) }
         attr_accessor :type
 
+        # The completion status of the summary part. Omitted when the part completed
+        # normally and set to `incomplete` when generation was interrupted.
+        sig do
+          returns(
+            T.nilable(
+              OpenAI::Responses::ResponseReasoningSummaryPartDoneEvent::Status::TaggedSymbol
+            )
+          )
+        end
+        attr_reader :status
+
+        sig do
+          params(
+            status:
+              OpenAI::Responses::ResponseReasoningSummaryPartDoneEvent::Status::OrSymbol
+          ).void
+        end
+        attr_writer :status
+
         # Emitted when a reasoning summary part is completed.
         sig do
           params(
@@ -57,6 +76,8 @@ module OpenAI
               OpenAI::Responses::ResponseReasoningSummaryPartDoneEvent::Part::OrHash,
             sequence_number: Integer,
             summary_index: Integer,
+            status:
+              OpenAI::Responses::ResponseReasoningSummaryPartDoneEvent::Status::OrSymbol,
             type: Symbol
           ).returns(T.attached_class)
         end
@@ -71,6 +92,9 @@ module OpenAI
           sequence_number:,
           # The index of the summary part within the reasoning summary.
           summary_index:,
+          # The completion status of the summary part. Omitted when the part completed
+          # normally and set to `incomplete` when generation was interrupted.
+          status: nil,
           # The type of the event. Always `response.reasoning_summary_part.done`.
           type: :"response.reasoning_summary_part.done"
         )
@@ -85,7 +109,9 @@ module OpenAI
                 OpenAI::Responses::ResponseReasoningSummaryPartDoneEvent::Part,
               sequence_number: Integer,
               summary_index: Integer,
-              type: Symbol
+              type: Symbol,
+              status:
+                OpenAI::Responses::ResponseReasoningSummaryPartDoneEvent::Status::TaggedSymbol
             }
           )
         end
@@ -123,6 +149,37 @@ module OpenAI
           def to_hash
           end
         end
+
+        # The completion status of the summary part. Omitted when the part completed
+        # normally and set to `incomplete` when generation was interrupted.
+        module Status
+          extend OpenAI::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                OpenAI::Responses::ResponseReasoningSummaryPartDoneEvent::Status
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          INCOMPLETE =
+            T.let(
+              :incomplete,
+              OpenAI::Responses::ResponseReasoningSummaryPartDoneEvent::Status::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                OpenAI::Responses::ResponseReasoningSummaryPartDoneEvent::Status::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
       end
     end
   end