openai 0.116.0 → 0.118.0

data/lib/openai/models/admin/organization/workload_identity_providers/federation_rule_retrieve_params.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Admin
+      module Organization
+        module WorkloadIdentityProviders
+          # @see OpenAI::Resources::Admin::Organization::WorkloadIdentityProviders::FederationRules#retrieve
+          class FederationRuleRetrieveParams < OpenAI::Internal::Type::BaseModel
+            extend OpenAI::Internal::Type::RequestParameters::Converter
+            include OpenAI::Internal::Type::RequestParameters
+
+            # @!attribute workload_identity_provider_id
+            #
+            #   @return [String]
+            required :workload_identity_provider_id, String
+
+            # @!attribute workload_identity_federation_rule_id
+            #
+            #   @return [String]
+            required :workload_identity_federation_rule_id, String
+
+            # @!method initialize(workload_identity_provider_id:, workload_identity_federation_rule_id:, request_options: {})
+            #   @param workload_identity_provider_id [String]
+            #   @param workload_identity_federation_rule_id [String]
+            #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/openai/models/admin/organization/workload_identity_providers/federation_rule_update_params.rb

@@ -0,0 +1,134 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Admin
+      module Organization
+        module WorkloadIdentityProviders
+          # @see OpenAI::Resources::Admin::Organization::WorkloadIdentityProviders::FederationRules#update
+          class FederationRuleUpdateParams < OpenAI::Internal::Type::BaseModel
+            extend OpenAI::Internal::Type::RequestParameters::Converter
+            include OpenAI::Internal::Type::RequestParameters
+
+            # @!attribute workload_identity_provider_id
+            #
+            #   @return [String]
+            required :workload_identity_provider_id, String
+
+            # @!attribute workload_identity_federation_rule_id
+            #
+            #   @return [String]
+            required :workload_identity_federation_rule_id, String
+
+            # @!attribute attribute_matchers
+            #
+            #   @return [Hash{Symbol=>String, Boolean, Integer, Float}, nil]
+            optional(
+              :attribute_matchers,
+              -> {
+                OpenAI::Internal::Type::HashOf[
+                  union: OpenAI::Admin::Organization::WorkloadIdentityProviders::FederationRuleUpdateParams::AttributeMatcher
+                ]
+              }
+            )
+
+            # @!attribute description
+            #
+            #   @return [String, nil]
+            optional :description, String, nil?: true
+
+            # @!attribute enabled
+            #
+            #   @return [Boolean, nil]
+            optional :enabled, OpenAI::Internal::Type::Boolean
+
+            # @!attribute name
+            #
+            #   @return [String, nil]
+            optional :name, String, nil?: true
+
+            # @!attribute permissions
+            #
+            #   @return [OpenAI::Models::Admin::Organization::WorkloadIdentityProviders::FederationRuleUpdateParams::Permissions::DefaultPermissionsParam, OpenAI::Models::Admin::Organization::WorkloadIdentityProviders::FederationRuleUpdateParams::Permissions::RestrictedPermissionsParam, nil]
+            optional(
+              :permissions,
+              union: -> {
+                OpenAI::Admin::Organization::WorkloadIdentityProviders::FederationRuleUpdateParams::Permissions
+              }
+            )
+
+            # @!method initialize(workload_identity_provider_id:, workload_identity_federation_rule_id:, attribute_matchers: nil, description: nil, enabled: nil, name: nil, permissions: nil, request_options: {})
+            #   @param workload_identity_provider_id [String]
+            #   @param workload_identity_federation_rule_id [String]
+            #   @param attribute_matchers [Hash{Symbol=>String, Boolean, Integer, Float}]
+            #   @param description [String, nil]
+            #   @param enabled [Boolean]
+            #   @param name [String, nil]
+            #   @param permissions [OpenAI::Models::Admin::Organization::WorkloadIdentityProviders::FederationRuleUpdateParams::Permissions::DefaultPermissionsParam, OpenAI::Models::Admin::Organization::WorkloadIdentityProviders::FederationRuleUpdateParams::Permissions::RestrictedPermissionsParam]
+            #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
+
+            module AttributeMatcher
+              extend OpenAI::Internal::Type::Union
+
+              variant String
+
+              variant OpenAI::Internal::Type::Boolean
+
+              variant Integer
+
+              variant Float
+
+              # @!method self.variants
+              #   @return [Array(String, Boolean, Integer, Float)]
+            end
+
+            module Permissions
+              extend OpenAI::Internal::Type::Union
+
+              variant(
+                -> {
+                  OpenAI::Admin::Organization::WorkloadIdentityProviders::FederationRuleUpdateParams::Permissions::DefaultPermissionsParam
+                }
+              )
+
+              variant(
+                -> {
+                  OpenAI::Admin::Organization::WorkloadIdentityProviders::FederationRuleUpdateParams::Permissions::RestrictedPermissionsParam
+                }
+              )
+
+              class DefaultPermissionsParam < OpenAI::Internal::Type::BaseModel
+                # @!attribute type
+                #
+                #   @return [Symbol, :service_account_default]
+                required :type, const: :service_account_default
+
+                # @!method initialize(type: :service_account_default)
+                #   @param type [Symbol, :service_account_default]
+              end
+
+              class RestrictedPermissionsParam < OpenAI::Internal::Type::BaseModel
+                # @!attribute scopes
+                #
+                #   @return [Array<String>]
+                required :scopes, OpenAI::Internal::Type::ArrayOf[String]
+
+                # @!attribute type
+                #
+                #   @return [Symbol, :restricted]
+                required :type, const: :restricted
+
+                # @!method initialize(scopes:, type: :restricted)
+                #   @param scopes [Array<String>]
+                #   @param type [Symbol, :restricted]
+              end
+
+              # @!method self.variants
+              #   @return [Array(OpenAI::Models::Admin::Organization::WorkloadIdentityProviders::FederationRuleUpdateParams::Permissions::DefaultPermissionsParam, OpenAI::Models::Admin::Organization::WorkloadIdentityProviders::FederationRuleUpdateParams::Permissions::RestrictedPermissionsParam)]
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/openai/models/beta/beta_response.rb

