openai 0.68.0 → 0.69.0

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

@@ -34,6 +34,26 @@ 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::Conversations::ComputerScreenshotContent::PromptCacheBreakpoint
+            )
+          )
+        end
+        attr_reader :prompt_cache_breakpoint
+
+        sig do
+          params(
+            prompt_cache_breakpoint:
+              OpenAI::Conversations::ComputerScreenshotContent::PromptCacheBreakpoint::OrHash
+          ).void
+        end
+        attr_writer :prompt_cache_breakpoint
+
         # A screenshot of a computer.
         sig do
           params(
@@ -41,6 +61,8 @@ module OpenAI
               OpenAI::Conversations::ComputerScreenshotContent::Detail::OrSymbol,
             file_id: T.nilable(String),
             image_url: T.nilable(String),
+            prompt_cache_breakpoint:
+              OpenAI::Conversations::ComputerScreenshotContent::PromptCacheBreakpoint::OrHash,
             type: Symbol
           ).returns(T.attached_class)
         end
@@ -52,6 +74,10 @@ module OpenAI
           file_id:,
           # The URL of the screenshot image.
           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.
+          prompt_cache_breakpoint: nil,
           # Specifies the event type. For a computer screenshot, this property is always set
           # to `computer_screenshot`.
           type: :computer_screenshot
@@ -65,7 +91,9 @@ module OpenAI
                 OpenAI::Conversations::ComputerScreenshotContent::Detail::TaggedSymbol,
               file_id: T.nilable(String),
               image_url: T.nilable(String),
-              type: Symbol
+              type: Symbol,
+              prompt_cache_breakpoint:
+                OpenAI::Conversations::ComputerScreenshotContent::PromptCacheBreakpoint
             }
           )
         end
@@ -117,6 +145,34 @@ module OpenAI
           def self.values
           end
         end
+
+        class PromptCacheBreakpoint < OpenAI::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                OpenAI::Conversations::ComputerScreenshotContent::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/conversations/conversation_create_params.rbi

@@ -51,7 +51,9 @@ module OpenAI
                   OpenAI::Responses::ResponseCustomToolCallOutput,
                   OpenAI::Responses::ResponseCustomToolCall,
                   OpenAI::Responses::ResponseInputItem::CompactionTrigger,
-                  OpenAI::Responses::ResponseInputItem::ItemReference
+                  OpenAI::Responses::ResponseInputItem::ItemReference,
+                  OpenAI::Responses::ResponseInputItem::Program,
+                  OpenAI::Responses::ResponseInputItem::ProgramOutput
                 )
               ]
             )
@@ -103,7 +105,9 @@ module OpenAI
                     OpenAI::Responses::ResponseCustomToolCallOutput::OrHash,
                     OpenAI::Responses::ResponseCustomToolCall::OrHash,
                     OpenAI::Responses::ResponseInputItem::CompactionTrigger::OrHash,
-                    OpenAI::Responses::ResponseInputItem::ItemReference::OrHash
+                    OpenAI::Responses::ResponseInputItem::ItemReference::OrHash,
+                    OpenAI::Responses::ResponseInputItem::Program::OrHash,
+                    OpenAI::Responses::ResponseInputItem::ProgramOutput::OrHash
                   )
                 ]
               ),
@@ -162,7 +166,9 @@ module OpenAI
                       OpenAI::Responses::ResponseCustomToolCallOutput,
                       OpenAI::Responses::ResponseCustomToolCall,
                       OpenAI::Responses::ResponseInputItem::CompactionTrigger,
-                      OpenAI::Responses::ResponseInputItem::ItemReference
+                      OpenAI::Responses::ResponseInputItem::ItemReference,
+                      OpenAI::Responses::ResponseInputItem::Program,
+                      OpenAI::Responses::ResponseInputItem::ProgramOutput
                     )
                   ]
                 ),

data/rbi/openai/models/conversations/conversation_item.rbi

@@ -26,6 +26,8 @@ module OpenAI
               OpenAI::Responses::ResponseToolSearchOutputItem,
               OpenAI::Conversations::ConversationItem::AdditionalTools,
               OpenAI::Responses::ResponseReasoningItem,
+              OpenAI::Conversations::ConversationItem::Program,
+              OpenAI::Conversations::ConversationItem::ProgramOutput,
               OpenAI::Responses::ResponseCompactionItem,
               OpenAI::Responses::ResponseCodeInterpreterToolCall,
               OpenAI::Conversations::ConversationItem::LocalShellCall,
@@ -197,6 +199,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,
@@ -303,6 +306,181 @@ module OpenAI
           end
         end
 
