turbopuffer 2.3.0 → 2.5.0

data/lib/turbopuffer/models/namespace_poll_copy_from_params.rb

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

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.
       #
@@ -64,6 +72,13 @@ module Turbopuffer
       #   @return [Integer, Turbopuffer::Models::Limit, nil]
       optional :limit, union: -> { Turbopuffer::NamespaceQueryParams::Limit }
 
+      # @!attribute offset
+      #   Number of documents to skip before returning results. Supported only in v2
+      #   queries with an explicit `rank_by` and `top_k` or `limit`.
+      #
+      #   @return [Integer, nil]
+      optional :offset, Integer
+
       # @!attribute rank_by
       #   How to rank the documents in the namespace.
       #
@@ -82,7 +97,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, offset: 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 +105,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.
@@ -104,6 +121,8 @@ module Turbopuffer
       #
       #   @param limit [Integer, Turbopuffer::Models::Limit] Limits the documents returned by a query.
       #
+      #   @param offset [Integer] Number of documents to skip before returning results. Supported only in v2 queri
+      #
       #   @param rank_by [Object] How to rank the documents in the namespace.
       #
       #   @param top_k [Integer] The number of results to return.

data/lib/turbopuffer/models/namespace_start_copy_from_params.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+module Turbopuffer
+  module Models
+    # @see Turbopuffer::Resources::Namespaces#start_copy_from
+    class NamespaceStartCopyFromParams < Turbopuffer::Internal::Type::BaseModel
+      extend Turbopuffer::Internal::Type::RequestParameters::Converter
+      include Turbopuffer::Internal::Type::RequestParameters
+
+      # @!attribute namespace
+      #
+      #   @return [String, nil]
+      optional :namespace, String
+
+      # @!attribute source_namespace
+      #   The namespace to copy documents from.
+      #
+      #   @return [String]
+      required :source_namespace, String
+
+      # @!attribute dest_encryption
+      #   (Optional) The encryption configuration for the destination namespace.
+      #
+      #   @return [Turbopuffer::Models::Encryption::CustomerManaged, Turbopuffer::Models::Encryption::Default, nil]
+      optional :dest_encryption, union: -> { Turbopuffer::Encryption }
+
+      # @!attribute source_api_key
+      #   (Optional) An API key for the organization containing the source namespace
+      #
+      #   @return [String, nil]
+      optional :source_api_key, String
+
+      # @!attribute source_region
+      #   (Optional) The region of the source namespace.
+      #
+      #   @return [String, nil]
+      optional :source_region, String
+
+      # @!method initialize(source_namespace:, namespace: nil, dest_encryption: nil, source_api_key: nil, source_region: nil, request_options: {})
+      #   @param source_namespace [String] The namespace to copy documents from.
+      #
+      #   @param namespace [String]
+      #
+      #   @param dest_encryption [Turbopuffer::Models::Encryption::CustomerManaged, Turbopuffer::Models::Encryption::Default] (Optional) The encryption configuration for the destination namespace.
+      #
+      #   @param source_api_key [String] (Optional) An API key for the organization containing the source namespace
+      #
+      #   @param source_region [String] (Optional) The region of the source namespace.
+      #
+      #   @param request_options [Turbopuffer::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/turbopuffer/models/namespace_start_copy_from_response.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Turbopuffer
+  module Models
+    # @see Turbopuffer::Resources::Namespaces#start_copy_from
+    class NamespaceStartCopyFromResponse < Turbopuffer::Internal::Type::BaseModel
+      # @!attribute token
+      #   The token identifying the copy operation.
+      #
+      #   @return [String]
+      required :token, String
+
+      # @!method initialize(token:)
+      #   @param token [String] The token identifying the copy operation.
+    end
+  end
+end

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/operation_error.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module Turbopuffer
+  module Models
+    class OperationError < Turbopuffer::Internal::Type::BaseModel
+      # @!attribute detail
+      #   The response to an unsuccessful request.
+      #
+      #   @return [Turbopuffer::Models::OperationError::Detail]
+      required :detail, -> { Turbopuffer::OperationError::Detail }
+
+      # @!attribute status_code
+      #   The HTTP status code of the operation's error.
+      #
+      #   @return [Integer]
+      required :status_code, Integer
+
+      # @!method initialize(detail:, status_code:)
+      #   @param detail [Turbopuffer::Models::OperationError::Detail] The response to an unsuccessful request.
+      #
+      #   @param status_code [Integer] The HTTP status code of the operation's error.
+
+      # @see Turbopuffer::Models::OperationError#detail
+      class Detail < Turbopuffer::Internal::Type::BaseModel
+        # @!attribute error
+        #   The error message.
+        #
+        #   @return [String]
+        required :error, String
+
+        # @!attribute status
+        #   The status of the request.
+        #
+        #   @return [Symbol, :error]
+        required :status, const: :error
+
+        # @!method initialize(error:, status: :error)
+        #   The response to an unsuccessful request.
+        #
+        #   @param error [String] The error message.
+        #
+        #   @param status [Symbol, :error] The status of the request.
+      end
+    end
+  end
+end

