turbopuffer-ruby 0.2.0.pre.alpha.1

data/lib/turbopuffer/internal.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Turbopuffer
+  module Internal
+    extend Turbopuffer::Internal::Util::SorbetRuntimeSupport
+
+    OMIT =
+      Object.new.tap do
+        _1.define_singleton_method(:inspect) { "#<#{Turbopuffer::Internal}::OMIT>" }
+      end
+        .freeze
+
+    define_sorbet_constant!(:AnyHash) do
+      T.type_alias { T::Hash[Symbol, T.anything] }
+    end
+    define_sorbet_constant!(:FileInput) do
+      T.type_alias { T.any(Pathname, StringIO, IO, String, Turbopuffer::FilePart) }
+    end
+  end
+end

data/lib/turbopuffer/models/attribute_schema.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Turbopuffer
+  module Models
+    # The schema for an attribute attached to a document.
+    module AttributeSchema
+      extend Turbopuffer::Internal::Type::Union
+
+      # The data type of the attribute. Valid values: string, int, uint, uuid, datetime, bool, []string, []int, []uint, []uuid, []datetime, [DIMS]f16, [DIMS]f32.
+      variant -> { Turbopuffer::AttributeType }
+
+      # Detailed configuration for an attribute attached to a document.
+      variant -> { Turbopuffer::AttributeSchemaConfig }
+
+      # @!method self.variants
+      #   @return [Array(String, Turbopuffer::Models::AttributeSchemaConfig)]
+    end
+  end
+end

data/lib/turbopuffer/models/attribute_schema_config.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Turbopuffer
+  module Models
+    class AttributeSchemaConfig < Turbopuffer::Internal::Type::BaseModel
+      # @!attribute ann
+      #   Whether to create an approximate nearest neighbor index for the attribute.
+      #
+      #   @return [Boolean, nil]
+      optional :ann, Turbopuffer::Internal::Type::Boolean
+
+      # @!attribute filterable
+      #   Whether or not the attributes can be used in filters.
+      #
+      #   @return [Boolean, nil]
+      optional :filterable, Turbopuffer::Internal::Type::Boolean
+
+      # @!attribute full_text_search
+      #   Whether this attribute can be used as part of a BM25 full-text search. Requires
+      #   the `string` or `[]string` type, and by default, BM25-enabled attributes are not
+      #   filterable. You can override this by setting `filterable: true`.
+      #
+      #   @return [Boolean, Turbopuffer::Models::FullTextSearchConfig, nil]
+      optional :full_text_search, union: -> { Turbopuffer::FullTextSearch }
+
+      # @!attribute type
+      #   The data type of the attribute. Valid values: string, int, uint, uuid, datetime,
+      #   bool, []string, []int, []uint, []uuid, []datetime, [DIMS]f16, [DIMS]f32.
+      #
+      #   @return [String, nil]
+      optional :type, String
+
+      # @!method initialize(ann: nil, filterable: nil, full_text_search: nil, type: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Turbopuffer::Models::AttributeSchemaConfig} for more details.
+      #
+      #   Detailed configuration for an attribute attached to a document.
+      #
+      #   @param ann [Boolean] Whether to create an approximate nearest neighbor index for the attribute.
+      #
+      #   @param filterable [Boolean] Whether or not the attributes can be used in filters.
+      #
+      #   @param full_text_search [Boolean, Turbopuffer::Models::FullTextSearchConfig] Whether this attribute can be used as part of a BM25 full-text search. Requires
+      #
+      #   @param type [String] The data type of the attribute. Valid values: string, int, uint, uuid, datetime,
+    end
+  end
+end

data/lib/turbopuffer/models/attribute_type.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Turbopuffer
+  module Models
+    AttributeType = String
+  end
+end

