openai 0.89.0 → 0.90.0

data/lib/openai/models/beta/agents/sessions/turn_list_params.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Beta
+      module Agents
+        module Sessions
+          # @see OpenAI::Resources::Beta::Agents::Sessions::Turns#list
+          class TurnListParams < OpenAI::Internal::Type::BaseModel
+            extend OpenAI::Internal::Type::RequestParameters::Converter
+            include OpenAI::Internal::Type::RequestParameters
+
+            # @!attribute session_id
+            #
+            #   @return [String]
+            required :session_id, String
+
+            # @!attribute after
+            #   Return resources after this resource ID in the selected order.
+            #
+            #   @return [String, nil]
+            optional :after, String
+
+            # @!attribute limit
+            #   The maximum number of resources to return, between 1 and 100. Defaults to 20.
+            #
+            #   @return [Integer, nil]
+            optional :limit, Integer
+
+            # @!attribute order
+            #   The order in which resources are returned. Defaults to `desc`.
+            #
+            #   @return [Symbol, OpenAI::Models::Beta::Agents::Sessions::TurnListParams::Order, nil]
+            optional :order, enum: -> { OpenAI::Beta::Agents::Sessions::TurnListParams::Order }
+
+            # @!method initialize(session_id:, after: nil, limit: nil, order: nil, request_options: {})
+            #   @param session_id [String]
+            #
+            #   @param after [String]
+            #     Return resources after this resource ID in the selected order.
+            #
+            #   @param limit [Integer]
+            #     The maximum number of resources to return, between 1 and 100. Defaults to 20.
+            #
+            #   @param order [Symbol, OpenAI::Models::Beta::Agents::Sessions::TurnListParams::Order]
+            #     The order in which resources are returned. Defaults to `desc`.
+            #
+            #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
+
+            # The order in which resources are returned. Defaults to `desc`.
+            module Order
+              extend OpenAI::Internal::Type::Enum
+
+              # Returns resources in ascending order.
+              ASC = :asc
+
+              # Returns resources in descending order.
+              DESC = :desc
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/openai/models/beta/agents/sessions/turn_retrieve_params.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Beta
+      module Agents
+        module Sessions
+          # @see OpenAI::Resources::Beta::Agents::Sessions::Turns#retrieve
+          class TurnRetrieveParams < OpenAI::Internal::Type::BaseModel
+            extend OpenAI::Internal::Type::RequestParameters::Converter
+            include OpenAI::Internal::Type::RequestParameters
+
+            # @!attribute session_id
+            #
+            #   @return [String]
+            required :session_id, String
+
+            # @!attribute turn_id
+            #
+            #   @return [String]
+            required :turn_id, String
+
+            # @!method initialize(session_id:, turn_id:, request_options: {})
+            #   @param session_id [String]
+            #   @param turn_id [String]
+            #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/openai/models/beta/agents/vault.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Beta
+      module Agents
+        # @see OpenAI::Resources::Beta::Agents::Vaults#create
+        class Vault < OpenAI::Internal::Type::BaseModel
+          # @!attribute id
+          #   The ID of the vault.
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute created_at
+          #   The Unix timestamp, in seconds, when the vault was created.
+          #
+          #   @return [Integer]
+          required :created_at, Integer
+
+          # @!attribute metadata
+          #   Key-value pairs associated with the vault, such as an application or team
+          #   identifier.
+          #
+          #   @return [Hash{Symbol=>String}]
+          required :metadata, OpenAI::Internal::Type::HashOf[String]
+
+          # @!attribute name
+          #   The human-readable name of the vault, if set.
+          #
+          #   @return [String, nil]
+          required :name, String, nil?: true
+
+          # @!attribute object
+          #   The object type. Always `vault`.
+          #
+          #   @return [Symbol, :vault]
+          required :object, const: :vault
+
+          # @!method initialize(id:, created_at:, metadata:, name:, object: :vault)
+          #   A collection of credentials that agent tools can use to authenticate to MCP
+          #   servers.
+          #
+          #   @param id [String]
+          #     The ID of the vault.
+          #
+          #   @param created_at [Integer]
+          #     The Unix timestamp, in seconds, when the vault was created.
+          #
+          #   @param metadata [Hash{Symbol=>String}]
+          #     Key-value pairs associated with the vault, such as an application or team
+          #     identifier.
+          #
+          #   @param name [String, nil]
+          #     The human-readable name of the vault, if set.
+          #
+          #   @param object [Symbol, :vault]
+          #     The object type. Always `vault`.
+        end
+      end
+    end
+  end
+end

