turbopuffer 2.5.0 → 2.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c7a74005340bd71314cefec78857e87f61242c5e99ca0619718932862dfb9b3e
-  data.tar.gz: 90568747fb99e6f0c3e07e135600cd49e48e806023059f27f0f270bb3f20ca20
+  metadata.gz: ef31174cdc912d308aff4e1392291db0bc29aaa5accdfe5f715a51bccb46e6f7
+  data.tar.gz: b73f653240c84d4ecd85be785bf236c77e236c1c95547754339b3e94e98feb7d
 SHA512:
-  metadata.gz: e01efec060630c4a1b3840c93dc93148fd8724ffe326b7b697679a6d2a51eeecea9692ece6be917b3d42d7ed85ed1a958db57134f215b4290ab63f0c33521232
-  data.tar.gz: 9ce535511cfc814424db7cf0c6567b35724ddb1c75550224866a805040220b2daf28c9b0dfa686153f2a6e8a41c056066c29d0952a805594e7bda8cfe356351b
+  metadata.gz: 1c2a3e24797234d50a2d0606b449a589ceec5c9b29debb461f7e1e0559170d8c7c3237bf1d70df606affcdbf96142b8905ca42f17a01cbe11a660535d22d10de
+  data.tar.gz: 6e33f83ad2b352168124205f2ac50d93101ae784eb379cc77ae20182eaf9cc3cfe9ac19a02c104c640e1225903f410369ebc1d1e9f828008b2907b6dc4e19d5f