data/lib/turbopuffer/models/client_namespaces_params.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module Turbopuffer
+  module Models
+    # @see Turbopuffer::Resources::Client#namespaces
+    class ClientNamespacesParams < Turbopuffer::Internal::Type::BaseModel
+      extend Turbopuffer::Internal::Type::RequestParameters::Converter
+      include Turbopuffer::Internal::Type::RequestParameters
+
+      # @!attribute cursor
+      #   Retrieve the next page of results.
+      #
+      #   @return [String, nil]
+      optional :cursor, String
+
+      # @!attribute page_size
+      #   Limit the number of results per page.
+      #
+      #   @return [Integer, nil]
+      optional :page_size, Integer
+
+      # @!attribute prefix
+      #   Retrieve only the namespaces that match the prefix.
+      #
+      #   @return [String, nil]
+      optional :prefix, String
+
+      # @!method initialize(cursor: nil, page_size: nil, prefix: nil, request_options: {})
+      #   @param cursor [String] Retrieve the next page of results.
+      #
+      #   @param page_size [Integer] Limit the number of results per page.
+      #
+      #   @param prefix [String] Retrieve only the namespaces that match the prefix.
+      #
+      #   @param request_options [Turbopuffer::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/turbopuffer/models/columns.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+module Turbopuffer
+  module Models
+    class Columns < Turbopuffer::Internal::Type::BaseModel
+      # @!attribute id
+      #   The IDs of the documents.
+      #
+      #   @return [Array<String, Integer>]
+      required :id, -> { Turbopuffer::Internal::Type::ArrayOf[union: Turbopuffer::ID] }
+
+      # @!attribute vector
+      #   The vector embeddings of the documents.
+      #
+      #   @return [Array<Array<Float>, String>, Array<Float>, String, nil]
+      optional :vector, union: -> { Turbopuffer::Columns::Vector }
+
+      # @!method initialize(id:, vector: nil)
+      #   A list of documents in columnar format. Each key is a column name, mapped to an
+      #   array of values for that column.
+      #
+      #   @param id [Array<String, Integer>] The IDs of the documents.
+      #
+      #   @param vector [Array<Array<Float>, String>, Array<Float>, String] The vector embeddings of the documents.
+
+      # The vector embeddings of the documents.
+      #
+      # @see Turbopuffer::Models::Columns#vector
+      module Vector
+        extend Turbopuffer::Internal::Type::Union
+
+        # The vector embeddings of the documents.
+        variant -> { Turbopuffer::Models::Columns::Vector::VectorArray }
+
+        # A dense vector encoded as an array of floats.
+        variant -> { Turbopuffer::Models::Columns::Vector::FloatArray }
+
+        # A dense vector encoded as a base64 string.
+        variant String
+
+        # @!method self.variants
+        #   @return [Array(Array<Array<Float>, String>, Array<Float>, String)]
+
+        # @type [Turbopuffer::Internal::Type::Converter]
+        VectorArray = Turbopuffer::Internal::Type::ArrayOf[union: -> { Turbopuffer::Vector }]
+
+        # @type [Turbopuffer::Internal::Type::Converter]
+        FloatArray = Turbopuffer::Internal::Type::ArrayOf[Float]
+      end
+
+      def method_missing(name, *args, &block)
+        if @data.key?(name)
+          @data[name]
+        else
+          super
+        end
+      end
+
+      def respond_to_missing?(name, include_private = false)
+        @data.key?(name) || super
+      end
+    end
+  end
+end

data/lib/turbopuffer/models/distance_metric.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Turbopuffer
+  module Models
+    # A function used to calculate vector similarity.
+    module DistanceMetric
+      extend Turbopuffer::Internal::Type::Enum
+
+      # Defined as `1 - cosine_similarity` and ranges from 0 to 2. Lower is better.
+      COSINE_DISTANCE = :cosine_distance
+
+      # Defined as `sum((x - y)^2)`. Lower is better.
+      EUCLIDEAN_SQUARED = :euclidean_squared
+
+      # @!method self.values
+      #   @return [Array<Symbol>]
+    end
+  end
+end