data/lib/openai/models/beta/agents/vault_create_params.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Beta
+      module Agents
+        # @see OpenAI::Resources::Beta::Agents::Vaults#create
+        class VaultCreateParams < OpenAI::Internal::Type::BaseModel
+          extend OpenAI::Internal::Type::RequestParameters::Converter
+          include OpenAI::Internal::Type::RequestParameters
+
+          # @!attribute metadata
+          #   Key-value pairs to associate with the vault, such as an application or team
+          #   identifier.
+          #
+          #   @return [Hash{Symbol=>String}, nil]
+          optional :metadata, OpenAI::Internal::Type::HashOf[String], nil?: true
+
+          # @!attribute name
+          #   The name is trimmed before storage. It must contain 1 to 256 UTF-8 bytes after
+          #   trimming.
+          #
+          #   @return [String, nil]
+          optional :name, String
+
+          # @!method initialize(metadata: nil, name: nil, request_options: {})
+          #   @param metadata [Hash{Symbol=>String}, nil]
+          #     Key-value pairs to associate with the vault, such as an application or team
+          #     identifier.
+          #
+          #   @param name [String]
+          #     The name is trimmed before storage. It must contain 1 to 256 UTF-8 bytes after
+          #     trimming.
+          #
+          #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
+        end
+      end
+    end
+  end
+end

data/lib/openai/models/beta/agents/vault_delete_params.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Beta
+      module Agents
+        # @see OpenAI::Resources::Beta::Agents::Vaults#delete
+        class VaultDeleteParams < OpenAI::Internal::Type::BaseModel
+          extend OpenAI::Internal::Type::RequestParameters::Converter
+          include OpenAI::Internal::Type::RequestParameters
+
+          # @!attribute vault_id
+          #
+          #   @return [String]
+          required :vault_id, String
+
+          # @!method initialize(vault_id:, request_options: {})
+          #   @param vault_id [String]
+          #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
+        end
+      end
+    end
+  end
+end

data/lib/openai/models/beta/agents/vault_deleted.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Beta
+      module Agents
+        # @see OpenAI::Resources::Beta::Agents::Vaults#delete
+        class VaultDeleted < OpenAI::Internal::Type::BaseModel
+          # @!attribute id
+          #   The ID of the deleted vault.
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute deleted
+          #   Whether the resource was deleted. Always `true`.
+          #
+          #   @return [Boolean]
+          required :deleted, OpenAI::Internal::Type::Boolean
+
+          # @!attribute object
+          #   The object type. Always `vault.deleted`.
+          #
+          #   @return [Symbol, :"vault.deleted"]
+          required :object, const: :"vault.deleted"
+
+          # @!method initialize(id:, deleted:, object: :"vault.deleted")
+          #   Confirmation that a vault was deleted.
+          #
+          #   @param id [String]
+          #     The ID of the deleted vault.
+          #
+          #   @param deleted [Boolean]
+          #     Whether the resource was deleted. Always `true`.
+          #
+          #   @param object [Symbol, :"vault.deleted"]
+          #     The object type. Always `vault.deleted`.
+        end
+      end
+    end
+  end
+end

