turbopuffer 1.12.2 → 1.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 76ba369ee8a3bf99895b83a7d72cc02257a835139651940f02a86cb4adc1247c
-  data.tar.gz: b71e9e3031e6d0dbe82baf9fe9e13d056a4977789bfb4d6a444675285376e9d3
+  metadata.gz: bf103528d41a884cdd21e0f270de4c81ff9a0dace54a41bcf8be8c267e6a6130
+  data.tar.gz: cdfd28b66449cc1265566e23dbf48f58841eb7f075b8b060ce71762f6e9b5fbe
 SHA512:
-  metadata.gz: 667eeea38f344a0fd154b352664bac0b615f692f275ffba655798ec78526ebf0d7681067a9168bba76d0c3e696c96a52deaf9073d4043ed3554e37d523d4ff22
-  data.tar.gz: de73e44ca72966a51da5031e6b1fd6f82a6ba96cbd1698e1f4e073b7adddc9a33060baccfd18e40416912cda5f64c8d723c53dae6dba6d0ee61fc7839979076f
+  metadata.gz: 871db166c6bd140b8356c388f952c161a37dd26b68c64bafea41b90e3bb95d0124789efacf20b6eeff13de1e72b7181c1be0b71722a819c0302788cfed80100f
+  data.tar.gz: 888efaea3f982b55e38f0dc647913d5d400a1191261bc317ba8a51ec1f2a16bb136b31bb5cc9f8cb3b5612fdac60973855a65ed1e16688f2e5016e403ecc91ac

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 1.13.0 (2026-02-08)
+
+Full Changelog: [v1.12.2...v1.13.0](https://github.com/turbopuffer/turbopuffer-ruby/compare/v1.12.2...v1.13.0)
+
+### Features
+
+* add support for `limit` query parameter ([e7de801](https://github.com/turbopuffer/turbopuffer-ruby/commit/e7de80171a0d67759c0f04d15bf1f47f4bde6a6f))
+* spec: clean up limit codegen ([383ab43](https://github.com/turbopuffer/turbopuffer-ruby/commit/383ab4339dd079c33d01c1ef53c470be58994544))
+
 ## 1.12.2 (2026-02-06)
 
 Full Changelog: [v1.12.1...v1.12.2](https://github.com/turbopuffer/turbopuffer-ruby/compare/v1.12.1...v1.12.2)

data/README.md

@@ -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", "~> 1.12.2"
+gem "turbopuffer", "~> 1.13.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/turbopuffer/models/limit.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+module Turbopuffer
+  module Models
+    class Limit < Turbopuffer::Internal::Type::BaseModel
+      # @!attribute total
+      #   Limits the total number of documents returned.
+      #
+      #   @return [Integer]
+      required :total, Integer
+
+      # @!attribute per
+      #   Limits the number of documents with the same value for a set of attributes (the
+      #   "limit key") that can appear in the results.
+      #
+      #   @return [Turbopuffer::Models::Limit::Per, nil]
+      optional :per, -> { Turbopuffer::Limit::Per }
+
+      # @!method initialize(total:, per: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Turbopuffer::Models::Limit} for more details.
+      #
+      #   Limits the documents returned by a query.
+      #
+      #   @param total [Integer] Limits the total number of documents returned.
+      #
+      #   @param per [Turbopuffer::Models::Limit::Per] Limits the number of documents with the same value for a set of attributes (the
+
+      # @see Turbopuffer::Models::Limit#per
+      class Per < Turbopuffer::Internal::Type::BaseModel
+        # @!attribute attributes
+        #   The attributes to include in the limit key.
+        #
+        #   @return [Array<String>]
+        required :attributes, Turbopuffer::Internal::Type::ArrayOf[String]
+
+        # @!attribute limit
+        #   The maximum number of documents to return for each value of the limit key.
+        #
+        #   @return [Integer]
+        required :limit, Integer
+
+        # @!method initialize(attributes:, limit:)
+        #   Some parameter documentations has been truncated, see
+        #   {Turbopuffer::Models::Limit::Per} for more details.
+        #
+        #   Limits the number of documents with the same value for a set of attributes (the
+        #   "limit key") that can appear in the results.
+        #
+        #   @param attributes [Array<String>] The attributes to include in the limit key.
+        #
+        #   @param limit [Integer] The maximum number of documents to return for each value of the limit key.
+      end
+    end
+  end
+end

data/lib/turbopuffer/models/namespace_explain_query_params.rb

@@ -58,6 +58,12 @@ module Turbopuffer
       #   @return [Boolean, Array<String>, nil]
       optional :include_attributes, union: -> { Turbopuffer::IncludeAttributes }
 
+      # @!attribute limit
+      #   Limits the documents returned by a query.
+      #
+      #   @return [Integer, Turbopuffer::Models::Limit, nil]
+      optional :limit, union: -> { Turbopuffer::NamespaceExplainQueryParams::Limit }
+
       # @!attribute rank_by
       #   How to rank the documents in the namespace.
       #
@@ -76,7 +82,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, rank_by: nil, top_k: nil, vector_encoding: nil, request_options: {})
+      # @!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: {})
       #   Some parameter documentations has been truncated, see
       #   {Turbopuffer::Models::NamespaceExplainQueryParams} for more details.
       #
@@ -96,6 +102,8 @@ module Turbopuffer
       #
       #   @param include_attributes [Boolean, Array<String>] Whether to include attributes in the response.
       #
+      #   @param limit [Integer, Turbopuffer::Models::Limit] Limits the documents returned by a query.
+      #
       #   @param rank_by [Object] How to rank the documents in the namespace.
       #
       #   @param top_k [Integer] The number of results to return.
@@ -132,6 +140,19 @@ module Turbopuffer
           #   @return [Array<Symbol>]
         end
       end
+
+      # Limits the documents returned by a query.
+      module Limit
+        extend Turbopuffer::Internal::Type::Union
+
+        variant Integer
+
+        # Limits the documents returned by a query.
+        variant -> { Turbopuffer::Limit }
+
+        # @!method self.variants
+        #   @return [Array(Integer, Turbopuffer::Models::Limit)]
+      end
     end
   end
 end

data/lib/turbopuffer/models/namespace_query_params.rb

@@ -58,6 +58,12 @@ module Turbopuffer
       #   @return [Boolean, Array<String>, nil]
       optional :include_attributes, union: -> { Turbopuffer::IncludeAttributes }
 
+      # @!attribute limit
+      #   Limits the documents returned by a query.
+      #
+      #   @return [Integer, Turbopuffer::Models::Limit, nil]
+      optional :limit, union: -> { Turbopuffer::NamespaceQueryParams::Limit }
+
       # @!attribute rank_by
       #   How to rank the documents in the namespace.
       #
@@ -76,7 +82,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, rank_by: nil, top_k: nil, vector_encoding: nil, request_options: {})
+      # @!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: {})
       #   Some parameter documentations has been truncated, see
       #   {Turbopuffer::Models::NamespaceQueryParams} for more details.
       #
@@ -96,6 +102,8 @@ module Turbopuffer
       #
       #   @param include_attributes [Boolean, Array<String>] Whether to include attributes in the response.
       #
+      #   @param limit [Integer, Turbopuffer::Models::Limit] Limits the documents returned by a query.
+      #
       #   @param rank_by [Object] How to rank the documents in the namespace.
       #
       #   @param top_k [Integer] The number of results to return.
@@ -132,6 +140,19 @@ module Turbopuffer
           #   @return [Array<Symbol>]
         end
       end
+
+      # Limits the documents returned by a query.
+      module Limit
+        extend Turbopuffer::Internal::Type::Union
+
+        variant Integer
+
+        # Limits the documents returned by a query.
+        variant -> { Turbopuffer::Limit }
+
+        # @!method self.variants
+        #   @return [Array(Integer, Turbopuffer::Models::Limit)]
+      end
     end
   end
 end

data/lib/turbopuffer/models/query.rb

@@ -43,6 +43,12 @@ module Turbopuffer
       #   @return [Boolean, Array<String>, nil]
       optional :include_attributes, union: -> { Turbopuffer::IncludeAttributes }
 
+      # @!attribute limit
+      #   Limits the documents returned by a query.
+      #
+      #   @return [Integer, Turbopuffer::Models::Limit, nil]
+      optional :limit, union: -> { Turbopuffer::Query::Limit }
+
       # @!attribute rank_by
       #   How to rank the documents in the namespace.
       #
@@ -55,7 +61,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, rank_by: nil, top_k: nil)
+      # @!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)
       #   Some parameter documentations has been truncated, see
       #   {Turbopuffer::Models::Query} for more details.
       #
@@ -73,9 +79,26 @@ module Turbopuffer
       #
       #   @param include_attributes [Boolean, Array<String>] Whether to include attributes in the response.
       #
+      #   @param limit [Integer, Turbopuffer::Models::Limit] Limits the documents returned by a query.
+      #
       #   @param rank_by [Object] How to rank the documents in the namespace.
       #
       #   @param top_k [Integer] The number of results to return.
+
+      # Limits the documents returned by a query.
+      #
+      # @see Turbopuffer::Models::Query#limit
+      module Limit
+        extend Turbopuffer::Internal::Type::Union
+
+        variant Integer
+
+        # Limits the documents returned by a query.
+        variant -> { Turbopuffer::Limit }
+
+        # @!method self.variants
+        #   @return [Array(Integer, Turbopuffer::Models::Limit)]
+      end
     end
   end
 end

data/lib/turbopuffer/models.rb

@@ -70,6 +70,8 @@ module Turbopuffer
 
   Language = Turbopuffer::Models::Language
 
+  Limit = Turbopuffer::Models::Limit
+
   NamespaceDeleteAllParams = Turbopuffer::Models::NamespaceDeleteAllParams
 
   NamespaceExplainQueryParams = Turbopuffer::Models::NamespaceExplainQueryParams

data/lib/turbopuffer/resources/namespaces.rb

@@ -33,7 +33,7 @@ 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, rank_by: nil, top_k: nil, vector_encoding: nil, request_options: {})
+      # @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: {})
       #
       # @param namespace [String] Path param: The name of the namespace.
       #
@@ -51,6 +51,8 @@ module Turbopuffer
       #
       # @param include_attributes [Boolean, Array<String>] Body param: Whether to include attributes in the response.
       #
+      # @param limit [Integer, Turbopuffer::Models::Limit] Body param: Limits the documents returned by a query.
+      #
       # @param rank_by [Object] Body param: How to rank the documents in the namespace.
       #
       # @param top_k [Integer] Body param: The number of results to return.
@@ -164,7 +166,7 @@ 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, rank_by: nil, top_k: nil, vector_encoding: nil, request_options: {})
+      # @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: {})
       #
       # @param namespace [String] Path param: The name of the namespace.
       #
@@ -182,6 +184,8 @@ module Turbopuffer
       #
       # @param include_attributes [Boolean, Array<String>] Body param: Whether to include attributes in the response.
       #
+      # @param limit [Integer, Turbopuffer::Models::Limit] Body param: Limits the documents returned by a query.
+      #
       # @param rank_by [Object] Body param: How to rank the documents in the namespace.
       #
       # @param top_k [Integer] Body param: The number of results to return.

data/lib/turbopuffer/version.rb

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

data/lib/turbopuffer.rb

@@ -68,6 +68,7 @@ require_relative "turbopuffer/models/full_text_search_config"
 require_relative "turbopuffer/models/id"
 require_relative "turbopuffer/models/include_attributes"
 require_relative "turbopuffer/models/language"
+require_relative "turbopuffer/models/limit"
 require_relative "turbopuffer/models/namespace_delete_all_params"
 require_relative "turbopuffer/models/namespace_delete_all_response"
 require_relative "turbopuffer/models/namespace_explain_query_params"

data/rbi/turbopuffer/models/limit.rbi

@@ -0,0 +1,79 @@
+# typed: strong
+
+module Turbopuffer
+  module Models
+    class Limit < Turbopuffer::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Turbopuffer::Limit, Turbopuffer::Internal::AnyHash)
+        end
+
+      # Limits the total number of documents returned.
+      sig { returns(Integer) }
+      attr_accessor :total
+
+      # Limits the number of documents with the same value for a set of attributes (the
+      # "limit key") that can appear in the results.
+      sig { returns(T.nilable(Turbopuffer::Limit::Per)) }
+      attr_reader :per
+
+      sig { params(per: Turbopuffer::Limit::Per::OrHash).void }
+      attr_writer :per
+
+      # Limits the documents returned by a query.
+      sig do
+        params(total: Integer, per: Turbopuffer::Limit::Per::OrHash).returns(
+          T.attached_class
+        )
+      end
+      def self.new(
+        # Limits the total number of documents returned.
+        total:,
+        # Limits the number of documents with the same value for a set of attributes (the
+        # "limit key") that can appear in the results.
+        per: nil
+      )
+      end
+
+      sig { override.returns({ total: Integer, per: Turbopuffer::Limit::Per }) }
+      def to_hash
+      end
+
+      class Per < Turbopuffer::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(Turbopuffer::Limit::Per, Turbopuffer::Internal::AnyHash)
+          end
+
+        # The attributes to include in the limit key.
+        sig { returns(T::Array[String]) }
+        attr_accessor :attributes
+
+        # The maximum number of documents to return for each value of the limit key.
+        sig { returns(Integer) }
+        attr_accessor :limit
+
+        # Limits the number of documents with the same value for a set of attributes (the
+        # "limit key") that can appear in the results.
+        sig do
+          params(attributes: T::Array[String], limit: Integer).returns(
+            T.attached_class
+          )
+        end
+        def self.new(
+          # The attributes to include in the limit key.
+          attributes:,
+          # The maximum number of documents to return for each value of the limit key.
+          limit:
+        )
+        end
+
+        sig do
+          override.returns({ attributes: T::Array[String], limit: Integer })
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/turbopuffer/models/namespace_explain_query_params.rbi