+        class Program < OpenAI::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                OpenAI::Conversations::ConversationItem::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::Conversations::ConversationItem::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::Conversations::ConversationItem::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::Conversations::ConversationItem::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::Conversations::ConversationItem::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::Conversations::ConversationItem::ProgramOutput::Status
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            COMPLETED =
+              T.let(
+                :completed,
+                OpenAI::Conversations::ConversationItem::ProgramOutput::Status::TaggedSymbol
+              )
+            INCOMPLETE =
+              T.let(
+                :incomplete,
+                OpenAI::Conversations::ConversationItem::ProgramOutput::Status::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  OpenAI::Conversations::ConversationItem::ProgramOutput::Status::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+        end
+
         class LocalShellCall < OpenAI::Internal::Type::BaseModel
           OrHash =
             T.type_alias do

data/rbi/openai/models/conversations/conversation_item_list.rbi

@@ -54,6 +54,8 @@ module OpenAI
                   OpenAI::Responses::ResponseToolSearchOutputItem::OrHash,
                   OpenAI::Conversations::ConversationItem::AdditionalTools::OrHash,
                   OpenAI::Responses::ResponseReasoningItem::OrHash,
+                  OpenAI::Conversations::ConversationItem::Program::OrHash,
+                  OpenAI::Conversations::ConversationItem::ProgramOutput::OrHash,
                   OpenAI::Responses::ResponseCompactionItem::OrHash,
                   OpenAI::Responses::ResponseCodeInterpreterToolCall::OrHash,
                   OpenAI::Conversations::ConversationItem::LocalShellCall::OrHash,

data/rbi/openai/models/conversations/item_create_params.rbi

@@ -52,7 +52,9 @@ module OpenAI
                 OpenAI::Responses::ResponseCustomToolCallOutput,
                 OpenAI::Responses::ResponseCustomToolCall,
                 OpenAI::Responses::ResponseInputItem::CompactionTrigger,
-                OpenAI::Responses::ResponseInputItem::ItemReference
+                OpenAI::Responses::ResponseInputItem::ItemReference,
+                OpenAI::Responses::ResponseInputItem::Program,
+                OpenAI::Responses::ResponseInputItem::ProgramOutput
               )
             ]
           )
@@ -111,7 +113,9 @@ module OpenAI
                   OpenAI::Responses::ResponseCustomToolCallOutput::OrHash,
                   OpenAI::Responses::ResponseCustomToolCall::OrHash,
                   OpenAI::Responses::ResponseInputItem::CompactionTrigger::OrHash,
-                  OpenAI::Responses::ResponseInputItem::ItemReference::OrHash
+                  OpenAI::Responses::ResponseInputItem::ItemReference::OrHash,
+                  OpenAI::Responses::ResponseInputItem::Program::OrHash,
+                  OpenAI::Responses::ResponseInputItem::ProgramOutput::OrHash
                 )
               ],
             include: T::Array[OpenAI::Responses::ResponseIncludable::OrSymbol],
@@ -166,7 +170,9 @@ module OpenAI
                     OpenAI::Responses::ResponseCustomToolCallOutput,
                     OpenAI::Responses::ResponseCustomToolCall,
                     OpenAI::Responses::ResponseInputItem::CompactionTrigger,
-                    OpenAI::Responses::ResponseInputItem::ItemReference
+                    OpenAI::Responses::ResponseInputItem::ItemReference,
+                    OpenAI::Responses::ResponseInputItem::Program,
+                    OpenAI::Responses::ResponseInputItem::ProgramOutput
                   )
                 ],
               include:

data/rbi/openai/models/evals/create_eval_completions_run_data_source.rbi

@@ -906,19 +906,12 @@ module OpenAI
           sig { params(max_completion_tokens: Integer).void }
           attr_writer :max_completion_tokens
 
-          # Constrains effort on reasoning for
-          # [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
-          # supported values are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`.
-          # Reducing reasoning effort can result in faster responses and fewer tokens used
-          # on reasoning in a response.
-          #
-          # - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported
-          #   reasoning values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool
-          #   calls are supported for all reasoning values in gpt-5.1.
-          # - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
-          #   support `none`.
-          # - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-          # - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+          # Constrains effort on reasoning for reasoning models. Currently supported values
+          # are `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing
+          # reasoning effort can result in faster responses and fewer tokens used on
+          # reasoning in a response. Not all reasoning models support every value. See the
+          # [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for
+          # model-specific support.
           sig { returns(T.nilable(OpenAI::ReasoningEffort::OrSymbol)) }
           attr_accessor :reasoning_effort
 