data/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## [2.7.0](https://github.com/turbopuffer/turbopuffer-ruby/compare/v2.6.0...v2.7.0) (2026-10-08)
+
+
+### Features
+
+* embedding: openapi embedding stats ([8e507b4](https://github.com/turbopuffer/turbopuffer-ruby/commit/8e507b4be4c36b6a451e4ae1caee59d477fcc494))
+* metadata: expose unindexed_rows in index status ([d9fe3b0](https://github.com/turbopuffer/turbopuffer-ruby/commit/d9fe3b065aff2fb578c7f950cce4c2664037b0a5))
+
+
+### Chores
+
+* regenerate SDK ([b6678e9](https://github.com/turbopuffer/turbopuffer-ruby/commit/b6678e9fd9a33f4545541da85e7578d377154801))
+
+## [2.6.0](https://github.com/turbopuffer/turbopuffer-ruby/compare/v2.5.0...v2.6.0) (2026-10-07)
+
+
+### Features
+
+* add create_namespace to openapi.yml ([39cb498](https://github.com/turbopuffer/turbopuffer-ruby/commit/39cb4987eb4b8783caf2484554588e954be76244))
+* stainless to stlc migration ([6e6718f](https://github.com/turbopuffer/turbopuffer-ruby/commit/6e6718fd42b5c2608ea0164f5cf32ea6609104ad))
+* stlc: qol fixes ([95ae3c3](https://github.com/turbopuffer/turbopuffer-ruby/commit/95ae3c31b03afe8384da1f384a6eb0cdcda952f3))
+
 ## 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)

data/README.md

@@ -17,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.5.0"
+gem "turbopuffer", "~> 2.7.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/turbopuffer/models/attribute_schema.rb

@@ -12,8 +12,11 @@ module Turbopuffer
       # Detailed configuration for an attribute attached to a document.
       variant -> { Turbopuffer::AttributeSchemaConfig }
 
+      # Drops the attribute from the namespace. Cannot be combined with other schema settings.
+      variant -> { Turbopuffer::AttributeSchemaDrop }
+
       # @!method self.variants
-      #   @return [Array(String, Turbopuffer::Models::AttributeSchemaConfig)]
+      #   @return [Array(String, Turbopuffer::Models::AttributeSchemaConfig, Turbopuffer::Models::AttributeSchemaDrop)]
     end
   end
 end

data/lib/turbopuffer/models/attribute_schema_drop.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Turbopuffer
+  module Models
+    class AttributeSchemaDrop < Turbopuffer::Internal::Type::BaseModel
+      # @!attribute drop
+      #   Must be `true`.
+      #
+      #   @return [Boolean]
+      required :drop, Turbopuffer::Internal::Type::Boolean
+
+      # @!method initialize(drop:)
+      #   Drops the attribute from the namespace. Cannot be combined with other schema
+      #   settings.
+      #
+      #   @param drop [Boolean] Must be `true`.
+    end
+  end
+end

data/lib/turbopuffer/models/namespace_metadata.rb

@@ -124,12 +124,20 @@ module Turbopuffer
           #   @return [Integer]
           required :unindexed_bytes, Integer
 
-          # @!method initialize(unindexed_bytes:, status: :updating)
+          # @!attribute unindexed_rows
+          #   The number of rows in the write-ahead log that have not yet been indexed.
+          #
+          #   @return [Integer]
+          required :unindexed_rows, Integer
+
+          # @!method initialize(unindexed_bytes:, unindexed_rows:, status: :updating)
           #   Some parameter documentations has been truncated, see
           #   {Turbopuffer::Models::NamespaceMetadata::Index::IndexUpdating} for more details.
           #
           #   @param unindexed_bytes [Integer] The number of bytes in the namespace that are in the write-ahead log but have no
           #
+          #   @param unindexed_rows [Integer] The number of rows in the write-ahead log that have not yet been indexed.
+          #
           #   @param status [Symbol, :updating]
         end
 

data/lib/turbopuffer/models/namespace_update_schema_params.rb

@@ -15,13 +15,13 @@ module Turbopuffer
       # @!attribute schema
       #   The desired schema for the namespace.
       #
-      #   @return [Hash{Symbol=>String, Turbopuffer::Models::AttributeSchemaConfig}, nil]
+      #   @return [Hash{Symbol=>String, Turbopuffer::Models::AttributeSchemaConfig, Turbopuffer::Models::AttributeSchemaDrop}, nil]
       optional :schema, -> { Turbopuffer::Internal::Type::HashOf[union: Turbopuffer::AttributeSchema] }
 
       # @!method initialize(namespace: nil, schema: nil, request_options: {})
       #   @param namespace [String]
       #
-      #   @param schema [Hash{Symbol=>String, Turbopuffer::Models::AttributeSchemaConfig}] The desired schema for the namespace.
+      #   @param schema [Hash{Symbol=>String, Turbopuffer::Models::AttributeSchemaConfig, Turbopuffer::Models::AttributeSchemaDrop}] The desired schema for the namespace.
       #
       #   @param request_options [Turbopuffer::RequestOptions, Hash{Symbol=>Object}]
     end

data/lib/turbopuffer/models/namespace_write_params.rb

@@ -24,6 +24,16 @@ module Turbopuffer
       #   @return [String, Turbopuffer::Models::CopyFromNamespaceParams::CopyFromNamespaceConfig, nil]
       optional :copy_from_namespace, union: -> { Turbopuffer::CopyFromNamespaceParams }
 
+      # @!attribute create_namespace
+      #   If `true`, ensures the namespace is created, even if the request writes no
+      #   documents. Creating an empty namespace requires the `id` type to be declared in
+      #   `schema`. If `false`, a namespace is never created, and a 404 is returned if it
+      #   does not exist. If omitted, a namespace is created by the first request that
+      #   writes documents.
+      #
+      #   @return [Boolean, nil]
+      optional :create_namespace, Turbopuffer::Internal::Type::Boolean
+
       # @!attribute delete_by_filter
       #   The filter specifying which documents to delete.
       #
@@ -108,7 +118,7 @@ module Turbopuffer
       # @!attribute schema
       #   The schema of the attributes attached to the documents.
       #
-      #   @return [Hash{Symbol=>String, Turbopuffer::Models::AttributeSchemaConfig}, nil]
+      #   @return [Hash{Symbol=>String, Turbopuffer::Models::AttributeSchemaConfig, Turbopuffer::Models::AttributeSchemaDrop}, nil]
       optional :schema, -> { Turbopuffer::Internal::Type::HashOf[union: Turbopuffer::AttributeSchema] }
 
       # @!attribute sharding
@@ -139,7 +149,7 @@ module Turbopuffer
       #   @return [Array<Turbopuffer::Models::Row>, nil]
       optional :upsert_rows, -> { Turbopuffer::Internal::Type::ArrayOf[Turbopuffer::Row] }
 
-      # @!method initialize(namespace: nil, branch_from_namespace: nil, copy_from_namespace: nil, delete_by_filter: nil, delete_by_filter_allow_partial: nil, delete_condition: nil, deletes: nil, disable_backpressure: nil, distance_metric: nil, encryption: nil, patch_by_filter: nil, patch_by_filter_allow_partial: nil, patch_columns: nil, patch_condition: nil, patch_rows: nil, return_affected_ids: nil, schema: nil, sharding: nil, upsert_columns: nil, upsert_condition: nil, upsert_rows: nil, request_options: {})
+      # @!method initialize(namespace: nil, branch_from_namespace: nil, copy_from_namespace: nil, create_namespace: nil, delete_by_filter: nil, delete_by_filter_allow_partial: nil, delete_condition: nil, deletes: nil, disable_backpressure: nil, distance_metric: nil, encryption: nil, patch_by_filter: nil, patch_by_filter_allow_partial: nil, patch_columns: nil, patch_condition: nil, patch_rows: nil, return_affected_ids: nil, schema: nil, sharding: nil, upsert_columns: nil, upsert_condition: nil, upsert_rows: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Turbopuffer::Models::NamespaceWriteParams} for more details.
       #
@@ -149,6 +159,8 @@ module Turbopuffer
       #
       #   @param copy_from_namespace [String, Turbopuffer::Models::CopyFromNamespaceParams::CopyFromNamespaceConfig] The namespace to copy documents from.
       #
+      #   @param create_namespace [Boolean] If `true`, ensures the namespace is created, even if the request writes no docum
+      #
       #   @param delete_by_filter [Object] The filter specifying which documents to delete.
       #
       #   @param delete_by_filter_allow_partial [Boolean] Allow partial completion when filter matches too many documents.
@@ -175,7 +187,7 @@ module Turbopuffer
       #
       #   @param return_affected_ids [Boolean] If true, return the IDs of affected rows (deleted, patched, upserted) in the res
       #
-      #   @param schema [Hash{Symbol=>String, Turbopuffer::Models::AttributeSchemaConfig}] The schema of the attributes attached to the documents.
+      #   @param schema [Hash{Symbol=>String, Turbopuffer::Models::AttributeSchemaConfig, Turbopuffer::Models::AttributeSchemaDrop}] The schema of the attributes attached to the documents.
       #
       #   @param sharding [Turbopuffer::Models::ShardingConfig] Configuration for namespace sharding, which partitions a namespace's documents a
       #

data/lib/turbopuffer/models/query_performance.rb

@@ -41,7 +41,20 @@ module Turbopuffer
       #   @return [Integer]
       required :server_total_ms, Integer
 
-      # @!method initialize(approx_namespace_size:, cache_hit_ratio:, cache_temperature:, exhaustive_search_count:, query_execution_ms:, server_total_ms:)
+      # @!attribute embedding_ms
+      #   Time spent embedding text, in milliseconds. Only set when using a native
+      #   embedding model.
+      #
+      #   @return [Integer, nil]
+      optional :embedding_ms, Integer
+
+      # @!attribute embedding_tokens
+      #   The number of tokens embedded. Only set when using a native embedding model.
+      #
+      #   @return [Integer, nil]
+      optional :embedding_tokens, Integer
+
+      # @!method initialize(approx_namespace_size:, cache_hit_ratio:, cache_temperature:, exhaustive_search_count:, query_execution_ms:, server_total_ms:, embedding_ms: nil, embedding_tokens: nil)
       #   Some parameter documentations has been truncated, see
       #   {Turbopuffer::Models::QueryPerformance} for more details.
       #
@@ -58,6 +71,10 @@ module Turbopuffer
       #   @param query_execution_ms [Integer] Request time measured on the server, excluding time spent waiting due to the nam
       #
       #   @param server_total_ms [Integer] Request time measured on the server, including time spent waiting for other quer
+      #
+      #   @param embedding_ms [Integer] Time spent embedding text, in milliseconds. Only set when using a native embeddi
+      #
+      #   @param embedding_tokens [Integer] The number of tokens embedded. Only set when using a native embedding model.
     end
   end
 end

data/lib/turbopuffer/models/write_performance.rb

@@ -9,10 +9,30 @@ module Turbopuffer
       #   @return [Integer]
       required :server_total_ms, Integer
 
-      # @!method initialize(server_total_ms:)
+      # @!attribute embedding_ms
+      #   Time spent embedding text, in milliseconds. Only set when using a native
+      #   embedding model.
+      #
+      #   @return [Integer, nil]
+      optional :embedding_ms, Integer
+
+      # @!attribute embedding_tokens
+      #   The number of tokens embedded. Only set when using a native embedding model.
+      #
+      #   @return [Integer, nil]
+      optional :embedding_tokens, Integer
+
+      # @!method initialize(server_total_ms:, embedding_ms: nil, embedding_tokens: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Turbopuffer::Models::WritePerformance} for more details.
+      #
       #   The performance information for a write request.
       #
       #   @param server_total_ms [Integer] Request time measured on the server, in milliseconds.
+      #
+      #   @param embedding_ms [Integer] Time spent embedding text, in milliseconds. Only set when using a native embeddi
+      #
+      #   @param embedding_tokens [Integer] The number of tokens embedded. Only set when using a native embedding model.
     end
   end
 end

data/lib/turbopuffer/models.rb

@@ -50,6 +50,8 @@ module Turbopuffer
 
   AttributeSchemaConfig = Turbopuffer::Models::AttributeSchemaConfig
 
+  AttributeSchemaDrop = Turbopuffer::Models::AttributeSchemaDrop
+
   AttributeType = Turbopuffer::Models::AttributeType
 
   Bm25ClauseParams = Turbopuffer::Models::Bm25ClauseParams

data/lib/turbopuffer/resources/namespaces.rb

@@ -463,7 +463,7 @@ module Turbopuffer
       #
       # @param namespace [String] Path param: The name of the namespace.
       #
-      # @param schema [Hash{Symbol=>String, Turbopuffer::Models::AttributeSchemaConfig}] Body param: The desired schema for the namespace.
+      # @param schema [Hash{Symbol=>String, Turbopuffer::Models::AttributeSchemaConfig, Turbopuffer::Models::AttributeSchemaDrop}] Body param: The desired schema for the namespace.
       #
       # @param request_options [Turbopuffer::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -490,7 +490,7 @@ module Turbopuffer
       #
       # Create, update, or delete documents.
       #
-      # @overload write(namespace: nil, branch_from_namespace: nil, copy_from_namespace: nil, delete_by_filter: nil, delete_by_filter_allow_partial: nil, delete_condition: nil, deletes: nil, disable_backpressure: nil, distance_metric: nil, encryption: nil, patch_by_filter: nil, patch_by_filter_allow_partial: nil, patch_columns: nil, patch_condition: nil, patch_rows: nil, return_affected_ids: nil, schema: nil, sharding: nil, upsert_columns: nil, upsert_condition: nil, upsert_rows: nil, request_options: {})
+      # @overload write(namespace: nil, branch_from_namespace: nil, copy_from_namespace: nil, create_namespace: nil, delete_by_filter: nil, delete_by_filter_allow_partial: nil, delete_condition: nil, deletes: nil, disable_backpressure: nil, distance_metric: nil, encryption: nil, patch_by_filter: nil, patch_by_filter_allow_partial: nil, patch_columns: nil, patch_condition: nil, patch_rows: nil, return_affected_ids: nil, schema: nil, sharding: nil, upsert_columns: nil, upsert_condition: nil, upsert_rows: nil, request_options: {})
       #
       # @param namespace [String] Path param: The name of the namespace.
       #
@@ -498,6 +498,8 @@ module Turbopuffer
       #
       # @param copy_from_namespace [String, Turbopuffer::Models::CopyFromNamespaceParams::CopyFromNamespaceConfig] Body param: The namespace to copy documents from.
       #
+      # @param create_namespace [Boolean] Body param: If `true`, ensures the namespace is created, even if the request wri
+      #
       # @param delete_by_filter [Object] Body param: The filter specifying which documents to delete.
       #
       # @param delete_by_filter_allow_partial [Boolean] Body param: Allow partial completion when filter matches too many documents.
@@ -524,7 +526,7 @@ module Turbopuffer
       #
       # @param return_affected_ids [Boolean] Body param: If true, return the IDs of affected rows (deleted, patched, upserted
       #
-      # @param schema [Hash{Symbol=>String, Turbopuffer::Models::AttributeSchemaConfig}] Body param: The schema of the attributes attached to the documents.
+      # @param schema [Hash{Symbol=>String, Turbopuffer::Models::AttributeSchemaConfig, Turbopuffer::Models::AttributeSchemaDrop}] Body param: The schema of the attributes attached to the documents.
       #
       # @param sharding [Turbopuffer::Models::ShardingConfig] Body param: Configuration for namespace sharding, which partitions a namespace's
       #

data/lib/turbopuffer/version.rb

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

data/lib/turbopuffer.rb

@@ -61,6 +61,7 @@ require_relative "turbopuffer/models/attribute_embed"
 require_relative "turbopuffer/models/attribute_embed_config"
 require_relative "turbopuffer/models/attribute_schema"
 require_relative "turbopuffer/models/attribute_schema_config"
+require_relative "turbopuffer/models/attribute_schema_drop"
 require_relative "turbopuffer/models/attribute_type"
 require_relative "turbopuffer/models/bm25_clause_params"
 require_relative "turbopuffer/models/branch_from_namespace_params"

data/rbi/turbopuffer/models/attribute_schema.rbi

@@ -7,7 +7,13 @@ module Turbopuffer
       extend Turbopuffer::Internal::Type::Union
 
       Variants =
-        T.type_alias { T.any(String, Turbopuffer::AttributeSchemaConfig) }
+        T.type_alias do
+          T.any(
+            String,
+            Turbopuffer::AttributeSchemaConfig,
+            Turbopuffer::AttributeSchemaDrop
+          )
+        end
 
       sig { override.returns(T::Array[Turbopuffer::AttributeSchema::Variants]) }
       def self.variants

data/rbi/turbopuffer/models/attribute_schema_drop.rbi

@@ -0,0 +1,32 @@
+# typed: strong
+
+module Turbopuffer
+  module Models
+    class AttributeSchemaDrop < Turbopuffer::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            Turbopuffer::AttributeSchemaDrop,
+            Turbopuffer::Internal::AnyHash
+          )
+        end
+
+      # Must be `true`.
+      sig { returns(T::Boolean) }
+      attr_accessor :drop
+
+      # Drops the attribute from the namespace. Cannot be combined with other schema
+      # settings.
+      sig { params(drop: T::Boolean).returns(T.attached_class) }
+      def self.new(
+        # Must be `true`.
+        drop:
+      )
+      end
+
+      sig { override.returns({ drop: T::Boolean }) }
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/turbopuffer/models/namespace_metadata.rbi

@@ -180,20 +180,36 @@ module Turbopuffer
           sig { returns(Integer) }
           attr_accessor :unindexed_bytes
 
+          # The number of rows in the write-ahead log that have not yet been indexed.
+          sig { returns(Integer) }
+          attr_accessor :unindexed_rows
+
           sig do
-            params(unindexed_bytes: Integer, status: Symbol).returns(
-              T.attached_class
-            )
+            params(
+              unindexed_bytes: Integer,
+              unindexed_rows: Integer,
+              status: Symbol
+            ).returns(T.attached_class)
           end
           def self.new(
             # The number of bytes in the namespace that are in the write-ahead log but have
             # not yet been indexed.
             unindexed_bytes:,
+            # The number of rows in the write-ahead log that have not yet been indexed.
+            unindexed_rows:,
             status: :updating
           )
           end
 
-          sig { override.returns({ status: Symbol, unindexed_bytes: Integer }) }
+          sig do
+            override.returns(
+              {
+                status: Symbol,
+                unindexed_bytes: Integer,
+                unindexed_rows: Integer
+              }
+            )
+          end
           def to_hash
           end
         end

data/rbi/turbopuffer/models/namespace_update_schema_params.rbi

@@ -24,7 +24,14 @@ module Turbopuffer
       sig do
         returns(
           T.nilable(
-            T::Hash[Symbol, T.any(String, Turbopuffer::AttributeSchemaConfig)]
+            T::Hash[
+              Symbol,
+              T.any(
+                String,
+                Turbopuffer::AttributeSchemaConfig,
+                Turbopuffer::AttributeSchemaDrop
+              )
+            ]
           )
         )
       end
@@ -35,7 +42,11 @@ module Turbopuffer
           schema:
             T::Hash[
               Symbol,
-              T.any(String, Turbopuffer::AttributeSchemaConfig::OrHash)
+              T.any(
+                String,
+                Turbopuffer::AttributeSchemaConfig::OrHash,
+                Turbopuffer::AttributeSchemaDrop::OrHash
+              )
             ]
         ).void
       end
@@ -47,7 +58,11 @@ module Turbopuffer
           schema:
             T::Hash[
               Symbol,
-              T.any(String, Turbopuffer::AttributeSchemaConfig::OrHash)
+              T.any(
+                String,
+                Turbopuffer::AttributeSchemaConfig::OrHash,
+                Turbopuffer::AttributeSchemaDrop::OrHash
+              )
             ],
           request_options: Turbopuffer::RequestOptions::OrHash
         ).returns(T.attached_class)
@@ -67,7 +82,11 @@ module Turbopuffer
             schema:
               T::Hash[
                 Symbol,
-                T.any(String, Turbopuffer::AttributeSchemaConfig)
+                T.any(
+                  String,
+                  Turbopuffer::AttributeSchemaConfig,
+                  Turbopuffer::AttributeSchemaDrop
+                )
               ],
             request_options: Turbopuffer::RequestOptions
           }

data/rbi/turbopuffer/models/namespace_write_params.rbi

@@ -68,6 +68,17 @@ module Turbopuffer
       end
       attr_writer :copy_from_namespace
 
+      # If `true`, ensures the namespace is created, even if the request writes no
+      # documents. Creating an empty namespace requires the `id` type to be declared in
+      # `schema`. If `false`, a namespace is never created, and a 404 is returned if it
+      # does not exist. If omitted, a namespace is created by the first request that
+      # writes documents.
+      sig { returns(T.nilable(T::Boolean)) }
+      attr_reader :create_namespace
+
+      sig { params(create_namespace: T::Boolean).void }
+      attr_writer :create_namespace
+
       # The filter specifying which documents to delete.
       sig { returns(T.nilable(T.anything)) }
       attr_reader :delete_by_filter
@@ -192,7 +203,14 @@ module Turbopuffer
       sig do
         returns(
           T.nilable(
-            T::Hash[Symbol, T.any(String, Turbopuffer::AttributeSchemaConfig)]
+            T::Hash[
+              Symbol,
+              T.any(
+                String,
+                Turbopuffer::AttributeSchemaConfig,
+                Turbopuffer::AttributeSchemaDrop
+              )
+            ]
           )
         )
       end
@@ -203,7 +221,11 @@ module Turbopuffer
           schema:
             T::Hash[
               Symbol,
-              T.any(String, Turbopuffer::AttributeSchemaConfig::OrHash)
+              T.any(
+                String,
+                Turbopuffer::AttributeSchemaConfig::OrHash,
+                Turbopuffer::AttributeSchemaDrop::OrHash
+              )
             ]
         ).void
       end
@@ -254,6 +276,7 @@ module Turbopuffer
               String,
               Turbopuffer::CopyFromNamespaceParams::CopyFromNamespaceConfig::OrHash
             ),
+          create_namespace: T::Boolean,
           delete_by_filter: T.anything,
           delete_by_filter_allow_partial: T::Boolean,
           delete_condition: T.anything,
@@ -275,7 +298,11 @@ module Turbopuffer
           schema:
             T::Hash[
               Symbol,
-              T.any(String, Turbopuffer::AttributeSchemaConfig::OrHash)
+              T.any(
+                String,
+                Turbopuffer::AttributeSchemaConfig::OrHash,
+                Turbopuffer::AttributeSchemaDrop::OrHash
+              )
             ],
           sharding: Turbopuffer::ShardingConfig::OrHash,
           upsert_columns: Turbopuffer::Columns::OrHash,
@@ -290,6 +317,12 @@ module Turbopuffer
         branch_from_namespace: nil,
         # The namespace to copy documents from.
         copy_from_namespace: nil,
+        # If `true`, ensures the namespace is created, even if the request writes no
+        # documents. Creating an empty namespace requires the `id` type to be declared in
+        # `schema`. If `false`, a namespace is never created, and a 404 is returned if it
+        # does not exist. If omitted, a namespace is created by the first request that
+        # writes documents.
+        create_namespace: nil,
         # The filter specifying which documents to delete.
         delete_by_filter: nil,
         # Allow partial completion when filter matches too many documents.
@@ -351,6 +384,7 @@ module Turbopuffer
                 String,
                 Turbopuffer::CopyFromNamespaceParams::CopyFromNamespaceConfig
               ),
+            create_namespace: T::Boolean,
             delete_by_filter: T.anything,
             delete_by_filter_allow_partial: T::Boolean,
             delete_condition: T.anything,
@@ -371,7 +405,11 @@ module Turbopuffer
             schema:
               T::Hash[
                 Symbol,
-                T.any(String, Turbopuffer::AttributeSchemaConfig)
+                T.any(
+                  String,
+                  Turbopuffer::AttributeSchemaConfig,
+                  Turbopuffer::AttributeSchemaDrop
+                )
               ],
             sharding: Turbopuffer::ShardingConfig,
             upsert_columns: Turbopuffer::Columns,

data/rbi/turbopuffer/models/query_performance.rbi

@@ -34,6 +34,21 @@ module Turbopuffer
       sig { returns(Integer) }
       attr_accessor :server_total_ms
 
+      # Time spent embedding text, in milliseconds. Only set when using a native
+      # embedding model.
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :embedding_ms
+
+      sig { params(embedding_ms: Integer).void }
+      attr_writer :embedding_ms
+
+      # The number of tokens embedded. Only set when using a native embedding model.
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :embedding_tokens
+
+      sig { params(embedding_tokens: Integer).void }
+      attr_writer :embedding_tokens
+
       # The performance information for a query.
       sig do
         params(
@@ -42,7 +57,9 @@ module Turbopuffer
           cache_temperature: String,
           exhaustive_search_count: Integer,
           query_execution_ms: Integer,
-          server_total_ms: Integer
+          server_total_ms: Integer,
+          embedding_ms: Integer,
+          embedding_tokens: Integer
         ).returns(T.attached_class)
       end
       def self.new(
@@ -59,7 +76,12 @@ module Turbopuffer
         query_execution_ms:,
         # Request time measured on the server, including time spent waiting for other
         # queries to complete if the namespace was at its concurrency limit.
-        server_total_ms:
+        server_total_ms:,
+        # Time spent embedding text, in milliseconds. Only set when using a native
+        # embedding model.
+        embedding_ms: nil,
+        # The number of tokens embedded. Only set when using a native embedding model.
+        embedding_tokens: nil
       )
       end
 
@@ -71,7 +93,9 @@ module Turbopuffer
             cache_temperature: String,
             exhaustive_search_count: Integer,
             query_execution_ms: Integer,
-            server_total_ms: Integer
+            server_total_ms: Integer,
+            embedding_ms: Integer,
+            embedding_tokens: Integer
           }
         )
       end

data/rbi/turbopuffer/models/write_performance.rbi

@@ -12,15 +12,49 @@ module Turbopuffer
       sig { returns(Integer) }
       attr_accessor :server_total_ms
 
+      # Time spent embedding text, in milliseconds. Only set when using a native
+      # embedding model.
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :embedding_ms
+
+      sig { params(embedding_ms: Integer).void }
+      attr_writer :embedding_ms
+
+      # The number of tokens embedded. Only set when using a native embedding model.
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :embedding_tokens
+
+      sig { params(embedding_tokens: Integer).void }
+      attr_writer :embedding_tokens
+
       # The performance information for a write request.
-      sig { params(server_total_ms: Integer).returns(T.attached_class) }
+      sig do
+        params(
+          server_total_ms: Integer,
+          embedding_ms: Integer,
+          embedding_tokens: Integer
+        ).returns(T.attached_class)
+      end
       def self.new(
         # Request time measured on the server, in milliseconds.
-        server_total_ms:
+        server_total_ms:,
+        # Time spent embedding text, in milliseconds. Only set when using a native
+        # embedding model.
+        embedding_ms: nil,
+        # The number of tokens embedded. Only set when using a native embedding model.
+        embedding_tokens: nil
       )
       end
 
-      sig { override.returns({ server_total_ms: Integer }) }
+      sig do
+        override.returns(
+          {
+            server_total_ms: Integer,
+            embedding_ms: Integer,
+            embedding_tokens: Integer
+          }
+        )
+      end
       def to_hash
       end
     end

data/rbi/turbopuffer/models.rbi

@@ -15,6 +15,8 @@ module Turbopuffer
 
   AttributeSchemaConfig = Turbopuffer::Models::AttributeSchemaConfig
 
+  AttributeSchemaDrop = Turbopuffer::Models::AttributeSchemaDrop
+
   AttributeType = Turbopuffer::Models::AttributeType
 
   Bm25ClauseParams = Turbopuffer::Models::Bm25ClauseParams

data/rbi/turbopuffer/resources/namespaces.rbi

@@ -382,7 +382,11 @@ module Turbopuffer
           schema:
             T::Hash[
               Symbol,
-              T.any(String, Turbopuffer::AttributeSchemaConfig::OrHash)
+              T.any(
+                String,
+                Turbopuffer::AttributeSchemaConfig::OrHash,
+                Turbopuffer::AttributeSchemaDrop::OrHash
+              )
             ],
           request_options: Turbopuffer::RequestOptions::OrHash
         ).returns(T::Hash[Symbol, Turbopuffer::AttributeSchemaConfig])
@@ -410,6 +414,7 @@ module Turbopuffer
               String,
               Turbopuffer::CopyFromNamespaceParams::CopyFromNamespaceConfig::OrHash
             ),
+          create_namespace: T::Boolean,
           delete_by_filter: T.anything,
           delete_by_filter_allow_partial: T::Boolean,
           delete_condition: T.anything,
@@ -431,7 +436,11 @@ module Turbopuffer
           schema:
             T::Hash[
               Symbol,
-              T.any(String, Turbopuffer::AttributeSchemaConfig::OrHash)
+              T.any(
+                String,
+                Turbopuffer::AttributeSchemaConfig::OrHash,
+                Turbopuffer::AttributeSchemaDrop::OrHash
+              )
             ],
           sharding: Turbopuffer::ShardingConfig::OrHash,
           upsert_columns: Turbopuffer::Columns::OrHash,
@@ -447,6 +456,12 @@ module Turbopuffer
         branch_from_namespace: nil,
         # Body param: The namespace to copy documents from.
         copy_from_namespace: nil,
+        # Body param: If `true`, ensures the namespace is created, even if the request
+        # writes no documents. Creating an empty namespace requires the `id` type to be
+        # declared in `schema`. If `false`, a namespace is never created, and a 404 is
+        # returned if it does not exist. If omitted, a namespace is created by the first
+        # request that writes documents.
+        create_namespace: nil,
         # Body param: The filter specifying which documents to delete.
         delete_by_filter: nil,
         # Body param: Allow partial completion when filter matches too many documents.

data/sig/turbopuffer/models/attribute_schema.rbs

@@ -1,6 +1,9 @@
 module Turbopuffer
   module Models
-    type attribute_schema = String | Turbopuffer::AttributeSchemaConfig
+    type attribute_schema =
+      String
+      | Turbopuffer::AttributeSchemaConfig
+      | Turbopuffer::AttributeSchemaDrop
 
     module AttributeSchema
       extend Turbopuffer::Internal::Type::Union

data/sig/turbopuffer/models/attribute_schema_drop.rbs

@@ -0,0 +1,13 @@
+module Turbopuffer
+  module Models
+    type attribute_schema_drop = { drop: bool }
+
+    class AttributeSchemaDrop < Turbopuffer::Internal::Type::BaseModel
+      attr_accessor drop: bool
+
+      def initialize: (drop: bool) -> void
+
+      def to_hash: -> { drop: bool }
+    end
+  end
+end

data/sig/turbopuffer/models/namespace_metadata.rbs

@@ -88,16 +88,31 @@ module Turbopuffer
           def to_hash: -> { status: :"up-to-date" }
         end
 
-        type index_updating = { status: :updating, unindexed_bytes: Integer }
+        type index_updating =
+          {
+            status: :updating,
+            unindexed_bytes: Integer,
+            unindexed_rows: Integer
+          }
 
         class IndexUpdating < Turbopuffer::Internal::Type::BaseModel
           attr_accessor status: :updating
 
           attr_accessor unindexed_bytes: Integer
 
-          def initialize: (unindexed_bytes: Integer, ?status: :updating) -> void
+          attr_accessor unindexed_rows: Integer
 
-          def to_hash: -> { status: :updating, unindexed_bytes: Integer }
+          def initialize: (
+            unindexed_bytes: Integer,
+            unindexed_rows: Integer,
+            ?status: :updating
+          ) -> void
+
+          def to_hash: -> {
+            status: :updating,
+            unindexed_bytes: Integer,
+            unindexed_rows: Integer
+          }
         end
 
         def self?.variants: -> ::Array[Turbopuffer::Models::NamespaceMetadata::index]

data/sig/turbopuffer/models/namespace_write_params.rbs

@@ -5,6 +5,7 @@ module Turbopuffer
         namespace: String,
         branch_from_namespace: Turbopuffer::Models::branch_from_namespace_params,
         copy_from_namespace: Turbopuffer::Models::copy_from_namespace_params,
+        create_namespace: bool,
         delete_by_filter: top,
         delete_by_filter_allow_partial: bool,
         delete_condition: top,
@@ -46,6 +47,10 @@ module Turbopuffer
         Turbopuffer::Models::copy_from_namespace_params
       ) -> Turbopuffer::Models::copy_from_namespace_params
 