@@ -1855,6 +1855,7 @@ module OpenAI
             extend OpenAI::Internal::Type::Enum
 
             TTL_30M = :"30m"
+            TTL_12H = :"12h"
 
             # @!method self.values
             #   @return [Array<Symbol>]

data/lib/openai/models/beta/beta_response_usage.rb

@@ -68,7 +68,15 @@ module OpenAI
           #   @return [Integer]
           required :cached_tokens, Integer
 
-          # @!method initialize(cache_write_tokens:, cached_tokens:)
+          # @!attribute cache_write_tokens_details
+          #
+          #   @return [OpenAI::Models::Beta::BetaResponseUsage::InputTokensDetails::CacheWriteTokensDetails, nil]
+          optional(
+            :cache_write_tokens_details,
+            -> { OpenAI::Beta::BetaResponseUsage::InputTokensDetails::CacheWriteTokensDetails }
+          )
+
+          # @!method initialize(cache_write_tokens:, cached_tokens:, cache_write_tokens_details: nil)
           #   A detailed breakdown of the input tokens.
           #
           #   @param cache_write_tokens [Integer]
@@ -77,6 +85,30 @@ module OpenAI
           #   @param cached_tokens [Integer]
           #     The number of tokens that were retrieved from the cache.
           #     [More on prompt caching](https://developers.openai.com/api/docs/guides/prompt-caching).