@@ -88,6 +88,13 @@ module Turbopuffer
       end
       attr_writer :include_attributes
 
+      # Limits the documents returned by a query.
+      sig { returns(T.nilable(T.any(Integer, Turbopuffer::Limit))) }
+      attr_reader :limit
+
+      sig { params(limit: T.any(Integer, Turbopuffer::Limit::OrHash)).void }
+      attr_writer :limit
+
       # How to rank the documents in the namespace.
       sig { returns(T.nilable(T.anything)) }
       attr_reader :rank_by
@@ -122,6 +129,7 @@ module Turbopuffer
           filters: T.anything,
           group_by: T::Array[String],
           include_attributes: Turbopuffer::IncludeAttributes::Variants,
+          limit: T.any(Integer, Turbopuffer::Limit::OrHash),
           rank_by: T.anything,
           top_k: Integer,
           vector_encoding: Turbopuffer::VectorEncoding::OrSymbol,
@@ -148,6 +156,8 @@ module Turbopuffer
         group_by: nil,
         # Whether to include attributes in the response.
         include_attributes: nil,
+        # Limits the documents returned by a query.
+        limit: nil,
         # How to rank the documents in the namespace.
         rank_by: nil,
         # The number of results to return.
@@ -169,6 +179,7 @@ module Turbopuffer
             filters: T.anything,
             group_by: T::Array[String],
             include_attributes: Turbopuffer::IncludeAttributes::Variants,
