openai 0.102.0 → 0.104.0

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

@@ -59,6 +59,16 @@ module OpenAI
           sig { returns(T.nilable(T::Hash[Symbol, String])) }
           attr_accessor :metadata
 
+          # Optional spending limit in USD cents. Omission or null creates an unlimited
+          # session.
+          sig { returns(T.nilable(OpenAI::Beta::Agents::SessionCreateParams::SpendControl)) }
+          attr_reader :spend_control
+
+          sig {
+            params(spend_control: T.nilable(OpenAI::Beta::Agents::SessionCreateParams::SpendControl::OrHash)).void
+          }
+          attr_writer :spend_control
+
           # The IDs of vaults made available to the session.
           sig { returns(T.nilable(T::Array[String])) }
           attr_accessor :vault_ids
@@ -80,6 +90,8 @@ module OpenAI
 
               metadata: T.nilable(T::Hash[Symbol, String]),
 
+              spend_control: T.nilable(OpenAI::Beta::Agents::SessionCreateParams::SpendControl::OrHash),
+
               vault_ids: T.nilable(T::Array[String]),
 
               request_options: OpenAI::RequestOptions::OrHash
@@ -109,6 +121,10 @@ module OpenAI
             # characters. Omission or null defaults to an empty map.
             metadata: nil,
 
+            # Optional spending limit in USD cents. Omission or null creates an unlimited
+            # session.
+            spend_control: nil,
+
             # The IDs of vaults made available to the session.
             vault_ids: nil,
 
@@ -128,6 +144,7 @@ module OpenAI
                 agent_id: String,
                 input: T.nilable(OpenAI::Beta::Agents::SessionCreateParams::Input::Variants),
                 metadata: T.nilable(T::Hash[Symbol, String]),
+                spend_control: T.nilable(OpenAI::Beta::Agents::SessionCreateParams::SpendControl),
                 vault_ids: T.nilable(T::Array[String]),
                 request_options: OpenAI::RequestOptions
               }
@@ -182,7 +199,9 @@ module OpenAI
             sig { params(text: T.nilable(OpenAI::Beta::AgentTextParam::OrHash)).void }
             attr_writer :text
 
