turbopuffer 2.9.0 → 2.10.0

data/rbi/turbopuffer/resources/namespaces.rbi

@@ -73,7 +73,10 @@ module Turbopuffer
           aggregate_by: T::Hash[Symbol, T.anything],
           compute_attributes: T::Hash[Symbol, T.anything],
           consistency:
-            Turbopuffer::NamespaceExplainQueryParams::Consistency::OrHash,
+            T.any(
+              Turbopuffer::NamespaceExplainQueryParams::Consistency::Strong::OrHash,
+              Turbopuffer::NamespaceExplainQueryParams::Consistency::Eventual::OrHash
+            ),
           distance_metric: Turbopuffer::DistanceMetric::OrSymbol,
           exclude_attributes: T::Array[String],
           filters: T.anything,
@@ -162,7 +165,10 @@ module Turbopuffer
             T::Array[Turbopuffer::NamespaceMultiQueryParams::Query::OrHash],
           namespace: String,
           consistency:
-            Turbopuffer::NamespaceMultiQueryParams::Consistency::OrHash,
+            T.any(
+              Turbopuffer::NamespaceMultiQueryParams::Consistency::Strong::OrHash,
+              Turbopuffer::NamespaceMultiQueryParams::Consistency::Eventual::OrHash
+            ),
           limit: T.any(Integer, Turbopuffer::RerankLimit::OrHash),
           offset: Integer,
           rerank_by: T.anything,
@@ -214,7 +220,11 @@ module Turbopuffer
           namespace: T.nilable(String),
           aggregate_by: T::Hash[Symbol, T.anything],
           compute_attributes: T::Hash[Symbol, T.anything],
-          consistency: Turbopuffer::NamespaceQueryParams::Consistency::OrHash,
+          consistency:
+            T.any(
+              Turbopuffer::NamespaceQueryParams::Consistency::Strong::OrHash,
+              Turbopuffer::NamespaceQueryParams::Consistency::Eventual::OrHash
+            ),
           distance_metric: Turbopuffer::DistanceMetric::OrSymbol,
           exclude_attributes: T::Array[String],
           filters: T.anything,

data/sig/turbopuffer/internal/telemetry.rbs

@@ -4,6 +4,11 @@ module Turbopuffer
       ENV_VAR: String
       HEADER: String
       SAMPLE_RATE_HEADER: String
+      REQUEST_ID_ALPHABET: String
+      REQUEST_ID_BYTES: Integer
+      REQUEST_ID_HEADER: String
+      REQUEST_ID_PREFIX: String
+      REQUEST_ID_RANDOM_BYTES: Integer
 
       ENVELOPE_VERSION: Integer
 
@@ -31,6 +36,10 @@ module Turbopuffer
 
       def self.random: -> Float
 
