turbopuffer 1.16.0 → 1.18.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 49996bb69761463127455f5c055e194300f90c3019a799a22caba584aea8d782
-  data.tar.gz: 4de6f2a10ec1a14391748137eb96f93a6e3251f5a567dcb60afb0d914c47dcbe
+  metadata.gz: 392026af67d721a1c1e41655fa994e4b091513a09098debb10dfe3d7f5b28b10
+  data.tar.gz: b2594569c7c125a0ac5adf38e0a2837143672f8c5e2fac0d2c6e44c1a9e74f27
 SHA512:
-  metadata.gz: 476911f60864a91b8f621a8a0d46a1ca0aa3bd1613bf238c9e4e1609444849874e1b3a2826969f96ff6b24637f476ccae5ea07ad9a705bea50bc9957b79926d2
-  data.tar.gz: e8ce0b91324f880dac5070f46cda019dabe5eed989a2ce0337078cdf64544e7609442ae5e6554390057377226edd3e6fbd5237f05ef44769b6008d6981a49c66
+  metadata.gz: 5479a222309efe4bcf5c8405c3801e1b69701ae752e97629503da8fb575267f6a5ae1c9ad25761c76c4cc0e390e8ba5b236fdbd950fbcd4a6901ab7f9d4170e9
+  data.tar.gz: c8ae2cdf9de61b0766fb85f8de6e647d8eeda1d5d59fa5de98dbe69d22d02ae7a7106e4ac9403cba15a5449f21bff58cea6b0cf015dbbd89072f94c5bae02a6b

data/CHANGELOG.md

@@ -1,5 +1,33 @@
 # Changelog
 
