turbopuffer 2.2.0 → 2.4.0

data/sig/turbopuffer/models/highlight_config_params.rbs

@@ -0,0 +1,47 @@
+module Turbopuffer
+  module Models
+    type highlight_config_params =
+      {
+        fragment_by: Turbopuffer::Models::highlight_fragment_by,
+        fragment_limit: Integer,
+        include_offsets: Turbopuffer::Models::highlight_offset_units,
+        rank_fragments_by: top
+      }
+
+    class HighlightConfigParams < Turbopuffer::Internal::Type::BaseModel
+      attr_reader fragment_by: Turbopuffer::Models::highlight_fragment_by?
+
+      def fragment_by=: (
+        Turbopuffer::Models::highlight_fragment_by
+      ) -> Turbopuffer::Models::highlight_fragment_by
+
+      attr_reader fragment_limit: Integer?
+
+      def fragment_limit=: (Integer) -> Integer
+
+      attr_reader include_offsets: Turbopuffer::Models::highlight_offset_units?
+
+      def include_offsets=: (
+        Turbopuffer::Models::highlight_offset_units
+      ) -> Turbopuffer::Models::highlight_offset_units
+
+      attr_reader rank_fragments_by: top?
+
+      def rank_fragments_by=: (top) -> top
+
+      def initialize: (
+        ?fragment_by: Turbopuffer::Models::highlight_fragment_by,
+        ?fragment_limit: Integer,
+        ?include_offsets: Turbopuffer::Models::highlight_offset_units,
+        ?rank_fragments_by: top
+      ) -> void
+
+      def to_hash: -> {
+        fragment_by: Turbopuffer::Models::highlight_fragment_by,
+        fragment_limit: Integer,
+        include_offsets: Turbopuffer::Models::highlight_offset_units,
+        rank_fragments_by: top
+      }
+    end
+  end
+end

data/sig/turbopuffer/models/highlight_fragment_by.rbs

@@ -0,0 +1,23 @@
+module Turbopuffer
+  module Models
+    type highlight_fragment_by = :none | :sentence | :paragraph | :word
+
+    module HighlightFragmentBy
+      extend Turbopuffer::Internal::Type::Enum
+
+      # Treat the whole attribute as a single fragment.
+      NONE: :none
+
+      # Split the attribute into sentences. This is the default.
+      SENTENCE: :sentence
+
+      # Split the attribute into paragraphs.
+      PARAGRAPH: :paragraph
+
+      # Split the attribute into individual words.
+      WORD: :word
+
+      def self?.values: -> ::Array[Turbopuffer::Models::highlight_fragment_by]
+    end
+  end
+end

data/sig/turbopuffer/models/highlight_offset_units.rbs

@@ -0,0 +1,15 @@
+module Turbopuffer
+  module Models
+    type highlight_offset_units = :"utf-8" | :"utf-16" | :codepoints
+
+    module HighlightOffsetUnits
+      extend Turbopuffer::Internal::Type::Enum
+
+      UTF_8: :"utf-8"
+      UTF_16: :"utf-16"
+      CODEPOINTS: :codepoints
+
+      def self?.values: -> ::Array[Turbopuffer::Models::highlight_offset_units]
+    end
+  end
+end

data/sig/turbopuffer/models/namespace_copy_from_params.rbs

@@ -4,6 +4,7 @@ module Turbopuffer
       {
         namespace: String,
         source_namespace: String,
+        dest_encryption: Turbopuffer::Models::encryption,
         source_api_key: String,
         source_region: String
       }
@@ -19,6 +20,12 @@ module Turbopuffer
 
       attr_accessor source_namespace: String
 
+      attr_reader dest_encryption: Turbopuffer::Models::encryption?
+
+      def dest_encryption=: (
+        Turbopuffer::Models::encryption
+      ) -> Turbopuffer::Models::encryption
+
       attr_reader source_api_key: String?
 
       def source_api_key=: (String) -> String