+      def self.encode_base32: (String bytes) -> String
+
+      def self.new_request_id: (Time now, ?random: String) -> String
+
       def self.buffer_for: (
         bool? enabled,
         String api_key,
@@ -61,15 +70,19 @@ module Turbopuffer
 
         def observe_response: (top response) -> void
 
+        def sample: -> Float?
+
         def record: (
           method: Symbol | String,
           url: URI::Generic | String,
           status: Integer,
           retries: Integer,
           durations: ::Hash[Symbol, Integer],
+          sample_rate: Float,
           ?server_total_ms: Numeric?,
           ?error: String?,
-          ?reused: bool?
+          ?reused: bool?,
+          ?request_id: String?
         ) -> void
 
         def take: -> Turbopuffer::Internal::Telemetry::Batch?

data/sig/turbopuffer/models/encryption.rbs

@@ -7,16 +7,35 @@ module Turbopuffer
     module Encryption
       extend Turbopuffer::Internal::Type::Union
 
-      type customer_managed = { key_name: String, mode: :"customer-managed" }
+      type customer_managed =
+        {
+          key_name: String,
+          mode: :"customer-managed",
+          encryption_context: ::Hash[Symbol, String]
+        }
 
       class CustomerManaged < Turbopuffer::Internal::Type::BaseModel
         attr_accessor key_name: String
 
         attr_accessor mode: :"customer-managed"
 
-        def initialize: (key_name: String, ?mode: :"customer-managed") -> void
+        attr_reader encryption_context: ::Hash[Symbol, String]?
 
-        def to_hash: -> { key_name: String, mode: :"customer-managed" }
+        def encryption_context=: (
+          ::Hash[Symbol, String]
+        ) -> ::Hash[Symbol, String]
+
+        def initialize: (
+          key_name: String,
+          ?encryption_context: ::Hash[Symbol, String],
+          ?mode: :"customer-managed"
+        ) -> void
+
+        def to_hash: -> {
+          key_name: String,
+          mode: :"customer-managed",
+          encryption_context: ::Hash[Symbol, String]
+        }
       end
 
       type default = { mode: :default }

data/sig/turbopuffer/models/namespace_explain_query_params.rbs

@@ -5,7 +5,7 @@ module Turbopuffer
         namespace: String,
         aggregate_by: ::Hash[Symbol, top],
         compute_attributes: ::Hash[Symbol, top],
-        consistency: Turbopuffer::NamespaceExplainQueryParams::Consistency,
+        consistency: Turbopuffer::Models::NamespaceExplainQueryParams::consistency,
         distance_metric: Turbopuffer::Models::distance_metric,
         exclude_attributes: ::Array[String],
         filters: top,
@@ -35,11 +35,11 @@ module Turbopuffer
 
       def compute_attributes=: (::Hash[Symbol, top]) -> ::Hash[Symbol, top]
 
-      attr_reader consistency: Turbopuffer::NamespaceExplainQueryParams::Consistency?
+      attr_reader consistency: Turbopuffer::Models::NamespaceExplainQueryParams::consistency?
 
       def consistency=: (
-        Turbopuffer::NamespaceExplainQueryParams::Consistency
-      ) -> Turbopuffer::NamespaceExplainQueryParams::Consistency
+        Turbopuffer::Models::NamespaceExplainQueryParams::consistency
+      ) -> Turbopuffer::Models::NamespaceExplainQueryParams::consistency
 
       attr_reader distance_metric: Turbopuffer::Models::distance_metric?
 
@@ -93,7 +93,7 @@ module Turbopuffer
         ?namespace: String,
         ?aggregate_by: ::Hash[Symbol, top],
         ?compute_attributes: ::Hash[Symbol, top],
-        ?consistency: Turbopuffer::NamespaceExplainQueryParams::Consistency,
+        ?consistency: Turbopuffer::Models::NamespaceExplainQueryParams::consistency,
         ?distance_metric: Turbopuffer::Models::distance_metric,
         ?exclude_attributes: ::Array[String],
         ?filters: top,
@@ -111,7 +111,7 @@ module Turbopuffer
         namespace: String,
         aggregate_by: ::Hash[Symbol, top],
         compute_attributes: ::Hash[Symbol, top],
-        consistency: Turbopuffer::NamespaceExplainQueryParams::Consistency,
+        consistency: Turbopuffer::Models::NamespaceExplainQueryParams::consistency,
         distance_metric: Turbopuffer::Models::distance_metric,
         exclude_attributes: ::Array[String],
         filters: top,
@@ -126,38 +126,40 @@ module Turbopuffer
       }
 
       type consistency =
-        {
-          level: Turbopuffer::Models::NamespaceExplainQueryParams::Consistency::level
-        }
+        Turbopuffer::NamespaceExplainQueryParams::Consistency::Strong
+        | Turbopuffer::NamespaceExplainQueryParams::Consistency::Eventual
 
-      class Consistency < Turbopuffer::Internal::Type::BaseModel
-        attr_reader level: Turbopuffer::Models::NamespaceExplainQueryParams::Consistency::level?
+      module Consistency
+        extend Turbopuffer::Internal::Type::Union
+
+        type strong = { level: :strong }
 
-        def level=: (
-          Turbopuffer::Models::NamespaceExplainQueryParams::Consistency::level
-        ) -> Turbopuffer::Models::NamespaceExplainQueryParams::Consistency::level
+        class Strong < Turbopuffer::Internal::Type::BaseModel
+          attr_accessor level: :strong
 
-        def initialize: (
-          ?level: Turbopuffer::Models::NamespaceExplainQueryParams::Consistency::level
-        ) -> void
+          def initialize: (?level: :strong) -> void
 
-        def to_hash: -> {
-          level: Turbopuffer::Models::NamespaceExplainQueryParams::Consistency::level
-        }
+          def to_hash: -> { level: :strong }
+        end
 