+          #
+          #   @param cache_write_tokens_details [OpenAI::Models::Beta::BetaResponseUsage::InputTokensDetails::CacheWriteTokensDetails]
+
+          # @see OpenAI::Models::Beta::BetaResponseUsage::InputTokensDetails#cache_write_tokens_details
+          class CacheWriteTokensDetails < OpenAI::Internal::Type::BaseModel
+            # @!attribute ttl_12h_tokens
+            #   The number of input tokens written with 12-hour retention.
+            #
+            #   @return [Integer]
+            required :ttl_12h_tokens, Integer
+
+            # @!attribute ttl_30m_tokens
+            #   The number of input tokens written with 30-minute retention.
+            #
+            #   @return [Integer]
+            required :ttl_30m_tokens, Integer
+
+            # @!method initialize(ttl_12h_tokens:, ttl_30m_tokens:)
+            #   @param ttl_12h_tokens [Integer]
+            #     The number of input tokens written with 12-hour retention.
+            #
+            #   @param ttl_30m_tokens [Integer]
+            #     The number of input tokens written with 30-minute retention.
+          end
         end
 
         # @see OpenAI::Models::Beta::BetaResponseUsage#output_tokens_details

data/lib/openai/models/beta/beta_responses_client_event.rb

@@ -253,7 +253,7 @@ module OpenAI
           #   request can write up to four breakpoints. For cache matching, OpenAI considers
           #   up to the latest 80 breakpoints in the conversation, without a content-block
           #   lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
-          #   `ttl` defaults to `30m`, which is currently the only supported value. See the
+          #   `ttl` defaults to `30m`. Supported lifetimes depend on the API. See the
           #   [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
           #   for current details.
           #
@@ -617,7 +617,7 @@ module OpenAI
           #     request can write up to four breakpoints. For cache matching, OpenAI considers
           #     up to the latest 80 breakpoints in the conversation, without a content-block
           #     lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
-          #     `ttl` defaults to `30m`, which is currently the only supported value. See the
+          #     `ttl` defaults to `30m`. Supported lifetimes depend on the API. See the
           #     [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
           #     for current details.
           #
@@ -1884,8 +1884,8 @@ module OpenAI
 
             # @!attribute ttl
             #   The minimum lifetime applied to every implicit and explicit cache breakpoint