-            # Tools available to the agent. Omit to inherit, or pass null to clear them.
+            # Tools available to the agent. Omit to inherit, or pass null to clear them. The
+            # resolved tool list must fit within 3 MiB (3,145,728 bytes) of compact UTF-8
+            # JSON.
             sig {
               returns(
                 T.nilable(
@@ -255,7 +274,9 @@ module OpenAI
               # Configuration for text generated by the agent.
               text: nil,
 
-              # Tools available to the agent. Omit to inherit, or pass null to clear them.
+              # Tools available to the agent. Omit to inherit, or pass null to clear them. The
+              # resolved tool list must fit within 3 MiB (3,145,728 bytes) of compact UTF-8
+              # JSON.
 
               tools: nil
             )
@@ -340,6 +361,45 @@ module OpenAI
 
           end
 
+          class SpendControl < OpenAI::Internal::Type::BaseModel
+            OrHash = T.type_alias do
+              T.any(
+                OpenAI::Beta::Agents::SessionCreateParams::SpendControl,
+                OpenAI::Internal::AnyHash
+              )
+            end
+
+            # Positive USD cents, or null to remove the limit.
+            sig { returns(T.nilable(Integer)) }
+            attr_accessor :limit
+
+            # Optional spending limit in USD cents. Omission or null creates an unlimited
+            # session.
+            sig do
+              params(
+
+                limit: T.nilable(Integer)
+              )
+                .returns(T.attached_class)
+            end
+            def self.new(
+
+              # Positive USD cents, or null to remove the limit.
+
+              limit:
+            )
+            end
+
+            sig do
+              override.returns(
+                {limit: T.nilable(Integer)}
+              )
+            end
+            def to_hash
+            end
+
+          end
+
         end
 
       end

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

@@ -34,12 +34,14 @@ module OpenAI
           sig { params(agent_id: String).void }
           attr_writer :agent_id
 
-          # The maximum number of resources to return.
+          # The maximum number of resources to return, between 1 and 100. Defaults to 20.
           sig { returns(T.nilable(Integer)) }
-          attr_accessor :limit
+          attr_reader :limit
 
-          # Sort order by the `created_at` timestamp. Use `asc` for ascending order or
-          # `desc` for descending order. Defaults to `desc`.
+          sig { params(limit: Integer).void }
+          attr_writer :limit
+
+          # The order in which resources are returned. Defaults to `desc`.
           sig { returns(T.nilable(OpenAI::Beta::Agents::SessionListParams::Order::OrSymbol)) }
           attr_reader :order
 
@@ -53,7 +55,7 @@ module OpenAI
 
               agent_id: String,
 
-              limit: T.nilable(Integer),
+              limit: Integer,
 
               order: OpenAI::Beta::Agents::SessionListParams::Order::OrSymbol,
 
@@ -70,11 +72,10 @@ module OpenAI
             # all agents.
             agent_id: nil,
 
-            # The maximum number of resources to return.
+            # The maximum number of resources to return, between 1 and 100. Defaults to 20.
             limit: nil,
 
-            # Sort order by the `created_at` timestamp. Use `asc` for ascending order or
-            # `desc` for descending order. Defaults to `desc`.
+            # The order in which resources are returned. Defaults to `desc`.
             order: nil,
 
             request_options: {}
@@ -86,7 +87,7 @@ module OpenAI
               {
                 after: String,
                 agent_id: String,
-                limit: T.nilable(Integer),
+                limit: Integer,
                 order: OpenAI::Beta::Agents::SessionListParams::Order::OrSymbol,
                 request_options: OpenAI::RequestOptions
               }
@@ -95,8 +96,7 @@ module OpenAI
           def to_hash
           end
 
-          # Sort order by the `created_at` timestamp. Use `asc` for ascending order or
-          # `desc` for descending order. Defaults to `desc`.
+          # The order in which resources are returned. Defaults to `desc`.
           module Order
             extend OpenAI::Internal::Type::Enum
 

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

@@ -35,6 +35,16 @@ module OpenAI
           sig { returns(T.nilable(T::Hash[Symbol, String])) }
           attr_accessor :metadata
 
+          # Omit to retain the limit; null or a null limit removes it without resetting
+          # spend.
+          sig { returns(T.nilable(OpenAI::Beta::Agents::SessionUpdateParams::SpendControl)) }
+          attr_reader :spend_control
+
+          sig {
+            params(spend_control: T.nilable(OpenAI::Beta::Agents::SessionUpdateParams::SpendControl::OrHash)).void
+          }
+          attr_writer :spend_control
+
           sig do
             params(
 
@@ -44,6 +54,8 @@ module OpenAI
 
               metadata: T.nilable(T::Hash[Symbol, String]),
 
+              spend_control: T.nilable(OpenAI::Beta::Agents::SessionUpdateParams::SpendControl::OrHash),
+
               request_options: OpenAI::RequestOptions::OrHash
             )
               .returns(T.attached_class)
@@ -60,6 +72,10 @@ module OpenAI
             # characters.
             metadata: nil,
 
+            # Omit to retain the limit; null or a null limit removes it without resetting
+            # spend.
+            spend_control: nil,
+
             request_options: {}
           )
           end
@@ -70,6 +86,7 @@ module OpenAI
                 session_id: String,
                 agent: OpenAI::Beta::Agents::SessionUpdateParams::Agent,
                 metadata: T.nilable(T::Hash[Symbol, String]),
+                spend_control: T.nilable(OpenAI::Beta::Agents::SessionUpdateParams::SpendControl),
                 request_options: OpenAI::RequestOptions
               }
             )
@@ -242,6 +259,45 @@ module OpenAI
             end
           end
 
+          class SpendControl < OpenAI::Internal::Type::BaseModel
+            OrHash = T.type_alias do
+              T.any(
+                OpenAI::Beta::Agents::SessionUpdateParams::SpendControl,
+                OpenAI::Internal::AnyHash
+              )
+            end
+
+            # Positive USD cents, or null to remove the limit.
+            sig { returns(T.nilable(Integer)) }
+            attr_accessor :limit
+
+            # Omit to retain the limit; null or a null limit removes it without resetting
+            # spend.
+            sig do
+              params(
+
+                limit: T.nilable(Integer)
+              )
+                .returns(T.attached_class)
+            end
+            def self.new(
+
+              # Positive USD cents, or null to remove the limit.
+
+              limit:
+            )
+            end
+
+            sig do
+              override.returns(
+                {limit: T.nilable(Integer)}
+              )
+            end
+            def to_hash
+            end
+
+          end
+
         end
 
       end

data/rbi/openai/models/beta/agents/sessions/artifact_list_params.rbi