+            limit: T.any(Integer, Turbopuffer::Limit),
             rank_by: T.anything,
             top_k: Integer,
             vector_encoding: Turbopuffer::VectorEncoding::OrSymbol,
@@ -268,6 +279,21 @@ module Turbopuffer
           end
         end
       end
+
+      # Limits the documents returned by a query.
+      module Limit
+        extend Turbopuffer::Internal::Type::Union
+
+        Variants = T.type_alias { T.any(Integer, Turbopuffer::Limit) }
+
+        sig do
+          override.returns(
+            T::Array[Turbopuffer::NamespaceExplainQueryParams::Limit::Variants]
+          )
+        end
+        def self.variants
+        end
+      end
     end
   end
 end

data/rbi/turbopuffer/models/namespace_query_params.rbi

@@ -83,6 +83,13 @@ module Turbopuffer
       end
       attr_writer :include_attributes
 
+      # Limits the documents returned by a query.
+      sig { returns(T.nilable(T.any(Integer, Turbopuffer::Limit))) }
+      attr_reader :limit
+
+      sig { params(limit: T.any(Integer, Turbopuffer::Limit::OrHash)).void }
+      attr_writer :limit
+
       # How to rank the documents in the namespace.
       sig { returns(T.nilable(T.anything)) }
       attr_reader :rank_by