data/lib/turbopuffer/models/full_text_search.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Turbopuffer
+  module Models
+    # Whether this attribute can be used as part of a BM25 full-text search. Requires
+    # the `string` or `[]string` type, and by default, BM25-enabled attributes are not
+    # filterable. You can override this by setting `filterable: true`.
+    module FullTextSearch
+      extend Turbopuffer::Internal::Type::Union
+
+      variant Turbopuffer::Internal::Type::Boolean
+
+      # Configuration options for full-text search.
+      variant -> { Turbopuffer::FullTextSearchConfig }
+
+      # @!method self.variants
+      #   @return [Array(Boolean, Turbopuffer::Models::FullTextSearchConfig)]
+    end
+  end
+end

data/lib/turbopuffer/models/full_text_search_config.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+module Turbopuffer
+  module Models
+    class FullTextSearchConfig < Turbopuffer::Internal::Type::BaseModel
+      # @!attribute b
+      #   The `b` document length normalization parameter for BM25. Defaults to `0.75`.
+      #
+      #   @return [Float, nil]
+      optional :b, Float
+
+      # @!attribute case_sensitive
+      #   Whether searching is case-sensitive. Defaults to `false` (i.e.
+      #   case-insensitive).
+      #
+      #   @return [Boolean, nil]
+      optional :case_sensitive, Turbopuffer::Internal::Type::Boolean
+
+      # @!attribute k1
+      #   The `k1` term saturation parameter for BM25. Defaults to `1.2`.
+      #
+      #   @return [Float, nil]
+      optional :k1, Float
+
+      # @!attribute language
+      #   Describes the language of a text attribute. Defaults to `english`.
+      #
+      #   @return [Symbol, Turbopuffer::Models::Language, nil]
+      optional :language, enum: -> { Turbopuffer::Language }
+
+      # @!attribute remove_stopwords
+      #   Removes common words from the text based on language. Defaults to `true` (i.e.
+      #   remove common words).
+      #
+      #   @return [Boolean, nil]
+      optional :remove_stopwords, Turbopuffer::Internal::Type::Boolean
+
+      # @!attribute stemming
+      #   Language-specific stemming for the text. Defaults to `false` (i.e., do not
+      #   stem).
+      #
+      #   @return [Boolean, nil]
+      optional :stemming, Turbopuffer::Internal::Type::Boolean
+
+      # @!attribute tokenizer
+      #   The tokenizer to use for full-text search on an attribute.
+      #
+      #   @return [Symbol, Turbopuffer::Models::Tokenizer, nil]
+      optional :tokenizer, enum: -> { Turbopuffer::Tokenizer }
+
+      # @!method initialize(b: nil, case_sensitive: nil, k1: nil, language: nil, remove_stopwords: nil, stemming: nil, tokenizer: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Turbopuffer::Models::FullTextSearchConfig} for more details.
+      #
+      #   Configuration options for full-text search.
+      #
+      #   @param b [Float] The `b` document length normalization parameter for BM25. Defaults to `0.75`.
+      #
+      #   @param case_sensitive [Boolean] Whether searching is case-sensitive. Defaults to `false` (i.e. case-insensitive)
+      #
+      #   @param k1 [Float] The `k1` term saturation parameter for BM25. Defaults to `1.2`.
+      #
+      #   @param language [Symbol, Turbopuffer::Models::Language] Describes the language of a text attribute. Defaults to `english`.
+      #
+      #   @param remove_stopwords [Boolean] Removes common words from the text based on language. Defaults to `true` (i.e. r
+      #
+      #   @param stemming [Boolean] Language-specific stemming for the text. Defaults to `false` (i.e., do not stem)
+      #
+      #   @param tokenizer [Symbol, Turbopuffer::Models::Tokenizer] The tokenizer to use for full-text search on an attribute.
+    end
+  end
+end