@@ -24,19 +24,25 @@ module OpenAI
             sig { returns(String) }
             attr_accessor :session_id
 
-            # Return artifacts after this immutable artifact ID.
+            # Return resources after this resource ID in the selected order.
             sig { returns(T.nilable(String)) }
-            attr_accessor :after
+            attr_reader :after
+
+            sig { params(after: String).void }
+            attr_writer :after
 
             # Restrict the listing to artifacts produced by this environment.
             sig { returns(T.nilable(String)) }
             attr_accessor :environment_id
 
-            # The maximum number of artifacts to return, between 1 and 100.
+            # The maximum number of resources to return, between 1 and 100. Defaults to 20.
             sig { returns(T.nilable(Integer)) }
-            attr_accessor :limit
+            attr_reader :limit
+
+            sig { params(limit: Integer).void }
+            attr_writer :limit
 
-            # Sort by creation time and ID. Defaults to descending.
+            # The order in which resources are returned. Defaults to `desc`.
             sig { returns(T.nilable(OpenAI::Beta::Agents::Sessions::ArtifactListParams::Order::OrSymbol)) }
             attr_reader :order
 
@@ -48,11 +54,11 @@ module OpenAI
 
                 session_id: String,
 
-                after: T.nilable(String),
+                after: String,
 
                 environment_id: T.nilable(String),
 
-                limit: T.nilable(Integer),
+                limit: Integer,
 
                 order: OpenAI::Beta::Agents::Sessions::ArtifactListParams::Order::OrSymbol,
 
@@ -64,16 +70,16 @@ module OpenAI
 
               session_id:,
 
-              # Return artifacts after this immutable artifact ID.
+              # Return resources after this resource ID in the selected order.
               after: nil,
 
               # Restrict the listing to artifacts produced by this environment.
               environment_id: nil,
 
-              # The maximum number of artifacts to return, between 1 and 100.
+              # The maximum number of resources to return, between 1 and 100. Defaults to 20.
               limit: nil,
 
-              # Sort by creation time and ID. Defaults to descending.
+              # The order in which resources are returned. Defaults to `desc`.
               order: nil,
 
               request_options: {}
@@ -84,9 +90,9 @@ module OpenAI
               override.returns(
                 {
                   session_id: String,
-                  after: T.nilable(String),
+                  after: String,
                   environment_id: T.nilable(String),
-                  limit: T.nilable(Integer),
+                  limit: Integer,
                   order: OpenAI::Beta::Agents::Sessions::ArtifactListParams::Order::OrSymbol,
                   request_options: OpenAI::RequestOptions
                 }
@@ -95,7 +101,7 @@ module OpenAI
             def to_hash
             end
 
-            # Sort by creation time and ID. Defaults to descending.
+            # The order in which resources are returned. Defaults to `desc`.
             module Order
               extend OpenAI::Internal::Type::Enum
 

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

@@ -26,13 +26,24 @@ module OpenAI
           sig { params(after: String).void }
           attr_writer :after
 
-          # The maximum number of resources to return. Defaults to 20. Values are clamped
-          # between 1 and 100.
+          # The maximum number of resources to return, between 1 and 100. Defaults to 20.
           sig { returns(T.nilable(Integer)) }
-          attr_accessor :limit
+          attr_reader :limit
 
-          # Sort order by the `created_at` timestamp. Use `asc` for ascending order or
-          # `desc` for descending order. Defaults to `desc`.
+          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. Filtering is eventually consistent; metadata changes may take time
+          # to appear.
+          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::VaultListParams::Order::OrSymbol)) }
           attr_reader :order
 
@@ -69,7 +80,9 @@ module OpenAI
 
               after: String,
 
-              limit: T.nilable(Integer),
+              limit: Integer,
+
+              metadata: T::Hash[Symbol, String],
 
               order: OpenAI::Beta::Agents::VaultListParams::Order::OrSymbol,
 
@@ -87,12 +100,16 @@ module OpenAI
             # Return resources after this resource ID in the selected order.
             after: nil,
 
-            # The maximum number of resources to return. Defaults to 20. Values are clamped
-            # between 1 and 100.
+            # The maximum number of resources to return, between 1 and 100. Defaults to 20.
             limit: nil,
 
