turbopuffer 2.4.0 → 2.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 261de656879e46b1d9f2261ccd91ff7ea9e266d8a86607c5395ad55f38733dcf
-  data.tar.gz: f747583237835002c070734cd7a3955c9476df205d5815e3fcf04ee10e9a8a76
+  metadata.gz: c7a74005340bd71314cefec78857e87f61242c5e99ca0619718932862dfb9b3e
+  data.tar.gz: 90568747fb99e6f0c3e07e135600cd49e48e806023059f27f0f270bb3f20ca20
 SHA512:
-  metadata.gz: 9bc98d5c9e8d49f32361220486d44837ae507de3693b375b40d8ba6a668c9897efdeb60372d93da15a10493ca7a3b999c0962e7809ccd42514ec4c52230e96c8
-  data.tar.gz: 022a2361e31a953a68d1867c5cc67ce571556e126ad873267ef2beb28ccf0e81438681570c86955134514a574c6812c374036b61fd5b0c88d8e642e62eb33c88
+  metadata.gz: e01efec060630c4a1b3840c93dc93148fd8724ffe326b7b697679a6d2a51eeecea9692ece6be917b3d42d7ed85ed1a958db57134f215b4290ab63f0c33521232
+  data.tar.gz: 9ce535511cfc814424db7cf0c6567b35724ddb1c75550224866a805040220b2daf28c9b0dfa686153f2a6e8a41c056066c29d0952a805594e7bda8cfe356351b

