openai 0.114.0 → 0.115.0

data/rbi/openai/models/beta/agent_update_params.rbi

@@ -20,6 +20,23 @@ module OpenAI
         sig { returns(String) }
         attr_accessor :agent_id
 
+        # Context compaction settings. Omit to keep the current settings. A supplied
+        # object replaces the settings; null or an empty object enables background
+        # compaction.
+        sig { returns(T.nilable(OpenAI::Beta::AgentUpdateParams::Compaction)) }
+        attr_reader :compaction
+
+        sig { params(compaction: T.nilable(OpenAI::Beta::AgentUpdateParams::Compaction::OrHash)).void }
+        attr_writer :compaction
+
+        # Experimental settings to merge by key. Omitted settings keep their current
+        # values.
+        sig { returns(T.nilable(OpenAI::Beta::AgentUpdateParams::Experimental)) }
+        attr_reader :experimental
+
+        sig { params(experimental: OpenAI::Beta::AgentUpdateParams::Experimental::OrHash).void }
+        attr_writer :experimental
+
         # Additional instructions appended to the agent's default base instructions. Omit
         # to leave unchanged.
         sig { returns(T.nilable(String)) }
@@ -94,6 +111,10 @@ module OpenAI
 
             agent_id: String,
 
+            compaction: T.nilable(OpenAI::Beta::AgentUpdateParams::Compaction::OrHash),
+
+            experimental: OpenAI::Beta::AgentUpdateParams::Experimental::OrHash,
+
             instructions: T.nilable(String),
 
             metadata: T.nilable(T::Hash[Symbol, String]),
@@ -132,6 +153,15 @@ module OpenAI
 
           agent_id:,
 
+          # Context compaction settings. Omit to keep the current settings. A supplied
+          # object replaces the settings; null or an empty object enables background
+          # compaction.
+          compaction: nil,
+
+          # Experimental settings to merge by key. Omitted settings keep their current
+          # values.
+          experimental: nil,
+
           # Additional instructions appended to the agent's default base instructions. Omit
           # to leave unchanged.
           instructions: nil,