@@ -116,6 +123,7 @@ module Turbopuffer
           filters: T.anything,
           group_by: T::Array[String],
           include_attributes: Turbopuffer::IncludeAttributes::Variants,
+          limit: T.any(Integer, Turbopuffer::Limit::OrHash),
           rank_by: T.anything,
           top_k: Integer,
           vector_encoding: Turbopuffer::VectorEncoding::OrSymbol,
@@ -142,6 +150,8 @@ module Turbopuffer
         group_by: nil,
         # Whether to include attributes in the response.
         include_attributes: nil,
+        # Limits the documents returned by a query.
+        limit: nil,
         # How to rank the documents in the namespace.
         rank_by: nil,
         # The number of results to return.
@@ -163,6 +173,7 @@ module Turbopuffer
             filters: T.anything,
             group_by: T::Array[String],
             include_attributes: Turbopuffer::IncludeAttributes::Variants,
+            limit: T.any(Integer, Turbopuffer::Limit),
             rank_by: T.anything,
             top_k: Integer,
             vector_encoding: Turbopuffer::VectorEncoding::OrSymbol,
@@ -262,6 +273,21 @@ module Turbopuffer
           end
         end
       end
+
+      # Limits the documents returned by a query.
+      module Limit
+        extend Turbopuffer::Internal::Type::Union
+
+        Variants = T.type_alias { T.any(Integer, Turbopuffer::Limit) }
+
+        sig do
+          override.returns(
+            T::Array[Turbopuffer::NamespaceQueryParams::Limit::Variants]
+          )
+        end
+        def self.variants
+        end
+      end
     end
   end
 end

