chore: add missing docstrings

Author: stainless-app[bot]

src/turbopuffer/types/attribute_schema_config.py

@@ -12,6 +12,8 @@
 
 
 class AnnAnnConfig(BaseModel):
+    """Configuration options for ANN (Approximate Nearest Neighbor) indexing."""
+
     distance_metric: Optional[DistanceMetric] = None
     """A function used to calculate vector similarity."""
 
@@ -20,6 +22,8 @@ class AnnAnnConfig(BaseModel):
 
 
 class AttributeSchemaConfig(BaseModel):
+    """Detailed configuration for an attribute attached to a document."""
+
     type: AttributeType
     """The data type of the attribute.
 

src/turbopuffer/types/attribute_schema_config_param.py

@@ -13,6 +13,8 @@
 
 
 class AnnAnnConfig(TypedDict, total=False):
+    """Configuration options for ANN (Approximate Nearest Neighbor) indexing."""
+
     distance_metric: DistanceMetric
     """A function used to calculate vector similarity."""
 
@@ -21,6 +23,8 @@ class AnnAnnConfig(TypedDict, total=False):
 
 
 class AttributeSchemaConfigParam(TypedDict, total=False):
+    """Detailed configuration for an attribute attached to a document."""
+
     type: Required[AttributeType]
     """The data type of the attribute.
 

src/turbopuffer/types/bm25_clause_params.py

@@ -8,5 +8,7 @@
 
 
 class Bm25ClauseParams(TypedDict, total=False):
+    """Additional (optional) parameters for a single BM25 query clause."""
+
     last_as_prefix: bool
     """Whether to treat the last token in the query input as a literal prefix."""

src/turbopuffer/types/columns_param.py

@@ -13,6 +13,11 @@
 
 
 class ColumnsParamTyped(TypedDict, total=False):
+    """A list of documents in columnar format.
+
+    Each key is a column name, mapped to an array of values for that column.
+    """
+
     id: Required[SequenceNotStr[IDParam]]
     """The IDs of the documents."""
 

src/turbopuffer/types/contains_all_tokens_filter_params.py

@@ -8,5 +8,7 @@
 
 
 class ContainsAllTokensFilterParams(TypedDict, total=False):
+    """Additional (optional) parameters for the ContainsAllTokens filter."""
+
     last_as_prefix: bool
     """Whether to treat the last token in the query input as a literal prefix."""

src/turbopuffer/types/full_text_search_config.py

@@ -10,6 +10,8 @@
 
 
 class FullTextSearchConfig(BaseModel):
+    """Configuration options for full-text search."""
+
     ascii_folding: Optional[bool] = None
     """
     Whether to convert each non-ASCII character in a token to its ASCII equivalent,

src/turbopuffer/types/full_text_search_config_param.py

@@ -11,6 +11,8 @@
 
 
 class FullTextSearchConfigParam(TypedDict, total=False):
+    """Configuration options for full-text search."""
+
     ascii_folding: bool
     """
     Whether to convert each non-ASCII character in a token to its ASCII equivalent,

src/turbopuffer/types/namespace_delete_all_response.py

@@ -8,5 +8,7 @@
 
 
 class NamespaceDeleteAllResponse(BaseModel):
+    """The response to a successful namespace deletion request."""
+
     status: Literal["OK"]
     """The status of the request."""

src/turbopuffer/types/namespace_explain_query_params.py

@@ -60,6 +60,8 @@ class NamespaceExplainQueryParams(TypedDict, total=False):
 
 
 class Consistency(TypedDict, total=False):
+    """The consistency level for a query."""
+
     level: Literal["strong", "eventual"]
     """The query's consistency level.
 

src/turbopuffer/types/namespace_explain_query_response.py

@@ -8,5 +8,7 @@
 
 
 class NamespaceExplainQueryResponse(BaseModel):
+    """The response to a successful query explain."""
+
     plan_text: Optional[str] = None
     """The textual representation of the query plan."""