data/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 2.5.0 (2026-09-18)
+
+Full Changelog: [v2.4.0...v2.5.0](https://github.com/turbopuffer/turbopuffer-ruby/compare/v2.4.0...v2.5.0)
+
+### Features
+
+* Add `read_only` namespace field ([8dfb1f7](https://github.com/turbopuffer/turbopuffer-ruby/commit/8dfb1f77bf0f2ad5eb1c238a0c4b3df49549b9fd))
+* **api:** Merge remote-tracking branch 'origin/preview/benesch/named-rerank-limit-schema' ([917c0b7](https://github.com/turbopuffer/turbopuffer-ruby/commit/917c0b700820ef1d68eb92c485d02e1013fe4479))
+* Apply limit on rerank_by when provided ([fbd70cb](https://github.com/turbopuffer/turbopuffer-ruby/commit/fbd70cbaeb31bae86f197975d2bdd40669620cf1))
+* engine,openapi: async copy_from_namespace endpoints ([5af8916](https://github.com/turbopuffer/turbopuffer-ruby/commit/5af89166d027304ae1869e691bf79cade774c04a))
+* spec: no-op change to Stainless spec ([4e0d0cc](https://github.com/turbopuffer/turbopuffer-ruby/commit/4e0d0ccb819df54524e8b5c3fd3efea8105ddae7))
+* tpuf-engine: Adding pagination through `offset` ([1de87c9](https://github.com/turbopuffer/turbopuffer-ruby/commit/1de87c959126a8737a724c5cd594bd844cc43bf0))
+* tpuf-engine: expose billed_replicas in pinning metadata ([3f414fc](https://github.com/turbopuffer/turbopuffer-ruby/commit/3f414fcf1df33d8f41615755c5474f8fcd6713b2))
+
+
+### Bug Fixes
+
+* wrap start copy request bodies ([#70](https://github.com/turbopuffer/turbopuffer-ruby/issues/70)) ([4a44435](https://github.com/turbopuffer/turbopuffer-ruby/commit/4a444351b3a1dc68f0dcba86fe15dcac03d3ae88))
+
 ## 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)

data/README.md

@@ -4,15 +4,6 @@ The turbopuffer Ruby library provides convenient access to the [turbopuffer HTTP
 
 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.
-
-[![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)
-
-> Note: You may need to set environment variables in your MCP client.
-
 ## Documentation
 
 Documentation for releases of this gem can be found [on RubyDoc](https://gemdocs.org/gems/turbopuffer).
@@ -26,7 +17,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "turbopuffer", "~> 2.4.0"
+gem "turbopuffer", "~> 2.5.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/turbopuffer/client.rb

@@ -15,7 +15,7 @@ module Turbopuffer
     # Default max retry delay in seconds.
     DEFAULT_MAX_RETRY_DELAY = 8.0
 
-    # API key used for authentication
+    # API key used for authentication.
     # @return [String]
     attr_reader :api_key
 
@@ -74,7 +74,7 @@ module Turbopuffer
 
     # Creates and returns a new client for interacting with the API.
     #
-    # @param api_key [String, nil] API key used for authentication Defaults to `ENV["TURBOPUFFER_API_KEY"]`
+    # @param api_key [String, nil] API key used for authentication. Defaults to `ENV["TURBOPUFFER_API_KEY"]`
     #
     # @param region [String, nil] The turbopuffer region to use. Defaults to `ENV["TURBOPUFFER_REGION"]`
     #

data/lib/turbopuffer/internal/type/union.rb

@@ -6,14 +6,24 @@ module Turbopuffer
       # @api private
       #
       # @example
-      #   # `attribute_embed` is a `Turbopuffer::AttributeEmbed`
-      #   case attribute_embed
-      #   when String
-      #     # ...
-      #   when Turbopuffer::AttributeEmbedConfig
-      #     puts(attribute_embed.model)
+      #   # `copy_from_namespace_operation` is a `Turbopuffer::CopyFromNamespaceOperation`
+      #   case copy_from_namespace_operation
+      #   when Turbopuffer::CopyFromNamespaceOperation::Running
+      #     puts(copy_from_namespace_operation.start_time)
+      #   when Turbopuffer::CopyFromNamespaceOperation::Finished
+      #     puts(copy_from_namespace_operation.finish_time)
       #   else
-      #     puts(attribute_embed)
+      #     puts(copy_from_namespace_operation)
+      #   end
+      #
+      # @example
+      #   case copy_from_namespace_operation
+      #   in {status: :running, start_time: start_time, progress: progress}
+      #     puts(start_time)
+      #   in {status: :finished, finish_time: finish_time, result: result, start_time: start_time}
+      #     puts(finish_time)
+      #   else
+      #     puts(copy_from_namespace_operation)
       #   end
       module Union
         include Turbopuffer::Internal::Type::Converter

data/lib/turbopuffer/models/copy_from_namespace_operation.rb

@@ -0,0 +1,84 @@
+# frozen_string_literal: true
+
+module Turbopuffer
+  module Models
+    # The current status of a copy operation.
+    #
+    # @see Turbopuffer::Resources::Namespaces#poll_copy_from
+    module CopyFromNamespaceOperation
+      extend Turbopuffer::Internal::Type::Union
+
+      discriminator :status
+
+      variant :running, -> { Turbopuffer::CopyFromNamespaceOperation::Running }
+
+      variant :finished, -> { Turbopuffer::CopyFromNamespaceOperation::Finished }
+
+      class Running < Turbopuffer::Internal::Type::BaseModel
+        # @!attribute start_time
+        #   The time at which the operation started.
+        #
+        #   @return [Time]
+        required :start_time, Time
+
+        # @!attribute status
+        #
+        #   @return [Symbol, :running]
+        required :status, const: :running
+
+        # @!attribute progress
+        #   A freeform description of the operation's progress. May be absent, and its
+        #   format may change.
+        #
+        #   @return [String, nil]
+        optional :progress, String
+
+        # @!method initialize(start_time:, progress: nil, status: :running)
+        #   Some parameter documentations has been truncated, see
+        #   {Turbopuffer::Models::CopyFromNamespaceOperation::Running} for more details.
+        #
+        #   @param start_time [Time] The time at which the operation started.
+        #
+        #   @param progress [String] A freeform description of the operation's progress. May be absent, and its forma
+        #
+        #   @param status [Symbol, :running]
+      end
+
+      class Finished < Turbopuffer::Internal::Type::BaseModel
+        # @!attribute finish_time
+        #   The time at which the operation finished.
+        #
+        #   @return [Time]
+        required :finish_time, Time
+
+        # @!attribute result
+        #
+        #   @return [Turbopuffer::Models::CopyFromNamespaceOperationResult::Success, Turbopuffer::Models::CopyFromNamespaceOperationResult::Error]
+        required :result, union: -> { Turbopuffer::CopyFromNamespaceOperationResult }
+
+        # @!attribute start_time
+        #   The time at which the operation started.
+        #
+        #   @return [Time]
+        required :start_time, Time
+
+        # @!attribute status
+        #
+        #   @return [Symbol, :finished]
+        required :status, const: :finished
+
+        # @!method initialize(finish_time:, result:, start_time:, status: :finished)
+        #   @param finish_time [Time] The time at which the operation finished.
+        #
+        #   @param result [Turbopuffer::Models::CopyFromNamespaceOperationResult::Success, Turbopuffer::Models::CopyFromNamespaceOperationResult::Error]
+        #
+        #   @param start_time [Time] The time at which the operation started.
+        #
+        #   @param status [Symbol, :finished]
+      end
+
+      # @!method self.variants
+      #   @return [Array(Turbopuffer::Models::CopyFromNamespaceOperation::Running, Turbopuffer::Models::CopyFromNamespaceOperation::Finished)]
+    end
+  end
+end

data/lib/turbopuffer/models/copy_from_namespace_operation_result.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module Turbopuffer
+  module Models
+    module CopyFromNamespaceOperationResult
+      extend Turbopuffer::Internal::Type::Union
+
+      variant -> { Turbopuffer::CopyFromNamespaceOperationResult::Success }
+
+      variant -> { Turbopuffer::CopyFromNamespaceOperationResult::Error }
+
+      class Success < Turbopuffer::Internal::Type::BaseModel
+        # @!attribute success
+        #   The response to a successful write request.
+        #
+        #   @return [Turbopuffer::Models::WriteResult]
+        required :success, -> { Turbopuffer::WriteResult }
+
+        # @!method initialize(success:)
+        #   @param success [Turbopuffer::Models::WriteResult] The response to a successful write request.
+      end
+
+      class Error < Turbopuffer::Internal::Type::BaseModel
+        # @!attribute error
+        #
+        #   @return [Turbopuffer::Models::OperationError]
+        required :error, -> { Turbopuffer::OperationError }
+
+        # @!method initialize(error:)
+        #   @param error [Turbopuffer::Models::OperationError]
+      end
+
+      # @!method self.variants
+      #   @return [Array(Turbopuffer::Models::CopyFromNamespaceOperationResult::Success, Turbopuffer::Models::CopyFromNamespaceOperationResult::Error)]
+    end
+  end
+end

data/lib/turbopuffer/models/namespace_explain_query_params.rb

@@ -72,6 +72,13 @@ module Turbopuffer
       #   @return [Integer, Turbopuffer::Models::Limit, nil]
       optional :limit, union: -> { Turbopuffer::NamespaceExplainQueryParams::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.
       #
@@ -90,7 +97,7 @@ module Turbopuffer
       #   @return [Symbol, Turbopuffer::Models::VectorEncoding, nil]
       optional :vector_encoding, enum: -> { Turbopuffer::VectorEncoding }
 
-      # @!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: {})
+      # @!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::NamespaceExplainQueryParams} for more details.
       #
@@ -114,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_metadata.rb

@@ -52,6 +52,12 @@ module Turbopuffer
       #   @return [Turbopuffer::Models::NamespaceMetadata::Pinning, nil]
       optional :pinning, -> { Turbopuffer::NamespaceMetadata::Pinning }
 
+      # @!attribute read_only
+      #   Whether document and schema writes are rejected. Omitted when `false`.
+      #
+      #   @return [Boolean, nil]
+      optional :read_only, Turbopuffer::Internal::Type::Boolean
+
       # @!attribute sharding
       #   Configuration for namespace sharding, which partitions a namespace's documents
       #   across multiple internal shards to scale indexing and query throughput beyond a
@@ -61,7 +67,7 @@ module Turbopuffer
       #   @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)
+      # @!method initialize(approx_logical_bytes:, approx_row_count:, created_at:, encryption:, index:, schema:, updated_at:, pinning: nil, read_only: nil, sharding: nil)
       #   Some parameter documentations has been truncated, see
       #   {Turbopuffer::Models::NamespaceMetadata} for more details.
       #
@@ -83,6 +89,8 @@ module Turbopuffer
       #
       #   @param pinning [Turbopuffer::Models::NamespaceMetadata::Pinning] Configuration for namespace pinning, along with the current status of the pinned
       #
+      #   @param read_only [Boolean] Whether document and schema writes are rejected. Omitted when `false`.
+      #
       #   @param sharding [Turbopuffer::Models::ShardingConfig] Configuration for namespace sharding, which partitions a namespace's documents a
 
       # @see Turbopuffer::Models::NamespaceMetadata#index
@@ -150,6 +158,15 @@ module Turbopuffer
           #   @return [Integer]
           required :ready_replicas, Integer
 
+          # @!attribute replicas
+          #   The number of running replicas for the namespace. Replicas are billed once
+          #   running, even before they finish warming their caches and become ready to serve
+          #   traffic. This count is updated independently and may briefly disagree with the
+          #   other status fields.
+          #
+          #   @return [Integer]
+          required :replicas, Integer
+
           # @!attribute updated_at
           #   The timestamp of the latest pinning status snapshot.
           #
@@ -163,7 +180,7 @@ module Turbopuffer
           #   @return [Float]
           required :utilization, Float
 
-          # @!method initialize(ready_replicas:, updated_at:, utilization:)
+          # @!method initialize(ready_replicas:, replicas:, updated_at:, utilization:)
           #   Some parameter documentations has been truncated, see
           #   {Turbopuffer::Models::NamespaceMetadata::Pinning::Status} for more details.
           #
@@ -171,6 +188,8 @@ module Turbopuffer
           #
           #   @param ready_replicas [Integer] The number of replicas that are warm and serving traffic.
           #
+          #   @param replicas [Integer] The number of running replicas for the namespace. Replicas are billed once runni
+          #
           #   @param updated_at [Time] The timestamp of the latest pinning status snapshot.
           #
           #   @param utilization [Float] Aggregate utilization for the pinned namespace, reported as a value between 0.0

data/lib/turbopuffer/models/namespace_metadata_patch.rb

@@ -14,13 +14,22 @@ module Turbopuffer
       #   @return [Boolean, Turbopuffer::Models::PinningConfig, nil]
       optional :pinning, union: -> { Turbopuffer::NamespaceMetadataPatch::Pinning }, nil?: true
 
-      # @!method initialize(pinning: nil)
+      # @!attribute read_only
+      #   Set to `true` to reject document and schema writes, or `false` to allow them.
+      #   Writes already in progress may still commit. Metadata updates remain available.
+      #
+      #   @return [Boolean, nil]
+      optional :read_only, Turbopuffer::Internal::Type::Boolean
+
+      # @!method initialize(pinning: nil, read_only: nil)
       #   Some parameter documentations has been truncated, see
       #   {Turbopuffer::Models::NamespaceMetadataPatch} for more details.
       #
       #   Request to update namespace metadata configuration.
       #
       #   @param pinning [Boolean, Turbopuffer::Models::PinningConfig, nil] Configuration for namespace pinning.
+      #
+      #   @param read_only [Boolean] Set to `true` to reject document and schema writes, or `false` to allow them. Wr
 
       # Configuration for namespace pinning.
       #

data/lib/turbopuffer/models/namespace_multi_query_params.rb

@@ -24,6 +24,19 @@ module Turbopuffer
       #   @return [Turbopuffer::Models::NamespaceMultiQueryParams::Consistency, nil]
       optional :consistency, -> { Turbopuffer::NamespaceMultiQueryParams::Consistency }
 
+      # @!attribute limit
+      #   Limits the total number of reranked documents returned.
+      #
+      #   @return [Integer, Turbopuffer::Models::RerankLimit, nil]
+      optional :limit, union: -> { Turbopuffer::NamespaceMultiQueryParams::Limit }
+
+      # @!attribute offset
+      #   Number of reranked documents to skip before returning results. Requires
+      #   `rerank_by` and `limit`.
+      #
+      #   @return [Integer, nil]
+      optional :offset, Integer
+
       # @!attribute rerank_by
       #   How to combine the rows returned by each sub-query into a single ranked list.
       #
@@ -36,13 +49,21 @@ module Turbopuffer
       #   @return [Symbol, Turbopuffer::Models::VectorEncoding, nil]
       optional :vector_encoding, enum: -> { Turbopuffer::VectorEncoding }
 
-      # @!method initialize(queries:, namespace: nil, consistency: nil, rerank_by: nil, vector_encoding: nil, request_options: {})
+      # @!method initialize(queries:, namespace: nil, consistency: nil, limit: nil, offset: nil, rerank_by: nil, vector_encoding: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Turbopuffer::Models::NamespaceMultiQueryParams} for more details.
+      #
       #   @param queries [Array<Turbopuffer::Models::NamespaceMultiQueryParams::Query>]
       #
       #   @param namespace [String]
       #
       #   @param consistency [Turbopuffer::Models::NamespaceMultiQueryParams::Consistency] The consistency level for a query.
       #
+      #   @param limit [Integer, Turbopuffer::Models::RerankLimit] Limits the total number of reranked documents returned.
+      #
+      #   @param offset [Integer] Number of reranked documents to skip before returning results. Requires
+      #   `rerank\_
+      #
       #   @param rerank_by [Object] How to combine the rows returned by each sub-query into a single ranked list.
       #
       #   @param vector_encoding [Symbol, Turbopuffer::Models::VectorEncoding] The encoding to use for vectors in the response.
@@ -104,6 +125,13 @@ module Turbopuffer
         #   @return [Integer, Turbopuffer::Models::Limit, nil]
         optional :limit, union: -> { Turbopuffer::NamespaceMultiQueryParams::Query::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.
         #
@@ -116,7 +144,7 @@ module Turbopuffer
         #   @return [Integer, nil]
         optional :top_k, Integer
 
-        # @!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)
+        # @!method initialize(aggregate_by: nil, compute_attributes: 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)
         #   Some parameter documentations has been truncated, see
         #   {Turbopuffer::Models::NamespaceMultiQueryParams::Query} for more details.
         #
@@ -138,6 +166,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.
@@ -186,6 +216,19 @@ module Turbopuffer
           #   @return [Array<Symbol>]
         end
       end
+
+      # Limits the total number of reranked documents returned.
+      module Limit
+        extend Turbopuffer::Internal::Type::Union
+
+        variant Integer
+
+        # Limits the total number of reranked documents returned.
+        variant -> { Turbopuffer::RerankLimit }
+
+        # @!method self.variants
+        #   @return [Array(Integer, Turbopuffer::Models::RerankLimit)]
+      end
     end
   end
 end

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

@@ -72,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.
       #
@@ -90,7 +97,7 @@ module Turbopuffer
       #   @return [Symbol, Turbopuffer::Models::VectorEncoding, nil]
       optional :vector_encoding, enum: -> { Turbopuffer::VectorEncoding }
 
-      # @!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: {})
+      # @!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.
       #
@@ -114,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/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