+      attr_reader create_namespace: bool?
+
+      def create_namespace=: (bool) -> bool
+
       attr_reader delete_by_filter: top?
 
       def delete_by_filter=: (top) -> top
@@ -134,6 +139,7 @@ module Turbopuffer
         ?namespace: String,
         ?branch_from_namespace: Turbopuffer::Models::branch_from_namespace_params,
         ?copy_from_namespace: Turbopuffer::Models::copy_from_namespace_params,
+        ?create_namespace: bool,
         ?delete_by_filter: top,
         ?delete_by_filter_allow_partial: bool,
         ?delete_condition: top,
@@ -159,6 +165,7 @@ module Turbopuffer
         namespace: String,
         branch_from_namespace: Turbopuffer::Models::branch_from_namespace_params,
         copy_from_namespace: Turbopuffer::Models::copy_from_namespace_params,
+        create_namespace: bool,
         delete_by_filter: top,
         delete_by_filter_allow_partial: bool,
         delete_condition: top,

data/sig/turbopuffer/models/query_performance.rbs

@@ -7,7 +7,9 @@ module Turbopuffer
         cache_temperature: String,
         exhaustive_search_count: Integer,
         query_execution_ms: Integer,
-        server_total_ms: Integer
+        server_total_ms: Integer,
+        embedding_ms: Integer,
+        embedding_tokens: Integer
       }
 
     class QueryPerformance < Turbopuffer::Internal::Type::BaseModel