@@ -1014,19 +1007,12 @@ module OpenAI
           def self.new(
             # The maximum number of tokens in the generated output.
             max_completion_tokens: nil,
-            # Constrains effort on reasoning for
-            # [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
-            # supported values are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`.
-            # Reducing reasoning effort can result in faster responses and fewer tokens used
-            # on reasoning in a response.
-            #
-            # - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported
-            #   reasoning values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool
-            #   calls are supported for all reasoning values in gpt-5.1.
-            # - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
-            #   support `none`.
-            # - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-            # - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+            # Constrains effort on reasoning for reasoning models. Currently supported values
+            # are `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing
+            # reasoning effort can result in faster responses and fewer tokens used on
+            # reasoning in a response. Not all reasoning models support every value. See the
+            # [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for
+            # model-specific support.
             reasoning_effort: nil,
             # An object specifying the format that the model must output.
             #

data/rbi/openai/models/evals/run_cancel_response.rbi

@@ -510,19 +510,12 @@ module OpenAI
                 sig { returns(T.nilable(String)) }
                 attr_accessor :model
 
-                # Constrains effort on reasoning for
-                # [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
-                # supported values are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`.
-                # Reducing reasoning effort can result in faster responses and fewer tokens used
-                # on reasoning in a response.
-                #
-                # - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported
-                #   reasoning values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool
-                #   calls are supported for all reasoning values in gpt-5.1.
-                # - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
-                #   support `none`.
-                # - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-                # - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+                # Constrains effort on reasoning for reasoning models. Currently supported values
+                # are `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing
+                # reasoning effort can result in faster responses and fewer tokens used on
+                # reasoning in a response. Not all reasoning models support every value. See the
+                # [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for
+                # model-specific support.
                 sig do
                   returns(T.nilable(OpenAI::ReasoningEffort::TaggedSymbol))
                 end
@@ -577,19 +570,12 @@ module OpenAI
                   # The name of the model to find responses for. This is a query parameter used to
                   # select responses.
                   model: nil,
-                  # Constrains effort on reasoning for
-                  # [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
-                  # supported values are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`.
-                  # Reducing reasoning effort can result in faster responses and fewer tokens used
-                  # on reasoning in a response.
-                  #
-                  # - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported
-                  #   reasoning values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool
-                  #   calls are supported for all reasoning values in gpt-5.1.
-                  # - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
-                  #   support `none`.
-                  # - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-                  # - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+                  # Constrains effort on reasoning for reasoning models. Currently supported values
+                  # are `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing
+                  # reasoning effort can result in faster responses and fewer tokens used on
+                  # reasoning in a response. Not all reasoning models support every value. See the
+                  # [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for
+                  # model-specific support.
                   reasoning_effort: nil,
                   # Sampling temperature. This is a query parameter used to select responses.
                   temperature: nil,
@@ -1134,19 +1120,12 @@ module OpenAI
               sig { params(max_completion_tokens: Integer).void }
               attr_writer :max_completion_tokens
 
-              # Constrains effort on reasoning for
-              # [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
-              # supported values are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`.
-              # Reducing reasoning effort can result in faster responses and fewer tokens used
-              # on reasoning in a response.
-              #
-              # - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported
-              #   reasoning values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool
-              #   calls are supported for all reasoning values in gpt-5.1.
-              # - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
-              #   support `none`.
-              # - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-              # - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+              # Constrains effort on reasoning for reasoning models. Currently supported values
+              # are `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing
+              # reasoning effort can result in faster responses and fewer tokens used on
+              # reasoning in a response. Not all reasoning models support every value. See the
+              # [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for
+              # model-specific support.
               sig { returns(T.nilable(OpenAI::ReasoningEffort::TaggedSymbol)) }
               attr_accessor :reasoning_effort
 
@@ -1216,6 +1195,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,
@@ -1256,6 +1236,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,
@@ -1273,19 +1254,12 @@ module OpenAI
               def self.new(
                 # The maximum number of tokens in the generated output.
                 max_completion_tokens: nil,
-                # Constrains effort on reasoning for
-                # [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
-                # supported values are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`.
-                # Reducing reasoning effort can result in faster responses and fewer tokens used
-                # on reasoning in a response.
-                #
-                # - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported
-                #   reasoning values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool
-                #   calls are supported for all reasoning values in gpt-5.1.
-                # - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
-                #   support `none`.
-                # - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-                # - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+                # Constrains effort on reasoning for reasoning models. Currently supported values
+                # are `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing
+                # reasoning effort can result in faster responses and fewer tokens used on
+                # reasoning in a response. Not all reasoning models support every value. See the
+                # [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for
+                # model-specific support.
                 reasoning_effort: nil,
                 # A seed value to initialize the randomness, during sampling.
                 seed: nil,