-            # Sort order by the `created_at` timestamp. Use `asc` for ascending order or
-            # `desc` for descending order. Defaults to `desc`.
+            # 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. Filtering is eventually consistent; metadata changes may take time
+            # to appear.
+            metadata: nil,
+
+            # The order in which resources are returned. Defaults to `desc`.
             order: nil,
 
             # Filter by one status or a list, such as `status=active` or
@@ -107,7 +124,8 @@ module OpenAI
             override.returns(
               {
                 after: String,
-                limit: T.nilable(Integer),
+                limit: Integer,
+                metadata: T::Hash[Symbol, String],
                 order: OpenAI::Beta::Agents::VaultListParams::Order::OrSymbol,
                 status: T.any(
                   OpenAI::Beta::Agents::VaultStatus::OrSymbol,
@@ -120,8 +138,7 @@ module OpenAI
           def to_hash
           end
 
-          # Sort order by the `created_at` timestamp. Use `asc` for ascending order or
-          # `desc` for descending order. Defaults to `desc`.
+          # The order in which resources are returned. Defaults to `desc`.
           module Order
             extend OpenAI::Internal::Type::Enum
 

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

@@ -23,9 +23,7 @@ module OpenAI
           end
 
           VaultStatusArray = T.let(
-            OpenAI::Internal::Type::ArrayOf[
-              enum: -> { OpenAI::Models::Beta::Agents::VaultStatus }
-            ],
+            OpenAI::Internal::Type::ArrayOf[enum: -> { OpenAI::Models::Beta::Agents::VaultStatus }],
             OpenAI::Internal::Type::Converter
           )
 

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

@@ -0,0 +1,87 @@
+# typed: strong
+
+module OpenAI
+  module Models
+
+    module Beta
+
+      module Agents
+
+        class VaultUpdateParams < OpenAI::Internal::Type::BaseModel
+
+          extend OpenAI::Internal::Type::RequestParameters::Converter
+          include OpenAI::Internal::Type::RequestParameters
+
+          OrHash = T.type_alias do
+            T.any(
+              OpenAI::Beta::Agents::VaultUpdateParams,
+              OpenAI::Internal::AnyHash
+            )
+          end
+
+          sig { returns(String) }
+          attr_accessor :vault_id
+
+          # Replaces all metadata. Omit to leave unchanged, or pass {} to clear it. Up to 16
+          # string key-value pairs, with keys up to 64 and values up to 512 characters.
+          sig { returns(T.nilable(T::Hash[Symbol, String])) }
+          attr_reader :metadata
+
+          sig { params(metadata: T::Hash[Symbol, String]).void }
+          attr_writer :metadata
+
+          # A replacement name. Omit to leave unchanged, or pass null to clear it. The name
+          # is trimmed before storage. It must contain 1 to 256 UTF-8 bytes after trimming.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :name
+
+          sig do
+            params(
+
+              vault_id: String,
+
+              metadata: T::Hash[Symbol, String],
+
+              name: T.nilable(String),
+
+              request_options: OpenAI::RequestOptions::OrHash
+            )
+              .returns(T.attached_class)
+          end
+          def self.new(
+
+            vault_id:,
+
+            # Replaces all metadata. Omit to leave unchanged, or pass {} to clear it. Up to 16
+            # string key-value pairs, with keys up to 64 and values up to 512 characters.
+            metadata: nil,
+
+            # A replacement name. Omit to leave unchanged, or pass null to clear it. The name
+            # is trimmed before storage. It must contain 1 to 256 UTF-8 bytes after trimming.
+            name: nil,
+
+            request_options: {}
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                vault_id: String,
+                metadata: T::Hash[Symbol, String],
+                name: T.nilable(String),
+                request_options: OpenAI::RequestOptions
+              }
+            )
+          end
+          def to_hash
+          end
+
+        end
+
+      end
+
+    end
+
+  end
+end

data/rbi/openai/models/beta/agents/vaults/credential_list_params.rbi

@@ -31,13 +31,24 @@ module OpenAI
             sig { params(after: String).void }
             attr_writer :after
 
-            # The maximum number of resources to return. Defaults to 20. Values are clamped
-            # between 1 and 100.
+            # The maximum number of resources to return, between 1 and 100. Defaults to 20.
             sig { returns(T.nilable(Integer)) }
-            attr_accessor :limit
+            attr_reader :limit
 
-            # Sort order by the `created_at` timestamp. Use `asc` for ascending order or
-            # `desc` for descending order. Defaults to `desc`.
+            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. Filtering is eventually consistent; metadata changes may take time
+            # to appear.
+            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::Vaults::CredentialListParams::Order::OrSymbol)) }
             attr_reader :order
 