@@ -23,13 +25,23 @@ module Turbopuffer
 
       attr_accessor server_total_ms: Integer
 
+      attr_reader embedding_ms: Integer?
+
+      def embedding_ms=: (Integer) -> Integer
+
+      attr_reader embedding_tokens: Integer?
+
+      def embedding_tokens=: (Integer) -> Integer
+
       def initialize: (
         approx_namespace_size: Integer,
         cache_hit_ratio: Float,
         cache_temperature: String,
         exhaustive_search_count: Integer,
         query_execution_ms: Integer,
-        server_total_ms: Integer
+        server_total_ms: Integer,
+        ?embedding_ms: Integer,
+        ?embedding_tokens: Integer
       ) -> void
 
       def to_hash: -> {
@@ -38,7 +50,9 @@ module Turbopuffer
         cache_temperature: String,
         exhaustive_search_count: Integer,
         query_execution_ms: Integer,
-        server_total_ms: Integer
+        server_total_ms: Integer,
+        embedding_ms: Integer,
+        embedding_tokens: Integer
       }
     end
   end

data/sig/turbopuffer/models/write_performance.rbs

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

data/sig/turbopuffer/models.rbs

@@ -9,6 +9,8 @@ module Turbopuffer
 
   class AttributeSchemaConfig = Turbopuffer::Models::AttributeSchemaConfig
 