data/rbi/turbopuffer/models/query.rbi

@@ -60,6 +60,13 @@ module Turbopuffer
       end
       attr_writer :include_attributes
 
+      # Limits the documents returned by a query.
+      sig { returns(T.nilable(T.any(Integer, Turbopuffer::Limit))) }
+      attr_reader :limit
+
+      sig { params(limit: T.any(Integer, Turbopuffer::Limit::OrHash)).void }
+      attr_writer :limit
+
       # How to rank the documents in the namespace.
       sig { returns(T.nilable(T.anything)) }
       attr_reader :rank_by
@@ -83,6 +90,7 @@ module Turbopuffer
           filters: T.anything,
           group_by: T::Array[String],
           include_attributes: Turbopuffer::IncludeAttributes::Variants,
+          limit: T.any(Integer, Turbopuffer::Limit::OrHash),
           rank_by: T.anything,
           top_k: Integer
         ).returns(T.attached_class)
@@ -104,6 +112,8 @@ module Turbopuffer
         group_by: nil,
         # Whether to include attributes in the response.
         include_attributes: nil,
+        # Limits the documents returned by a query.
+        limit: nil,
         # How to rank the documents in the namespace.
         rank_by: nil,
         # The number of results to return.
@@ -120,6 +130,7 @@ module Turbopuffer
             filters: T.anything,
             group_by: T::Array[String],
             include_attributes: Turbopuffer::IncludeAttributes::Variants,
+            limit: T.any(Integer, Turbopuffer::Limit),
             rank_by: T.anything,
             top_k: Integer
           }
@@ -127,6 +138,17 @@ module Turbopuffer
       end
       def to_hash
       end
+
+      # Limits the documents returned by a query.
+      module Limit
+        extend Turbopuffer::Internal::Type::Union
+
+        Variants = T.type_alias { T.any(Integer, Turbopuffer::Limit) }
+
+        sig { override.returns(T::Array[Turbopuffer::Query::Limit::Variants]) }
+        def self.variants
+        end
+      end
     end
   end
 end