data/lib/turbopuffer/models/rerank_limit.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Turbopuffer
+  module Models
+    class RerankLimit < Turbopuffer::Internal::Type::BaseModel
+      # @!attribute total
+      #   Limits the total number of documents returned after reranking.
+      #
+      #   @return [Integer]
+      required :total, Integer
+
+      # @!method initialize(total:)
+      #   Limits the total number of reranked documents returned.
+      #
+      #   @param total [Integer] Limits the total number of documents returned after reranking.
+    end
+  end
+end

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/write_result.rb

@@ -0,0 +1,112 @@
+# frozen_string_literal: true
+
+module Turbopuffer
+  module Models
+    class WriteResult < Turbopuffer::Internal::Type::BaseModel
+      # @!attribute billing
+      #   The billing information for a write request.
+      #
+      #   @return [Turbopuffer::Models::WriteBilling]
+      required :billing, -> { Turbopuffer::WriteBilling }
+
+      # @!attribute message
+      #   A message describing the result of the write request.
+      #
+      #   @return [String]
+      required :message, String
+
+      # @!attribute rows_affected
+      #   The number of rows affected by the write request.
+      #
+      #   @return [Integer]
+      required :rows_affected, Integer
+
+      # @!attribute status
+      #   The status of the request.
+      #
+      #   @return [Symbol, :OK]
+      required :status, const: :OK
+
+      # @!attribute deleted_ids
+      #   The IDs of documents that were deleted. Only included when `return_affected_ids`
+      #   is true and at least one document was deleted.
+      #
+      #   @return [Array<String, Integer>, nil]
+      optional :deleted_ids, -> { Turbopuffer::Internal::Type::ArrayOf[union: Turbopuffer::ID] }
+
+      # @!attribute patched_ids
+      #   The IDs of documents that were patched. Only included when `return_affected_ids`
+      #   is true and at least one document was patched.
+      #
+      #   @return [Array<String, Integer>, nil]
+      optional :patched_ids, -> { Turbopuffer::Internal::Type::ArrayOf[union: Turbopuffer::ID] }
+
+      # @!attribute performance
+      #   The performance information for a write request.
+      #
+      #   @return [Turbopuffer::Models::WritePerformance, nil]
+      optional :performance, -> { Turbopuffer::WritePerformance }
+
+      # @!attribute rows_deleted
+      #   The number of rows deleted by the write request.
+      #
+      #   @return [Integer, nil]
+      optional :rows_deleted, Integer
+
+      # @!attribute rows_patched
+      #   The number of rows patched by the write request.
+      #
+      #   @return [Integer, nil]
+      optional :rows_patched, Integer
+
+      # @!attribute rows_remaining
+      #   Whether more documents match the filter for partial operations.
+      #
+      #   @return [Boolean, nil]
+      optional :rows_remaining, Turbopuffer::Internal::Type::Boolean
+
+      # @!attribute rows_upserted
+      #   The number of rows upserted by the write request.
+      #
+      #   @return [Integer, nil]
+      optional :rows_upserted, Integer
+
+      # @!attribute upserted_ids
+      #   The IDs of documents that were upserted. Only included when
+      #   `return_affected_ids` is true and at least one document was upserted.
+      #
+      #   @return [Array<String, Integer>, nil]
+      optional :upserted_ids, -> { Turbopuffer::Internal::Type::ArrayOf[union: Turbopuffer::ID] }
+
+      # @!method initialize(billing:, message:, rows_affected:, deleted_ids: nil, patched_ids: nil, performance: nil, rows_deleted: nil, rows_patched: nil, rows_remaining: nil, rows_upserted: nil, upserted_ids: nil, status: :OK)
+      #   Some parameter documentations has been truncated, see
+      #   {Turbopuffer::Models::WriteResult} for more details.
+      #
+      #   The response to a successful write request.
+      #
+      #   @param billing [Turbopuffer::Models::WriteBilling] The billing information for a write request.
+      #
+      #   @param message [String] A message describing the result of the write request.
+      #
+      #   @param rows_affected [Integer] The number of rows affected by the write request.
+      #
+      #   @param deleted_ids [Array<String, Integer>] The IDs of documents that were deleted. Only included when `return_affected_ids`
+      #
+      #   @param patched_ids [Array<String, Integer>] The IDs of documents that were patched. Only included when `return_affected_ids`
+      #
+      #   @param performance [Turbopuffer::Models::WritePerformance] The performance information for a write request.
+      #
+      #   @param rows_deleted [Integer] The number of rows deleted by the write request.
+      #
+      #   @param rows_patched [Integer] The number of rows patched by the write request.
+      #
+      #   @param rows_remaining [Boolean] Whether more documents match the filter for partial operations.
+      #
+      #   @param rows_upserted [Integer] The number of rows upserted by the write request.
+      #
+      #   @param upserted_ids [Array<String, Integer>] The IDs of documents that were upserted. Only included when `return_affected_ids
+      #
+      #   @param status [Symbol, :OK] The status of the request.
+    end
+  end
+end