data/lib/turbopuffer/models/id.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Turbopuffer
+  module Models
+    # An identifier for a document.
+    module ID
+      extend Turbopuffer::Internal::Type::Union
+
+      # A UUID.
+      variant String
+
+      # An integer ID.
+      variant Integer
+
+      # @!method self.variants
+      #   @return [Array(String, Integer)]
+    end
+  end
+end

data/lib/turbopuffer/models/include_attributes.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Turbopuffer
+  module Models
+    # Whether to include attributes in the response.
+    module IncludeAttributes
+      extend Turbopuffer::Internal::Type::Union
+
+      # When `true`, include all attributes in the response. When `false`, include no attributes in the response.
+      variant Turbopuffer::Internal::Type::Boolean
+
+      # Include exactly the specified attributes in the response.
+      variant -> { Turbopuffer::Models::IncludeAttributes::StringArray }
+
+      # @!method self.variants
+      #   @return [Array(Boolean, Array<String>)]
+
+      # @type [Turbopuffer::Internal::Type::Converter]
+      StringArray = Turbopuffer::Internal::Type::ArrayOf[String]
+    end
+  end
+end

data/lib/turbopuffer/models/language.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Turbopuffer
+  module Models
+    # Describes the language of a text attribute. Defaults to `english`.
+    module Language
+      extend Turbopuffer::Internal::Type::Enum
+
+      ARABIC = :arabic
+      DANISH = :danish
+      DUTCH = :dutch
+      ENGLISH = :english
+      FINNISH = :finnish
+      FRENCH = :french
+      GERMAN = :german
+      GREEK = :greek
+      HUNGARIAN = :hungarian
+      ITALIAN = :italian
+      NORWEGIAN = :norwegian
+      PORTUGUESE = :portuguese
+      ROMANIAN = :romanian
+      RUSSIAN = :russian
+      SPANISH = :spanish
+      SWEDISH = :swedish
+      TAMIL = :tamil
+      TURKISH = :turkish
+
+      # @!method self.values
+      #   @return [Array<Symbol>]
+    end
+  end
+end

data/lib/turbopuffer/models/namespace_delete_all_params.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Turbopuffer
+  module Models
+    # @see Turbopuffer::Resources::Namespaces#delete_all
+    class NamespaceDeleteAllParams < Turbopuffer::Internal::Type::BaseModel
+      extend Turbopuffer::Internal::Type::RequestParameters::Converter
+      include Turbopuffer::Internal::Type::RequestParameters
+
+      # @!attribute namespace
+      #
+      #   @return [String, nil]
+      optional :namespace, String
+
+      # @!method initialize(namespace: nil, request_options: {})
+      #   @param namespace [String]
+      #   @param request_options [Turbopuffer::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/turbopuffer/models/namespace_delete_all_response.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Turbopuffer
+  module Models
+    # @see Turbopuffer::Resources::Namespaces#delete_all
+    class NamespaceDeleteAllResponse < Turbopuffer::Internal::Type::BaseModel
+      # @!attribute status
+      #   The status of the request.
+      #
+      #   @return [Symbol, :OK]
+      required :status, const: :OK
+
+      # @!method initialize(status: :OK)
+      #   The response to a successful namespace deletion request.
+      #
+      #   @param status [Symbol, :OK] The status of the request.
+    end
+  end
+end

data/lib/turbopuffer/models/namespace_hint_cache_warm_params.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Turbopuffer
+  module Models
+    # @see Turbopuffer::Resources::Namespaces#hint_cache_warm
+    class NamespaceHintCacheWarmParams < Turbopuffer::Internal::Type::BaseModel
+      extend Turbopuffer::Internal::Type::RequestParameters::Converter
+      include Turbopuffer::Internal::Type::RequestParameters
+
+      # @!attribute namespace
+      #
+      #   @return [String, nil]
+      optional :namespace, String
+
+      # @!method initialize(namespace: nil, request_options: {})
+      #   @param namespace [String]
+      #   @param request_options [Turbopuffer::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/turbopuffer/models/namespace_hint_cache_warm_response.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Turbopuffer
+  module Models
+    # @see Turbopuffer::Resources::Namespaces#hint_cache_warm
+    class NamespaceHintCacheWarmResponse < Turbopuffer::Internal::Type::BaseModel
+      # @!attribute status
+      #   The status of the request.
+      #
+      #   @return [Symbol, :OK]
+      required :status, const: :OK
+
+      # @!attribute message
+      #
+      #   @return [String, nil]
+      optional :message, String
+
+      # @!method initialize(message: nil, status: :OK)
+      #   The response to a successful cache warm request.
+      #
+      #   @param message [String]
+      #
+      #   @param status [Symbol, :OK] The status of the request.
+    end
+  end
+end