@@ -172,6 +202,8 @@ module OpenAI
           override.returns(
             {
               agent_id: String,
+              compaction: T.nilable(OpenAI::Beta::AgentUpdateParams::Compaction),
+              experimental: OpenAI::Beta::AgentUpdateParams::Experimental,
               instructions: T.nilable(String),
               metadata: T.nilable(T::Hash[Symbol, String]),
               model: String,
@@ -200,6 +232,94 @@ module OpenAI
         def to_hash
         end
 
+        class Compaction < OpenAI::Internal::Type::BaseModel
+          OrHash = T.type_alias do
+            T.any(
+              OpenAI::Beta::AgentUpdateParams::Compaction,
+              OpenAI::Internal::AnyHash
+            )
+          end
+
+          # Whether to compact context in the background. Omission or null defaults to true.
+          # Set to false to use blocking compaction. Background compaction may increase
+          # token usage.
+          sig { returns(T.nilable(T::Boolean)) }
+          attr_accessor :async
+
+          # Context compaction settings. Omit to keep the current settings. A supplied
+          # object replaces the settings; null or an empty object enables background
+          # compaction.
+          sig do
+            params(
+
+              async: T.nilable(T::Boolean)
+            )
+              .returns(T.attached_class)
+          end
+          def self.new(
+
+            # Whether to compact context in the background. Omission or null defaults to true.
+            # Set to false to use blocking compaction. Background compaction may increase
+            # token usage.
+
+            async: nil
+          )
+          end
+
+          sig do
+            override.returns(
+              {async: T.nilable(T::Boolean)}
+            )
+          end
+          def to_hash
+          end
+
+        end
+
+        class Experimental < OpenAI::Internal::Type::BaseModel
+          OrHash = T.type_alias do
+            T.any(
+              OpenAI::Beta::AgentUpdateParams::Experimental,
+              OpenAI::Internal::AnyHash
+            )
+          end
+
+          # Whether to give the model periodic current-time reminders. Omit to keep the
+          # current setting.
+          sig { returns(T.nilable(T::Boolean)) }
+          attr_reader :time_awareness
+
+          sig { params(time_awareness: T::Boolean).void }
+          attr_writer :time_awareness
+
+          # Experimental settings to merge by key. Omitted settings keep their current
+          # values.
+          sig do
+            params(
+
+              time_awareness: T::Boolean
+            )
+              .returns(T.attached_class)
+          end
+          def self.new(
+
+            # Whether to give the model periodic current-time reminders. Omit to keep the
+            # current setting.
+
+            time_awareness: nil
+          )
+          end
+
+          sig do
+            override.returns(
+              {time_awareness: T::Boolean}
+            )
+          end
+          def to_hash
+          end
+
+        end
+
         # The service tier used for model requests.
         module ServiceTier
           extend OpenAI::Internal::Type::Enum

data/rbi/openai/models/beta/agents/session_create_params.rbi

@@ -59,6 +59,13 @@ module OpenAI
           sig { returns(T.nilable(T::Hash[Symbol, String])) }
           attr_accessor :metadata
 
+          # Action review mode. Omit to use none.
+          sig { returns(T.nilable(OpenAI::Beta::Agents::SessionCreateParams::Review::OrSymbol)) }
+          attr_reader :review
+
+          sig { params(review: OpenAI::Beta::Agents::SessionCreateParams::Review::OrSymbol).void }
+          attr_writer :review
+
           # Optional spending limit in USD cents. Omission or null creates an unlimited
           # session.
           sig { returns(T.nilable(OpenAI::Beta::Agents::SessionCreateParams::SpendControl)) }
@@ -90,6 +97,8 @@ module OpenAI
 
               metadata: T.nilable(T::Hash[Symbol, String]),
 
+              review: OpenAI::Beta::Agents::SessionCreateParams::Review::OrSymbol,
+
               spend_control: T.nilable(OpenAI::Beta::Agents::SessionCreateParams::SpendControl::OrHash),
 
               vault_ids: T.nilable(T::Array[String]),
@@ -121,6 +130,9 @@ module OpenAI
             # characters. Omission or null defaults to an empty map.
             metadata: nil,
 
+            # Action review mode. Omit to use none.
+            review: nil,
+
             # Optional spending limit in USD cents. Omission or null creates an unlimited
             # session.
             spend_control: nil,
@@ -144,6 +156,7 @@ module OpenAI
                 agent_id: String,
                 input: T.nilable(OpenAI::Beta::Agents::SessionCreateParams::Input::Variants),
                 metadata: T.nilable(T::Hash[Symbol, String]),
+                review: OpenAI::Beta::Agents::SessionCreateParams::Review::OrSymbol,
                 spend_control: T.nilable(OpenAI::Beta::Agents::SessionCreateParams::SpendControl),
                 vault_ids: T.nilable(T::Array[String]),
                 request_options: OpenAI::RequestOptions
@@ -161,6 +174,25 @@ module OpenAI
               )
             end
 
+            # Context compaction settings. Omit to keep the current settings. A supplied
+            # object replaces the settings; null or an empty object enables background
+            # compaction.
+            sig { returns(T.nilable(OpenAI::Beta::Agents::SessionCreateParams::Agent::Compaction)) }
+            attr_reader :compaction
+
+            sig {
+              params(compaction: T.nilable(OpenAI::Beta::Agents::SessionCreateParams::Agent::Compaction::OrHash)).void
+            }
+            attr_writer :compaction
+
+            # Experimental settings to merge by key. Omitted settings keep their current
+            # values.
+            sig { returns(T.nilable(OpenAI::Beta::Agents::SessionCreateParams::Agent::Experimental)) }
+            attr_reader :experimental
+
+            sig { params(experimental: OpenAI::Beta::Agents::SessionCreateParams::Agent::Experimental::OrHash).void }
+            attr_writer :experimental
+
             # Additional instructions appended to the agent's default base instructions. Omit
             # to leave unchanged.
             sig { returns(T.nilable(String)) }
@@ -226,6 +258,10 @@ module OpenAI
             sig do
               params(
 
+                compaction: T.nilable(OpenAI::Beta::Agents::SessionCreateParams::Agent::Compaction::OrHash),
+
+                experimental: OpenAI::Beta::Agents::SessionCreateParams::Agent::Experimental::OrHash,
+
                 instructions: T.nilable(String),
 
                 model: String,
@@ -256,6 +292,15 @@ module OpenAI
             end
             def self.new(
 
+              # Context compaction settings. Omit to keep the current settings. A supplied
+              # object replaces the settings; null or an empty object enables background
+              # compaction.
+              compaction: nil,
+
+              # Experimental settings to merge by key. Omitted settings keep their current
+              # values.
+              experimental: nil,
+
               # Additional instructions appended to the agent's default base instructions. Omit
               # to leave unchanged.
               instructions: nil,
@@ -287,6 +332,8 @@ module OpenAI
             sig do
               override.returns(
                 {
+                  compaction: T.nilable(OpenAI::Beta::Agents::SessionCreateParams::Agent::Compaction),
+                  experimental: OpenAI::Beta::Agents::SessionCreateParams::Agent::Experimental,
                   instructions: T.nilable(String),
                   model: String,
                   multi_agent: T.nilable(OpenAI::Beta::MultiAgentConfigParam),
@@ -312,6 +359,94 @@ module OpenAI
             def to_hash
             end
 
+            class Compaction < OpenAI::Internal::Type::BaseModel
+              OrHash = T.type_alias do
+                T.any(
+                  OpenAI::Beta::Agents::SessionCreateParams::Agent::Compaction,
+                  OpenAI::Internal::AnyHash
+                )
+              end
+
+              # Whether to compact context in the background. Omission or null defaults to true.
+              # Set to false to use blocking compaction. Background compaction may increase
+              # token usage.
+              sig { returns(T.nilable(T::Boolean)) }
+              attr_accessor :async
+
+              # Context compaction settings. Omit to keep the current settings. A supplied
+              # object replaces the settings; null or an empty object enables background
+              # compaction.
+              sig do
+                params(
+
+                  async: T.nilable(T::Boolean)
+                )
+                  .returns(T.attached_class)
+              end
+              def self.new(
+
+                # Whether to compact context in the background. Omission or null defaults to true.
+                # Set to false to use blocking compaction. Background compaction may increase
+                # token usage.
+
+                async: nil
+              )
+              end
+
+              sig do
+                override.returns(
+                  {async: T.nilable(T::Boolean)}
+                )
+              end
+              def to_hash
+              end
+
+            end
+
+            class Experimental < OpenAI::Internal::Type::BaseModel
+              OrHash = T.type_alias do
+                T.any(
+                  OpenAI::Beta::Agents::SessionCreateParams::Agent::Experimental,
+                  OpenAI::Internal::AnyHash
+                )
+              end
+
+              # Whether to give the model periodic current-time reminders. Omit to keep the
+              # current setting.
+              sig { returns(T.nilable(T::Boolean)) }
+              attr_reader :time_awareness
+
+              sig { params(time_awareness: T::Boolean).void }
+              attr_writer :time_awareness
+
+              # Experimental settings to merge by key. Omitted settings keep their current
+              # values.
+              sig do
+                params(
+
+                  time_awareness: T::Boolean
+                )
+                  .returns(T.attached_class)
+              end
+              def self.new(
+
+                # Whether to give the model periodic current-time reminders. Omit to keep the
+                # current setting.
+
+                time_awareness: nil
+              )
+              end
+
+              sig do
+                override.returns(
+                  {time_awareness: T::Boolean}
+                )
+              end
+              def to_hash
+              end
+
+            end
+
             # The service tier used for model requests.
             module ServiceTier
               extend OpenAI::Internal::Type::Enum
@@ -367,6 +502,24 @@ module OpenAI
 
           end
 
+          # Action review mode. Omit to use none.
+          module Review
+            extend OpenAI::Internal::Type::Enum
+
+            TaggedSymbol = T.type_alias { T.all(Symbol, OpenAI::Beta::Agents::SessionCreateParams::Review) }
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            # Keep the existing execution behavior without automatic action review.
+            NONE = T.let(:none, OpenAI::Beta::Agents::SessionCreateParams::Review::TaggedSymbol)
+
+            # Review eligible actions automatically. Deny manual approval fallbacks.
+            AUTO_REVIEW = T.let(:auto_review, OpenAI::Beta::Agents::SessionCreateParams::Review::TaggedSymbol)
+
+            sig { override.returns(T::Array[OpenAI::Beta::Agents::SessionCreateParams::Review::TaggedSymbol]) }
+            def self.values
+            end
+          end
+
           class SpendControl < OpenAI::Internal::Type::BaseModel
             OrHash = T.type_alias do
               T.any(

data/rbi/openai/models/beta/agents/session_list_params.rbi

@@ -41,6 +41,16 @@ module OpenAI
           sig { params(limit: Integer).void }
           attr_writer :limit
 
+          # Exact string matches supplied as `metadata[key]=value`. All supplied pairs must
+          # match. Up to 16 pairs, with keys from 1 to 64 characters and values up to 512
+          # characters. New sessions and metadata updates may take time to appear in
+          # filtered results.
+          sig { returns(T.nilable(T::Hash[Symbol, String])) }
+          attr_reader :metadata
+
+          sig { params(metadata: T::Hash[Symbol, String]).void }
+          attr_writer :metadata
+
           # The order in which resources are returned. Defaults to `desc`.
           sig { returns(T.nilable(OpenAI::Beta::Agents::SessionListParams::Order::OrSymbol)) }
           attr_reader :order
@@ -57,6 +67,8 @@ module OpenAI
 
               limit: Integer,
 
+              metadata: T::Hash[Symbol, String],
+
               order: OpenAI::Beta::Agents::SessionListParams::Order::OrSymbol,
 
               request_options: OpenAI::RequestOptions::OrHash
@@ -75,6 +87,12 @@ module OpenAI
             # The maximum number of resources to return, between 1 and 100. Defaults to 20.
             limit: nil,
 
+            # Exact string matches supplied as `metadata[key]=value`. All supplied pairs must
+            # match. Up to 16 pairs, with keys from 1 to 64 characters and values up to 512
+            # characters. New sessions and metadata updates may take time to appear in
+            # filtered results.
+            metadata: nil,
+
             # The order in which resources are returned. Defaults to `desc`.
             order: nil,
 
@@ -88,6 +106,7 @@ module OpenAI
                 after: String,
                 agent_id: String,
                 limit: Integer,
+                metadata: T::Hash[Symbol, String],
                 order: OpenAI::Beta::Agents::SessionListParams::Order::OrSymbol,
                 request_options: OpenAI::RequestOptions
               }

data/rbi/openai/models/beta/agents/session_update_params.rbi

@@ -22,7 +22,7 @@ module OpenAI
           sig { returns(String) }
           attr_accessor :session_id
 
-          # Model settings for subsequent turns. Omitted fields stay unchanged.
+          # Agent settings to update on this session. Omitted fields stay unchanged.
           sig { returns(T.nilable(OpenAI::Beta::Agents::SessionUpdateParams::Agent)) }
           attr_reader :agent
 
@@ -35,6 +35,14 @@ module OpenAI
           sig { returns(T.nilable(T::Hash[Symbol, String])) }
           attr_accessor :metadata
 
+          # Default action review for new root turns. Existing turns and their subagents
+          # keep their review mode.
+          sig { returns(T.nilable(OpenAI::Beta::Agents::SessionUpdateParams::Review::OrSymbol)) }
+          attr_reader :review
+
+          sig { params(review: OpenAI::Beta::Agents::SessionUpdateParams::Review::OrSymbol).void }
+          attr_writer :review
+
           # Omit to retain the limit; null or a null limit removes it without resetting
           # spend.
           sig { returns(T.nilable(OpenAI::Beta::Agents::SessionUpdateParams::SpendControl)) }
@@ -54,6 +62,8 @@ module OpenAI
 
               metadata: T.nilable(T::Hash[Symbol, String]),
 
+              review: OpenAI::Beta::Agents::SessionUpdateParams::Review::OrSymbol,
+
               spend_control: T.nilable(OpenAI::Beta::Agents::SessionUpdateParams::SpendControl::OrHash),
 
               request_options: OpenAI::RequestOptions::OrHash
@@ -64,7 +74,7 @@ module OpenAI
 
             session_id:,
 
-            # Model settings for subsequent turns. Omitted fields stay unchanged.
+            # Agent settings to update on this session. Omitted fields stay unchanged.
             agent: nil,
 
             # Replaces all metadata. Omit to leave unchanged, or pass null or {} to clear it.
@@ -72,6 +82,10 @@ module OpenAI
             # characters.
             metadata: nil,
 
+            # Default action review for new root turns. Existing turns and their subagents
+            # keep their review mode.
+            review: nil,
+
             # Omit to retain the limit; null or a null limit removes it without resetting
             # spend.
             spend_control: nil,
@@ -86,6 +100,7 @@ module OpenAI
                 session_id: String,
                 agent: OpenAI::Beta::Agents::SessionUpdateParams::Agent,
                 metadata: T.nilable(T::Hash[Symbol, String]),
+                review: OpenAI::Beta::Agents::SessionUpdateParams::Review::OrSymbol,
                 spend_control: T.nilable(OpenAI::Beta::Agents::SessionUpdateParams::SpendControl),
                 request_options: OpenAI::RequestOptions
               }
@@ -120,7 +135,29 @@ module OpenAI
             sig { returns(T.nilable(OpenAI::Beta::Agents::SessionUpdateParams::Agent::ServiceTier::OrSymbol)) }
             attr_accessor :service_tier
 
-            # Model settings for subsequent turns. Omitted fields stay unchanged.
+            # Replaces the session tools. Functions and MCP servers change on the next model
+            # call. Built-in tools change by the next turn. Omit to keep the current tools, or
+            # pass null or an empty array to clear them.
+            sig {
+              returns(
+                T.nilable(
+                  T::Array[
+                    T.any(
+                      OpenAI::Beta::AgentToolParam::Function,
+                      OpenAI::Beta::AgentToolParam::ToolSearch,
+                      OpenAI::Beta::AgentToolParam::ProgrammaticToolCalling,
+                      OpenAI::Beta::AgentToolParam::Mcp,
+                      OpenAI::Beta::AgentToolParam::WebSearch,
+                      OpenAI::Beta::AgentToolParam::ComputerUse,
+                      OpenAI::Beta::AgentToolParam::Automations
+                    )
+                  ]
+                )
+              )
+            }
+            attr_accessor :tools
+
+            # Agent settings to update on this session. Omitted fields stay unchanged.
             sig do
               params(
 
@@ -128,7 +165,21 @@ module OpenAI
 
                 reasoning: OpenAI::Beta::Agents::SessionUpdateParams::Agent::Reasoning::OrHash,
 
-                service_tier: T.nilable(OpenAI::Beta::Agents::SessionUpdateParams::Agent::ServiceTier::OrSymbol)
+                service_tier: T.nilable(OpenAI::Beta::Agents::SessionUpdateParams::Agent::ServiceTier::OrSymbol),
+
+                tools: T.nilable(
+                  T::Array[
+                    T.any(
+                      OpenAI::Beta::AgentToolParam::Function::OrHash,
+                      OpenAI::Beta::AgentToolParam::ToolSearch::OrHash,
+                      OpenAI::Beta::AgentToolParam::ProgrammaticToolCalling::OrHash,
+                      OpenAI::Beta::AgentToolParam::Mcp::OrHash,
+                      OpenAI::Beta::AgentToolParam::WebSearch::OrHash,
+                      OpenAI::Beta::AgentToolParam::ComputerUse::OrHash,
+                      OpenAI::Beta::AgentToolParam::Automations::OrHash
+                    )
+                  ]
+                )
               )
                 .returns(T.attached_class)
             end
@@ -141,8 +192,13 @@ module OpenAI
               reasoning: nil,
 
               # Omit to keep the current tier. Null resets it to auto.
+              service_tier: nil,
+
+              # Replaces the session tools. Functions and MCP servers change on the next model
+              # call. Built-in tools change by the next turn. Omit to keep the current tools, or
+              # pass null or an empty array to clear them.
 
-              service_tier: nil
+              tools: nil
             )
             end
 
@@ -151,7 +207,20 @@ module OpenAI
                 {
                   model: String,
                   reasoning: OpenAI::Beta::Agents::SessionUpdateParams::Agent::Reasoning,
-                  service_tier: T.nilable(OpenAI::Beta::Agents::SessionUpdateParams::Agent::ServiceTier::OrSymbol)
+                  service_tier: T.nilable(OpenAI::Beta::Agents::SessionUpdateParams::Agent::ServiceTier::OrSymbol),
+                  tools: T.nilable(
+                    T::Array[
+                      T.any(
+                        OpenAI::Beta::AgentToolParam::Function,
+                        OpenAI::Beta::AgentToolParam::ToolSearch,
+                        OpenAI::Beta::AgentToolParam::ProgrammaticToolCalling,
+                        OpenAI::Beta::AgentToolParam::Mcp,
+                        OpenAI::Beta::AgentToolParam::WebSearch,
+                        OpenAI::Beta::AgentToolParam::ComputerUse,
+                        OpenAI::Beta::AgentToolParam::Automations
+                      )
+                    ]
+                  )
                 }
               )
             end
@@ -262,6 +331,25 @@ module OpenAI
             end
           end
 
+          # Default action review for new root turns. Existing turns and their subagents
+          # keep their review mode.
+          module Review
+            extend OpenAI::Internal::Type::Enum
+
+            TaggedSymbol = T.type_alias { T.all(Symbol, OpenAI::Beta::Agents::SessionUpdateParams::Review) }
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            # Keep the existing execution behavior without automatic action review.
+            NONE = T.let(:none, OpenAI::Beta::Agents::SessionUpdateParams::Review::TaggedSymbol)
+
+            # Review eligible actions automatically. Deny manual approval fallbacks.
+            AUTO_REVIEW = T.let(:auto_review, OpenAI::Beta::Agents::SessionUpdateParams::Review::TaggedSymbol)
+
+            sig { override.returns(T::Array[OpenAI::Beta::Agents::SessionUpdateParams::Review::TaggedSymbol]) }
+            def self.values
+            end
+          end
+
           class SpendControl < OpenAI::Internal::Type::BaseModel
             OrHash = T.type_alias do
               T.any(