@@ -76,7 +87,9 @@ module OpenAI
 
                 after: String,
 
-                limit: T.nilable(Integer),
+                limit: Integer,
+
+                metadata: T::Hash[Symbol, String],
 
                 order: OpenAI::Beta::Agents::Vaults::CredentialListParams::Order::OrSymbol,
 
@@ -96,12 +109,16 @@ module OpenAI
               # Return resources after this resource ID in the selected order.
               after: nil,
 
-              # The maximum number of resources to return. Defaults to 20. Values are clamped
-              # between 1 and 100.
+              # The maximum number of resources to return, between 1 and 100. Defaults to 20.
               limit: nil,
 
-              # Sort order by the `created_at` timestamp. Use `asc` for ascending order or
-              # `desc` for descending order. Defaults to `desc`.
+              # 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. Filtering is eventually consistent; metadata changes may take time
+              # to appear.
+              metadata: nil,
+
+              # The order in which resources are returned. Defaults to `desc`.
               order: nil,
 
               # Filter by one status or a list, such as `status=active` or
@@ -117,7 +134,8 @@ module OpenAI
                 {
                   vault_id: String,
                   after: String,
-                  limit: T.nilable(Integer),
+                  limit: Integer,
+                  metadata: T::Hash[Symbol, String],
                   order: OpenAI::Beta::Agents::Vaults::CredentialListParams::Order::OrSymbol,
                   status: T.any(
                     OpenAI::Beta::Agents::VaultStatus::OrSymbol,
@@ -130,8 +148,7 @@ module OpenAI
             def to_hash
             end
 
-            # Sort order by the `created_at` timestamp. Use `asc` for ascending order or
-            # `desc` for descending order. Defaults to `desc`.
+            # The order in which resources are returned. Defaults to `desc`.
             module Order
               extend OpenAI::Internal::Type::Enum
 

data/rbi/openai/models/beta/beta_response.rbi

@@ -246,7 +246,7 @@ module OpenAI
 
         # A stable identifier used to help detect users of your application that may be
         # violating OpenAI's usage policies. The IDs should be a string that uniquely
-        # identifies each user, with a maximum length of 64 characters. We recommend
+        # identifies each user, with a maximum length of 128 characters. We recommend
         # hashing their username or email address, in order to avoid sending us any
         # identifying information.
         # [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
@@ -645,7 +645,7 @@ module OpenAI
 
           # A stable identifier used to help detect users of your application that may be
           # violating OpenAI's usage policies. The IDs should be a string that uniquely
-          # identifies each user, with a maximum length of 64 characters. We recommend
+          # identifies each user, with a maximum length of 128 characters. We recommend
           # hashing their username or email address, in order to avoid sending us any
           # identifying information.
           # [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).

data/rbi/openai/models/beta/beta_response_error.rbi

@@ -30,6 +30,14 @@ module OpenAI
         sig { params(misalignment: OpenAI::Beta::BetaResponseError::Misalignment::OrHash).void }
         attr_writer :misalignment
 
+        # The request parameter associated with the error, or null if none was recorded.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :param
+
+        # The original error type, or null if it was not recorded.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :type
+
         # An error object returned when the model fails to generate a Response.
         sig do
           params(
@@ -38,7 +46,11 @@ module OpenAI
 
             message: String,
 
-            misalignment: OpenAI::Beta::BetaResponseError::Misalignment::OrHash
+            misalignment: OpenAI::Beta::BetaResponseError::Misalignment::OrHash,
+
+            param: T.nilable(String),
+
+            type: T.nilable(String)
           )
             .returns(T.attached_class)
         end
@@ -50,7 +62,14 @@ module OpenAI
           # A human-readable description of the error.
           message:,
 
-          misalignment: nil
+          misalignment: nil,
+
+          # The request parameter associated with the error, or null if none was recorded.
+          param: nil,
+
+          # The original error type, or null if it was not recorded.
+
+          type: nil
         )
         end
 
@@ -59,7 +78,9 @@ module OpenAI
             {
               code: OpenAI::Beta::BetaResponseError::Code::TaggedSymbol,
               message: String,
-              misalignment: OpenAI::Beta::BetaResponseError::Misalignment
+              misalignment: OpenAI::Beta::BetaResponseError::Misalignment,
+              param: T.nilable(String),
+              type: T.nilable(String)
             }
           )
         end