data/lib/turbopuffer/models/namespace_metadata.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module Turbopuffer
+  module Models
+    # @see Turbopuffer::Resources::Namespaces#metadata
+    class NamespaceMetadata < Turbopuffer::Internal::Type::BaseModel
+      # @!attribute approx_logical_bytes
+      #   The approximate number of logical bytes in the namespace.
+      #
+      #   @return [Integer]
+      required :approx_logical_bytes, Integer
+
+      # @!attribute created_at
+      #   The timestamp when the namespace was created.
+      #
+      #   @return [Time]
+      required :created_at, Time
+
+      # @!attribute schema
+      #   The schema of the namespace.
+      #
+      #   @return [Hash{Symbol=>Turbopuffer::Models::AttributeSchemaConfig}]
+      required :schema, -> { Turbopuffer::Internal::Type::HashOf[Turbopuffer::AttributeSchemaConfig] }
+
+      # @!method initialize(approx_logical_bytes:, created_at:, schema:)
+      #   Metadata about a namespace.
+      #
+      #   @param approx_logical_bytes [Integer] The approximate number of logical bytes in the namespace.
+      #
+      #   @param created_at [Time] The timestamp when the namespace was created.
+      #
+      #   @param schema [Hash{Symbol=>Turbopuffer::Models::AttributeSchemaConfig}] The schema of the namespace.
+    end
+  end
+end