data/lib/openai/models/beta/agents/vault_list_params.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Beta
+      module Agents
+        # @see OpenAI::Resources::Beta::Agents::Vaults#list
+        class VaultListParams < OpenAI::Internal::Type::BaseModel
+          extend OpenAI::Internal::Type::RequestParameters::Converter
+          include OpenAI::Internal::Type::RequestParameters
+
+          # @!attribute after
+          #   Return resources after this resource ID in the selected order.
+          #
+          #   @return [String, nil]
+          optional :after, String
+
+          # @!attribute limit
+          #   The maximum number of resources to return. Defaults to 20. Values are clamped
+          #   between 1 and 100.
+          #
+          #   @return [Integer, nil]
+          optional :limit, Integer, nil?: true
+
+          # @!attribute order
+          #   Sort order by the `created_at` timestamp. Use `asc` for ascending order or
+          #   `desc` for descending order. Defaults to `desc`.
+          #
+          #   @return [Symbol, OpenAI::Models::Beta::Agents::VaultListParams::Order, nil]
+          optional :order, enum: -> { OpenAI::Beta::Agents::VaultListParams::Order }
+
+          # @!attribute status
+          #   Filter by one status or a list, such as `status=active` or
+          #   `status[]=active&status[]=archived`. Both statuses are included by default.
+          #
+          #   @return [Symbol, OpenAI::Models::Beta::Agents::VaultStatus, Array<Symbol, OpenAI::Models::Beta::Agents::VaultStatus>, nil]
+          optional :status, union: -> { OpenAI::Beta::Agents::VaultStatusFilter }
+
+          # @!method initialize(after: nil, limit: nil, order: nil, status: nil, request_options: {})
+          #   @param after [String]
+          #     Return resources after this resource ID in the selected order.
+          #
+          #   @param limit [Integer, nil]
+          #     The maximum number of resources to return. Defaults to 20. Values are clamped
+          #     between 1 and 100.
+          #
+          #   @param order [Symbol, OpenAI::Models::Beta::Agents::VaultListParams::Order]
+          #     Sort order by the `created_at` timestamp. Use `asc` for ascending order or
+          #     `desc` for descending order. Defaults to `desc`.
+          #
+          #   @param status [Symbol, OpenAI::Models::Beta::Agents::VaultStatus, Array<Symbol, OpenAI::Models::Beta::Agents::VaultStatus>]
+          #     Filter by one status or a list, such as `status=active` or
+          #     `status[]=active&status[]=archived`. Both statuses are included by default.
+          #
+          #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
+
+          # Sort order by the `created_at` timestamp. Use `asc` for ascending order or
+          # `desc` for descending order. Defaults to `desc`.
+          module Order
+            extend OpenAI::Internal::Type::Enum
+
+            # Returns resources in ascending order.
+            ASC = :asc
+
+            # Returns resources in descending order.
+            DESC = :desc
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/openai/models/beta/agents/vault_retrieve_params.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Beta
+      module Agents
+        # @see OpenAI::Resources::Beta::Agents::Vaults#retrieve
+        class VaultRetrieveParams < OpenAI::Internal::Type::BaseModel
+          extend OpenAI::Internal::Type::RequestParameters::Converter
+          include OpenAI::Internal::Type::RequestParameters
+
+          # @!attribute vault_id
+          #
+          #   @return [String]
+          required :vault_id, String
+
+          # @!method initialize(vault_id:, request_options: {})
+          #   @param vault_id [String]
+          #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
+        end
+      end
+    end
+  end
+end

data/lib/openai/models/beta/agents/vault_status.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Beta
+      module Agents
+        # Whether a vault or credential is active or archived.
+        module VaultStatus
+          extend OpenAI::Internal::Type::Enum
+
+          ACTIVE = :active
+          ARCHIVED = :archived
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/openai/models/beta/agents/vault_status_filter.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Beta
+      module Agents
+        # One or more lifecycle statuses to include when listing vaults or credentials.
+        module VaultStatusFilter
+          extend OpenAI::Internal::Type::Union
+
+          # Whether a vault or credential is active or archived.
+          variant enum: -> { OpenAI::Beta::Agents::VaultStatus }
+
+          variant -> { OpenAI::Models::Beta::Agents::VaultStatusFilter::VaultStatusArray }
+
+          # @!method self.variants
+          #   @return [Array(Symbol, OpenAI::Models::Beta::Agents::VaultStatus, Array<Symbol, OpenAI::Models::Beta::Agents::VaultStatus>)]
+
+          # @type [OpenAI::Internal::Type::Converter]
+          VaultStatusArray = OpenAI::Internal::Type::ArrayOf[
+            enum: -> { OpenAI::Models::Beta::Agents::VaultStatus }
+          ]
+        end
+      end
+    end
+  end
+end