data/rbi/turbopuffer/models.rbi

@@ -37,6 +37,8 @@ module Turbopuffer
 
   Language = Turbopuffer::Models::Language
 
+  Limit = Turbopuffer::Models::Limit
+
   NamespaceDeleteAllParams = Turbopuffer::Models::NamespaceDeleteAllParams
 
   NamespaceExplainQueryParams = Turbopuffer::Models::NamespaceExplainQueryParams

data/rbi/turbopuffer/resources/namespaces.rbi

@@ -29,6 +29,7 @@ module Turbopuffer
           filters: T.anything,
           group_by: T::Array[String],
           include_attributes: Turbopuffer::IncludeAttributes::Variants,
+          limit: T.any(Integer, Turbopuffer::Limit::OrHash),
           rank_by: T.anything,
           top_k: Integer,
           vector_encoding: Turbopuffer::VectorEncoding::OrSymbol,
@@ -56,6 +57,8 @@ module Turbopuffer
         group_by: nil,
         # Body param: Whether to include attributes in the response.
         include_attributes: nil,
+        # Body param: Limits the documents returned by a query.
+        limit: nil,
         # Body param: How to rank the documents in the namespace.
         rank_by: nil,
         # Body param: The number of results to return.
@@ -129,6 +132,7 @@ module Turbopuffer
           filters: T.anything,
           group_by: T::Array[String],
           include_attributes: Turbopuffer::IncludeAttributes::Variants,
+          limit: T.any(Integer, Turbopuffer::Limit::OrHash),
           rank_by: T.anything,
           top_k: Integer,
           vector_encoding: Turbopuffer::VectorEncoding::OrSymbol,
@@ -156,6 +160,8 @@ module Turbopuffer
         group_by: nil,
         # Body param: Whether to include attributes in the response.
         include_attributes: nil,
+        # Body param: Limits the documents returned by a query.
+        limit: nil,
         # Body param: How to rank the documents in the namespace.
         rank_by: nil,
         # Body param: The number of results to return.

data/sig/turbopuffer/models/limit.rbs

@@ -0,0 +1,29 @@
+module Turbopuffer
+  module Models
+    type limit = { total: Integer, per: Turbopuffer::Limit::Per }
+
+    class Limit < Turbopuffer::Internal::Type::BaseModel
+      attr_accessor total: Integer
+
+      attr_reader per: Turbopuffer::Limit::Per?
+
+      def per=: (Turbopuffer::Limit::Per) -> Turbopuffer::Limit::Per
+
+      def initialize: (total: Integer, ?per: Turbopuffer::Limit::Per) -> void
+
+      def to_hash: -> { total: Integer, per: Turbopuffer::Limit::Per }
+
+      type per = { attributes: ::Array[String], limit: Integer }
+
+      class Per < Turbopuffer::Internal::Type::BaseModel
+        attr_accessor attributes: ::Array[String]
+
+        attr_accessor limit: Integer
+
+        def initialize: (attributes: ::Array[String], limit: Integer) -> void
+
+        def to_hash: -> { attributes: ::Array[String], limit: Integer }
+      end
+    end
+  end
+end

data/sig/turbopuffer/models/namespace_explain_query_params.rbs

@@ -10,6 +10,7 @@ module Turbopuffer
         filters: top,
         group_by: ::Array[String],
         include_attributes: Turbopuffer::Models::include_attributes,
+        limit: Turbopuffer::Models::NamespaceExplainQueryParams::limit,
         rank_by: top,
         top_k: Integer,
         vector_encoding: Turbopuffer::Models::vector_encoding
@@ -58,6 +59,12 @@ module Turbopuffer
         Turbopuffer::Models::include_attributes
       ) -> Turbopuffer::Models::include_attributes
 
+      attr_reader limit: Turbopuffer::Models::NamespaceExplainQueryParams::limit?
+
+      def limit=: (
+        Turbopuffer::Models::NamespaceExplainQueryParams::limit
+      ) -> Turbopuffer::Models::NamespaceExplainQueryParams::limit
+
       attr_reader rank_by: top?
 
       def rank_by=: (top) -> top