data/lib/turbopuffer/models.rb

@@ -64,6 +64,10 @@ module Turbopuffer
 
   ContainsAnyTokenFilterParams = Turbopuffer::Models::ContainsAnyTokenFilterParams
 
+  CopyFromNamespaceOperation = Turbopuffer::Models::CopyFromNamespaceOperation
+
+  CopyFromNamespaceOperationResult = Turbopuffer::Models::CopyFromNamespaceOperationResult
+
   CopyFromNamespaceParams = Turbopuffer::Models::CopyFromNamespaceParams
 
   DecayParams = Turbopuffer::Models::DecayParams
@@ -82,6 +86,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
@@ -108,12 +118,16 @@ module Turbopuffer
 
   NamespaceMultiQueryParams = Turbopuffer::Models::NamespaceMultiQueryParams
 
+  NamespacePollCopyFromParams = Turbopuffer::Models::NamespacePollCopyFromParams
+
   NamespaceQueryParams = Turbopuffer::Models::NamespaceQueryParams
 
   NamespaceRecallParams = Turbopuffer::Models::NamespaceRecallParams
 
   NamespaceSchemaParams = Turbopuffer::Models::NamespaceSchemaParams
 
+  NamespaceStartCopyFromParams = Turbopuffer::Models::NamespaceStartCopyFromParams
+
   NamespaceSummary = Turbopuffer::Models::NamespaceSummary
 
   NamespaceUpdateMetadataParams = Turbopuffer::Models::NamespaceUpdateMetadataParams
@@ -122,18 +136,24 @@ module Turbopuffer
 
   NamespaceWriteParams = Turbopuffer::Models::NamespaceWriteParams
 
+  OperationError = Turbopuffer::Models::OperationError
+
   PinningConfig = Turbopuffer::Models::PinningConfig
 
   QueryBilling = Turbopuffer::Models::QueryBilling
 
   QueryPerformance = Turbopuffer::Models::QueryPerformance
 
+  RerankLimit = Turbopuffer::Models::RerankLimit
+
   Row = Turbopuffer::Models::Row
 
   RrfParams = Turbopuffer::Models::RrfParams
 
   SaturateParams = Turbopuffer::Models::SaturateParams
 
+  ShardingConfig = Turbopuffer::Models::ShardingConfig
+
   SparseDistanceMetric = Turbopuffer::Models::SparseDistanceMetric
 
   Tokenizer = Turbopuffer::Models::Tokenizer
@@ -145,4 +165,6 @@ module Turbopuffer
   WriteBilling = Turbopuffer::Models::WriteBilling
 
   WritePerformance = Turbopuffer::Models::WritePerformance
+
+  WriteResult = Turbopuffer::Models::WriteResult
 end

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, offset: 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.
@@ -118,6 +120,8 @@ module Turbopuffer
       #
       # @param limit [Integer, Turbopuffer::Models::Limit] Body param: Limits the documents returned by a query.
       #
+      # @param offset [Integer] Body param: Number of documents to skip before returning results. Supported only
+      #
       # @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.
@@ -199,7 +203,7 @@ module Turbopuffer
       #
       # Issue multiple concurrent queries filter or search documents.
       #
-      # @overload multi_query(queries:, namespace: nil, consistency: nil, rerank_by: nil, vector_encoding: nil, request_options: {})
+      # @overload multi_query(queries:, namespace: nil, consistency: nil, limit: nil, offset: nil, rerank_by: nil, vector_encoding: nil, request_options: {})
       #
       # @param queries [Array<Turbopuffer::Models::NamespaceMultiQueryParams::Query>] Body param
       #
@@ -207,6 +211,10 @@ module Turbopuffer
       #
       # @param consistency [Turbopuffer::Models::NamespaceMultiQueryParams::Consistency] Body param: The consistency level for a query.
       #