+  class AttributeSchemaDrop = Turbopuffer::Models::AttributeSchemaDrop
+
   class AttributeType = Turbopuffer::Models::AttributeType
 
   class Bm25ClauseParams = Turbopuffer::Models::Bm25ClauseParams

data/sig/turbopuffer/resources/namespaces.rbs

@@ -125,6 +125,7 @@ module Turbopuffer
         ?namespace: String,
         ?branch_from_namespace: Turbopuffer::Models::branch_from_namespace_params,
         ?copy_from_namespace: Turbopuffer::Models::copy_from_namespace_params,
+        ?create_namespace: bool,
         ?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: 2.5.0
+  version: 2.7.0
 platform: ruby
 authors:
 - Turbopuffer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-18 00:00:00.000000000 Z
+date: 2026-10-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi
@@ -76,6 +76,7 @@ files:
 - lib/turbopuffer/models/attribute_embed_config.rb
 - lib/turbopuffer/models/attribute_schema.rb
 - lib/turbopuffer/models/attribute_schema_config.rb
+- lib/turbopuffer/models/attribute_schema_drop.rb
 - lib/turbopuffer/models/attribute_type.rb
 - lib/turbopuffer/models/bm25_clause_params.rb
 - lib/turbopuffer/models/branch_from_namespace_params.rb
@@ -177,6 +178,7 @@ files:
 - rbi/turbopuffer/models/attribute_embed_config.rbi
 - rbi/turbopuffer/models/attribute_schema.rbi
 - rbi/turbopuffer/models/attribute_schema_config.rbi
+- rbi/turbopuffer/models/attribute_schema_drop.rbi
 - rbi/turbopuffer/models/attribute_type.rbi
 - rbi/turbopuffer/models/bm25_clause_params.rbi
 - rbi/turbopuffer/models/branch_from_namespace_params.rbi
@@ -277,6 +279,7 @@ files:
 - sig/turbopuffer/models/attribute_embed_config.rbs
 - sig/turbopuffer/models/attribute_schema.rbs
 - sig/turbopuffer/models/attribute_schema_config.rbs
+- sig/turbopuffer/models/attribute_schema_drop.rbs
 - sig/turbopuffer/models/attribute_type.rbs
 - sig/turbopuffer/models/bm25_clause_params.rbs
 - sig/turbopuffer/models/branch_from_namespace_params.rbs