@@ -81,6 +88,7 @@ module Turbopuffer
         ?filters: top,
         ?group_by: ::Array[String],
         ?include_attributes: Turbopuffer::Models::include_attributes,
+        ?limit: Turbopuffer::Models::NamespaceExplainQueryParams::limit,
         ?rank_by: top,
         ?top_k: Integer,
         ?vector_encoding: Turbopuffer::Models::vector_encoding,
@@ -96,6 +104,7 @@ module Turbopuffer
         filters: top,
         group_by: ::Array[String],
         include_attributes: Turbopuffer::Models::include_attributes,
+        limit: Turbopuffer::Models::NamespaceExplainQueryParams::limit,
         rank_by: top,
         top_k: Integer,
         vector_encoding: Turbopuffer::Models::vector_encoding,
@@ -136,6 +145,14 @@ module Turbopuffer
           def self?.values: -> ::Array[Turbopuffer::Models::NamespaceExplainQueryParams::Consistency::level]
         end
       end
+
+      type limit = Integer | Turbopuffer::Limit
+
+      module Limit
+        extend Turbopuffer::Internal::Type::Union
+
+        def self?.variants: -> ::Array[Turbopuffer::Models::NamespaceExplainQueryParams::limit]
+      end
     end
   end
 end

data/sig/turbopuffer/models/namespace_query_params.rbs

@@ -10,6 +10,7 @@ module Turbopuffer
         filters: top,
         group_by: ::Array[String],
         include_attributes: Turbopuffer::Models::include_attributes,
+        limit: Turbopuffer::Models::NamespaceQueryParams::limit,
         rank_by: top,
         top_k: Integer,
         vector_encoding: Turbopuffer::Models::vector_encoding
@@ -58,6 +59,12 @@ module Turbopuffer
         Turbopuffer::Models::include_attributes
       ) -> Turbopuffer::Models::include_attributes
 
+      attr_reader limit: Turbopuffer::Models::NamespaceQueryParams::limit?
+
+      def limit=: (
+        Turbopuffer::Models::NamespaceQueryParams::limit
+      ) -> Turbopuffer::Models::NamespaceQueryParams::limit
+
       attr_reader rank_by: top?
 
       def rank_by=: (top) -> top
@@ -81,6 +88,7 @@ module Turbopuffer
         ?filters: top,
         ?group_by: ::Array[String],
         ?include_attributes: Turbopuffer::Models::include_attributes,
+        ?limit: Turbopuffer::Models::NamespaceQueryParams::limit,
         ?rank_by: top,
         ?top_k: Integer,
         ?vector_encoding: Turbopuffer::Models::vector_encoding,
@@ -96,6 +104,7 @@ module Turbopuffer
         filters: top,
         group_by: ::Array[String],
         include_attributes: Turbopuffer::Models::include_attributes,
+        limit: Turbopuffer::Models::NamespaceQueryParams::limit,
         rank_by: top,
         top_k: Integer,
         vector_encoding: Turbopuffer::Models::vector_encoding,
@@ -134,6 +143,14 @@ module Turbopuffer
           def self?.values: -> ::Array[Turbopuffer::Models::NamespaceQueryParams::Consistency::level]
         end
       end
+
+      type limit = Integer | Turbopuffer::Limit
+
+      module Limit
+        extend Turbopuffer::Internal::Type::Union
+
+        def self?.variants: -> ::Array[Turbopuffer::Models::NamespaceQueryParams::limit]
+      end
     end
   end
 end

data/sig/turbopuffer/models/query.rbs

@@ -8,6 +8,7 @@ module Turbopuffer
         filters: top,
         group_by: ::Array[String],
         include_attributes: Turbopuffer::Models::include_attributes,
+        limit: Turbopuffer::Models::Query::limit,
         rank_by: top,
         top_k: Integer
       }
@@ -41,6 +42,12 @@ module Turbopuffer
         Turbopuffer::Models::include_attributes
       ) -> Turbopuffer::Models::include_attributes
 