-        type level = :strong | :eventual
+        type eventual = { level: :eventual, max_staleness_seconds: Integer }
 
-        module Level
-          extend Turbopuffer::Internal::Type::Enum
+        class Eventual < Turbopuffer::Internal::Type::BaseModel
+          attr_accessor level: :eventual
 
-          # Strong consistency. Requires a round-trip to object storage to fetch the latest writes.
-          STRONG: :strong
+          attr_reader max_staleness_seconds: Integer?
 
-          # Eventual consistency. Does not require a round-trip to object storage, but may not see the latest writes.
-          EVENTUAL: :eventual
+          def max_staleness_seconds=: (Integer) -> Integer
 
-          def self?.values: -> ::Array[Turbopuffer::Models::NamespaceExplainQueryParams::Consistency::level]
+          def initialize: (
+            ?max_staleness_seconds: Integer,
+            ?level: :eventual
+          ) -> void
+
+          def to_hash: -> { level: :eventual, max_staleness_seconds: Integer }
         end
+
+        def self?.variants: -> ::Array[Turbopuffer::Models::NamespaceExplainQueryParams::consistency]
       end
 
       type limit = Integer | Turbopuffer::Limit

data/sig/turbopuffer/models/namespace_multi_query_params.rbs

@@ -4,7 +4,7 @@ module Turbopuffer
       {
         namespace: String,
         queries: ::Array[Turbopuffer::NamespaceMultiQueryParams::Query],
-        consistency: Turbopuffer::NamespaceMultiQueryParams::Consistency,
+        consistency: Turbopuffer::Models::NamespaceMultiQueryParams::consistency,
         limit: Turbopuffer::Models::NamespaceMultiQueryParams::limit,
         offset: Integer,
         rerank_by: top,
@@ -22,11 +22,11 @@ module Turbopuffer
 
       attr_accessor queries: ::Array[Turbopuffer::NamespaceMultiQueryParams::Query]
 
-      attr_reader consistency: Turbopuffer::NamespaceMultiQueryParams::Consistency?
+      attr_reader consistency: Turbopuffer::Models::NamespaceMultiQueryParams::consistency?
 
       def consistency=: (
-        Turbopuffer::NamespaceMultiQueryParams::Consistency
-      ) -> Turbopuffer::NamespaceMultiQueryParams::Consistency
+        Turbopuffer::Models::NamespaceMultiQueryParams::consistency
+      ) -> Turbopuffer::Models::NamespaceMultiQueryParams::consistency
 
       attr_reader limit: Turbopuffer::Models::NamespaceMultiQueryParams::limit?
 