data/lib/openai/models/beta/agents/vaults/credential.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Beta
+      module Agents
+        module Vaults
+          # @see OpenAI::Resources::Beta::Agents::Vaults::Credentials#create
+          class Credential < OpenAI::Internal::Type::BaseModel
+            # @!attribute id
+            #   The ID of the credential.
+            #
+            #   @return [String]
+            required :id, String
+
+            # @!attribute auth
+            #   The authentication method and non-secret configuration for the MCP server.
+            #
+            #   @return [OpenAI::Models::Beta::Agents::Vaults::CredentialAuth::McpOauth, OpenAI::Models::Beta::Agents::Vaults::CredentialAuth::StaticBearer]
+            required :auth, union: -> { OpenAI::Beta::Agents::Vaults::CredentialAuth }
+
+            # @!attribute created_at
+            #   The Unix timestamp, in seconds, when the credential was created.
+            #
+            #   @return [Integer]
+            required :created_at, Integer
+
+            # @!attribute name
+            #   The human-readable name of the credential.
+            #
+            #   @return [String]
+            required :name, String
+
+            # @!attribute object
+            #   The object type. Always `vault.credential`.
+            #
+            #   @return [Symbol, :"vault.credential"]
+            required :object, const: :"vault.credential"
+
+            # @!attribute updated_at
+            #   The Unix timestamp, in seconds, when the credential was last updated.
+            #
+            #   @return [Integer]
+            required :updated_at, Integer
+
+            # @!attribute vault_id
+            #   The ID of the vault containing this credential.
+            #
+            #   @return [String]
+            required :vault_id, String
+
+            # @!method initialize(id:, auth:, created_at:, name:, updated_at:, vault_id:, object: :"vault.credential")
+            #   Metadata for a stored MCP server credential. Secret values are never returned.
+            #
+            #   @param id [String]
+            #     The ID of the credential.
+            #
+            #   @param auth [OpenAI::Models::Beta::Agents::Vaults::CredentialAuth::McpOauth, OpenAI::Models::Beta::Agents::Vaults::CredentialAuth::StaticBearer]
+            #     The authentication method and non-secret configuration for the MCP server.
+            #
+            #   @param created_at [Integer]
+            #     The Unix timestamp, in seconds, when the credential was created.
+            #
+            #   @param name [String]
+            #     The human-readable name of the credential.
+            #
+            #   @param updated_at [Integer]
+            #     The Unix timestamp, in seconds, when the credential was last updated.
+            #
+            #   @param vault_id [String]
+            #     The ID of the vault containing this credential.
+            #
+            #   @param object [Symbol, :"vault.credential"]
+            #     The object type. Always `vault.credential`.
+          end
+        end
+      end
+    end
+  end
+end

data/lib/openai/models/beta/agents/vaults/credential_auth.rb