-            #   written by the request. Defaults to `30m`, which is currently the only supported
-            #   value. The backend may retain cache entries for longer.
+            #   written by the request. Supported values are `30m` (the default) and `12h`. The
+            #   backend may retain cache entries for longer.
             #
             #   @return [Symbol, OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::PromptCacheOptions::Ttl, nil]
             optional(
@@ -1900,7 +1900,7 @@ module OpenAI
             #   request can write up to four breakpoints. For cache matching, OpenAI considers
             #   up to the latest 80 breakpoints in the conversation, without a content-block
             #   lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
-            #   `ttl` defaults to `30m`, which is currently the only supported value. See the
+            #   `ttl` defaults to `30m`. Supported lifetimes depend on the API. See the
             #   [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
             #   for current details.
             #
@@ -1922,8 +1922,8 @@ module OpenAI
             #
             #   @param ttl [Symbol, OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::PromptCacheOptions::Ttl]
             #     The minimum lifetime applied to every implicit and explicit cache breakpoint
-            #     written by the request. Defaults to `30m`, which is currently the only supported
-            #     value. The backend may retain cache entries for longer.
+            #     written by the request. Supported values are `30m` (the default) and `12h`. The
+            #     backend may retain cache entries for longer.
 
             # Controls whether OpenAI automatically creates an implicit cache breakpoint.
             # Defaults to `implicit`. With `implicit`, OpenAI creates one implicit breakpoint
@@ -1944,14 +1944,15 @@ module OpenAI
             end
 
             # The minimum lifetime applied to every implicit and explicit cache breakpoint
-            # written by the request. Defaults to `30m`, which is currently the only supported
-            # value. The backend may retain cache entries for longer.
+            # written by the request. Supported values are `30m` (the default) and `12h`. The
+            # backend may retain cache entries for longer.
             #
             # @see OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::PromptCacheOptions#ttl
             module Ttl
               extend OpenAI::Internal::Type::Enum
 
               TTL_30M = :"30m"
+              TTL_12H = :"12h"
 
               # @!method self.values
               #   @return [Array<Symbol>]

data/lib/openai/models/beta/chatkit/chat_session_workflow_param.rb

@@ -15,7 +15,7 @@ module OpenAI
           #   State variables forwarded to the workflow. Keys may be up to 64 characters,
           #   values must be primitive types, and the map defaults to an empty object.
           #
-          #   @return [Hash{Symbol=>String, Boolean, Float}, nil]
+          #   @return [Hash{Symbol=>String, Integer, Boolean, Float}, nil]
           optional(
             :state_variables,
             -> {
@@ -42,7 +42,7 @@ module OpenAI
           #   @param id [String]
           #     Identifier for the workflow invoked by the session.
           #
-          #   @param state_variables [Hash{Symbol=>String, Boolean, Float}]
+          #   @param state_variables [Hash{Symbol=>String, Integer, Boolean, Float}]
           #     State variables forwarded to the workflow. Keys may be up to 64 characters,
           #     values must be primitive types, and the map defaults to an empty object.
           #
@@ -57,12 +57,14 @@ module OpenAI
 
             variant String
 
+            variant Integer
+
             variant OpenAI::Internal::Type::Boolean
 
             variant Float
 
             # @!method self.variants
-            #   @return [Array(String, Boolean, Float)]
+            #   @return [Array(String, Integer, Boolean, Float)]
           end
 
           # @see OpenAI::Models::Beta::ChatKit::ChatSessionWorkflowParam#tracing

data/lib/openai/models/beta/chatkit_workflow.rb

@@ -14,7 +14,7 @@ module OpenAI
         #   State variable key-value pairs applied when invoking the workflow. Defaults to
         #   null when no overrides were provided.
         #
-        #   @return [Hash{Symbol=>String, Boolean, Float}, nil]
+        #   @return [Hash{Symbol=>String, Integer, Boolean, Float}, nil]
         required(
           :state_variables,
           -> { OpenAI::Internal::Type::HashOf[union: OpenAI::Beta::ChatKitWorkflow::StateVariable] },
@@ -40,7 +40,7 @@ module OpenAI
         #   @param id [String]
         #     Identifier of the workflow backing the session.
         #
-        #   @param state_variables [Hash{Symbol=>String, Boolean, Float}, nil]
+        #   @param state_variables [Hash{Symbol=>String, Integer, Boolean, Float}, nil]
         #     State variable key-value pairs applied when invoking the workflow. Defaults to
         #     null when no overrides were provided.
         #
@@ -55,12 +55,14 @@ module OpenAI
 
           variant String
 
+          variant Integer
+
           variant OpenAI::Internal::Type::Boolean
 
           variant Float
 
           # @!method self.variants
-          #   @return [Array(String, Boolean, Float)]
+          #   @return [Array(String, Integer, Boolean, Float)]
         end
 
         # @see OpenAI::Models::Beta::ChatKitWorkflow#tracing

data/lib/openai/models/beta/response_compact_params.rb

@@ -55,7 +55,7 @@ module OpenAI
         #   request can write up to four breakpoints. For cache matching, OpenAI considers
         #   up to the latest 80 breakpoints in the conversation, without a content-block
         #   lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
-        #   `ttl` defaults to `30m`, which is currently the only supported value. See the
+        #   `ttl` defaults to `30m`. Supported lifetimes depend on the API. See the
         #   [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
         #   for current details.
         #
@@ -139,7 +139,7 @@ module OpenAI
         #     request can write up to four breakpoints. For cache matching, OpenAI considers
         #     up to the latest 80 breakpoints in the conversation, without a content-block
         #     lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
-        #     `ttl` defaults to `30m`, which is currently the only supported value. See the
+        #     `ttl` defaults to `30m`. Supported lifetimes depend on the API. See the
         #     [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
         #     for current details.
         #
@@ -830,7 +830,7 @@ module OpenAI
           #   request can write up to four breakpoints. For cache matching, OpenAI considers
           #   up to the latest 80 breakpoints in the conversation, without a content-block
           #   lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
-          #   `ttl` defaults to `30m`, which is currently the only supported value. See the
+          #   `ttl` defaults to `30m`. Supported lifetimes depend on the API. See the
           #   [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
           #   for current details.
           #

data/lib/openai/models/beta/response_create_params.rb

@@ -182,7 +182,7 @@ module OpenAI
         #   request can write up to four breakpoints. For cache matching, OpenAI considers
         #   up to the latest 80 breakpoints in the conversation, without a content-block
         #   lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
-        #   `ttl` defaults to `30m`, which is currently the only supported value. See the
+        #   `ttl` defaults to `30m`. Supported lifetimes depend on the API. See the
         #   [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
         #   for current details.
         #
@@ -494,7 +494,7 @@ module OpenAI
         #     request can write up to four breakpoints. For cache matching, OpenAI considers
         #     up to the latest 80 breakpoints in the conversation, without a content-block
         #     lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
-        #     `ttl` defaults to `30m`, which is currently the only supported value. See the
+        #     `ttl` defaults to `30m`. Supported lifetimes depend on the API. See the
         #     [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
         #     for current details.
         #
@@ -1533,8 +1533,8 @@ module OpenAI
 
           # @!attribute ttl
           #   The minimum lifetime applied to every implicit and explicit cache breakpoint
-          #   written by the request. Defaults to `30m`, which is currently the only supported
-          #   value. The backend may retain cache entries for longer.
+          #   written by the request. Supported values are `30m` (the default) and `12h`. The
+          #   backend may retain cache entries for longer.
           #
           #   @return [Symbol, OpenAI::Models::Beta::ResponseCreateParams::PromptCacheOptions::Ttl, nil]
           optional :ttl, enum: -> { OpenAI::Beta::ResponseCreateParams::PromptCacheOptions::Ttl }
@@ -1546,7 +1546,7 @@ module OpenAI
           #   request can write up to four breakpoints. For cache matching, OpenAI considers
           #   up to the latest 80 breakpoints in the conversation, without a content-block
           #   lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
-          #   `ttl` defaults to `30m`, which is currently the only supported value. See the
+          #   `ttl` defaults to `30m`. Supported lifetimes depend on the API. See the
           #   [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
           #   for current details.
           #
@@ -1568,8 +1568,8 @@ module OpenAI
           #
           #   @param ttl [Symbol, OpenAI::Models::Beta::ResponseCreateParams::PromptCacheOptions::Ttl]
           #     The minimum lifetime applied to every implicit and explicit cache breakpoint
-          #     written by the request. Defaults to `30m`, which is currently the only supported
-          #     value. The backend may retain cache entries for longer.
+          #     written by the request. Supported values are `30m` (the default) and `12h`. The
+          #     backend may retain cache entries for longer.
 
           # Controls whether OpenAI automatically creates an implicit cache breakpoint.
           # Defaults to `implicit`. With `implicit`, OpenAI creates one implicit breakpoint
@@ -1590,14 +1590,15 @@ module OpenAI
           end
 
           # The minimum lifetime applied to every implicit and explicit cache breakpoint
-          # written by the request. Defaults to `30m`, which is currently the only supported
-          # value. The backend may retain cache entries for longer.
+          # written by the request. Supported values are `30m` (the default) and `12h`. The
+          # backend may retain cache entries for longer.
           #
           # @see OpenAI::Models::Beta::ResponseCreateParams::PromptCacheOptions#ttl
           module Ttl
             extend OpenAI::Internal::Type::Enum
 
             TTL_30M = :"30m"
+            TTL_12H = :"12h"
 
             # @!method self.values
             #   @return [Array<Symbol>]

data/lib/openai/models/chat/completion_create_params.rb

@@ -212,7 +212,7 @@ module OpenAI
         #   request can write up to four breakpoints. For cache matching, OpenAI considers
         #   up to the latest 80 breakpoints in the conversation, without a content-block
         #   lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
-        #   `ttl` defaults to `30m`, which is currently the only supported value. See the
+        #   `ttl` defaults to `30m`. Supported lifetimes depend on the API. See the
         #   [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
         #   for current details.
         #
@@ -569,7 +569,7 @@ module OpenAI
         #     request can write up to four breakpoints. For cache matching, OpenAI considers
         #     up to the latest 80 breakpoints in the conversation, without a content-block
         #     lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
-        #     `ttl` defaults to `30m`, which is currently the only supported value. See the
+        #     `ttl` defaults to `30m`. Supported lifetimes depend on the API. See the
         #     [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
         #     for current details.
         #
@@ -979,7 +979,7 @@ module OpenAI
           #   request can write up to four breakpoints. For cache matching, OpenAI considers
           #   up to the latest 80 breakpoints in the conversation, without a content-block
           #   lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
-          #   `ttl` defaults to `30m`, which is currently the only supported value. See the
+          #   `ttl` defaults to `30m`. Supported lifetimes depend on the API. See the
           #   [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
           #   for current details.
           #

data/lib/openai/models/responses/response.rb

@@ -1239,6 +1239,7 @@ module OpenAI
             extend OpenAI::Internal::Type::Enum
 
             TTL_30M = :"30m"
+            TTL_12H = :"12h"
 
             # @!method self.values
             #   @return [Array<Symbol>]

data/lib/openai/models/responses/response_compact_params.rb

@@ -55,7 +55,7 @@ module OpenAI
         #   request can write up to four breakpoints. For cache matching, OpenAI considers
         #   up to the latest 80 breakpoints in the conversation, without a content-block
         #   lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
-        #   `ttl` defaults to `30m`, which is currently the only supported value. See the
+        #   `ttl` defaults to `30m`. Supported lifetimes depend on the API. See the
         #   [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
         #   for current details.
         #
@@ -132,7 +132,7 @@ module OpenAI
         #     request can write up to four breakpoints. For cache matching, OpenAI considers
         #     up to the latest 80 breakpoints in the conversation, without a content-block
         #     lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
-        #     `ttl` defaults to `30m`, which is currently the only supported value. See the
+        #     `ttl` defaults to `30m`. Supported lifetimes depend on the API. See the
         #     [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
         #     for current details.
         #
@@ -833,7 +833,7 @@ module OpenAI
           #   request can write up to four breakpoints. For cache matching, OpenAI considers
           #   up to the latest 80 breakpoints in the conversation, without a content-block
           #   lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
-          #   `ttl` defaults to `30m`, which is currently the only supported value. See the
+          #   `ttl` defaults to `30m`. Supported lifetimes depend on the API. See the
           #   [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
           #   for current details.
           #

data/lib/openai/models/responses/response_create_params.rb

@@ -182,7 +182,7 @@ module OpenAI
         #   request can write up to four breakpoints. For cache matching, OpenAI considers
         #   up to the latest 80 breakpoints in the conversation, without a content-block
         #   lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
-        #   `ttl` defaults to `30m`, which is currently the only supported value. See the
+        #   `ttl` defaults to `30m`. Supported lifetimes depend on the API. See the
         #   [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
         #   for current details.
         #
@@ -491,7 +491,7 @@ module OpenAI
         #     request can write up to four breakpoints. For cache matching, OpenAI considers
         #     up to the latest 80 breakpoints in the conversation, without a content-block
         #     lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
-        #     `ttl` defaults to `30m`, which is currently the only supported value. See the
+        #     `ttl` defaults to `30m`. Supported lifetimes depend on the API. See the
         #     [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
         #     for current details.
         #
@@ -887,8 +887,8 @@ module OpenAI
 
           # @!attribute ttl
           #   The minimum lifetime applied to every implicit and explicit cache breakpoint
-          #   written by the request. Defaults to `30m`, which is currently the only supported
-          #   value. The backend may retain cache entries for longer.
+          #   written by the request. Supported values are `30m` (the default) and `12h`. The
+          #   backend may retain cache entries for longer.
           #
           #   @return [Symbol, OpenAI::Models::Responses::ResponseCreateParams::PromptCacheOptions::Ttl, nil]
           optional :ttl, enum: -> { OpenAI::Responses::ResponseCreateParams::PromptCacheOptions::Ttl }
@@ -900,7 +900,7 @@ module OpenAI
           #   request can write up to four breakpoints. For cache matching, OpenAI considers
           #   up to the latest 80 breakpoints in the conversation, without a content-block
           #   lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
-          #   `ttl` defaults to `30m`, which is currently the only supported value. See the
+          #   `ttl` defaults to `30m`. Supported lifetimes depend on the API. See the
           #   [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
           #   for current details.
           #
@@ -922,8 +922,8 @@ module OpenAI
           #
           #   @param ttl [Symbol, OpenAI::Models::Responses::ResponseCreateParams::PromptCacheOptions::Ttl]
           #     The minimum lifetime applied to every implicit and explicit cache breakpoint
-          #     written by the request. Defaults to `30m`, which is currently the only supported
-          #     value. The backend may retain cache entries for longer.
+          #     written by the request. Supported values are `30m` (the default) and `12h`. The
+          #     backend may retain cache entries for longer.
 
           # Controls whether OpenAI automatically creates an implicit cache breakpoint.
           # Defaults to `implicit`. With `implicit`, OpenAI creates one implicit breakpoint
@@ -944,14 +944,15 @@ module OpenAI
           end
 
           # The minimum lifetime applied to every implicit and explicit cache breakpoint
-          # written by the request. Defaults to `30m`, which is currently the only supported
-          # value. The backend may retain cache entries for longer.
+          # written by the request. Supported values are `30m` (the default) and `12h`. The
+          # backend may retain cache entries for longer.
           #
           # @see OpenAI::Models::Responses::ResponseCreateParams::PromptCacheOptions#ttl
           module Ttl
             extend OpenAI::Internal::Type::Enum
 
             TTL_30M = :"30m"
+            TTL_12H = :"12h"
 
             # @!method self.values
             #   @return [Array<Symbol>]

data/lib/openai/models/responses/response_usage.rb

@@ -68,7 +68,15 @@ module OpenAI
           #   @return [Integer]
           required :cached_tokens, Integer
 
-          # @!method initialize(cache_write_tokens:, cached_tokens:)
+          # @!attribute cache_write_tokens_details
+          #
+          #   @return [OpenAI::Models::Responses::ResponseUsage::InputTokensDetails::CacheWriteTokensDetails, nil]
+          optional(
+            :cache_write_tokens_details,
+            -> { OpenAI::Responses::ResponseUsage::InputTokensDetails::CacheWriteTokensDetails }
+          )
+
+          # @!method initialize(cache_write_tokens:, cached_tokens:, cache_write_tokens_details: nil)
           #   A detailed breakdown of the input tokens.
           #
           #   @param cache_write_tokens [Integer]
@@ -77,6 +85,30 @@ module OpenAI
           #   @param cached_tokens [Integer]
           #     The number of tokens that were retrieved from the cache.
           #     [More on prompt caching](https://developers.openai.com/api/docs/guides/prompt-caching).
+          #
+          #   @param cache_write_tokens_details [OpenAI::Models::Responses::ResponseUsage::InputTokensDetails::CacheWriteTokensDetails]
+
+          # @see OpenAI::Models::Responses::ResponseUsage::InputTokensDetails#cache_write_tokens_details
+          class CacheWriteTokensDetails < OpenAI::Internal::Type::BaseModel
+            # @!attribute ttl_12h_tokens
+            #   The number of input tokens written with 12-hour retention.
+            #
+            #   @return [Integer]
+            required :ttl_12h_tokens, Integer
+
+            # @!attribute ttl_30m_tokens
+            #   The number of input tokens written with 30-minute retention.
+            #
+            #   @return [Integer]
+            required :ttl_30m_tokens, Integer
+
+            # @!method initialize(ttl_12h_tokens:, ttl_30m_tokens:)
+            #   @param ttl_12h_tokens [Integer]
+            #     The number of input tokens written with 12-hour retention.
+            #
+            #   @param ttl_30m_tokens [Integer]
+            #     The number of input tokens written with 30-minute retention.
+          end
         end
 
         # @see OpenAI::Models::Responses::ResponseUsage#output_tokens_details