turbopuffer 1.16.0 → 1.17.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 49996bb69761463127455f5c055e194300f90c3019a799a22caba584aea8d782
-  data.tar.gz: 4de6f2a10ec1a14391748137eb96f93a6e3251f5a567dcb60afb0d914c47dcbe
+  metadata.gz: 51ed4f8a26c5c46912e76a0eccd23b4a397408567b0911ee847afabcf41d3a76
+  data.tar.gz: cd812fc750088020a732b173c5f0d1744e24a54df391125446601feea7c1248f
 SHA512:
-  metadata.gz: 476911f60864a91b8f621a8a0d46a1ca0aa3bd1613bf238c9e4e1609444849874e1b3a2826969f96ff6b24637f476ccae5ea07ad9a705bea50bc9957b79926d2
-  data.tar.gz: e8ce0b91324f880dac5070f46cda019dabe5eed989a2ce0337078cdf64544e7609442ae5e6554390057377226edd3e6fbd5237f05ef44769b6008d6981a49c66
+  metadata.gz: efdbdd5d2cf339959d586d87557784371caea3e63df37ff4528cd97ffd9771f357af788a5a2bf895af88ec80fbef96233cef5b67d53d1f50bdec8064842997bc
+  data.tar.gz: b61e2a2038949c21f21ef7dbbb637b17d685938a1c6d9ef6ad2d2c3ba4ba237d9862d9a3afedf73af73f23dd8bc642202e67478c7cb31921b3611dd7bc94f4c6

data/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 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.17.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/namespace_write_params.rb

@@ -12,6 +12,12 @@ 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, nil]
+      optional :branch_from_namespace, String
+
       # @!attribute copy_from_namespace
       #   The namespace to copy documents from.
       #
@@ -124,12 +130,14 @@ 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 branch_from_namespace [String] The namespace to create an instant, copy-on-write clone of.
+      #
       #   @param copy_from_namespace [String, Turbopuffer::Models::NamespaceWriteParams::CopyFromNamespace::CopyFromNamespaceConfig] The namespace to copy documents from.
       #
       #   @param delete_by_filter [Object] The filter specifying which documents to delete.

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

@@ -115,4 +115,6 @@ module Turbopuffer
   VectorEncoding = Turbopuffer::Models::VectorEncoding
 
   WriteBilling = Turbopuffer::Models::WriteBilling
+
+  WritePerformance = Turbopuffer::Models::WritePerformance
 end

data/lib/turbopuffer/resources/namespaces.rb

@@ -307,10 +307,12 @@ 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 branch_from_namespace [String] Body param: The namespace to create an instant, copy-on-write clone of.
+      #
       # @param copy_from_namespace [String, Turbopuffer::Models::NamespaceWriteParams::CopyFromNamespace::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.17.0"
 end

data/lib/turbopuffer.rb

@@ -100,6 +100,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/namespace_write_params.rbi

@@ -20,6 +20,13 @@ module Turbopuffer
       sig { params(namespace: String).void }
       attr_writer :namespace
 
+      # The namespace to create an instant, copy-on-write clone of.
+      sig { returns(T.nilable(String)) }
+      attr_reader :branch_from_namespace
+
+      sig { params(branch_from_namespace: String).void }
+      attr_writer :branch_from_namespace
+
       # The namespace to copy documents from.
       sig do
         returns(
@@ -197,6 +204,7 @@ module Turbopuffer
       sig do
         params(
           namespace: String,
+          branch_from_namespace: String,
           copy_from_namespace:
             T.any(
               String,
@@ -229,6 +237,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,6 +287,7 @@ module Turbopuffer
         override.returns(
           {
             namespace: String,
+            branch_from_namespace: String,
             copy_from_namespace:
               T.any(
                 String,

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

@@ -83,4 +83,6 @@ module Turbopuffer
   VectorEncoding = Turbopuffer::Models::VectorEncoding
 
   WriteBilling = Turbopuffer::Models::WriteBilling
+
+  WritePerformance = Turbopuffer::Models::WritePerformance
 end

data/rbi/turbopuffer/resources/namespaces.rbi

@@ -238,6 +238,7 @@ module Turbopuffer
       sig do
         params(
           namespace: String,
+          branch_from_namespace: String,
           copy_from_namespace:
             T.any(
               String,
@@ -271,6 +272,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/namespace_write_params.rbs

@@ -3,6 +3,7 @@ module Turbopuffer
     type namespace_write_params =
       {
         namespace: String,
+        branch_from_namespace: String,
         copy_from_namespace: Turbopuffer::Models::NamespaceWriteParams::copy_from_namespace,
         delete_by_filter: top,
         delete_by_filter_allow_partial: bool,
@@ -32,6 +33,10 @@ module Turbopuffer
 
       def namespace=: (String) -> String
 
+      attr_reader branch_from_namespace: String?
+
+      def branch_from_namespace=: (String) -> String
+
       attr_reader copy_from_namespace: Turbopuffer::Models::NamespaceWriteParams::copy_from_namespace?
 
       def copy_from_namespace=: (
@@ -118,6 +123,7 @@ module Turbopuffer
 
       def initialize: (
         ?namespace: String,
+        ?branch_from_namespace: String,
         ?copy_from_namespace: Turbopuffer::Models::NamespaceWriteParams::copy_from_namespace,
         ?delete_by_filter: top,
         ?delete_by_filter_allow_partial: bool,
@@ -141,6 +147,7 @@ module Turbopuffer
 
       def to_hash: -> {
         namespace: String,
+        branch_from_namespace: String,
         copy_from_namespace: Turbopuffer::Models::NamespaceWriteParams::copy_from_namespace,
         delete_by_filter: top,
         delete_by_filter_allow_partial: bool,

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

@@ -74,4 +74,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,6 +78,7 @@ module Turbopuffer
 
       def write: (
         ?namespace: String,
+        ?branch_from_namespace: String,
         ?copy_from_namespace: Turbopuffer::Models::NamespaceWriteParams::copy_from_namespace,
         ?delete_by_filter: top,
         ?delete_by_filter_allow_partial: bool,

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: turbopuffer
 version: !ruby/object:Gem::Version
-  version: 1.16.0
+  version: 1.17.0
 platform: ruby
 authors:
 - Turbopuffer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-03-16 00:00:00.000000000 Z
+date: 2026-03-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi
@@ -117,6 +117,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
@@ -189,6 +190,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
@@ -260,6 +262,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