@@ -0,0 +1,155 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Beta
+      module Agents
+        module Vaults
+          # The MCP server and authentication configuration of a vault credential, excluding
+          # secrets.
+          module CredentialAuth
+            extend OpenAI::Internal::Type::Union
+
+            discriminator :type
+
+            # Public metadata for an OAuth credential; tokens and client secrets are never returned.
+            variant :mcp_oauth, -> { OpenAI::Beta::Agents::Vaults::CredentialAuth::McpOauth }
+
+            # Metadata for a bearer-token credential, without automatic OAuth refresh.
+            variant :static_bearer, -> { OpenAI::Beta::Agents::Vaults::CredentialAuth::StaticBearer }
+
+            class McpOauth < OpenAI::Internal::Type::BaseModel
+              # @!attribute expires_at
+              #   When the OAuth access token expires, as an RFC 3339 timestamp, if known.
+              #
+              #   @return [String, nil]
+              required :expires_at, String, nil?: true
+
+              # @!attribute mcp_server_url
+              #   The HTTPS MCP server URL authorized by this credential.
+              #
+              #   @return [String]
+              required :mcp_server_url, String
+
+              # @!attribute refresh
+              #   Configuration used to refresh an MCP OAuth access token, excluding secret
+              #   values.
+              #
+              #   @return [OpenAI::Models::Beta::Agents::Vaults::CredentialAuth::McpOauth::Refresh, nil]
+              required(
+                :refresh,
+                -> {
+                  OpenAI::Beta::Agents::Vaults::CredentialAuth::McpOauth::Refresh
+                },
+                nil?: true
+              )
+
+              # @!attribute type
+              #   The type of the object. Always `mcp_oauth`.
+              #
+              #   @return [Symbol, :mcp_oauth]
+              required :type, const: :mcp_oauth
+
+              # @!method initialize(expires_at:, mcp_server_url:, refresh:, type: :mcp_oauth)
+              #   Public metadata for an OAuth credential; tokens and client secrets are never
+              #   returned.
+              #
+              #   @param expires_at [String, nil]
+              #     When the OAuth access token expires, as an RFC 3339 timestamp, if known.
+              #
+              #   @param mcp_server_url [String]
+              #     The HTTPS MCP server URL authorized by this credential.
+              #
+              #   @param refresh [OpenAI::Models::Beta::Agents::Vaults::CredentialAuth::McpOauth::Refresh, nil]
+              #     Configuration used to refresh an MCP OAuth access token, excluding secret
+              #     values.
+              #
+              #   @param type [Symbol, :mcp_oauth]
+              #     The type of the object. Always `mcp_oauth`.
+
+              # @see OpenAI::Models::Beta::Agents::Vaults::CredentialAuth::McpOauth#refresh
+              class Refresh < OpenAI::Internal::Type::BaseModel
+                # @!attribute client_id
+                #   The OAuth client ID used when requesting a new access token.
+                #
+                #   @return [String]
+                required :client_id, String
+
+                # @!attribute resource
+                #   The resource URI sent to the OAuth token endpoint during refresh, if configured.
+                #
+                #   @return [String, nil]
+                required :resource, String, nil?: true
+
+                # @!attribute scope
+                #   Space-separated OAuth scopes requested during refresh, if configured.
+                #
+                #   @return [String, nil]
+                required :scope, String, nil?: true
+
+                # @!attribute token_endpoint
+                #   The HTTPS OAuth token endpoint used for refresh.
+                #
+                #   @return [String]
+                required :token_endpoint, String
+
+                # @!attribute token_endpoint_auth
+                #   How the OAuth client authenticates to the token endpoint, excluding its client
+                #   secret.
+                #
+                #   @return [OpenAI::Models::Beta::Agents::Vaults::McpOauthTokenEndpointAuth::None, OpenAI::Models::Beta::Agents::Vaults::McpOauthTokenEndpointAuth::ClientSecretBasic, OpenAI::Models::Beta::Agents::Vaults::McpOauthTokenEndpointAuth::ClientSecretPost]
+                required :token_endpoint_auth, union: -> { OpenAI::Beta::Agents::Vaults::McpOauthTokenEndpointAuth }
+
+                # @!method initialize(client_id:, resource:, scope:, token_endpoint:, token_endpoint_auth:)
+                #   Configuration used to refresh an MCP OAuth access token, excluding secret
+                #   values.
+                #
+                #   @param client_id [String]
+                #     The OAuth client ID used when requesting a new access token.
+                #
+                #   @param resource [String, nil]
+                #     The resource URI sent to the OAuth token endpoint during refresh, if configured.
+                #
+                #   @param scope [String, nil]
+                #     Space-separated OAuth scopes requested during refresh, if configured.
+                #
+                #   @param token_endpoint [String]
+                #     The HTTPS OAuth token endpoint used for refresh.
+                #
+                #   @param token_endpoint_auth [OpenAI::Models::Beta::Agents::Vaults::McpOauthTokenEndpointAuth::None, OpenAI::Models::Beta::Agents::Vaults::McpOauthTokenEndpointAuth::ClientSecretBasic, OpenAI::Models::Beta::Agents::Vaults::McpOauthTokenEndpointAuth::ClientSecretPost]
+                #     How the OAuth client authenticates to the token endpoint, excluding its client
+                #     secret.
+              end
+            end
+
+            class StaticBearer < OpenAI::Internal::Type::BaseModel
+              # @!attribute mcp_server_url
+              #   The HTTPS MCP server URL authorized by this credential.
+              #
+              #   @return [String]
+              required :mcp_server_url, String
+
+              # @!attribute type
+              #   The type of the object. Always `static_bearer`.
+              #
+              #   @return [Symbol, :static_bearer]
+              required :type, const: :static_bearer
+
+              # @!method initialize(mcp_server_url:, type: :static_bearer)
+              #   Metadata for a bearer-token credential, without automatic OAuth refresh.
+              #
+              #   @param mcp_server_url [String]
+              #     The HTTPS MCP server URL authorized by this credential.
+              #
+              #   @param type [Symbol, :static_bearer]
+              #     The type of the object. Always `static_bearer`.
+            end
+
+            # @!method self.variants
+            #   @return [Array(OpenAI::Models::Beta::Agents::Vaults::CredentialAuth::McpOauth, OpenAI::Models::Beta::Agents::Vaults::CredentialAuth::StaticBearer)]
+          end
+        end
+      end
+    end
+  end
+end