turbopuffer 2.3.0 → 2.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a3a51779391cbefbadc2c92d4da69e9f2b8a16db31b09626fc610d979f8317af
-  data.tar.gz: f814addde33fea46dfea6c616ab8f71c34a4813a7f53283bdd3b04765ea9f91b
+  metadata.gz: 261de656879e46b1d9f2261ccd91ff7ea9e266d8a86607c5395ad55f38733dcf
+  data.tar.gz: f747583237835002c070734cd7a3955c9476df205d5815e3fcf04ee10e9a8a76
 SHA512:
-  metadata.gz: 66b621f09d12e2ae0540a69f163c596063b59c3a4df34416cd9c48330f167065af3ee4e1292d1d954adcfc7796b1d1a46fd023b50681f286d81e1984535e5880
-  data.tar.gz: 9b77397676c00954fd6ee3bad008eeedf6af798d41718d636841b9e12c35ab98caa434acaee6f157e006d9d08aa6491df57943ebfe8fa846fbcc131102a8d957
+  metadata.gz: 9bc98d5c9e8d49f32361220486d44837ae507de3693b375b40d8ba6a668c9897efdeb60372d93da15a10493ca7a3b999c0962e7809ccd42514ec4c52230e96c8
+  data.tar.gz: 022a2361e31a953a68d1867c5cc67ce571556e126ad873267ef2beb28ccf0e81438681570c86955134514a574c6812c374036b61fd5b0c88d8e642e62eb33c88