data/lib/turbopuffer/models/namespace_metadata_params.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Turbopuffer
+  module Models
+    # @see Turbopuffer::Resources::Namespaces#metadata
+    class NamespaceMetadataParams < Turbopuffer::Internal::Type::BaseModel
+      extend Turbopuffer::Internal::Type::RequestParameters::Converter
+      include Turbopuffer::Internal::Type::RequestParameters
+
+      # @!attribute namespace
+      #
+      #   @return [String, nil]
+      optional :namespace, String
+
+      # @!method initialize(namespace: nil, request_options: {})
+      #   @param namespace [String]
+      #   @param request_options [Turbopuffer::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/turbopuffer/models/namespace_multi_query_params.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+module Turbopuffer
+  module Models
+    # @see Turbopuffer::Resources::Namespaces#multi_query
+    class NamespaceMultiQueryParams < Turbopuffer::Internal::Type::BaseModel
+      extend Turbopuffer::Internal::Type::RequestParameters::Converter
+      include Turbopuffer::Internal::Type::RequestParameters
+
+      # @!attribute namespace
+      #
+      #   @return [String, nil]
+      optional :namespace, String
+
+      # @!attribute queries
+      #
+      #   @return [Array<Turbopuffer::Models::Query>]
+      required :queries, -> { Turbopuffer::Internal::Type::ArrayOf[Turbopuffer::Query] }
+
+      # @!attribute consistency
+      #   The consistency level for a query.
+      #
+      #   @return [Turbopuffer::Models::NamespaceMultiQueryParams::Consistency, nil]
+      optional :consistency, -> { Turbopuffer::NamespaceMultiQueryParams::Consistency }
+
+      # @!attribute vector_encoding
+      #   The encoding to use for vectors in the response.
+      #
+      #   @return [Symbol, Turbopuffer::Models::VectorEncoding, nil]
+      optional :vector_encoding, enum: -> { Turbopuffer::VectorEncoding }
+
+      # @!method initialize(queries:, namespace: nil, consistency: nil, vector_encoding: nil, request_options: {})
+      #   @param queries [Array<Turbopuffer::Models::Query>]
+      #
+      #   @param namespace [String]
+      #
+      #   @param consistency [Turbopuffer::Models::NamespaceMultiQueryParams::Consistency] The consistency level for a query.
+      #
+      #   @param vector_encoding [Symbol, Turbopuffer::Models::VectorEncoding] The encoding to use for vectors in the response.
+      #
+      #   @param request_options [Turbopuffer::RequestOptions, Hash{Symbol=>Object}]
+
+      class Consistency < Turbopuffer::Internal::Type::BaseModel
+        # @!attribute level
+        #   The query's consistency level.
+        #
+        #   @return [Symbol, Turbopuffer::Models::NamespaceMultiQueryParams::Consistency::Level, nil]
+        optional :level, enum: -> { Turbopuffer::NamespaceMultiQueryParams::Consistency::Level }
+
+        # @!method initialize(level: nil)
+        #   The consistency level for a query.
+        #
+        #   @param level [Symbol, Turbopuffer::Models::NamespaceMultiQueryParams::Consistency::Level] The query's consistency level.
+
+        # The query's consistency level.
+        #
+        # @see Turbopuffer::Models::NamespaceMultiQueryParams::Consistency#level
+        module Level
+          extend Turbopuffer::Internal::Type::Enum
+
+          # Strong consistency. Requires a round-trip to object storage to fetch the latest writes.
+          STRONG = :strong
+
+          # Eventual consistency. Does not require a round-trip to object storage, but may not see the latest writes.
+          EVENTUAL = :eventual
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/turbopuffer/models/namespace_multi_query_response.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module Turbopuffer
+  module Models
+    # @see Turbopuffer::Resources::Namespaces#multi_query
+    class NamespaceMultiQueryResponse < Turbopuffer::Internal::Type::BaseModel
+      # @!attribute billing
+      #   The billing information for a query.
+      #
+      #   @return [Turbopuffer::Models::QueryBilling]
+      required :billing, -> { Turbopuffer::QueryBilling }
+
+      # @!attribute performance
+      #   The performance information for a query.
+      #
+      #   @return [Turbopuffer::Models::QueryPerformance]
+      required :performance, -> { Turbopuffer::QueryPerformance }
+
+      # @!attribute results
+      #
+      #   @return [Array<Turbopuffer::Models::NamespaceMultiQueryResponse::Result>]
+      required :results,
+               -> { Turbopuffer::Internal::Type::ArrayOf[Turbopuffer::Models::NamespaceMultiQueryResponse::Result] }
+
+      # @!method initialize(billing:, performance:, results:)
+      #   The result of a multi-query.
+      #
+      #   @param billing [Turbopuffer::Models::QueryBilling] The billing information for a query.
+      #
+      #   @param performance [Turbopuffer::Models::QueryPerformance] The performance information for a query.
+      #
+      #   @param results [Array<Turbopuffer::Models::NamespaceMultiQueryResponse::Result>]
+
+      class Result < Turbopuffer::Internal::Type::BaseModel
+        # @!attribute aggregations
+        #
+        #   @return [Hash{Symbol=>Object}, nil]
+        optional :aggregations, Turbopuffer::Internal::Type::HashOf[Turbopuffer::Internal::Type::Unknown]
+
+        # @!attribute rows
+        #
+        #   @return [Array<Turbopuffer::Models::Row>, nil]
+        optional :rows, -> { Turbopuffer::Internal::Type::ArrayOf[Turbopuffer::Row] }
+
+        # @!method initialize(aggregations: nil, rows: nil)
+        #   @param aggregations [Hash{Symbol=>Object}]
+        #   @param rows [Array<Turbopuffer::Models::Row>]
+      end
+    end
+  end
+end