@@ -30,6 +37,7 @@ module Turbopuffer
       def initialize: (
         source_namespace: String,
         ?namespace: String,
+        ?dest_encryption: Turbopuffer::Models::encryption,
         ?source_api_key: String,
         ?source_region: String,
         ?request_options: Turbopuffer::request_opts
@@ -38,6 +46,7 @@ module Turbopuffer
       def to_hash: -> {
         namespace: String,
         source_namespace: String,
+        dest_encryption: Turbopuffer::Models::encryption,
         source_api_key: String,
         source_region: String,
         request_options: Turbopuffer::RequestOptions

data/sig/turbopuffer/models/namespace_explain_query_params.rbs

@@ -4,6 +4,7 @@ module Turbopuffer
       {
         namespace: String,
         aggregate_by: ::Hash[Symbol, top],
+        compute_attributes: ::Hash[Symbol, top],
         consistency: Turbopuffer::NamespaceExplainQueryParams::Consistency,
         distance_metric: Turbopuffer::Models::distance_metric,
         exclude_attributes: ::Array[String],
@@ -29,6 +30,10 @@ module Turbopuffer
 
       def aggregate_by=: (::Hash[Symbol, top]) -> ::Hash[Symbol, top]
 
+      attr_reader compute_attributes: ::Hash[Symbol, top]?
+
+      def compute_attributes=: (::Hash[Symbol, top]) -> ::Hash[Symbol, top]
+
       attr_reader consistency: Turbopuffer::NamespaceExplainQueryParams::Consistency?
 
       def consistency=: (
@@ -82,6 +87,7 @@ module Turbopuffer
       def initialize: (
         ?namespace: String,
         ?aggregate_by: ::Hash[Symbol, top],
+        ?compute_attributes: ::Hash[Symbol, top],
         ?consistency: Turbopuffer::NamespaceExplainQueryParams::Consistency,
         ?distance_metric: Turbopuffer::Models::distance_metric,
         ?exclude_attributes: ::Array[String],
@@ -98,6 +104,7 @@ module Turbopuffer
       def to_hash: -> {
         namespace: String,
         aggregate_by: ::Hash[Symbol, top],
+        compute_attributes: ::Hash[Symbol, top],
         consistency: Turbopuffer::NamespaceExplainQueryParams::Consistency,
         distance_metric: Turbopuffer::Models::distance_metric,
         exclude_attributes: ::Array[String],

data/sig/turbopuffer/models/namespace_metadata.rbs

@@ -9,7 +9,8 @@ module Turbopuffer
         index: Turbopuffer::Models::NamespaceMetadata::index,
         schema: ::Hash[Symbol, Turbopuffer::AttributeSchemaConfig],
         updated_at: Time,
-        pinning: Turbopuffer::NamespaceMetadata::Pinning
+        pinning: Turbopuffer::NamespaceMetadata::Pinning,
+        sharding: Turbopuffer::ShardingConfig
       }
 
     class NamespaceMetadata < Turbopuffer::Internal::Type::BaseModel
@@ -33,6 +34,12 @@ module Turbopuffer
         Turbopuffer::NamespaceMetadata::Pinning
       ) -> Turbopuffer::NamespaceMetadata::Pinning
 
+      attr_reader sharding: Turbopuffer::ShardingConfig?
+
+      def sharding=: (
+        Turbopuffer::ShardingConfig
+      ) -> Turbopuffer::ShardingConfig
+
       def initialize: (
         approx_logical_bytes: Integer,
         approx_row_count: Integer,
@@ -41,7 +48,8 @@ module Turbopuffer
         index: Turbopuffer::Models::NamespaceMetadata::index,
         schema: ::Hash[Symbol, Turbopuffer::AttributeSchemaConfig],
         updated_at: Time,
-        ?pinning: Turbopuffer::NamespaceMetadata::Pinning
+        ?pinning: Turbopuffer::NamespaceMetadata::Pinning,
+        ?sharding: Turbopuffer::ShardingConfig
       ) -> void
 
       def to_hash: -> {
@@ -52,7 +60,8 @@ module Turbopuffer
         index: Turbopuffer::Models::NamespaceMetadata::index,
         schema: ::Hash[Symbol, Turbopuffer::AttributeSchemaConfig],
         updated_at: Time,
-        pinning: Turbopuffer::NamespaceMetadata::Pinning
+        pinning: Turbopuffer::NamespaceMetadata::Pinning,
+        sharding: Turbopuffer::ShardingConfig
       }
 
       type index =

data/sig/turbopuffer/models/namespace_multi_query_params.rbs

@@ -57,6 +57,7 @@ module Turbopuffer
       type query =
         {
           aggregate_by: ::Hash[Symbol, top],
+          compute_attributes: ::Hash[Symbol, top],
           distance_metric: Turbopuffer::Models::distance_metric,
           exclude_attributes: ::Array[String],
           filters: top,
@@ -72,6 +73,10 @@ module Turbopuffer
 
         def aggregate_by=: (::Hash[Symbol, top]) -> ::Hash[Symbol, top]
 
+        attr_reader compute_attributes: ::Hash[Symbol, top]?
+
+        def compute_attributes=: (::Hash[Symbol, top]) -> ::Hash[Symbol, top]
+
         attr_reader distance_metric: Turbopuffer::Models::distance_metric?
 
         def distance_metric=: (
@@ -112,6 +117,7 @@ module Turbopuffer
 
         def initialize: (
           ?aggregate_by: ::Hash[Symbol, top],
+          ?compute_attributes: ::Hash[Symbol, top],
           ?distance_metric: Turbopuffer::Models::distance_metric,
           ?exclude_attributes: ::Array[String],
           ?filters: top,
@@ -124,6 +130,7 @@ module Turbopuffer
 
         def to_hash: -> {
           aggregate_by: ::Hash[Symbol, top],
+          compute_attributes: ::Hash[Symbol, top],
           distance_metric: Turbopuffer::Models::distance_metric,
           exclude_attributes: ::Array[String],
           filters: top,

data/sig/turbopuffer/models/namespace_query_params.rbs

@@ -4,6 +4,7 @@ module Turbopuffer
       {
         namespace: String,
         aggregate_by: ::Hash[Symbol, top],
+        compute_attributes: ::Hash[Symbol, top],
         consistency: Turbopuffer::NamespaceQueryParams::Consistency,
         distance_metric: Turbopuffer::Models::distance_metric,
         exclude_attributes: ::Array[String],
@@ -29,6 +30,10 @@ module Turbopuffer
 
       def aggregate_by=: (::Hash[Symbol, top]) -> ::Hash[Symbol, top]
 
+      attr_reader compute_attributes: ::Hash[Symbol, top]?
+
+      def compute_attributes=: (::Hash[Symbol, top]) -> ::Hash[Symbol, top]
+
       attr_reader consistency: Turbopuffer::NamespaceQueryParams::Consistency?
 
       def consistency=: (
@@ -82,6 +87,7 @@ module Turbopuffer
       def initialize: (
         ?namespace: String,
         ?aggregate_by: ::Hash[Symbol, top],
+        ?compute_attributes: ::Hash[Symbol, top],
         ?consistency: Turbopuffer::NamespaceQueryParams::Consistency,
         ?distance_metric: Turbopuffer::Models::distance_metric,
         ?exclude_attributes: ::Array[String],
@@ -98,6 +104,7 @@ module Turbopuffer
       def to_hash: -> {
         namespace: String,
         aggregate_by: ::Hash[Symbol, top],
+        compute_attributes: ::Hash[Symbol, top],
         consistency: Turbopuffer::NamespaceQueryParams::Consistency,
         distance_metric: Turbopuffer::Models::distance_metric,
         exclude_attributes: ::Array[String],

data/sig/turbopuffer/models/namespace_write_params.rbs

@@ -19,6 +19,7 @@ module Turbopuffer
         patch_rows: ::Array[Turbopuffer::Row],
         return_affected_ids: bool,
         schema: ::Hash[Symbol, Turbopuffer::Models::attribute_schema],
+        sharding: Turbopuffer::ShardingConfig,
         upsert_columns: Turbopuffer::Columns,
         upsert_condition: top,
         upsert_rows: ::Array[Turbopuffer::Row]
@@ -111,6 +112,12 @@ module Turbopuffer
         ::Hash[Symbol, Turbopuffer::Models::attribute_schema]
       ) -> ::Hash[Symbol, Turbopuffer::Models::attribute_schema]
 
+      attr_reader sharding: Turbopuffer::ShardingConfig?
+
+      def sharding=: (
+        Turbopuffer::ShardingConfig
+      ) -> Turbopuffer::ShardingConfig
+
       attr_reader upsert_columns: Turbopuffer::Columns?
 
       def upsert_columns=: (Turbopuffer::Columns) -> Turbopuffer::Columns
@@ -141,6 +148,7 @@ module Turbopuffer
         ?patch_rows: ::Array[Turbopuffer::Row],
         ?return_affected_ids: bool,
         ?schema: ::Hash[Symbol, Turbopuffer::Models::attribute_schema],
+        ?sharding: Turbopuffer::ShardingConfig,
         ?upsert_columns: Turbopuffer::Columns,
         ?upsert_condition: top,
         ?upsert_rows: ::Array[Turbopuffer::Row],
@@ -165,6 +173,7 @@ module Turbopuffer
         patch_rows: ::Array[Turbopuffer::Row],
         return_affected_ids: bool,
         schema: ::Hash[Symbol, Turbopuffer::Models::attribute_schema],
+        sharding: Turbopuffer::ShardingConfig,
         upsert_columns: Turbopuffer::Columns,
         upsert_condition: top,
         upsert_rows: ::Array[Turbopuffer::Row],

data/sig/turbopuffer/models/rrf_params.rbs

@@ -1,15 +1,22 @@
 module Turbopuffer
   module Models
-    type rrf_params = { rank_constant: Integer }
+    type rrf_params = { rank_constant: Integer, weights: ::Array[Float] }
 
     class RrfParams < Turbopuffer::Internal::Type::BaseModel
       attr_reader rank_constant: Integer?
 
       def rank_constant=: (Integer) -> Integer
 
-      def initialize: (?rank_constant: Integer) -> void
+      attr_reader weights: ::Array[Float]?
 
-      def to_hash: -> { rank_constant: Integer }
+      def weights=: (::Array[Float]) -> ::Array[Float]
+
+      def initialize: (
+        ?rank_constant: Integer,
+        ?weights: ::Array[Float]
+      ) -> void
+
+      def to_hash: -> { rank_constant: Integer, weights: ::Array[Float] }
     end
   end
 end

data/sig/turbopuffer/models/sharding_config.rbs

@@ -0,0 +1,13 @@
+module Turbopuffer
+  module Models
+    type sharding_config = { num_shards: Integer }
+
+    class ShardingConfig < Turbopuffer::Internal::Type::BaseModel
+      attr_accessor num_shards: Integer
+
+      def initialize: (num_shards: Integer) -> void
+
+      def to_hash: -> { num_shards: Integer }
+    end
+  end
+end

data/sig/turbopuffer/models.rbs

@@ -41,6 +41,12 @@ module Turbopuffer
 
   class FuzzyParams = Turbopuffer::Models::FuzzyParams
 
+  class HighlightConfigParams = Turbopuffer::Models::HighlightConfigParams
+
+  module HighlightFragmentBy = Turbopuffer::Models::HighlightFragmentBy
+
+  module HighlightOffsetUnits = Turbopuffer::Models::HighlightOffsetUnits
+
   module ID = Turbopuffer::Models::ID
 
   module IncludeAttributes = Turbopuffer::Models::IncludeAttributes
@@ -93,6 +99,8 @@ module Turbopuffer
 
   class SaturateParams = Turbopuffer::Models::SaturateParams
 
+  class ShardingConfig = Turbopuffer::Models::ShardingConfig
+
   module SparseDistanceMetric = Turbopuffer::Models::SparseDistanceMetric
 
   module Tokenizer = Turbopuffer::Models::Tokenizer

data/sig/turbopuffer/resources/namespaces.rbs

@@ -10,6 +10,7 @@ module Turbopuffer
       def copy_from: (
         source_namespace: String,
         ?namespace: String,
+        ?dest_encryption: Turbopuffer::Models::encryption,
         ?source_api_key: String,
         ?source_region: String,
         ?request_options: Turbopuffer::request_opts
@@ -23,6 +24,7 @@ module Turbopuffer
       def explain_query: (
         ?namespace: String,
         ?aggregate_by: ::Hash[Symbol, top],
+        ?compute_attributes: ::Hash[Symbol, top],
         ?consistency: Turbopuffer::NamespaceExplainQueryParams::Consistency,
         ?distance_metric: Turbopuffer::Models::distance_metric,
         ?exclude_attributes: ::Array[String],
@@ -58,6 +60,7 @@ module Turbopuffer
       def query: (
         ?namespace: String,
         ?aggregate_by: ::Hash[Symbol, top],
+        ?compute_attributes: ::Hash[Symbol, top],
         ?consistency: Turbopuffer::NamespaceQueryParams::Consistency,
         ?distance_metric: Turbopuffer::Models::distance_metric,
         ?exclude_attributes: ::Array[String],
@@ -116,6 +119,7 @@ module Turbopuffer
         ?patch_rows: ::Array[Turbopuffer::Row],
         ?return_affected_ids: bool,
         ?schema: ::Hash[Symbol, Turbopuffer::Models::attribute_schema],
+        ?sharding: Turbopuffer::ShardingConfig,
         ?upsert_columns: Turbopuffer::Columns,
         ?upsert_condition: top,
         ?upsert_rows: ::Array[Turbopuffer::Row],

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: turbopuffer
 version: !ruby/object:Gem::Version
-  version: 2.2.0
+  version: 2.4.0
 platform: ruby
 authors:
 - Turbopuffer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-06-08 00:00:00.000000000 Z
+date: 2026-07-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi
@@ -92,6 +92,9 @@ files:
 - lib/turbopuffer/models/full_text_search_config.rb
 - lib/turbopuffer/models/fuzzy_max_edit_distance.rb
 - lib/turbopuffer/models/fuzzy_params.rb
+- lib/turbopuffer/models/highlight_config_params.rb
+- lib/turbopuffer/models/highlight_fragment_by.rb
+- lib/turbopuffer/models/highlight_offset_units.rb
 - lib/turbopuffer/models/id.rb
 - lib/turbopuffer/models/include_attributes.rb
 - lib/turbopuffer/models/language.rb
@@ -129,6 +132,7 @@ files:
 - lib/turbopuffer/models/row.rb
 - lib/turbopuffer/models/rrf_params.rb
 - lib/turbopuffer/models/saturate_params.rb
+- lib/turbopuffer/models/sharding_config.rb
 - lib/turbopuffer/models/sparse_distance_metric.rb
 - lib/turbopuffer/models/tokenizer.rb
 - lib/turbopuffer/models/vector.rb
@@ -181,6 +185,9 @@ files:
 - rbi/turbopuffer/models/full_text_search_config.rbi
 - rbi/turbopuffer/models/fuzzy_max_edit_distance.rbi
 - rbi/turbopuffer/models/fuzzy_params.rbi
+- rbi/turbopuffer/models/highlight_config_params.rbi
+- rbi/turbopuffer/models/highlight_fragment_by.rbi
+- rbi/turbopuffer/models/highlight_offset_units.rbi
 - rbi/turbopuffer/models/id.rbi
 - rbi/turbopuffer/models/include_attributes.rbi
 - rbi/turbopuffer/models/language.rbi
@@ -218,6 +225,7 @@ files:
 - rbi/turbopuffer/models/row.rbi
 - rbi/turbopuffer/models/rrf_params.rbi
 - rbi/turbopuffer/models/saturate_params.rbi
+- rbi/turbopuffer/models/sharding_config.rbi
 - rbi/turbopuffer/models/sparse_distance_metric.rbi
 - rbi/turbopuffer/models/tokenizer.rbi
 - rbi/turbopuffer/models/vector.rbi
@@ -269,6 +277,9 @@ files:
 - sig/turbopuffer/models/full_text_search_config.rbs
 - sig/turbopuffer/models/fuzzy_max_edit_distance.rbs
 - sig/turbopuffer/models/fuzzy_params.rbs
+- sig/turbopuffer/models/highlight_config_params.rbs
+- sig/turbopuffer/models/highlight_fragment_by.rbs
+- sig/turbopuffer/models/highlight_offset_units.rbs
 - sig/turbopuffer/models/id.rbs
 - sig/turbopuffer/models/include_attributes.rbs
 - sig/turbopuffer/models/language.rbs
@@ -306,6 +317,7 @@ files:
 - sig/turbopuffer/models/row.rbs
 - sig/turbopuffer/models/rrf_params.rbs
 - sig/turbopuffer/models/saturate_params.rbs
+- sig/turbopuffer/models/sharding_config.rbs
 - sig/turbopuffer/models/sparse_distance_metric.rbs
 - sig/turbopuffer/models/tokenizer.rbs
 - sig/turbopuffer/models/vector.rbs