chore: add missing docstrings

Author: stainless-app[bot]

src/isaacus/types/classifications/universal_classification_response.py

@@ -68,11 +68,17 @@ class Classification(BaseModel):
 
 
 class Usage(BaseModel):
+    """Statistics about the usage of resources in the process of classifying the text."""
+
     input_tokens: int
     """The number of tokens inputted to the model."""
 
 
 class UniversalClassificationResponse(BaseModel):
+    """
+    Classifications of the relevance of legal documents to a query produced by an Isaacus universal legal AI classifier.
+    """
+
     classifications: List[Classification]
     """
     The classifications of the texts, by relevance to the query, in order from

src/isaacus/types/classifications/universal_create_params.py

@@ -59,6 +59,8 @@ class UniversalCreateParams(TypedDict, total=False):
 
 
 class ChunkingOptions(TypedDict, total=False):
+    """Options for how to split text into smaller chunks."""
+
     overlap_ratio: Optional[float]
     """A number greater than or equal to 0 and less than 1."""
 

src/isaacus/types/embedding_response.py

@@ -19,11 +19,15 @@ class Embedding(BaseModel):
 
 
 class Usage(BaseModel):
+    """Statistics about the usage of resources in the process of embedding the inputs."""
+
     input_tokens: int
     """The number of tokens inputted to the model."""
 
 
 class EmbeddingResponse(BaseModel):
+    """Embeddings of legal texts produced by an Isaacus legal AI embedder."""
+
     embeddings: List[Embedding]
     """The embeddings of the inputs."""
 

src/isaacus/types/extractions/answer_extraction_response.py

@@ -8,6 +8,8 @@
 
 
 class ExtractionAnswer(BaseModel):
+    """An answer extracted from a text."""
+
     end: int
     """
     The index of the character immediately after the last character of the answer in
@@ -31,6 +33,8 @@ class ExtractionAnswer(BaseModel):
 
 
 class Extraction(BaseModel):
+    """The result of extracting answers from a text."""
+
     answers: List[ExtractionAnswer]
     """Answers extracted from the text, ordered from highest to lowest score."""
 
@@ -53,11 +57,17 @@ class Extraction(BaseModel):
 
 
 class Usage(BaseModel):
+    """
+    Statistics about the usage of resources in the process of extracting answers from the texts.
+    """
+
     input_tokens: int
     """The number of tokens inputted to the model."""
 
 
 class AnswerExtractionResponse(BaseModel):
+    """The results of extracting answers from texts."""
+
     extractions: List[Extraction]
     """
     The results of extracting answers from the texts, ordered from highest to lowest

src/isaacus/types/extractions/qa_create_params.py

@@ -57,6 +57,8 @@ class QaCreateParams(TypedDict, total=False):
 
 
 class ChunkingOptions(TypedDict, total=False):
+    """Options for how to split text into smaller chunks."""
+
     overlap_ratio: Optional[float]
     """A number greater than or equal to 0 and less than 1."""
 

src/isaacus/types/reranking_create_params.py

@@ -67,6 +67,8 @@ class RerankingCreateParams(TypedDict, total=False):
 
 
 class ChunkingOptions(TypedDict, total=False):
+    """Options for how to split text into smaller chunks."""
+
     overlap_ratio: Optional[float]
     """A number greater than or equal to 0 and less than 1."""
 

src/isaacus/types/reranking_response.py

@@ -22,11 +22,17 @@ class Result(BaseModel):
 
 
 class Usage(BaseModel):
+    """Statistics about the usage of resources in the process of reranking the texts."""
+
     input_tokens: int
     """The number of tokens inputted to the model."""
 
 
 class RerankingResponse(BaseModel):
+    """
+    The reranking of texts, by relevance to a query, out of an input array of texts.
+    """
+
     results: List[Result]
     """
     The rerankings of the texts, by relevance to the query, in order from highest to