@@ -51,7 +51,7 @@ module Turbopuffer
       def initialize: (
         queries: ::Array[Turbopuffer::NamespaceMultiQueryParams::Query],
         ?namespace: String,
-        ?consistency: Turbopuffer::NamespaceMultiQueryParams::Consistency,
+        ?consistency: Turbopuffer::Models::NamespaceMultiQueryParams::consistency,
         ?limit: Turbopuffer::Models::NamespaceMultiQueryParams::limit,
         ?offset: Integer,
         ?rerank_by: top,
@@ -62,7 +62,7 @@ module Turbopuffer
       def to_hash: -> {
         namespace: String,
         queries: ::Array[Turbopuffer::NamespaceMultiQueryParams::Query],
-        consistency: Turbopuffer::NamespaceMultiQueryParams::Consistency,
+        consistency: Turbopuffer::Models::NamespaceMultiQueryParams::consistency,
         limit: Turbopuffer::Models::NamespaceMultiQueryParams::limit,
         offset: Integer,
         rerank_by: top,
@@ -174,38 +174,40 @@ module Turbopuffer
       end
 
       type consistency =
-        {
-          level: Turbopuffer::Models::NamespaceMultiQueryParams::Consistency::level
-        }
+        Turbopuffer::NamespaceMultiQueryParams::Consistency::Strong
+        | Turbopuffer::NamespaceMultiQueryParams::Consistency::Eventual
 
-      class Consistency < Turbopuffer::Internal::Type::BaseModel
-        attr_reader level: Turbopuffer::Models::NamespaceMultiQueryParams::Consistency::level?
+      module Consistency
+        extend Turbopuffer::Internal::Type::Union
 
-        def level=: (
-          Turbopuffer::Models::NamespaceMultiQueryParams::Consistency::level
-        ) -> Turbopuffer::Models::NamespaceMultiQueryParams::Consistency::level
+        type strong = { level: :strong }
 
-        def initialize: (
-          ?level: Turbopuffer::Models::NamespaceMultiQueryParams::Consistency::level
-        ) -> void
+        class Strong < Turbopuffer::Internal::Type::BaseModel
+          attr_accessor level: :strong
 
-        def to_hash: -> {
-          level: Turbopuffer::Models::NamespaceMultiQueryParams::Consistency::level
-        }
+          def initialize: (?level: :strong) -> void
+
+          def to_hash: -> { level: :strong }
+        end
 
-        type level = :strong | :eventual
+        type eventual = { level: :eventual, max_staleness_seconds: Integer }
 
-        module Level
-          extend Turbopuffer::Internal::Type::Enum
+        class Eventual < Turbopuffer::Internal::Type::BaseModel
+          attr_accessor level: :eventual
 
-          # Strong consistency. Requires a round-trip to object storage to fetch the latest writes.
-          STRONG: :strong
+          attr_reader max_staleness_seconds: Integer?
 
-          # Eventual consistency. Does not require a round-trip to object storage, but may not see the latest writes.
-          EVENTUAL: :eventual
+          def max_staleness_seconds=: (Integer) -> Integer
 
-          def self?.values: -> ::Array[Turbopuffer::Models::NamespaceMultiQueryParams::Consistency::level]
+          def initialize: (
+            ?max_staleness_seconds: Integer,
+            ?level: :eventual
+          ) -> void
+
+          def to_hash: -> { level: :eventual, max_staleness_seconds: Integer }
         end
+
+        def self?.variants: -> ::Array[Turbopuffer::Models::NamespaceMultiQueryParams::consistency]
       end
 
       type limit = Integer | Turbopuffer::RerankLimit

data/sig/turbopuffer/models/namespace_query_params.rbs

@@ -5,7 +5,7 @@ module Turbopuffer
         namespace: String,
         aggregate_by: ::Hash[Symbol, top],
         compute_attributes: ::Hash[Symbol, top],
-        consistency: Turbopuffer::NamespaceQueryParams::Consistency,
+        consistency: Turbopuffer::Models::NamespaceQueryParams::consistency,
         distance_metric: Turbopuffer::Models::distance_metric,
         exclude_attributes: ::Array[String],
         filters: top,
@@ -36,11 +36,11 @@ module Turbopuffer
 
       def compute_attributes=: (::Hash[Symbol, top]) -> ::Hash[Symbol, top]
 
-      attr_reader consistency: Turbopuffer::NamespaceQueryParams::Consistency?
+      attr_reader consistency: Turbopuffer::Models::NamespaceQueryParams::consistency?
 
       def consistency=: (
-        Turbopuffer::NamespaceQueryParams::Consistency
-      ) -> Turbopuffer::NamespaceQueryParams::Consistency
+        Turbopuffer::Models::NamespaceQueryParams::consistency
+      ) -> Turbopuffer::Models::NamespaceQueryParams::consistency
 
       attr_reader distance_metric: Turbopuffer::Models::distance_metric?
 
@@ -100,7 +100,7 @@ module Turbopuffer
         ?namespace: String,
         ?aggregate_by: ::Hash[Symbol, top],
         ?compute_attributes: ::Hash[Symbol, top],
-        ?consistency: Turbopuffer::NamespaceQueryParams::Consistency,
+        ?consistency: Turbopuffer::Models::NamespaceQueryParams::consistency,
         ?distance_metric: Turbopuffer::Models::distance_metric,
         ?exclude_attributes: ::Array[String],
         ?filters: top,
@@ -119,7 +119,7 @@ module Turbopuffer
         namespace: String,
         aggregate_by: ::Hash[Symbol, top],
         compute_attributes: ::Hash[Symbol, top],
-        consistency: Turbopuffer::NamespaceQueryParams::Consistency,
+        consistency: Turbopuffer::Models::NamespaceQueryParams::consistency,
         distance_metric: Turbopuffer::Models::distance_metric,
         exclude_attributes: ::Array[String],
         filters: top,
@@ -135,36 +135,40 @@ module Turbopuffer
       }
 
       type consistency =