data/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## 2.4.0 (2026-07-30)
+
+Full Changelog: [v2.3.0...v2.4.0](https://github.com/turbopuffer/turbopuffer-ruby/compare/v2.3.0...v2.4.0)
+
+### Features
+
+* openapi: add RRF `weights` parameter ([621628b](https://github.com/turbopuffer/turbopuffer-ruby/commit/621628bc8d9ed54a0ab5006c20ba5f4ae03e966e))
+* spec: add sharding config to the openapi spec ([2228a03](https://github.com/turbopuffer/turbopuffer-ruby/commit/2228a031201ad1b3d20ae1c77d029d665c67e428))
+* spec: expose computed attributes ([597fdde](https://github.com/turbopuffer/turbopuffer-ruby/commit/597fdde888efd50b9873b056ab0c12fab5a9e600))
+* spec: hide HighlightConfig.rank_fragments_by's RankBy ref from Stainless ([59c2734](https://github.com/turbopuffer/turbopuffer-ruby/commit/59c273482fcfccce1fc8f4d8b8d3ae13c0fbbcdc))
+* spec: make compute_attributes value x-stainless-any ([c170466](https://github.com/turbopuffer/turbopuffer-ruby/commit/c17046653f2533e00e9129d4e807a5ab2c3b1cd6))
+* spec: rename HighlightConfig -> HighlightConfigParams ([36413c3](https://github.com/turbopuffer/turbopuffer-ruby/commit/36413c3bebab413e60ab51ba728437e66edaa7ab))
+* **stlc:** configurable CI runner and private-production-repo support in workflow templates ([12b486b](https://github.com/turbopuffer/turbopuffer-ruby/commit/12b486b953bf4521f18eb1187ba20812d30b3cfd))
+* support late_interaction parameter in sdks ([ac90617](https://github.com/turbopuffer/turbopuffer-ruby/commit/ac9061734ae8f47e823c20f381bf925c27634d8e))
+
+
+### Chores
+
+* **internal:** bound formatter parallelism to CPU count ([a56e5af](https://github.com/turbopuffer/turbopuffer-ruby/commit/a56e5af20b69bd39b12fbf2e9db2cd6d9b1b1ee8))
+* remove unused MCP package ([2b81b9a](https://github.com/turbopuffer/turbopuffer-ruby/commit/2b81b9ae116370e14cf1213e056b147277e6cca3))
+
 ## 2.3.0 (2026-06-16)
 
 Full Changelog: [v2.2.0...v2.3.0](https://github.com/turbopuffer/turbopuffer-ruby/compare/v2.2.0...v2.3.0)

data/README.md

@@ -6,7 +6,7 @@ It is generated with [Stainless](https://www.stainless.com/).
 
 ## MCP Server
 
-Use the turbopuffer MCP Server to enable AI assistants to interact with this API, allowing them to explore endpoints, make test requests, and use documentation to help integrate this SDK into your application.
+Use the Turbopuffer MCP Server to enable AI assistants to interact with this API, allowing them to explore endpoints, make test requests, and use documentation to help integrate this SDK into your application.
 
 [![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=%40turbopuffer%2Fturbopuffer-mcp&config=eyJuYW1lIjoiQHR1cmJvcHVmZmVyL3R1cmJvcHVmZmVyLW1jcCIsInRyYW5zcG9ydCI6Imh0dHAiLCJ1cmwiOiJodHRwczovL3R1cmJvcHVmZmVyLnN0bG1jcC5jb20iLCJoZWFkZXJzIjp7IngtdHVyYm9wdWZmZXItYXBpLWtleSI6InRwdWZfQTEuLi4ifX0)
 [![Install in VS Code](https://img.shields.io/badge/_-Add_to_VS_Code-blue?style=for-the-badge&logo=data:image/svg%2bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIGZpbGw9Im5vbmUiIHZpZXdCb3g9IjAgMCA0MCA0MCI+PHBhdGggZmlsbD0iI0VFRSIgZmlsbC1ydWxlPSJldmVub2RkIiBkPSJNMzAuMjM1IDM5Ljg4NGEyLjQ5MSAyLjQ5MSAwIDAgMS0xLjc4MS0uNzNMMTIuNyAyNC43OGwtMy40NiAyLjYyNC0zLjQwNiAyLjU4MmExLjY2NSAxLjY2NSAwIDAgMS0xLjA4Mi4zMzggMS42NjQgMS42NjQgMCAwIDEtMS4wNDYtLjQzMWwtMi4yLTJhMS42NjYgMS42NjYgMCAwIDEgMC0yLjQ2M0w3LjQ1OCAyMCA0LjY3IDE3LjQ1MyAxLjUwNyAxNC41N2ExLjY2NSAxLjY2NSAwIDAgMSAwLTIuNDYzbDIuMi0yYTEuNjY1IDEuNjY1IDAgMCAxIDIuMTMtLjA5N2w2Ljg2MyA1LjIwOUwyOC40NTIuODQ0YTIuNDg4IDIuNDg4IDAgMCAxIDEuODQxLS43MjljLjM1MS4wMDkuNjk5LjA5MSAxLjAxOS4yNDVsOC4yMzYgMy45NjFhMi41IDIuNSAwIDAgMSAxLjQxNSAyLjI1M3YuMDk5LS4wNDVWMzMuMzd2LS4wNDUuMDk1YTIuNTAxIDIuNTAxIDAgMCAxLTEuNDE2IDIuMjU3bC04LjIzNSAzLjk2MWEyLjQ5MiAyLjQ5MiAwIDAgMS0xLjA3Ny4yNDZabS43MTYtMjguOTQ3LTExLjk0OCA5LjA2MiAxMS45NTIgOS4wNjUtLjAwNC0xOC4xMjdaIi8+PC9zdmc+)](https://vscode.stainless.com/mcp/%7B%22name%22%3A%22%40turbopuffer%2Fturbopuffer-mcp%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fturbopuffer.stlmcp.com%22%2C%22headers%22%3A%7B%22x-turbopuffer-api-key%22%3A%22tpuf_A1...%22%7D%7D)
@@ -26,7 +26,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "turbopuffer", "~> 2.3.0"
+gem "turbopuffer", "~> 2.4.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/turbopuffer/models/attribute_schema_config.rb

@@ -108,10 +108,23 @@ module Turbopuffer
           #   @return [Symbol, Turbopuffer::Models::DistanceMetric, nil]
           optional :distance_metric, enum: -> { Turbopuffer::DistanceMetric }
 
-          # @!method initialize(distance_metric: nil)
+          # @!attribute late_interaction
+          #   Opt in to late-interaction (MUVERA) indexing. Only valid on fixed-dim `[][N]f32`
+          #   vector array attributes, and is required to enable an ANN index on such
+          #   attributes. Defaults to `false`.
+          #
+          #   @return [Boolean, nil]
+          optional :late_interaction, Turbopuffer::Internal::Type::Boolean
+
+          # @!method initialize(distance_metric: nil, late_interaction: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Turbopuffer::Models::AttributeSchemaConfig::Ann::AnnConfig} for more details.
+          #
           #   Configuration options for ANN (Approximate Nearest Neighbor) indexing.
           #
           #   @param distance_metric [Symbol, Turbopuffer::Models::DistanceMetric] A function used to calculate vector similarity.
+          #
+          #   @param late_interaction [Boolean] Opt in to late-interaction (MUVERA) indexing. Only valid on fixed-dim `[][N]f32`
         end
 
         # @!method self.variants

data/lib/turbopuffer/models/highlight_config_params.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module Turbopuffer
+  module Models
+    class HighlightConfigParams < Turbopuffer::Internal::Type::BaseModel
+      # @!attribute fragment_by
+      #   How to split a text attribute into fragments for highlighting.
+      #
+      #   @return [Symbol, Turbopuffer::Models::HighlightFragmentBy, nil]
+      optional :fragment_by, enum: -> { Turbopuffer::HighlightFragmentBy }
+
+      # @!attribute fragment_limit
+      #   The maximum number of fragments to return. Defaults to `3`.
+      #
+      #   @return [Integer, nil]
+      optional :fragment_limit, Integer
+
+      # @!attribute include_offsets
+      #   The units to report highlighted fragment offsets in.
+      #
+      #   @return [Symbol, Turbopuffer::Models::HighlightOffsetUnits, nil]
+      optional :include_offsets, enum: -> { Turbopuffer::HighlightOffsetUnits }
+
+      # @!attribute rank_fragments_by
+      #   How to rank candidate fragments within the attribute before selecting the top
+      #   `fragment_limit`. Defaults to the query's `rank_by`.
+      #
+      #   @return [Object, nil]
+      optional :rank_fragments_by, Turbopuffer::Internal::Type::Unknown
+
+      # @!method initialize(fragment_by: nil, fragment_limit: nil, include_offsets: nil, rank_fragments_by: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Turbopuffer::Models::HighlightConfigParams} for more details.
+      #
+      #   Additional (optional) parameters for the Highlight compute expression.
+      #
+      #   @param fragment_by [Symbol, Turbopuffer::Models::HighlightFragmentBy] How to split a text attribute into fragments for highlighting.
+      #
+      #   @param fragment_limit [Integer] The maximum number of fragments to return. Defaults to `3`.
+      #
+      #   @param include_offsets [Symbol, Turbopuffer::Models::HighlightOffsetUnits] The units to report highlighted fragment offsets in.
+      #
+      #   @param rank_fragments_by [Object] How to rank candidate fragments within the attribute before selecting the top `f
+    end
+  end
+end

data/lib/turbopuffer/models/highlight_fragment_by.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Turbopuffer
+  module Models
+    # How to split a text attribute into fragments for highlighting.
+    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
+
+      # @!method self.values
+      #   @return [Array<Symbol>]
+    end
+  end
+end

data/lib/turbopuffer/models/highlight_offset_units.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Turbopuffer
+  module Models
+    # The units to report highlighted fragment offsets in.
+    module HighlightOffsetUnits
+      extend Turbopuffer::Internal::Type::Enum
+
+      UTF_8 = :"utf-8"
+      UTF_16 = :"utf-16"
+      CODEPOINTS = :codepoints
+
+      # @!method self.values
+      #   @return [Array<Symbol>]
+    end
+  end
+end

data/lib/turbopuffer/models/namespace_explain_query_params.rb

@@ -19,6 +19,14 @@ module Turbopuffer
       #   @return [Hash{Symbol=>Object}, nil]
       optional :aggregate_by, Turbopuffer::Internal::Type::HashOf[Turbopuffer::Internal::Type::Unknown]
 
+      # @!attribute compute_attributes
+      #   Computes additional values on documents returned by a query. Each key is the
+      #   name of the computed attribute; each value is an expression describing how to
+      #   compute it.
+      #
+      #   @return [Hash{Symbol=>Object}, nil]
+      optional :compute_attributes, Turbopuffer::Internal::Type::HashOf[Turbopuffer::Internal::Type::Unknown]
+
       # @!attribute consistency
       #   The consistency level for a query.
       #
@@ -82,7 +90,7 @@ module Turbopuffer
       #   @return [Symbol, Turbopuffer::Models::VectorEncoding, nil]
       optional :vector_encoding, enum: -> { Turbopuffer::VectorEncoding }
 
-      # @!method initialize(namespace: nil, aggregate_by: nil, consistency: nil, distance_metric: nil, exclude_attributes: nil, filters: nil, group_by: nil, include_attributes: nil, limit: nil, rank_by: nil, top_k: nil, vector_encoding: nil, request_options: {})
+      # @!method initialize(namespace: nil, aggregate_by: nil, compute_attributes: nil, consistency: nil, distance_metric: nil, exclude_attributes: nil, filters: nil, group_by: nil, include_attributes: nil, limit: nil, rank_by: nil, top_k: nil, vector_encoding: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Turbopuffer::Models::NamespaceExplainQueryParams} for more details.
       #
@@ -90,6 +98,8 @@ module Turbopuffer
       #
       #   @param aggregate_by [Hash{Symbol=>Object}] Aggregations to compute over all documents in the namespace that match the filte
       #
+      #   @param compute_attributes [Hash{Symbol=>Object}] Computes additional values on documents returned by a query. Each key is the nam
+      #
       #   @param consistency [Turbopuffer::Models::NamespaceExplainQueryParams::Consistency] The consistency level for a query.
       #
       #   @param distance_metric [Symbol, Turbopuffer::Models::DistanceMetric] A function used to calculate vector similarity.

data/lib/turbopuffer/models/namespace_metadata.rb

@@ -52,7 +52,16 @@ module Turbopuffer
       #   @return [Turbopuffer::Models::NamespaceMetadata::Pinning, nil]
       optional :pinning, -> { Turbopuffer::NamespaceMetadata::Pinning }
 
-      # @!method initialize(approx_logical_bytes:, approx_row_count:, created_at:, encryption:, index:, schema:, updated_at:, pinning: nil)
+      # @!attribute sharding
+      #   Configuration for namespace sharding, which partitions a namespace's documents
+      #   across multiple internal shards to scale indexing and query throughput beyond a
+      #   single machine. Sharding can only be configured on a namespace's inaugural
+      #   write, and cannot be added to or changed on an existing namespace.
+      #
+      #   @return [Turbopuffer::Models::ShardingConfig, nil]
+      optional :sharding, -> { Turbopuffer::ShardingConfig }
+
+      # @!method initialize(approx_logical_bytes:, approx_row_count:, created_at:, encryption:, index:, schema:, updated_at:, pinning: nil, sharding: nil)
       #   Some parameter documentations has been truncated, see
       #   {Turbopuffer::Models::NamespaceMetadata} for more details.
       #
@@ -73,6 +82,8 @@ module Turbopuffer
       #   @param updated_at [Time] The timestamp when the namespace was last modified by a write operation.
       #
       #   @param pinning [Turbopuffer::Models::NamespaceMetadata::Pinning] Configuration for namespace pinning, along with the current status of the pinned
+      #
+      #   @param sharding [Turbopuffer::Models::ShardingConfig] Configuration for namespace sharding, which partitions a namespace's documents a
 
       # @see Turbopuffer::Models::NamespaceMetadata#index
       module Index

data/lib/turbopuffer/models/namespace_multi_query_params.rb

@@ -57,6 +57,14 @@ module Turbopuffer
         #   @return [Hash{Symbol=>Object}, nil]
         optional :aggregate_by, Turbopuffer::Internal::Type::HashOf[Turbopuffer::Internal::Type::Unknown]
 
+        # @!attribute compute_attributes
+        #   Computes additional values on documents returned by a query. Each key is the
+        #   name of the computed attribute; each value is an expression describing how to
+        #   compute it.
+        #
+        #   @return [Hash{Symbol=>Object}, nil]
+        optional :compute_attributes, Turbopuffer::Internal::Type::HashOf[Turbopuffer::Internal::Type::Unknown]
+
         # @!attribute distance_metric
         #   A function used to calculate vector similarity.
         #
@@ -108,7 +116,7 @@ module Turbopuffer
         #   @return [Integer, nil]
         optional :top_k, Integer
 
-        # @!method initialize(aggregate_by: nil, distance_metric: nil, exclude_attributes: nil, filters: nil, group_by: nil, include_attributes: nil, limit: nil, rank_by: nil, top_k: nil)
+        # @!method initialize(aggregate_by: nil, compute_attributes: nil, distance_metric: nil, exclude_attributes: nil, filters: nil, group_by: nil, include_attributes: nil, limit: nil, rank_by: nil, top_k: nil)
         #   Some parameter documentations has been truncated, see
         #   {Turbopuffer::Models::NamespaceMultiQueryParams::Query} for more details.
         #
@@ -116,6 +124,8 @@ module Turbopuffer
         #
         #   @param aggregate_by [Hash{Symbol=>Object}] Aggregations to compute over all documents in the namespace that match the filte
         #
+        #   @param compute_attributes [Hash{Symbol=>Object}] Computes additional values on documents returned by a query. Each key is the nam
+        #
         #   @param distance_metric [Symbol, Turbopuffer::Models::DistanceMetric] A function used to calculate vector similarity.
         #
         #   @param exclude_attributes [Array<String>] List of attribute names to exclude from the response. All other attributes will

data/lib/turbopuffer/models/namespace_query_params.rb

@@ -19,6 +19,14 @@ module Turbopuffer
       #   @return [Hash{Symbol=>Object}, nil]
       optional :aggregate_by, Turbopuffer::Internal::Type::HashOf[Turbopuffer::Internal::Type::Unknown]
 
+      # @!attribute compute_attributes
+      #   Computes additional values on documents returned by a query. Each key is the
+      #   name of the computed attribute; each value is an expression describing how to
+      #   compute it.
+      #
+      #   @return [Hash{Symbol=>Object}, nil]
+      optional :compute_attributes, Turbopuffer::Internal::Type::HashOf[Turbopuffer::Internal::Type::Unknown]
+
       # @!attribute consistency
       #   The consistency level for a query.
       #
@@ -82,7 +90,7 @@ module Turbopuffer
       #   @return [Symbol, Turbopuffer::Models::VectorEncoding, nil]
       optional :vector_encoding, enum: -> { Turbopuffer::VectorEncoding }
 
-      # @!method initialize(namespace: nil, aggregate_by: nil, consistency: nil, distance_metric: nil, exclude_attributes: nil, filters: nil, group_by: nil, include_attributes: nil, limit: nil, rank_by: nil, top_k: nil, vector_encoding: nil, request_options: {})
+      # @!method initialize(namespace: nil, aggregate_by: nil, compute_attributes: nil, consistency: nil, distance_metric: nil, exclude_attributes: nil, filters: nil, group_by: nil, include_attributes: nil, limit: nil, rank_by: nil, top_k: nil, vector_encoding: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Turbopuffer::Models::NamespaceQueryParams} for more details.
       #
@@ -90,6 +98,8 @@ module Turbopuffer
       #
       #   @param aggregate_by [Hash{Symbol=>Object}] Aggregations to compute over all documents in the namespace that match the filte
       #
+      #   @param compute_attributes [Hash{Symbol=>Object}] Computes additional values on documents returned by a query. Each key is the nam
+      #
       #   @param consistency [Turbopuffer::Models::NamespaceQueryParams::Consistency] The consistency level for a query.
       #
       #   @param distance_metric [Symbol, Turbopuffer::Models::DistanceMetric] A function used to calculate vector similarity.

data/lib/turbopuffer/models/namespace_write_params.rb

@@ -111,6 +111,15 @@ module Turbopuffer
       #   @return [Hash{Symbol=>String, Turbopuffer::Models::AttributeSchemaConfig}, nil]
       optional :schema, -> { Turbopuffer::Internal::Type::HashOf[union: Turbopuffer::AttributeSchema] }
 
+      # @!attribute sharding
+      #   Configuration for namespace sharding, which partitions a namespace's documents
+      #   across multiple internal shards to scale indexing and query throughput beyond a
+      #   single machine. Sharding can only be configured on a namespace's inaugural
+      #   write, and cannot be added to or changed on an existing namespace.
+      #
+      #   @return [Turbopuffer::Models::ShardingConfig, nil]
+      optional :sharding, -> { Turbopuffer::ShardingConfig }
+
       # @!attribute upsert_columns
       #   A list of documents in columnar format. Each key is a column name, mapped to an
       #   array of values for that column.
@@ -130,7 +139,7 @@ module Turbopuffer
       #   @return [Array<Turbopuffer::Models::Row>, nil]
       optional :upsert_rows, -> { Turbopuffer::Internal::Type::ArrayOf[Turbopuffer::Row] }
 
-      # @!method initialize(namespace: nil, branch_from_namespace: nil, copy_from_namespace: nil, delete_by_filter: nil, delete_by_filter_allow_partial: nil, delete_condition: nil, deletes: nil, disable_backpressure: nil, distance_metric: nil, encryption: nil, patch_by_filter: nil, patch_by_filter_allow_partial: nil, patch_columns: nil, patch_condition: nil, patch_rows: nil, return_affected_ids: nil, schema: nil, upsert_columns: nil, upsert_condition: nil, upsert_rows: nil, request_options: {})
+      # @!method initialize(namespace: nil, branch_from_namespace: nil, copy_from_namespace: nil, delete_by_filter: nil, delete_by_filter_allow_partial: nil, delete_condition: nil, deletes: nil, disable_backpressure: nil, distance_metric: nil, encryption: nil, patch_by_filter: nil, patch_by_filter_allow_partial: nil, patch_columns: nil, patch_condition: nil, patch_rows: nil, return_affected_ids: nil, schema: nil, sharding: nil, upsert_columns: nil, upsert_condition: nil, upsert_rows: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Turbopuffer::Models::NamespaceWriteParams} for more details.
       #
@@ -168,6 +177,8 @@ module Turbopuffer
       #
       #   @param schema [Hash{Symbol=>String, Turbopuffer::Models::AttributeSchemaConfig}] The schema of the attributes attached to the documents.
       #
+      #   @param sharding [Turbopuffer::Models::ShardingConfig] Configuration for namespace sharding, which partitions a namespace's documents a
+      #
       #   @param upsert_columns [Turbopuffer::Models::Columns] A list of documents in columnar format. Each key is a column name, mapped to an
       #
       #   @param upsert_condition [Object] A condition evaluated against the current value of each document targeted by an

data/lib/turbopuffer/models/rrf_params.rb

@@ -9,10 +9,23 @@ module Turbopuffer
       #   @return [Integer, nil]
       optional :rank_constant, Integer
 
-      # @!method initialize(rank_constant: nil)
+      # @!attribute weights
+      #   A positive weight for each subquery, in the same order as `queries`. The number
+      #   of weights must match the number of subqueries. When omitted, every subquery has
+      #   a weight of `1`.
+      #
+      #   @return [Array<Float>, nil]
+      optional :weights, Turbopuffer::Internal::Type::ArrayOf[Float]
+
+      # @!method initialize(rank_constant: nil, weights: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Turbopuffer::Models::RrfParams} for more details.
+      #
       #   Configuration options for RRF.
       #
       #   @param rank_constant [Integer] RRF rank constant (`k`). Must be greater than zero. Defaults to `60`.
+      #
+      #   @param weights [Array<Float>] A positive weight for each subquery, in the same order as `queries`. The number
     end
   end
 end

data/lib/turbopuffer/models/sharding_config.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Turbopuffer
+  module Models
+    class ShardingConfig < Turbopuffer::Internal::Type::BaseModel
+      # @!attribute num_shards
+      #   The number of shards to partition the namespace into.
+      #
+      #   @return [Integer]
+      required :num_shards, Integer
+
+      # @!method initialize(num_shards:)
+      #   Configuration for namespace sharding, which partitions a namespace's documents
+      #   across multiple internal shards to scale indexing and query throughput beyond a
+      #   single machine. Sharding can only be configured on a namespace's inaugural
+      #   write, and cannot be added to or changed on an existing namespace.
+      #
+      #   @param num_shards [Integer] The number of shards to partition the namespace into.
+    end
+  end
+end

data/lib/turbopuffer/models.rb

@@ -82,6 +82,12 @@ module Turbopuffer
 
   FuzzyParams = Turbopuffer::Models::FuzzyParams
 
+  HighlightConfigParams = Turbopuffer::Models::HighlightConfigParams
+
+  HighlightFragmentBy = Turbopuffer::Models::HighlightFragmentBy
+
+  HighlightOffsetUnits = Turbopuffer::Models::HighlightOffsetUnits
+
   ID = Turbopuffer::Models::ID
 
   IncludeAttributes = Turbopuffer::Models::IncludeAttributes
@@ -134,6 +140,8 @@ module Turbopuffer
 
   SaturateParams = Turbopuffer::Models::SaturateParams
 
+  ShardingConfig = Turbopuffer::Models::ShardingConfig
+
   SparseDistanceMetric = Turbopuffer::Models::SparseDistanceMetric
 
   Tokenizer = Turbopuffer::Models::Tokenizer

data/lib/turbopuffer/resources/namespaces.rb

@@ -98,12 +98,14 @@ module Turbopuffer
       #
       # Explain a query plan.
       #
-      # @overload explain_query(namespace: nil, aggregate_by: nil, consistency: nil, distance_metric: nil, exclude_attributes: nil, filters: nil, group_by: nil, include_attributes: nil, limit: nil, rank_by: nil, top_k: nil, vector_encoding: nil, request_options: {})
+      # @overload explain_query(namespace: nil, aggregate_by: nil, compute_attributes: nil, consistency: nil, distance_metric: nil, exclude_attributes: nil, filters: nil, group_by: nil, include_attributes: nil, limit: nil, rank_by: nil, top_k: nil, vector_encoding: nil, request_options: {})
       #
       # @param namespace [String] Path param: The name of the namespace.
       #
       # @param aggregate_by [Hash{Symbol=>Object}] Body param: Aggregations to compute over all documents in the namespace that mat
       #
+      # @param compute_attributes [Hash{Symbol=>Object}] Body param: Computes additional values on documents returned by a query. Each ke
+      #
       # @param consistency [Turbopuffer::Models::NamespaceExplainQueryParams::Consistency] Body param: The consistency level for a query.
       #
       # @param distance_metric [Symbol, Turbopuffer::Models::DistanceMetric] Body param: A function used to calculate vector similarity.
@@ -236,12 +238,14 @@ module Turbopuffer
       #
       # Query, filter, full-text search and vector search documents.
       #
-      # @overload query(namespace: nil, aggregate_by: nil, consistency: nil, distance_metric: nil, exclude_attributes: nil, filters: nil, group_by: nil, include_attributes: nil, limit: nil, rank_by: nil, top_k: nil, vector_encoding: nil, request_options: {})
+      # @overload query(namespace: nil, aggregate_by: nil, compute_attributes: nil, consistency: nil, distance_metric: nil, exclude_attributes: nil, filters: nil, group_by: nil, include_attributes: nil, limit: nil, rank_by: nil, top_k: nil, vector_encoding: nil, request_options: {})
       #
       # @param namespace [String] Path param: The name of the namespace.
       #
       # @param aggregate_by [Hash{Symbol=>Object}] Body param: Aggregations to compute over all documents in the namespace that mat
       #
+      # @param compute_attributes [Hash{Symbol=>Object}] Body param: Computes additional values on documents returned by a query. Each ke
+      #
       # @param consistency [Turbopuffer::Models::NamespaceQueryParams::Consistency] Body param: The consistency level for a query.
       #
       # @param distance_metric [Symbol, Turbopuffer::Models::DistanceMetric] Body param: A function used to calculate vector similarity.
@@ -410,7 +414,7 @@ module Turbopuffer
       #
       # Create, update, or delete documents.
       #
-      # @overload write(namespace: nil, branch_from_namespace: nil, copy_from_namespace: nil, delete_by_filter: nil, delete_by_filter_allow_partial: nil, delete_condition: nil, deletes: nil, disable_backpressure: nil, distance_metric: nil, encryption: nil, patch_by_filter: nil, patch_by_filter_allow_partial: nil, patch_columns: nil, patch_condition: nil, patch_rows: nil, return_affected_ids: nil, schema: nil, upsert_columns: nil, upsert_condition: nil, upsert_rows: nil, request_options: {})
+      # @overload write(namespace: nil, branch_from_namespace: nil, copy_from_namespace: nil, delete_by_filter: nil, delete_by_filter_allow_partial: nil, delete_condition: nil, deletes: nil, disable_backpressure: nil, distance_metric: nil, encryption: nil, patch_by_filter: nil, patch_by_filter_allow_partial: nil, patch_columns: nil, patch_condition: nil, patch_rows: nil, return_affected_ids: nil, schema: nil, sharding: nil, upsert_columns: nil, upsert_condition: nil, upsert_rows: nil, request_options: {})
       #
       # @param namespace [String] Path param: The name of the namespace.
       #
@@ -446,6 +450,8 @@ module Turbopuffer
       #
       # @param schema [Hash{Symbol=>String, Turbopuffer::Models::AttributeSchemaConfig}] Body param: The schema of the attributes attached to the documents.
       #
+      # @param sharding [Turbopuffer::Models::ShardingConfig] Body param: Configuration for namespace sharding, which partitions a namespace's
+      #
       # @param upsert_columns [Turbopuffer::Models::Columns] Body param: A list of documents in columnar format. Each key is a column name, m
       #
       # @param upsert_condition [Object] Body param: A condition evaluated against the current value of each document tar

data/lib/turbopuffer/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Turbopuffer
-  VERSION = "2.3.0"
+  VERSION = "2.4.0"
 end

data/lib/turbopuffer.rb

@@ -77,6 +77,9 @@ require_relative "turbopuffer/models/full_text_search"
 require_relative "turbopuffer/models/full_text_search_config"
 require_relative "turbopuffer/models/fuzzy_max_edit_distance"
 require_relative "turbopuffer/models/fuzzy_params"
+require_relative "turbopuffer/models/highlight_config_params"
+require_relative "turbopuffer/models/highlight_fragment_by"
+require_relative "turbopuffer/models/highlight_offset_units"
 require_relative "turbopuffer/models/id"
 require_relative "turbopuffer/models/include_attributes"
 require_relative "turbopuffer/models/language"
@@ -112,6 +115,7 @@ require_relative "turbopuffer/models/query_performance"
 require_relative "turbopuffer/models/row"
 require_relative "turbopuffer/models/rrf_params"
 require_relative "turbopuffer/models/saturate_params"
+require_relative "turbopuffer/models/sharding_config"
 require_relative "turbopuffer/models/sparse_distance_metric"
 require_relative "turbopuffer/models/tokenizer"
 require_relative "turbopuffer/models/vector"

data/rbi/turbopuffer/models/attribute_schema_config.rbi

@@ -210,21 +210,38 @@ module Turbopuffer
           end
           attr_writer :distance_metric
 
+          # Opt in to late-interaction (MUVERA) indexing. Only valid on fixed-dim `[][N]f32`
+          # vector array attributes, and is required to enable an ANN index on such
+          # attributes. Defaults to `false`.
+          sig { returns(T.nilable(T::Boolean)) }
+          attr_reader :late_interaction
+
+          sig { params(late_interaction: T::Boolean).void }
+          attr_writer :late_interaction
+
           # Configuration options for ANN (Approximate Nearest Neighbor) indexing.
           sig do
             params(
-              distance_metric: Turbopuffer::DistanceMetric::OrSymbol
+              distance_metric: Turbopuffer::DistanceMetric::OrSymbol,
+              late_interaction: T::Boolean
             ).returns(T.attached_class)
           end
           def self.new(
             # A function used to calculate vector similarity.
-            distance_metric: nil
+            distance_metric: nil,
+            # Opt in to late-interaction (MUVERA) indexing. Only valid on fixed-dim `[][N]f32`
+            # vector array attributes, and is required to enable an ANN index on such
+            # attributes. Defaults to `false`.
+            late_interaction: nil
           )
           end
 
           sig do
             override.returns(
-              { distance_metric: Turbopuffer::DistanceMetric::OrSymbol }
+              {
+                distance_metric: Turbopuffer::DistanceMetric::OrSymbol,
+                late_interaction: T::Boolean
+              }
             )
           end
           def to_hash

data/rbi/turbopuffer/models/highlight_config_params.rbi

@@ -0,0 +1,85 @@
+# typed: strong
+
+module Turbopuffer
+  module Models
+    class HighlightConfigParams < Turbopuffer::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            Turbopuffer::HighlightConfigParams,
+            Turbopuffer::Internal::AnyHash
+          )
+        end
+
+      # How to split a text attribute into fragments for highlighting.
+      sig { returns(T.nilable(Turbopuffer::HighlightFragmentBy::OrSymbol)) }
+      attr_reader :fragment_by
+
+      sig do
+        params(fragment_by: Turbopuffer::HighlightFragmentBy::OrSymbol).void
+      end
+      attr_writer :fragment_by
+
+      # The maximum number of fragments to return. Defaults to `3`.
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :fragment_limit
+
+      sig { params(fragment_limit: Integer).void }
+      attr_writer :fragment_limit
+
+      # The units to report highlighted fragment offsets in.
+      sig { returns(T.nilable(Turbopuffer::HighlightOffsetUnits::OrSymbol)) }
+      attr_reader :include_offsets
+
+      sig do
+        params(
+          include_offsets: Turbopuffer::HighlightOffsetUnits::OrSymbol
+        ).void
+      end
+      attr_writer :include_offsets
+
+      # How to rank candidate fragments within the attribute before selecting the top
+      # `fragment_limit`. Defaults to the query's `rank_by`.
+      sig { returns(T.nilable(T.anything)) }
+      attr_reader :rank_fragments_by
+
+      sig { params(rank_fragments_by: T.anything).void }
+      attr_writer :rank_fragments_by
+
+      # Additional (optional) parameters for the Highlight compute expression.
+      sig do
+        params(
+          fragment_by: Turbopuffer::HighlightFragmentBy::OrSymbol,
+          fragment_limit: Integer,
+          include_offsets: Turbopuffer::HighlightOffsetUnits::OrSymbol,
+          rank_fragments_by: T.anything
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # How to split a text attribute into fragments for highlighting.
+        fragment_by: nil,
+        # The maximum number of fragments to return. Defaults to `3`.
+        fragment_limit: nil,
+        # The units to report highlighted fragment offsets in.
+        include_offsets: nil,
+        # How to rank candidate fragments within the attribute before selecting the top
+        # `fragment_limit`. Defaults to the query's `rank_by`.
+        rank_fragments_by: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            fragment_by: Turbopuffer::HighlightFragmentBy::OrSymbol,
+            fragment_limit: Integer,
+            include_offsets: Turbopuffer::HighlightOffsetUnits::OrSymbol,
+            rank_fragments_by: T.anything
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end