+      # @param limit [Integer, Turbopuffer::Models::RerankLimit] Body param: Limits the total number of reranked documents returned.
+      #
+      # @param offset [Integer] Body param: Number of reranked documents to skip before returning results. Requi
+      #
       # @param rerank_by [Object] Body param: How to combine the rows returned by each sub-query into a single ran
       #
       # @param vector_encoding [Symbol, Turbopuffer::Models::VectorEncoding] Body param: The encoding to use for vectors in the response.
@@ -231,17 +239,46 @@ module Turbopuffer
         )
       end
 
+      # Retrieve the current status of a copy operation.
+      #
+      # @overload poll_copy_from(token, namespace: nil, request_options: {})
+      #
+      # @param token [String] The operation token obtained when starting the copy.
+      #
+      # @param namespace [String] The name of the namespace.
+      #
+      # @param request_options [Turbopuffer::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Turbopuffer::Models::CopyFromNamespaceOperation::Running, Turbopuffer::Models::CopyFromNamespaceOperation::Finished]
+      #
+      # @see Turbopuffer::Models::NamespacePollCopyFromParams
+      def poll_copy_from(token, params = {})
+        parsed, options = Turbopuffer::NamespacePollCopyFromParams.dump_request(params)
+        namespace =
+          parsed.delete(:namespace) do
+            @client.default_namespace
+          end
+        @client.request(
+          method: :get,
+          path: ["v1/namespaces/%1$s/operations/%2$s?stainless_overload=pollCopyFrom", namespace, token],
+          model: Turbopuffer::CopyFromNamespaceOperation,
+          options: options
+        )
+      end
+
       # Some parameter documentations has been truncated, see
       # {Turbopuffer::Models::NamespaceQueryParams} for more details.
       #
       # 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, offset: 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.
@@ -256,6 +293,8 @@ module Turbopuffer
       #
       # @param limit [Integer, Turbopuffer::Models::Limit] Body param: Limits the documents returned by a query.
       #
+      # @param offset [Integer] Body param: Number of documents to skip before returning results. Supported only
+      #
       # @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.
@@ -346,17 +385,58 @@ module Turbopuffer
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {Turbopuffer::Models::NamespaceStartCopyFromParams} for more details.
+      #
+      # Start copying all documents from another namespace into this one. Returns an
+      # operation token without waiting for the copy to finish. Use the token to poll
+      # for progress and the result.
+      #
+      # @overload start_copy_from(source_namespace:, namespace: nil, dest_encryption: nil, source_api_key: nil, source_region: nil, request_options: {})
+      #
+      # @param source_namespace [String] Body param: The namespace to copy documents from.
+      #
+      # @param namespace [String] Path param: The name of the namespace.
+      #
+      # @param dest_encryption [Turbopuffer::Models::Encryption::CustomerManaged, Turbopuffer::Models::Encryption::Default] Body param: (Optional) The encryption configuration for the destination namespac
+      #
+      # @param source_api_key [String] Body param: (Optional) An API key for the organization containing the source nam
+      #
+      # @param source_region [String] Body param: (Optional) The region of the source namespace.
+      #
+      # @param request_options [Turbopuffer::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Turbopuffer::Models::NamespaceStartCopyFromResponse]
+      #
+      # @see Turbopuffer::Models::NamespaceStartCopyFromParams
+      def start_copy_from(params)
+        parsed, options = Turbopuffer::NamespaceStartCopyFromParams.dump_request(params)
+        namespace =
+          parsed.delete(:namespace) do
+            @client.default_namespace
+          end
+        @client.request(
+          method: :post,
+          path: ["v2/namespaces/%1$s/async?stainless_overload=startCopyFrom", namespace],
+          body: {copy_from_namespace: parsed},
+          model: Turbopuffer::Models::NamespaceStartCopyFromResponse,
+          options: options
+        )
+      end
+
       # Some parameter documentations has been truncated, see
       # {Turbopuffer::Models::NamespaceUpdateMetadataParams} for more details.
       #
       # Update metadata configuration for a namespace.
       #
-      # @overload update_metadata(namespace: nil, pinning: nil, request_options: {})
+      # @overload update_metadata(namespace: nil, pinning: nil, read_only: nil, request_options: {})
       #
       # @param namespace [String] Path param: The name of the namespace.
       #
       # @param pinning [Boolean, Turbopuffer::Models::PinningConfig, nil] Body param: Configuration for namespace pinning.
       #
+      # @param read_only [Boolean] Body param: Set to `true` to reject document and schema writes, or `false` to al
+      #
       # @param request_options [Turbopuffer::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Turbopuffer::Models::NamespaceMetadata]
@@ -410,7 +490,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 +526,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.5.0"
 end