-        { level: Turbopuffer::Models::NamespaceQueryParams::Consistency::level }
+        Turbopuffer::NamespaceQueryParams::Consistency::Strong
+        | Turbopuffer::NamespaceQueryParams::Consistency::Eventual
 
-      class Consistency < Turbopuffer::Internal::Type::BaseModel
-        attr_reader level: Turbopuffer::Models::NamespaceQueryParams::Consistency::level?
+      module Consistency
+        extend Turbopuffer::Internal::Type::Union
+
+        type strong = { level: :strong }
 
-        def level=: (
-          Turbopuffer::Models::NamespaceQueryParams::Consistency::level
-        ) -> Turbopuffer::Models::NamespaceQueryParams::Consistency::level
+        class Strong < Turbopuffer::Internal::Type::BaseModel
+          attr_accessor level: :strong
 
-        def initialize: (
-          ?level: Turbopuffer::Models::NamespaceQueryParams::Consistency::level
-        ) -> void
+          def initialize: (?level: :strong) -> void
 
-        def to_hash: -> {
-          level: Turbopuffer::Models::NamespaceQueryParams::Consistency::level
-        }
+          def to_hash: -> { level: :strong }
+        end
 
-        type level = :strong | :eventual
+        type eventual = { level: :eventual, max_staleness_seconds: Integer }
 
-        module Level
-          extend Turbopuffer::Internal::Type::Enum
+        class Eventual < Turbopuffer::Internal::Type::BaseModel
+          attr_accessor level: :eventual
 
-          # Strong consistency. Requires a round-trip to object storage to fetch the latest writes.
-          STRONG: :strong
+          attr_reader max_staleness_seconds: Integer?
 
-          # Eventual consistency. Does not require a round-trip to object storage, but may not see the latest writes.
-          EVENTUAL: :eventual
+          def max_staleness_seconds=: (Integer) -> Integer
 
-          def self?.values: -> ::Array[Turbopuffer::Models::NamespaceQueryParams::Consistency::level]
+          def initialize: (
+            ?max_staleness_seconds: Integer,
+            ?level: :eventual
+          ) -> void
+
+          def to_hash: -> { level: :eventual, max_staleness_seconds: Integer }
         end
+
+        def self?.variants: -> ::Array[Turbopuffer::Models::NamespaceQueryParams::consistency]
       end
 
       type limit = Integer | Turbopuffer::Limit

data/sig/turbopuffer/resources/namespaces.rbs

@@ -25,7 +25,7 @@ module Turbopuffer
         ?namespace: String,
         ?aggregate_by: ::Hash[Symbol, top],
         ?compute_attributes: ::Hash[Symbol, top],
-        ?consistency: Turbopuffer::NamespaceExplainQueryParams::Consistency,
+        ?consistency: Turbopuffer::Models::NamespaceExplainQueryParams::consistency,
         ?distance_metric: Turbopuffer::Models::distance_metric,
         ?exclude_attributes: ::Array[String],
         ?filters: top,
@@ -52,7 +52,7 @@ module Turbopuffer
       def multi_query: (
         queries: ::Array[Turbopuffer::NamespaceMultiQueryParams::Query],
         ?namespace: String,
-        ?consistency: Turbopuffer::NamespaceMultiQueryParams::Consistency,
+        ?consistency: Turbopuffer::Models::NamespaceMultiQueryParams::consistency,
         ?limit: Turbopuffer::Models::NamespaceMultiQueryParams::limit,
         ?offset: Integer,
         ?rerank_by: top,
@@ -70,7 +70,7 @@ module Turbopuffer
         ?namespace: String,
         ?aggregate_by: ::Hash[Symbol, top],
         ?compute_attributes: ::Hash[Symbol, top],
-        ?consistency: Turbopuffer::NamespaceQueryParams::Consistency,
+        ?consistency: Turbopuffer::Models::NamespaceQueryParams::consistency,
         ?distance_metric: Turbopuffer::Models::distance_metric,
         ?exclude_attributes: ::Array[String],
         ?filters: top,

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: turbopuffer
 version: !ruby/object:Gem::Version
-  version: 2.9.0
+  version: 2.10.0
 platform: ruby
 authors:
 - Turbopuffer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-10-22 00:00:00.000000000 Z
+date: 2026-10-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi
@@ -385,7 +385,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.1
+rubygems_version: 3.4.19
 signing_key:
 specification_version: 4
 summary: Ruby library to access the Turbopuffer API