+      attr_reader limit: Turbopuffer::Models::Query::limit?
+
+      def limit=: (
+        Turbopuffer::Models::Query::limit
+      ) -> Turbopuffer::Models::Query::limit
+
       attr_reader rank_by: top?
 
       def rank_by=: (top) -> top
@@ -56,6 +63,7 @@ module Turbopuffer
         ?filters: top,
         ?group_by: ::Array[String],
         ?include_attributes: Turbopuffer::Models::include_attributes,
+        ?limit: Turbopuffer::Models::Query::limit,
         ?rank_by: top,
         ?top_k: Integer
       ) -> void
@@ -67,9 +75,18 @@ module Turbopuffer
         filters: top,
         group_by: ::Array[String],
         include_attributes: Turbopuffer::Models::include_attributes,
+        limit: Turbopuffer::Models::Query::limit,
         rank_by: top,
         top_k: Integer
       }
+
+      type limit = Integer | Turbopuffer::Limit
+
+      module Limit
+        extend Turbopuffer::Internal::Type::Union
+
+        def self?.variants: -> ::Array[Turbopuffer::Models::Query::limit]
+      end
     end
   end
 end

data/sig/turbopuffer/models.rbs

@@ -29,6 +29,8 @@ module Turbopuffer
 
   module Language = Turbopuffer::Models::Language
 
+  class Limit = Turbopuffer::Models::Limit
+
   class NamespaceDeleteAllParams = Turbopuffer::Models::NamespaceDeleteAllParams
 
   class NamespaceExplainQueryParams = Turbopuffer::Models::NamespaceExplainQueryParams

data/sig/turbopuffer/resources/namespaces.rbs

@@ -15,6 +15,7 @@ module Turbopuffer
         ?filters: top,
         ?group_by: ::Array[String],
         ?include_attributes: Turbopuffer::Models::include_attributes,
+        ?limit: Turbopuffer::Models::NamespaceExplainQueryParams::limit,
         ?rank_by: top,
         ?top_k: Integer,
         ?vector_encoding: Turbopuffer::Models::vector_encoding,
@@ -48,6 +49,7 @@ module Turbopuffer
         ?filters: top,
         ?group_by: ::Array[String],
         ?include_attributes: Turbopuffer::Models::include_attributes,
+        ?limit: Turbopuffer::Models::NamespaceQueryParams::limit,
         ?rank_by: top,
         ?top_k: Integer,
         ?vector_encoding: Turbopuffer::Models::vector_encoding,

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: turbopuffer
 version: !ruby/object:Gem::Version
-  version: 1.12.2
+  version: 1.13.0
 platform: ruby
 authors:
 - Turbopuffer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-02-06 00:00:00.000000000 Z
+date: 2026-02-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi
@@ -85,6 +85,7 @@ files:
 - lib/turbopuffer/models/id.rb
 - lib/turbopuffer/models/include_attributes.rb
 - lib/turbopuffer/models/language.rb
+- lib/turbopuffer/models/limit.rb
 - lib/turbopuffer/models/namespace_delete_all_params.rb
 - lib/turbopuffer/models/namespace_delete_all_response.rb
 - lib/turbopuffer/models/namespace_explain_query_params.rb
@@ -154,6 +155,7 @@ files:
 - rbi/turbopuffer/models/id.rbi
 - rbi/turbopuffer/models/include_attributes.rbi
 - rbi/turbopuffer/models/language.rbi
+- rbi/turbopuffer/models/limit.rbi
 - rbi/turbopuffer/models/namespace_delete_all_params.rbi
 - rbi/turbopuffer/models/namespace_delete_all_response.rbi
 - rbi/turbopuffer/models/namespace_explain_query_params.rbi
@@ -222,6 +224,7 @@ files:
 - sig/turbopuffer/models/id.rbs
 - sig/turbopuffer/models/include_attributes.rbs
 - sig/turbopuffer/models/language.rbs
+- sig/turbopuffer/models/limit.rbs
 - sig/turbopuffer/models/namespace_delete_all_params.rbs
 - sig/turbopuffer/models/namespace_delete_all_response.rbs
 - sig/turbopuffer/models/namespace_explain_query_params.rbs