+## 1.18.0 (2026-03-20)
+
+Full Changelog: [v1.17.0...v1.18.0](https://github.com/turbopuffer/turbopuffer-ruby/compare/v1.17.0...v1.18.0)
+
+### Features
+
+* spec: disable CopyFromNamespace syntax sugar in Go ([93d9e4b](https://github.com/turbopuffer/turbopuffer-ruby/commit/93d9e4b4501ed7f444f2365b09baa5231349edf8))
+* tpuf-engine: add verbose form of branch_from_namespace ([1ae049a](https://github.com/turbopuffer/turbopuffer-ruby/commit/1ae049ad623d519817d4d9b71228f5f4e7a55aec))
+
+## 1.17.0 (2026-03-18)
+
+Full Changelog: [v1.16.0...v1.17.0](https://github.com/turbopuffer/turbopuffer-ruby/compare/v1.16.0...v1.17.0)
+
+### Features
+
+* Response performance object ([c3ca5e3](https://github.com/turbopuffer/turbopuffer-ruby/commit/c3ca5e32f6cc4cfcdc29bc30e8cd11cd6e5550ef))
+* tpuf: add branching to openapi spec ([7abdd2f](https://github.com/turbopuffer/turbopuffer-ruby/commit/7abdd2fb4f0fc1d2776dae20510b969e6c144b8b))
+
+
+### Bug Fixes
+
+* **client:** use higher retry delay precision ([bf9becb](https://github.com/turbopuffer/turbopuffer-ruby/commit/bf9becb1a4c0ef1d654e403b75032657a4dbde49))
+
+
+### Chores
+
+* **internal:** tweak CI branches ([f11cac6](https://github.com/turbopuffer/turbopuffer-ruby/commit/f11cac6b51f4c31c1c013537032ac67711c5e39d))
+
 ## 1.16.0 (2026-03-15)
 
 Full Changelog: [v1.15.0...v1.16.0](https://github.com/turbopuffer/turbopuffer-ruby/compare/v1.15.0...v1.16.0)

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.16.0"
+gem "turbopuffer", "~> 1.18.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/turbopuffer/client.rb

@@ -10,7 +10,7 @@ module Turbopuffer
 
     # Default initial retry delay in seconds.
     # Overall delay is calculated using exponential backoff + jitter.
-    DEFAULT_INITIAL_RETRY_DELAY = 0.3
+    DEFAULT_INITIAL_RETRY_DELAY = 0.25
 
     # Default max retry delay in seconds.
     DEFAULT_MAX_RETRY_DELAY = 8.0

data/lib/turbopuffer/models/branch_from_namespace_params.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Turbopuffer
+  module Models
+    # The namespace to create an instant, copy-on-write clone of.
+    module BranchFromNamespaceParams
+      extend Turbopuffer::Internal::Type::Union
+
+      # The namespace to create an instant, copy-on-write clone of.
+      variant String
+
+      variant -> { Turbopuffer::BranchFromNamespaceParams::BranchFromNamespaceConfig }
+
+      class BranchFromNamespaceConfig < Turbopuffer::Internal::Type::BaseModel
+        # @!attribute source_namespace
+        #   The namespace to create an instant, copy-on-write clone of.
+        #
+        #   @return [String]
+        required :source_namespace, String
+
+        # @!method initialize(source_namespace:)
+        #   @param source_namespace [String] The namespace to create an instant, copy-on-write clone of.
+      end
+
+      # @!method self.variants
+      #   @return [Array(String, Turbopuffer::Models::BranchFromNamespaceParams::BranchFromNamespaceConfig)]
+    end
+  end
+end

data/lib/turbopuffer/models/copy_from_namespace_params.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module Turbopuffer
+  module Models
+    # The namespace to copy documents from.
+    module CopyFromNamespaceParams
+      extend Turbopuffer::Internal::Type::Union
+
+      # The namespace to copy documents from.
+      variant String
+
+      variant -> { Turbopuffer::CopyFromNamespaceParams::CopyFromNamespaceConfig }
+
+      class CopyFromNamespaceConfig < Turbopuffer::Internal::Type::BaseModel
+        # @!attribute source_namespace
+        #   The namespace to copy documents from.
+        #
+        #   @return [String]
+        required :source_namespace, String
+
+        # @!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:, source_api_key: nil, source_region: nil)
+        #   @param source_namespace [String] The namespace to copy documents from.
+        #
+        #   @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.
+      end
+
+      # @!method self.variants
+      #   @return [Array(String, Turbopuffer::Models::CopyFromNamespaceParams::CopyFromNamespaceConfig)]
+    end
+  end
+end

data/lib/turbopuffer/models/namespace_write_params.rb

@@ -12,11 +12,17 @@ module Turbopuffer
       #   @return [String, nil]
       optional :namespace, String
 
+      # @!attribute branch_from_namespace
+      #   The namespace to create an instant, copy-on-write clone of.
+      #
+      #   @return [String, Turbopuffer::Models::BranchFromNamespaceParams::BranchFromNamespaceConfig, nil]
+      optional :branch_from_namespace, union: -> { Turbopuffer::BranchFromNamespaceParams }
+
       # @!attribute copy_from_namespace
       #   The namespace to copy documents from.
       #
-      #   @return [String, Turbopuffer::Models::NamespaceWriteParams::CopyFromNamespace::CopyFromNamespaceConfig, nil]
-      optional :copy_from_namespace, union: -> { Turbopuffer::NamespaceWriteParams::CopyFromNamespace }
+      #   @return [String, Turbopuffer::Models::CopyFromNamespaceParams::CopyFromNamespaceConfig, nil]
+      optional :copy_from_namespace, union: -> { Turbopuffer::CopyFromNamespaceParams }
 
       # @!attribute delete_by_filter
       #   The filter specifying which documents to delete.
@@ -124,13 +130,15 @@ module Turbopuffer
       #   @return [Array<Turbopuffer::Models::Row>, nil]
       optional :upsert_rows, -> { Turbopuffer::Internal::Type::ArrayOf[Turbopuffer::Row] }
 
-      # @!method initialize(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, upsert_columns: nil, upsert_condition: nil, upsert_rows: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Turbopuffer::Models::NamespaceWriteParams} for more details.
       #
       #   @param namespace [String]
       #
-      #   @param copy_from_namespace [String, Turbopuffer::Models::NamespaceWriteParams::CopyFromNamespace::CopyFromNamespaceConfig] The namespace to copy documents from.
+      #   @param branch_from_namespace [String, Turbopuffer::Models::BranchFromNamespaceParams::BranchFromNamespaceConfig] The namespace to create an instant, copy-on-write clone of.
+      #
+      #   @param copy_from_namespace [String, Turbopuffer::Models::CopyFromNamespaceParams::CopyFromNamespaceConfig] The namespace to copy documents from.
       #
       #   @param delete_by_filter [Object] The filter specifying which documents to delete.
       #
@@ -168,46 +176,6 @@ module Turbopuffer
       #
       #   @param request_options [Turbopuffer::RequestOptions, Hash{Symbol=>Object}]
 
-      # The namespace to copy documents from.
-      module CopyFromNamespace
-        extend Turbopuffer::Internal::Type::Union
-
-        # The namespace to copy documents from.
-        variant String
-
-        variant -> { Turbopuffer::NamespaceWriteParams::CopyFromNamespace::CopyFromNamespaceConfig }
-
-        class CopyFromNamespaceConfig < Turbopuffer::Internal::Type::BaseModel
-          # @!attribute source_namespace
-          #   The namespace to copy documents from.
-          #
-          #   @return [String]
-          required :source_namespace, String
-
-          # @!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:, source_api_key: nil, source_region: nil)
-          #   @param source_namespace [String] The namespace to copy documents from.
-          #
-          #   @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.
-        end
-
-        # @!method self.variants
-        #   @return [Array(String, Turbopuffer::Models::NamespaceWriteParams::CopyFromNamespace::CopyFromNamespaceConfig)]
-      end
-
       class Encryption < Turbopuffer::Internal::Type::BaseModel
         # @!attribute cmek
         #

data/lib/turbopuffer/models/namespace_write_response.rb

@@ -42,6 +42,12 @@ module Turbopuffer
       #   @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.
       #
@@ -73,7 +79,7 @@ module Turbopuffer
       #   @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, rows_deleted: nil, rows_patched: nil, rows_remaining: nil, rows_upserted: nil, upserted_ids: nil, status: :OK)
+      # @!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::NamespaceWriteResponse} for more details.
       #
@@ -89,6 +95,8 @@ module Turbopuffer
       #
       #   @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.

data/lib/turbopuffer/models/write_performance.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Turbopuffer
+  module Models
+    class WritePerformance < Turbopuffer::Internal::Type::BaseModel
+      # @!attribute server_total_ms
+      #   Request time measured on the server, in milliseconds.
+      #
+      #   @return [Integer]
+      required :server_total_ms, Integer
+
+      # @!method initialize(server_total_ms:)
+      #   The performance information for a write request.
+      #
+      #   @param server_total_ms [Integer] Request time measured on the server, in milliseconds.
+    end
+  end
+end

data/lib/turbopuffer/models.rb

@@ -50,6 +50,8 @@ module Turbopuffer
 
   Bm25ClauseParams = Turbopuffer::Models::Bm25ClauseParams
 
+  BranchFromNamespaceParams = Turbopuffer::Models::BranchFromNamespaceParams
+
   ClientNamespacesParams = Turbopuffer::Models::ClientNamespacesParams
 
   Columns = Turbopuffer::Models::Columns
@@ -58,6 +60,8 @@ module Turbopuffer
 
   ContainsAnyTokenFilterParams = Turbopuffer::Models::ContainsAnyTokenFilterParams
 
+  CopyFromNamespaceParams = Turbopuffer::Models::CopyFromNamespaceParams
+
   DecayParams = Turbopuffer::Models::DecayParams
 
   DistanceMetric = Turbopuffer::Models::DistanceMetric
@@ -115,4 +119,6 @@ module Turbopuffer
   VectorEncoding = Turbopuffer::Models::VectorEncoding
 
   WriteBilling = Turbopuffer::Models::WriteBilling
+
+  WritePerformance = Turbopuffer::Models::WritePerformance
 end

data/lib/turbopuffer/resources/namespaces.rb

@@ -307,11 +307,13 @@ module Turbopuffer
       #
       # Create, update, or delete documents.
       #
-      # @overload write(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, upsert_columns: nil, upsert_condition: nil, upsert_rows: nil, request_options: {})
       #
       # @param namespace [String] Path param: The name of the namespace.
       #
-      # @param copy_from_namespace [String, Turbopuffer::Models::NamespaceWriteParams::CopyFromNamespace::CopyFromNamespaceConfig] Body param: The namespace to copy documents from.
+      # @param branch_from_namespace [String, Turbopuffer::Models::BranchFromNamespaceParams::BranchFromNamespaceConfig] Body param: The namespace to create an instant, copy-on-write clone of.
+      #
+      # @param copy_from_namespace [String, Turbopuffer::Models::CopyFromNamespaceParams::CopyFromNamespaceConfig] Body param: The namespace to copy documents from.
       #
       # @param delete_by_filter [Object] Body param: The filter specifying which documents to delete.
       #

data/lib/turbopuffer/version.rb

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

data/lib/turbopuffer.rb

@@ -58,10 +58,12 @@ require_relative "turbopuffer/models/attribute_schema"
 require_relative "turbopuffer/models/attribute_schema_config"
 require_relative "turbopuffer/models/attribute_type"
 require_relative "turbopuffer/models/bm25_clause_params"
+require_relative "turbopuffer/models/branch_from_namespace_params"
 require_relative "turbopuffer/models/client_namespaces_params"
 require_relative "turbopuffer/models/columns"
 require_relative "turbopuffer/models/contains_all_tokens_filter_params"
 require_relative "turbopuffer/models/contains_any_token_filter_params"
+require_relative "turbopuffer/models/copy_from_namespace_params"
 require_relative "turbopuffer/models/decay_params"
 require_relative "turbopuffer/models/distance_metric"
 require_relative "turbopuffer/models/full_text_search"
@@ -100,6 +102,7 @@ require_relative "turbopuffer/models/tokenizer"
 require_relative "turbopuffer/models/vector"
 require_relative "turbopuffer/models/vector_encoding"
 require_relative "turbopuffer/models/write_billing"
+require_relative "turbopuffer/models/write_performance"
 require_relative "turbopuffer/models"
 require_relative "turbopuffer/resources/namespaces"
 require_relative "turbopuffer/namespace"

data/rbi/turbopuffer/client.rbi

@@ -6,7 +6,7 @@ module Turbopuffer
 
     DEFAULT_TIMEOUT_IN_SECONDS = T.let(60.0, Float)
 
-    DEFAULT_INITIAL_RETRY_DELAY = T.let(0.3, Float)
+    DEFAULT_INITIAL_RETRY_DELAY = T.let(0.25, Float)
 
     DEFAULT_MAX_RETRY_DELAY = T.let(8.0, Float)
 

data/rbi/turbopuffer/models/branch_from_namespace_params.rbi

@@ -0,0 +1,51 @@
+# typed: strong
+
+module Turbopuffer
+  module Models
+    # The namespace to create an instant, copy-on-write clone of.
+    module BranchFromNamespaceParams
+      extend Turbopuffer::Internal::Type::Union
+
+      Variants =
+        T.type_alias do
+          T.any(
+            String,
+            Turbopuffer::BranchFromNamespaceParams::BranchFromNamespaceConfig
+          )
+        end
+
+      class BranchFromNamespaceConfig < Turbopuffer::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Turbopuffer::BranchFromNamespaceParams::BranchFromNamespaceConfig,
+              Turbopuffer::Internal::AnyHash
+            )
+          end
+
+        # The namespace to create an instant, copy-on-write clone of.
+        sig { returns(String) }
+        attr_accessor :source_namespace
+
+        sig { params(source_namespace: String).returns(T.attached_class) }
+        def self.new(
+          # The namespace to create an instant, copy-on-write clone of.
+          source_namespace:
+        )
+        end
+
+        sig { override.returns({ source_namespace: String }) }
+        def to_hash
+        end
+      end
+
+      sig do
+        override.returns(
+          T::Array[Turbopuffer::BranchFromNamespaceParams::Variants]
+        )
+      end
+      def self.variants
+      end
+    end
+  end
+end

data/rbi/turbopuffer/models/copy_from_namespace_params.rbi

@@ -0,0 +1,83 @@
+# typed: strong
+
+module Turbopuffer
+  module Models
+    # The namespace to copy documents from.
+    module CopyFromNamespaceParams
+      extend Turbopuffer::Internal::Type::Union
+
+      Variants =
+        T.type_alias do
+          T.any(
+            String,
+            Turbopuffer::CopyFromNamespaceParams::CopyFromNamespaceConfig
+          )
+        end
+
+      class CopyFromNamespaceConfig < Turbopuffer::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Turbopuffer::CopyFromNamespaceParams::CopyFromNamespaceConfig,
+              Turbopuffer::Internal::AnyHash
+            )
+          end
+
+        # The namespace to copy documents from.
+        sig { returns(String) }
+        attr_accessor :source_namespace
+
+        # (Optional) An API key for the organization containing the source namespace
+        sig { returns(T.nilable(String)) }
+        attr_reader :source_api_key
+
+        sig { params(source_api_key: String).void }
+        attr_writer :source_api_key
+
+        # (Optional) The region of the source namespace.
+        sig { returns(T.nilable(String)) }
+        attr_reader :source_region
+
+        sig { params(source_region: String).void }
+        attr_writer :source_region
+
+        sig do
+          params(
+            source_namespace: String,
+            source_api_key: String,
+            source_region: String
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # The namespace to copy documents from.
+          source_namespace:,
+          # (Optional) An API key for the organization containing the source namespace
+          source_api_key: nil,
+          # (Optional) The region of the source namespace.
+          source_region: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              source_namespace: String,
+              source_api_key: String,
+              source_region: String
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+
+      sig do
+        override.returns(
+          T::Array[Turbopuffer::CopyFromNamespaceParams::Variants]
+        )
+      end
+      def self.variants
+      end
+    end
+  end
+end

data/rbi/turbopuffer/models/namespace_write_params.rbi

@@ -20,13 +20,37 @@ module Turbopuffer
       sig { params(namespace: String).void }
       attr_writer :namespace
 
+      # The namespace to create an instant, copy-on-write clone of.
+      sig do
+        returns(
+          T.nilable(
+            T.any(
+              String,
+              Turbopuffer::BranchFromNamespaceParams::BranchFromNamespaceConfig
+            )
+          )
+        )
+      end
+      attr_reader :branch_from_namespace
+
+      sig do
+        params(
+          branch_from_namespace:
+            T.any(
+              String,
+              Turbopuffer::BranchFromNamespaceParams::BranchFromNamespaceConfig::OrHash
+            )
+        ).void
+      end
+      attr_writer :branch_from_namespace
+
       # The namespace to copy documents from.
       sig do
         returns(
           T.nilable(
             T.any(
               String,
-              Turbopuffer::NamespaceWriteParams::CopyFromNamespace::CopyFromNamespaceConfig
+              Turbopuffer::CopyFromNamespaceParams::CopyFromNamespaceConfig
             )
           )
         )
@@ -38,7 +62,7 @@ module Turbopuffer
           copy_from_namespace:
             T.any(
               String,
-              Turbopuffer::NamespaceWriteParams::CopyFromNamespace::CopyFromNamespaceConfig::OrHash
+              Turbopuffer::CopyFromNamespaceParams::CopyFromNamespaceConfig::OrHash
             )
         ).void
       end
@@ -197,10 +221,15 @@ module Turbopuffer
       sig do
         params(
           namespace: String,
+          branch_from_namespace:
+            T.any(
+              String,
+              Turbopuffer::BranchFromNamespaceParams::BranchFromNamespaceConfig::OrHash
+            ),
           copy_from_namespace:
             T.any(
               String,
-              Turbopuffer::NamespaceWriteParams::CopyFromNamespace::CopyFromNamespaceConfig::OrHash
+              Turbopuffer::CopyFromNamespaceParams::CopyFromNamespaceConfig::OrHash
             ),
           delete_by_filter: T.anything,
           delete_by_filter_allow_partial: T::Boolean,
@@ -229,6 +258,8 @@ module Turbopuffer
       end
       def self.new(
         namespace: nil,
+        # The namespace to create an instant, copy-on-write clone of.
+        branch_from_namespace: nil,
         # The namespace to copy documents from.
         copy_from_namespace: nil,
         # The filter specifying which documents to delete.
@@ -277,10 +308,15 @@ module Turbopuffer
         override.returns(
           {
             namespace: String,
+            branch_from_namespace:
+              T.any(
+                String,
+                Turbopuffer::BranchFromNamespaceParams::BranchFromNamespaceConfig
+              ),
             copy_from_namespace:
               T.any(
                 String,
-                Turbopuffer::NamespaceWriteParams::CopyFromNamespace::CopyFromNamespaceConfig
+                Turbopuffer::CopyFromNamespaceParams::CopyFromNamespaceConfig
               ),
             delete_by_filter: T.anything,
             delete_by_filter_allow_partial: T::Boolean,
@@ -310,86 +346,6 @@ module Turbopuffer
       def to_hash
       end
 
-      # The namespace to copy documents from.
-      module CopyFromNamespace
-        extend Turbopuffer::Internal::Type::Union
-
-        Variants =
-          T.type_alias do
-            T.any(
-              String,
-              Turbopuffer::NamespaceWriteParams::CopyFromNamespace::CopyFromNamespaceConfig
-            )
-          end
-
-        class CopyFromNamespaceConfig < Turbopuffer::Internal::Type::BaseModel
-          OrHash =
-            T.type_alias do
-              T.any(
-                Turbopuffer::NamespaceWriteParams::CopyFromNamespace::CopyFromNamespaceConfig,
-                Turbopuffer::Internal::AnyHash
-              )
-            end
-
-          # The namespace to copy documents from.
-          sig { returns(String) }
-          attr_accessor :source_namespace
-
-          # (Optional) An API key for the organization containing the source namespace
-          sig { returns(T.nilable(String)) }
-          attr_reader :source_api_key
-
-          sig { params(source_api_key: String).void }
-          attr_writer :source_api_key
-
-          # (Optional) The region of the source namespace.
-          sig { returns(T.nilable(String)) }
-          attr_reader :source_region
-
-          sig { params(source_region: String).void }
-          attr_writer :source_region
-
-          sig do
-            params(
-              source_namespace: String,
-              source_api_key: String,
-              source_region: String
-            ).returns(T.attached_class)
-          end
-          def self.new(
-            # The namespace to copy documents from.
-            source_namespace:,
-            # (Optional) An API key for the organization containing the source namespace
-            source_api_key: nil,
-            # (Optional) The region of the source namespace.
-            source_region: nil
-          )
-          end
-
-          sig do
-            override.returns(
-              {
-                source_namespace: String,
-                source_api_key: String,
-                source_region: String
-              }
-            )
-          end
-          def to_hash
-          end
-        end
-
-        sig do
-          override.returns(
-            T::Array[
-              Turbopuffer::NamespaceWriteParams::CopyFromNamespace::Variants
-            ]
-          )
-        end
-        def self.variants
-        end
-      end
-
       class Encryption < Turbopuffer::Internal::Type::BaseModel
         OrHash =
           T.type_alias do

data/rbi/turbopuffer/models/namespace_write_response.rbi

@@ -46,6 +46,13 @@ module Turbopuffer
       sig { params(patched_ids: T::Array[Turbopuffer::ID::Variants]).void }
       attr_writer :patched_ids
 
+      # The performance information for a write request.
+      sig { returns(T.nilable(Turbopuffer::WritePerformance)) }
+      attr_reader :performance
+
+      sig { params(performance: Turbopuffer::WritePerformance::OrHash).void }
+      attr_writer :performance
+
       # The number of rows deleted by the write request.
       sig { returns(T.nilable(Integer)) }
       attr_reader :rows_deleted
@@ -90,6 +97,7 @@ module Turbopuffer
           rows_affected: Integer,
           deleted_ids: T::Array[Turbopuffer::ID::Variants],
           patched_ids: T::Array[Turbopuffer::ID::Variants],
+          performance: Turbopuffer::WritePerformance::OrHash,
           rows_deleted: Integer,
           rows_patched: Integer,
           rows_remaining: T::Boolean,
@@ -111,6 +119,8 @@ module Turbopuffer
         # The IDs of documents that were patched. Only included when `return_affected_ids`
         # is true and at least one document was patched.
         patched_ids: nil,
+        # The performance information for a write request.
+        performance: nil,
         # The number of rows deleted by the write request.
         rows_deleted: nil,
         # The number of rows patched by the write request.
@@ -136,6 +146,7 @@ module Turbopuffer
             status: Symbol,
             deleted_ids: T::Array[Turbopuffer::ID::Variants],
             patched_ids: T::Array[Turbopuffer::ID::Variants],
+            performance: Turbopuffer::WritePerformance,
             rows_deleted: Integer,
             rows_patched: Integer,
             rows_remaining: T::Boolean,

data/rbi/turbopuffer/models/write_performance.rbi

@@ -0,0 +1,28 @@
+# typed: strong
+
+module Turbopuffer
+  module Models
+    class WritePerformance < Turbopuffer::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Turbopuffer::WritePerformance, Turbopuffer::Internal::AnyHash)
+        end
+
+      # Request time measured on the server, in milliseconds.
+      sig { returns(Integer) }
+      attr_accessor :server_total_ms
+
+      # The performance information for a write request.
+      sig { params(server_total_ms: Integer).returns(T.attached_class) }
+      def self.new(
+        # Request time measured on the server, in milliseconds.
+        server_total_ms:
+      )
+      end
+
+      sig { override.returns({ server_total_ms: Integer }) }
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/turbopuffer/models.rbi

@@ -15,6 +15,8 @@ module Turbopuffer
 
   Bm25ClauseParams = Turbopuffer::Models::Bm25ClauseParams
 
+  BranchFromNamespaceParams = Turbopuffer::Models::BranchFromNamespaceParams
+
   ClientNamespacesParams = Turbopuffer::Models::ClientNamespacesParams
 
   Columns = Turbopuffer::Models::Columns
@@ -25,6 +27,8 @@ module Turbopuffer
   ContainsAnyTokenFilterParams =
     Turbopuffer::Models::ContainsAnyTokenFilterParams
 
+  CopyFromNamespaceParams = Turbopuffer::Models::CopyFromNamespaceParams
+
   DecayParams = Turbopuffer::Models::DecayParams
 
   DistanceMetric = Turbopuffer::Models::DistanceMetric
@@ -83,4 +87,6 @@ module Turbopuffer
   VectorEncoding = Turbopuffer::Models::VectorEncoding
 
   WriteBilling = Turbopuffer::Models::WriteBilling
+
+  WritePerformance = Turbopuffer::Models::WritePerformance
 end

data/rbi/turbopuffer/resources/namespaces.rbi

@@ -238,10 +238,15 @@ module Turbopuffer
       sig do
         params(
           namespace: String,
+          branch_from_namespace:
+            T.any(
+              String,
+              Turbopuffer::BranchFromNamespaceParams::BranchFromNamespaceConfig::OrHash
+            ),
           copy_from_namespace:
             T.any(
               String,
-              Turbopuffer::NamespaceWriteParams::CopyFromNamespace::CopyFromNamespaceConfig::OrHash
+              Turbopuffer::CopyFromNamespaceParams::CopyFromNamespaceConfig::OrHash
             ),
           delete_by_filter: T.anything,
           delete_by_filter_allow_partial: T::Boolean,
@@ -271,6 +276,8 @@ module Turbopuffer
       def write(
         # Path param: The name of the namespace.
         namespace: nil,
+        # Body param: The namespace to create an instant, copy-on-write clone of.
+        branch_from_namespace: nil,
         # Body param: The namespace to copy documents from.
         copy_from_namespace: nil,
         # Body param: The filter specifying which documents to delete.

data/sig/turbopuffer/models/branch_from_namespace_params.rbs

@@ -0,0 +1,22 @@
+module Turbopuffer
+  module Models
+    type branch_from_namespace_params =
+      String | Turbopuffer::BranchFromNamespaceParams::BranchFromNamespaceConfig
+
+    module BranchFromNamespaceParams
+      extend Turbopuffer::Internal::Type::Union
+
+      type branch_from_namespace_config = { source_namespace: String }
+
+      class BranchFromNamespaceConfig < Turbopuffer::Internal::Type::BaseModel
+        attr_accessor source_namespace: String
+
+        def initialize: (source_namespace: String) -> void
+
+        def to_hash: -> { source_namespace: String }
+      end
+
+      def self?.variants: -> ::Array[Turbopuffer::Models::branch_from_namespace_params]
+    end
+  end
+end

data/sig/turbopuffer/models/copy_from_namespace_params.rbs

@@ -0,0 +1,43 @@
+module Turbopuffer
+  module Models
+    type copy_from_namespace_params =
+      String | Turbopuffer::CopyFromNamespaceParams::CopyFromNamespaceConfig
+
+    module CopyFromNamespaceParams
+      extend Turbopuffer::Internal::Type::Union
+
+      type copy_from_namespace_config =
+        {
+          source_namespace: String,
+          source_api_key: String,
+          source_region: String
+        }
+
+      class CopyFromNamespaceConfig < Turbopuffer::Internal::Type::BaseModel
+        attr_accessor source_namespace: String
+
+        attr_reader source_api_key: String?
+
+        def source_api_key=: (String) -> String
+
+        attr_reader source_region: String?
+
+        def source_region=: (String) -> String
+
+        def initialize: (
+          source_namespace: String,
+          ?source_api_key: String,
+          ?source_region: String
+        ) -> void
+
+        def to_hash: -> {
+          source_namespace: String,
+          source_api_key: String,
+          source_region: String
+        }
+      end
+
+      def self?.variants: -> ::Array[Turbopuffer::Models::copy_from_namespace_params]
+    end
+  end
+end

data/sig/turbopuffer/models/namespace_write_params.rbs

@@ -3,7 +3,8 @@ module Turbopuffer
     type namespace_write_params =
       {
         namespace: String,
-        copy_from_namespace: Turbopuffer::Models::NamespaceWriteParams::copy_from_namespace,
+        branch_from_namespace: Turbopuffer::Models::branch_from_namespace_params,
+        copy_from_namespace: Turbopuffer::Models::copy_from_namespace_params,
         delete_by_filter: top,
         delete_by_filter_allow_partial: bool,
         delete_condition: top,
@@ -32,11 +33,17 @@ module Turbopuffer
 
       def namespace=: (String) -> String
 
-      attr_reader copy_from_namespace: Turbopuffer::Models::NamespaceWriteParams::copy_from_namespace?
+      attr_reader branch_from_namespace: Turbopuffer::Models::branch_from_namespace_params?
+
+      def branch_from_namespace=: (
+        Turbopuffer::Models::branch_from_namespace_params
+      ) -> Turbopuffer::Models::branch_from_namespace_params
+
+      attr_reader copy_from_namespace: Turbopuffer::Models::copy_from_namespace_params?
 
       def copy_from_namespace=: (
-        Turbopuffer::Models::NamespaceWriteParams::copy_from_namespace
-      ) -> Turbopuffer::Models::NamespaceWriteParams::copy_from_namespace
+        Turbopuffer::Models::copy_from_namespace_params
+      ) -> Turbopuffer::Models::copy_from_namespace_params
 
       attr_reader delete_by_filter: top?
 
@@ -118,7 +125,8 @@ module Turbopuffer
 
       def initialize: (
         ?namespace: String,
-        ?copy_from_namespace: Turbopuffer::Models::NamespaceWriteParams::copy_from_namespace,
+        ?branch_from_namespace: Turbopuffer::Models::branch_from_namespace_params,
+        ?copy_from_namespace: Turbopuffer::Models::copy_from_namespace_params,
         ?delete_by_filter: top,
         ?delete_by_filter_allow_partial: bool,
         ?delete_condition: top,
@@ -141,7 +149,8 @@ module Turbopuffer
 
       def to_hash: -> {
         namespace: String,
-        copy_from_namespace: Turbopuffer::Models::NamespaceWriteParams::copy_from_namespace,
+        branch_from_namespace: Turbopuffer::Models::branch_from_namespace_params,
+        copy_from_namespace: Turbopuffer::Models::copy_from_namespace_params,
         delete_by_filter: top,
         delete_by_filter_allow_partial: bool,
         delete_condition: top,
@@ -162,47 +171,6 @@ module Turbopuffer
         request_options: Turbopuffer::RequestOptions
       }
 
-      type copy_from_namespace =
-        String
-        | Turbopuffer::NamespaceWriteParams::CopyFromNamespace::CopyFromNamespaceConfig
-
-      module CopyFromNamespace
-        extend Turbopuffer::Internal::Type::Union
-
-        type copy_from_namespace_config =
-          {
-            source_namespace: String,
-            source_api_key: String,
-            source_region: String
-          }
-
-        class CopyFromNamespaceConfig < Turbopuffer::Internal::Type::BaseModel
-          attr_accessor source_namespace: String
-
-          attr_reader source_api_key: String?
-
-          def source_api_key=: (String) -> String
-
-          attr_reader source_region: String?
-
-          def source_region=: (String) -> String
-
-          def initialize: (
-            source_namespace: String,
-            ?source_api_key: String,
-            ?source_region: String
-          ) -> void
-
-          def to_hash: -> {
-            source_namespace: String,
-            source_api_key: String,
-            source_region: String
-          }
-        end
-
-        def self?.variants: -> ::Array[Turbopuffer::Models::NamespaceWriteParams::copy_from_namespace]
-      end
-
       type encryption =
         { cmek: Turbopuffer::NamespaceWriteParams::Encryption::Cmek }
 

data/sig/turbopuffer/models/namespace_write_response.rbs

@@ -8,6 +8,7 @@ module Turbopuffer
         status: :OK,
         deleted_ids: ::Array[Turbopuffer::Models::id],
         patched_ids: ::Array[Turbopuffer::Models::id],
+        performance: Turbopuffer::WritePerformance,
         rows_deleted: Integer,
         rows_patched: Integer,
         rows_remaining: bool,
@@ -36,6 +37,12 @@ module Turbopuffer
         ::Array[Turbopuffer::Models::id]
       ) -> ::Array[Turbopuffer::Models::id]
 
+      attr_reader performance: Turbopuffer::WritePerformance?
+
+      def performance=: (
+        Turbopuffer::WritePerformance
+      ) -> Turbopuffer::WritePerformance
+
       attr_reader rows_deleted: Integer?
 
       def rows_deleted=: (Integer) -> Integer
@@ -64,6 +71,7 @@ module Turbopuffer
         rows_affected: Integer,
         ?deleted_ids: ::Array[Turbopuffer::Models::id],
         ?patched_ids: ::Array[Turbopuffer::Models::id],
+        ?performance: Turbopuffer::WritePerformance,
         ?rows_deleted: Integer,
         ?rows_patched: Integer,
         ?rows_remaining: bool,
@@ -79,6 +87,7 @@ module Turbopuffer
         status: :OK,
         deleted_ids: ::Array[Turbopuffer::Models::id],
         patched_ids: ::Array[Turbopuffer::Models::id],
+        performance: Turbopuffer::WritePerformance,
         rows_deleted: Integer,
         rows_patched: Integer,
         rows_remaining: bool,

data/sig/turbopuffer/models/write_performance.rbs

@@ -0,0 +1,13 @@
+module Turbopuffer
+  module Models
+    type write_performance = { server_total_ms: Integer }
+
+    class WritePerformance < Turbopuffer::Internal::Type::BaseModel
+      attr_accessor server_total_ms: Integer
+
+      def initialize: (server_total_ms: Integer) -> void
+
+      def to_hash: -> { server_total_ms: Integer }
+    end
+  end
+end

data/sig/turbopuffer/models.rbs

@@ -9,6 +9,8 @@ module Turbopuffer
 
   class Bm25ClauseParams = Turbopuffer::Models::Bm25ClauseParams
 
+  module BranchFromNamespaceParams = Turbopuffer::Models::BranchFromNamespaceParams
+
   class ClientNamespacesParams = Turbopuffer::Models::ClientNamespacesParams
 
   class Columns = Turbopuffer::Models::Columns
@@ -17,6 +19,8 @@ module Turbopuffer
 
   class ContainsAnyTokenFilterParams = Turbopuffer::Models::ContainsAnyTokenFilterParams
 
+  module CopyFromNamespaceParams = Turbopuffer::Models::CopyFromNamespaceParams
+
   class DecayParams = Turbopuffer::Models::DecayParams
 
   module DistanceMetric = Turbopuffer::Models::DistanceMetric
@@ -74,4 +78,6 @@ module Turbopuffer
   module VectorEncoding = Turbopuffer::Models::VectorEncoding
 
   class WriteBilling = Turbopuffer::Models::WriteBilling
+
+  class WritePerformance = Turbopuffer::Models::WritePerformance
 end

data/sig/turbopuffer/resources/namespaces.rbs

@@ -78,7 +78,8 @@ module Turbopuffer
 
       def write: (
         ?namespace: String,
-        ?copy_from_namespace: Turbopuffer::Models::NamespaceWriteParams::copy_from_namespace,
+        ?branch_from_namespace: Turbopuffer::Models::branch_from_namespace_params,
+        ?copy_from_namespace: Turbopuffer::Models::copy_from_namespace_params,
         ?delete_by_filter: top,
         ?delete_by_filter_allow_partial: bool,
         ?delete_condition: top,

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: turbopuffer
 version: !ruby/object:Gem::Version
-  version: 1.16.0
+  version: 1.18.0
 platform: ruby
 authors:
 - Turbopuffer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-03-16 00:00:00.000000000 Z
+date: 2026-03-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi
@@ -75,10 +75,12 @@ files:
 - lib/turbopuffer/models/attribute_schema_config.rb
 - lib/turbopuffer/models/attribute_type.rb
 - lib/turbopuffer/models/bm25_clause_params.rb
+- lib/turbopuffer/models/branch_from_namespace_params.rb
 - lib/turbopuffer/models/client_namespaces_params.rb
 - lib/turbopuffer/models/columns.rb
 - lib/turbopuffer/models/contains_all_tokens_filter_params.rb
 - lib/turbopuffer/models/contains_any_token_filter_params.rb
+- lib/turbopuffer/models/copy_from_namespace_params.rb
 - lib/turbopuffer/models/decay_params.rb
 - lib/turbopuffer/models/distance_metric.rb
 - lib/turbopuffer/models/full_text_search.rb
@@ -117,6 +119,7 @@ files:
 - lib/turbopuffer/models/vector.rb
 - lib/turbopuffer/models/vector_encoding.rb
 - lib/turbopuffer/models/write_billing.rb
+- lib/turbopuffer/models/write_performance.rb
 - lib/turbopuffer/namespace.rb
 - lib/turbopuffer/request_options.rb
 - lib/turbopuffer/resources/namespaces.rb
@@ -147,10 +150,12 @@ files:
 - rbi/turbopuffer/models/attribute_schema_config.rbi
 - rbi/turbopuffer/models/attribute_type.rbi
 - rbi/turbopuffer/models/bm25_clause_params.rbi
+- rbi/turbopuffer/models/branch_from_namespace_params.rbi
 - rbi/turbopuffer/models/client_namespaces_params.rbi
 - rbi/turbopuffer/models/columns.rbi
 - rbi/turbopuffer/models/contains_all_tokens_filter_params.rbi
 - rbi/turbopuffer/models/contains_any_token_filter_params.rbi
+- rbi/turbopuffer/models/copy_from_namespace_params.rbi
 - rbi/turbopuffer/models/decay_params.rbi
 - rbi/turbopuffer/models/distance_metric.rbi
 - rbi/turbopuffer/models/full_text_search.rbi
@@ -189,6 +194,7 @@ files:
 - rbi/turbopuffer/models/vector.rbi
 - rbi/turbopuffer/models/vector_encoding.rbi
 - rbi/turbopuffer/models/write_billing.rbi
+- rbi/turbopuffer/models/write_performance.rbi
 - rbi/turbopuffer/namespace.rbi
 - rbi/turbopuffer/request_options.rbi
 - rbi/turbopuffer/resources/namespaces.rbi
@@ -218,10 +224,12 @@ files:
 - sig/turbopuffer/models/attribute_schema_config.rbs
 - sig/turbopuffer/models/attribute_type.rbs
 - sig/turbopuffer/models/bm25_clause_params.rbs
+- sig/turbopuffer/models/branch_from_namespace_params.rbs
 - sig/turbopuffer/models/client_namespaces_params.rbs
 - sig/turbopuffer/models/columns.rbs
 - sig/turbopuffer/models/contains_all_tokens_filter_params.rbs
 - sig/turbopuffer/models/contains_any_token_filter_params.rbs
+- sig/turbopuffer/models/copy_from_namespace_params.rbs
 - sig/turbopuffer/models/decay_params.rbs
 - sig/turbopuffer/models/distance_metric.rbs
 - sig/turbopuffer/models/full_text_search.rbs
@@ -260,6 +268,7 @@ files:
 - sig/turbopuffer/models/vector.rbs
 - sig/turbopuffer/models/vector_encoding.rbs
 - sig/turbopuffer/models/write_billing.rbs
+- sig/turbopuffer/models/write_performance.rbs
 - sig/turbopuffer/namespace.rbs
 - sig/turbopuffer/request_options.rbs
 - sig/turbopuffer/resources/namespaces.rbs