From 025587b946c3ece7a34a346280dbd688880a7276 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Tue, 3 Mar 2026 14:16:39 +0000
Subject: [PATCH 1/7] chore(internal): codegen related update

---
 src/isaacus/_client.py                        | 24 +++++++++++++++++++
 .../classifications/classifications.py        |  6 +++++
 .../classifications/universal/universal.py    |  4 ++++
 src/isaacus/resources/embeddings.py           |  4 ++++
 .../resources/extractions/extractions.py      |  6 +++++
 src/isaacus/resources/extractions/qa/qa.py    |  4 ++++
 src/isaacus/resources/rerankings.py           |  8 +++++++
 7 files changed, 56 insertions(+)

diff --git a/src/isaacus/_client.py b/src/isaacus/_client.py
index ae83c36..41660d8 100644
--- a/src/isaacus/_client.py
+++ b/src/isaacus/_client.py
@@ -98,6 +98,7 @@ def __init__(
 
     @cached_property
     def embeddings(self) -> EmbeddingsResource:
+        """Embed legal texts with Isaacus legal AI embedders."""
         from .resources.embeddings import EmbeddingsResource
 
         return EmbeddingsResource(self)
@@ -110,6 +111,9 @@ def classifications(self) -> ClassificationsResource:
 
     @cached_property
     def rerankings(self) -> RerankingsResource:
+        """
+        Rerank legal documents by their relevance to queries with Isaacus legal AI rerankers.
+        """
         from .resources.rerankings import RerankingsResource
 
         return RerankingsResource(self)
@@ -296,6 +300,7 @@ def __init__(
 
     @cached_property
     def embeddings(self) -> AsyncEmbeddingsResource:
+        """Embed legal texts with Isaacus legal AI embedders."""
         from .resources.embeddings import AsyncEmbeddingsResource
 
         return AsyncEmbeddingsResource(self)
@@ -308,6 +313,9 @@ def classifications(self) -> AsyncClassificationsResource:
 
     @cached_property
     def rerankings(self) -> AsyncRerankingsResource:
+        """
+        Rerank legal documents by their relevance to queries with Isaacus legal AI rerankers.
+        """
         from .resources.rerankings import AsyncRerankingsResource
 
         return AsyncRerankingsResource(self)
@@ -445,6 +453,7 @@ def __init__(self, client: Isaacus) -> None:
 
     @cached_property
     def embeddings(self) -> embeddings.EmbeddingsResourceWithRawResponse:
+        """Embed legal texts with Isaacus legal AI embedders."""
         from .resources.embeddings import EmbeddingsResourceWithRawResponse
 
         return EmbeddingsResourceWithRawResponse(self._client.embeddings)
@@ -457,6 +466,9 @@ def classifications(self) -> classifications.ClassificationsResourceWithRawRespo
 
     @cached_property
     def rerankings(self) -> rerankings.RerankingsResourceWithRawResponse:
+        """
+        Rerank legal documents by their relevance to queries with Isaacus legal AI rerankers.
+        """
         from .resources.rerankings import RerankingsResourceWithRawResponse
 
         return RerankingsResourceWithRawResponse(self._client.rerankings)
@@ -482,6 +494,7 @@ def __init__(self, client: AsyncIsaacus) -> None:
 
     @cached_property
     def embeddings(self) -> embeddings.AsyncEmbeddingsResourceWithRawResponse:
+        """Embed legal texts with Isaacus legal AI embedders."""
         from .resources.embeddings import AsyncEmbeddingsResourceWithRawResponse
 
         return AsyncEmbeddingsResourceWithRawResponse(self._client.embeddings)
@@ -494,6 +507,9 @@ def classifications(self) -> classifications.AsyncClassificationsResourceWithRaw
 
     @cached_property
     def rerankings(self) -> rerankings.AsyncRerankingsResourceWithRawResponse:
+        """
+        Rerank legal documents by their relevance to queries with Isaacus legal AI rerankers.
+        """
         from .resources.rerankings import AsyncRerankingsResourceWithRawResponse
 
         return AsyncRerankingsResourceWithRawResponse(self._client.rerankings)
@@ -519,6 +535,7 @@ def __init__(self, client: Isaacus) -> None:
 
     @cached_property
     def embeddings(self) -> embeddings.EmbeddingsResourceWithStreamingResponse:
+        """Embed legal texts with Isaacus legal AI embedders."""
         from .resources.embeddings import EmbeddingsResourceWithStreamingResponse
 
         return EmbeddingsResourceWithStreamingResponse(self._client.embeddings)
@@ -531,6 +548,9 @@ def classifications(self) -> classifications.ClassificationsResourceWithStreamin
 
     @cached_property
     def rerankings(self) -> rerankings.RerankingsResourceWithStreamingResponse:
+        """
+        Rerank legal documents by their relevance to queries with Isaacus legal AI rerankers.
+        """
         from .resources.rerankings import RerankingsResourceWithStreamingResponse
 
         return RerankingsResourceWithStreamingResponse(self._client.rerankings)
@@ -556,6 +576,7 @@ def __init__(self, client: AsyncIsaacus) -> None:
 
     @cached_property
     def embeddings(self) -> embeddings.AsyncEmbeddingsResourceWithStreamingResponse:
+        """Embed legal texts with Isaacus legal AI embedders."""
         from .resources.embeddings import AsyncEmbeddingsResourceWithStreamingResponse
 
         return AsyncEmbeddingsResourceWithStreamingResponse(self._client.embeddings)
@@ -568,6 +589,9 @@ def classifications(self) -> classifications.AsyncClassificationsResourceWithStr
 
     @cached_property
     def rerankings(self) -> rerankings.AsyncRerankingsResourceWithStreamingResponse:
+        """
+        Rerank legal documents by their relevance to queries with Isaacus legal AI rerankers.
+        """
         from .resources.rerankings import AsyncRerankingsResourceWithStreamingResponse
 
         return AsyncRerankingsResourceWithStreamingResponse(self._client.rerankings)
diff --git a/src/isaacus/resources/classifications/classifications.py b/src/isaacus/resources/classifications/classifications.py
index 19b4d4b..38fdf11 100644
--- a/src/isaacus/resources/classifications/classifications.py
+++ b/src/isaacus/resources/classifications/classifications.py
@@ -19,6 +19,7 @@
 class ClassificationsResource(SyncAPIResource):
     @cached_property
     def universal(self) -> UniversalResource:
+        """Classify legal documents with Isaacus legal AI classifiers."""
         return UniversalResource(self._client)
 
     @cached_property
@@ -44,6 +45,7 @@ def with_streaming_response(self) -> ClassificationsResourceWithStreamingRespons
 class AsyncClassificationsResource(AsyncAPIResource):
     @cached_property
     def universal(self) -> AsyncUniversalResource:
+        """Classify legal documents with Isaacus legal AI classifiers."""
         return AsyncUniversalResource(self._client)
 
     @cached_property
@@ -72,6 +74,7 @@ def __init__(self, classifications: ClassificationsResource) -> None:
 
     @cached_property
     def universal(self) -> UniversalResourceWithRawResponse:
+        """Classify legal documents with Isaacus legal AI classifiers."""
         return UniversalResourceWithRawResponse(self._classifications.universal)
 
 
@@ -81,6 +84,7 @@ def __init__(self, classifications: AsyncClassificationsResource) -> None:
 
     @cached_property
     def universal(self) -> AsyncUniversalResourceWithRawResponse:
+        """Classify legal documents with Isaacus legal AI classifiers."""
         return AsyncUniversalResourceWithRawResponse(self._classifications.universal)
 
 
@@ -90,6 +94,7 @@ def __init__(self, classifications: ClassificationsResource) -> None:
 
     @cached_property
     def universal(self) -> UniversalResourceWithStreamingResponse:
+        """Classify legal documents with Isaacus legal AI classifiers."""
         return UniversalResourceWithStreamingResponse(self._classifications.universal)
 
 
@@ -99,4 +104,5 @@ def __init__(self, classifications: AsyncClassificationsResource) -> None:
 
     @cached_property
     def universal(self) -> AsyncUniversalResourceWithStreamingResponse:
+        """Classify legal documents with Isaacus legal AI classifiers."""
         return AsyncUniversalResourceWithStreamingResponse(self._classifications.universal)
diff --git a/src/isaacus/resources/classifications/universal/universal.py b/src/isaacus/resources/classifications/universal/universal.py
index 9784b9c..e14aa5f 100644
--- a/src/isaacus/resources/classifications/universal/universal.py
+++ b/src/isaacus/resources/classifications/universal/universal.py
@@ -25,6 +25,8 @@
 
 
 class UniversalResource(SyncAPIResource):
+    """Classify legal documents with Isaacus legal AI classifiers."""
+
     @cached_property
     def with_raw_response(self) -> UniversalResourceWithRawResponse:
         """
@@ -126,6 +128,8 @@ def create(
 
 
 class AsyncUniversalResource(AsyncAPIResource):
+    """Classify legal documents with Isaacus legal AI classifiers."""
+
     @cached_property
     def with_raw_response(self) -> AsyncUniversalResourceWithRawResponse:
         """
diff --git a/src/isaacus/resources/embeddings.py b/src/isaacus/resources/embeddings.py
index e7a5e3a..5fda1b0 100644
--- a/src/isaacus/resources/embeddings.py
+++ b/src/isaacus/resources/embeddings.py
@@ -25,6 +25,8 @@
 
 
 class EmbeddingsResource(SyncAPIResource):
+    """Embed legal texts with Isaacus legal AI embedders."""
+
     @cached_property
     def with_raw_response(self) -> EmbeddingsResourceWithRawResponse:
         """
@@ -118,6 +120,8 @@ def create(
 
 
 class AsyncEmbeddingsResource(AsyncAPIResource):
+    """Embed legal texts with Isaacus legal AI embedders."""
+
     @cached_property
     def with_raw_response(self) -> AsyncEmbeddingsResourceWithRawResponse:
         """
diff --git a/src/isaacus/resources/extractions/extractions.py b/src/isaacus/resources/extractions/extractions.py
index 6733808..13c23d6 100644
--- a/src/isaacus/resources/extractions/extractions.py
+++ b/src/isaacus/resources/extractions/extractions.py
@@ -19,6 +19,7 @@
 class ExtractionsResource(SyncAPIResource):
     @cached_property
     def qa(self) -> QAResource:
+        """Extract information from legal documents with Isaacus legal AI extractors."""
         return QAResource(self._client)
 
     @cached_property
@@ -44,6 +45,7 @@ def with_streaming_response(self) -> ExtractionsResourceWithStreamingResponse:
 class AsyncExtractionsResource(AsyncAPIResource):
     @cached_property
     def qa(self) -> AsyncQAResource:
+        """Extract information from legal documents with Isaacus legal AI extractors."""
         return AsyncQAResource(self._client)
 
     @cached_property
@@ -72,6 +74,7 @@ def __init__(self, extractions: ExtractionsResource) -> None:
 
     @cached_property
     def qa(self) -> QAResourceWithRawResponse:
+        """Extract information from legal documents with Isaacus legal AI extractors."""
         return QAResourceWithRawResponse(self._extractions.qa)
 
 
@@ -81,6 +84,7 @@ def __init__(self, extractions: AsyncExtractionsResource) -> None:
 
     @cached_property
     def qa(self) -> AsyncQAResourceWithRawResponse:
+        """Extract information from legal documents with Isaacus legal AI extractors."""
         return AsyncQAResourceWithRawResponse(self._extractions.qa)
 
 
@@ -90,6 +94,7 @@ def __init__(self, extractions: ExtractionsResource) -> None:
 
     @cached_property
     def qa(self) -> QAResourceWithStreamingResponse:
+        """Extract information from legal documents with Isaacus legal AI extractors."""
         return QAResourceWithStreamingResponse(self._extractions.qa)
 
 
@@ -99,4 +104,5 @@ def __init__(self, extractions: AsyncExtractionsResource) -> None:
 
     @cached_property
     def qa(self) -> AsyncQAResourceWithStreamingResponse:
+        """Extract information from legal documents with Isaacus legal AI extractors."""
         return AsyncQAResourceWithStreamingResponse(self._extractions.qa)
diff --git a/src/isaacus/resources/extractions/qa/qa.py b/src/isaacus/resources/extractions/qa/qa.py
index c356ece..9f040f8 100644
--- a/src/isaacus/resources/extractions/qa/qa.py
+++ b/src/isaacus/resources/extractions/qa/qa.py
@@ -25,6 +25,8 @@
 
 
 class QAResource(SyncAPIResource):
+    """Extract information from legal documents with Isaacus legal AI extractors."""
+
     @cached_property
     def with_raw_response(self) -> QAResourceWithRawResponse:
         """
@@ -125,6 +127,8 @@ def create(
 
 
 class AsyncQAResource(AsyncAPIResource):
+    """Extract information from legal documents with Isaacus legal AI extractors."""
+
     @cached_property
     def with_raw_response(self) -> AsyncQAResourceWithRawResponse:
         """
diff --git a/src/isaacus/resources/rerankings.py b/src/isaacus/resources/rerankings.py
index cde9f98..20fd25d 100644
--- a/src/isaacus/resources/rerankings.py
+++ b/src/isaacus/resources/rerankings.py
@@ -25,6 +25,10 @@
 
 
 class RerankingsResource(SyncAPIResource):
+    """
+    Rerank legal documents by their relevance to queries with Isaacus legal AI rerankers.
+    """
+
     @cached_property
     def with_raw_response(self) -> RerankingsResourceWithRawResponse:
         """
@@ -136,6 +140,10 @@ def create(
 
 
 class AsyncRerankingsResource(AsyncAPIResource):
+    """
+    Rerank legal documents by their relevance to queries with Isaacus legal AI rerankers.
+    """
+
     @cached_property
     def with_raw_response(self) -> AsyncRerankingsResourceWithRawResponse:
         """

From 54b727d4799d95bce4143399039538f3c30c744f Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Sat, 7 Mar 2026 19:10:57 +0000
Subject: [PATCH 2/7] chore(ci): skip uploading artifacts on stainless-internal
 branches

---
 .github/workflows/ci.yml | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index c5a7b79..9cedc85 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -61,14 +61,18 @@ jobs:
         run: rye build
 
       - name: Get GitHub OIDC Token
-        if: github.repository == 'stainless-sdks/isaacus-python'
+        if: |-
+          github.repository == 'stainless-sdks/isaacus-python' &&
+          !startsWith(github.ref, 'refs/heads/stl/')
         id: github-oidc
         uses: actions/github-script@v8
         with:
           script: core.setOutput('github_token', await core.getIDToken());
 
       - name: Upload tarball
-        if: github.repository == 'stainless-sdks/isaacus-python'
+        if: |-
+          github.repository == 'stainless-sdks/isaacus-python' &&
+          !startsWith(github.ref, 'refs/heads/stl/')
         env:
           URL: https://pkg.stainless.com/s
           AUTH: ${{ steps.github-oidc.outputs.github_token }}

From e3f7e03cac7b73838a31bec0e1d0507a67a41f13 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Mon, 9 Mar 2026 05:43:13 +0000
Subject: [PATCH 3/7] feat(api): add kanon-2-reranker

---
 .stats.yml                                   |  4 ++--
 src/isaacus/resources/rerankings.py          | 22 +++++++++++++-------
 src/isaacus/types/reranking_create_params.py | 12 +++++++----
 src/isaacus/types/reranking_response.py      |  4 ++--
 tests/api_resources/test_rerankings.py       | 16 +++++++-------
 5 files changed, 34 insertions(+), 24 deletions(-)

diff --git a/.stats.yml b/.stats.yml
index d3f723c..d5c0227 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 5
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/isaacus%2Fisaacus-baf5ebdd05d1b5192759a356c2701131c47cfb5b7239a49fcb94e68d4210648c.yml
-openapi_spec_hash: 6ea786d56726e18156adf57915fcbe5f
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/isaacus%2Fisaacus-cc6e47db2f93647cdafaa2098b9dbe0fc58291998c8a86e2a2e2adc4184da071.yml
+openapi_spec_hash: 8062d4e1530c9017628f3860742c0639
 config_hash: 9040e7359f066240ad536041fb2c5185
diff --git a/src/isaacus/resources/rerankings.py b/src/isaacus/resources/rerankings.py
index 20fd25d..84c65ab 100644
--- a/src/isaacus/resources/rerankings.py
+++ b/src/isaacus/resources/rerankings.py
@@ -51,7 +51,7 @@ def with_streaming_response(self) -> RerankingsResourceWithStreamingResponse:
     def create(
         self,
         *,
-        model: Literal["kanon-universal-classifier", "kanon-universal-classifier-mini"],
+        model: Literal["kanon-2-reranker", "kanon-universal-classifier", "kanon-universal-classifier-mini"],
         query: str,
         texts: SequenceNotStr[str],
         top_n: Optional[int] | Omit = omit,
@@ -70,8 +70,9 @@ def create(
         reranker.
 
         Args:
-          model: The ID of the [model](https://docs.isaacus.com/models#reranking) to use for
-              reranking.
+          model: The ID of the model to use for reranking, being either a
+              [reranking model](https://docs.isaacus.com/models/introduction#reranking) or
+              [universal classification model](https://docs.isaacus.com/models/introduction#universal-classification).
 
           query: The query to evaluate the relevance of the texts to.
 
@@ -96,7 +97,9 @@ def create(
               before enabling IQL since queries can be crafted to consume an excessively large
               amount of tokens.
 
-          scoring_method: The method to use for producing an overall relevance score for a text.
+          scoring_method: The method to use for producing an overall relevance score for a text that
+              exceeds the model's local context window and has, therefore, been split into
+              multiple chunks.
 
               `auto` is the default scoring method and is recommended for most use cases.
               Currently, it is equivalent to `chunk_max`. In the future, it will automatically
@@ -166,7 +169,7 @@ def with_streaming_response(self) -> AsyncRerankingsResourceWithStreamingRespons
     async def create(
         self,
         *,
-        model: Literal["kanon-universal-classifier", "kanon-universal-classifier-mini"],
+        model: Literal["kanon-2-reranker", "kanon-universal-classifier", "kanon-universal-classifier-mini"],
         query: str,
         texts: SequenceNotStr[str],
         top_n: Optional[int] | Omit = omit,
@@ -185,8 +188,9 @@ async def create(
         reranker.
 
         Args:
-          model: The ID of the [model](https://docs.isaacus.com/models#reranking) to use for
-              reranking.
+          model: The ID of the model to use for reranking, being either a
+              [reranking model](https://docs.isaacus.com/models/introduction#reranking) or
+              [universal classification model](https://docs.isaacus.com/models/introduction#universal-classification).
 
           query: The query to evaluate the relevance of the texts to.
 
@@ -211,7 +215,9 @@ async def create(
               before enabling IQL since queries can be crafted to consume an excessively large
               amount of tokens.
 
-          scoring_method: The method to use for producing an overall relevance score for a text.
+          scoring_method: The method to use for producing an overall relevance score for a text that
+              exceeds the model's local context window and has, therefore, been split into
+              multiple chunks.
 
               `auto` is the default scoring method and is recommended for most use cases.
               Currently, it is equivalent to `chunk_max`. In the future, it will automatically
diff --git a/src/isaacus/types/reranking_create_params.py b/src/isaacus/types/reranking_create_params.py
index ab4a75a..782b78a 100644
--- a/src/isaacus/types/reranking_create_params.py
+++ b/src/isaacus/types/reranking_create_params.py
@@ -11,10 +11,11 @@
 
 
 class RerankingCreateParams(TypedDict, total=False):
-    model: Required[Literal["kanon-universal-classifier", "kanon-universal-classifier-mini"]]
+    model: Required[Literal["kanon-2-reranker", "kanon-universal-classifier", "kanon-universal-classifier-mini"]]
     """
-    The ID of the [model](https://docs.isaacus.com/models#reranking) to use for
-    reranking.
+    The ID of the model to use for reranking, being either a
+    [reranking model](https://docs.isaacus.com/models/introduction#reranking) or
+    [universal classification model](https://docs.isaacus.com/models/introduction#universal-classification).
     """
 
     query: Required[str]
@@ -49,7 +50,10 @@ class RerankingCreateParams(TypedDict, total=False):
     """
 
     scoring_method: Literal["auto", "chunk_max", "chunk_avg", "chunk_min"]
-    """The method to use for producing an overall relevance score for a text.
+    """
+    The method to use for producing an overall relevance score for a text that
+    exceeds the model's local context window and has, therefore, been split into
+    multiple chunks.
 
     `auto` is the default scoring method and is recommended for most use cases.
     Currently, it is equivalent to `chunk_max`. In the future, it will automatically
diff --git a/src/isaacus/types/reranking_response.py b/src/isaacus/types/reranking_response.py
index a0ba8d8..cd61196 100644
--- a/src/isaacus/types/reranking_response.py
+++ b/src/isaacus/types/reranking_response.py
@@ -31,8 +31,8 @@ class Usage(BaseModel):
 class RerankingResponse(BaseModel):
     results: List[Result]
     """
-    The rerankings of the texts, by relevance to the query, in order from highest to
-    lowest relevance score.
+    The texts reranked by relevance to the query, in order from highest to lowest
+    relevance score.
     """
 
     usage: Usage
diff --git a/tests/api_resources/test_rerankings.py b/tests/api_resources/test_rerankings.py
index fb37da6..51cb025 100644
--- a/tests/api_resources/test_rerankings.py
+++ b/tests/api_resources/test_rerankings.py
@@ -21,7 +21,7 @@ class TestRerankings:
     @parametrize
     def test_method_create(self, client: Isaacus) -> None:
         reranking = client.rerankings.create(
-            model="kanon-universal-classifier",
+            model="kanon-2-reranker",
             query="What are the essential elements required to establish a negligence claim?",
             texts=[
                 "To form a contract, there must be an offer, acceptance, consideration, and mutual intent to be bound.",
@@ -37,7 +37,7 @@ def test_method_create(self, client: Isaacus) -> None:
     @parametrize
     def test_method_create_with_all_params(self, client: Isaacus) -> None:
         reranking = client.rerankings.create(
-            model="kanon-universal-classifier",
+            model="kanon-2-reranker",
             query="What are the essential elements required to establish a negligence claim?",
             texts=[
                 "To form a contract, there must be an offer, acceptance, consideration, and mutual intent to be bound.",
@@ -61,7 +61,7 @@ def test_method_create_with_all_params(self, client: Isaacus) -> None:
     @parametrize
     def test_raw_response_create(self, client: Isaacus) -> None:
         response = client.rerankings.with_raw_response.create(
-            model="kanon-universal-classifier",
+            model="kanon-2-reranker",
             query="What are the essential elements required to establish a negligence claim?",
             texts=[
                 "To form a contract, there must be an offer, acceptance, consideration, and mutual intent to be bound.",
@@ -81,7 +81,7 @@ def test_raw_response_create(self, client: Isaacus) -> None:
     @parametrize
     def test_streaming_response_create(self, client: Isaacus) -> None:
         with client.rerankings.with_streaming_response.create(
-            model="kanon-universal-classifier",
+            model="kanon-2-reranker",
             query="What are the essential elements required to establish a negligence claim?",
             texts=[
                 "To form a contract, there must be an offer, acceptance, consideration, and mutual intent to be bound.",
@@ -109,7 +109,7 @@ class TestAsyncRerankings:
     @parametrize
     async def test_method_create(self, async_client: AsyncIsaacus) -> None:
         reranking = await async_client.rerankings.create(
-            model="kanon-universal-classifier",
+            model="kanon-2-reranker",
             query="What are the essential elements required to establish a negligence claim?",
             texts=[
                 "To form a contract, there must be an offer, acceptance, consideration, and mutual intent to be bound.",
@@ -125,7 +125,7 @@ async def test_method_create(self, async_client: AsyncIsaacus) -> None:
     @parametrize
     async def test_method_create_with_all_params(self, async_client: AsyncIsaacus) -> None:
         reranking = await async_client.rerankings.create(
-            model="kanon-universal-classifier",
+            model="kanon-2-reranker",
             query="What are the essential elements required to establish a negligence claim?",
             texts=[
                 "To form a contract, there must be an offer, acceptance, consideration, and mutual intent to be bound.",
@@ -149,7 +149,7 @@ async def test_method_create_with_all_params(self, async_client: AsyncIsaacus) -
     @parametrize
     async def test_raw_response_create(self, async_client: AsyncIsaacus) -> None:
         response = await async_client.rerankings.with_raw_response.create(
-            model="kanon-universal-classifier",
+            model="kanon-2-reranker",
             query="What are the essential elements required to establish a negligence claim?",
             texts=[
                 "To form a contract, there must be an offer, acceptance, consideration, and mutual intent to be bound.",
@@ -169,7 +169,7 @@ async def test_raw_response_create(self, async_client: AsyncIsaacus) -> None:
     @parametrize
     async def test_streaming_response_create(self, async_client: AsyncIsaacus) -> None:
         async with async_client.rerankings.with_streaming_response.create(
-            model="kanon-universal-classifier",
+            model="kanon-2-reranker",
             query="What are the essential elements required to establish a negligence claim?",
             texts=[
                 "To form a contract, there must be an offer, acceptance, consideration, and mutual intent to be bound.",

From 17d2f762f822686b31d360faab3e363bbae8a335 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Mon, 9 Mar 2026 06:31:05 +0000
Subject: [PATCH 4/7] codegen metadata

---
 .stats.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.stats.yml b/.stats.yml
index d5c0227..f663674 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 5
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/isaacus%2Fisaacus-cc6e47db2f93647cdafaa2098b9dbe0fc58291998c8a86e2a2e2adc4184da071.yml
-openapi_spec_hash: 8062d4e1530c9017628f3860742c0639
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/isaacus%2Fisaacus-0768ad934de95835e9f317b06cbe79b8958d9acc9b4b06f3c7743a2b9fcc0f44.yml
+openapi_spec_hash: e00200876d755684db6ee666119bc719
 config_hash: 9040e7359f066240ad536041fb2c5185

From dd1a29da595815016f988cf5e6a03cc6b160daf8 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Mon, 9 Mar 2026 06:46:17 +0000
Subject: [PATCH 5/7] docs(api): reworded descriptions

---
 .stats.yml                                    |  4 +--
 src/isaacus/_client.py                        | 30 +++++++++++--------
 .../classifications/classifications.py        | 12 ++++----
 .../classifications/universal/universal.py    | 10 +++----
 src/isaacus/resources/embeddings.py           |  8 ++---
 src/isaacus/resources/enrichments.py          |  8 +++--
 .../resources/extractions/extractions.py      | 12 ++++----
 src/isaacus/resources/extractions/qa/qa.py    | 12 ++++----
 src/isaacus/resources/rerankings.py           | 10 +++----
 .../universal_classification_response.py      |  2 +-
 10 files changed, 57 insertions(+), 51 deletions(-)

diff --git a/.stats.yml b/.stats.yml
index f663674..d8a7631 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 5
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/isaacus%2Fisaacus-0768ad934de95835e9f317b06cbe79b8958d9acc9b4b06f3c7743a2b9fcc0f44.yml
-openapi_spec_hash: e00200876d755684db6ee666119bc719
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/isaacus%2Fisaacus-a307f2351504c7d4d18a52c3cc7a120f2b1347bb5cfd8f89f8a95591bcc22eac.yml
+openapi_spec_hash: 5057bbce3b8a5c9561253624702d893d
 config_hash: 9040e7359f066240ad536041fb2c5185
diff --git a/src/isaacus/_client.py b/src/isaacus/_client.py
index 41660d8..e7d9b81 100644
--- a/src/isaacus/_client.py
+++ b/src/isaacus/_client.py
@@ -98,7 +98,7 @@ def __init__(
 
     @cached_property
     def embeddings(self) -> EmbeddingsResource:
-        """Embed legal texts with Isaacus legal AI embedders."""
+        """Vectorize content with an Isaacus embedding model."""
         from .resources.embeddings import EmbeddingsResource
 
         return EmbeddingsResource(self)
@@ -112,7 +112,7 @@ def classifications(self) -> ClassificationsResource:
     @cached_property
     def rerankings(self) -> RerankingsResource:
         """
-        Rerank legal documents by their relevance to queries with Isaacus legal AI rerankers.
+        Score and rank documents by their relevance to queries with an Isaacus reranker.
         """
         from .resources.rerankings import RerankingsResource
 
@@ -126,6 +126,7 @@ def extractions(self) -> ExtractionsResource:
 
     @cached_property
     def enrichments(self) -> EnrichmentsResource:
+        """Enrich documents with an Isaacus enrichment model."""
         from .resources.enrichments import EnrichmentsResource
 
         return EnrichmentsResource(self)
@@ -300,7 +301,7 @@ def __init__(
 
     @cached_property
     def embeddings(self) -> AsyncEmbeddingsResource:
-        """Embed legal texts with Isaacus legal AI embedders."""
+        """Vectorize content with an Isaacus embedding model."""
         from .resources.embeddings import AsyncEmbeddingsResource
 
         return AsyncEmbeddingsResource(self)
@@ -314,7 +315,7 @@ def classifications(self) -> AsyncClassificationsResource:
     @cached_property
     def rerankings(self) -> AsyncRerankingsResource:
         """
-        Rerank legal documents by their relevance to queries with Isaacus legal AI rerankers.
+        Score and rank documents by their relevance to queries with an Isaacus reranker.
         """
         from .resources.rerankings import AsyncRerankingsResource
 
@@ -328,6 +329,7 @@ def extractions(self) -> AsyncExtractionsResource:
 
     @cached_property
     def enrichments(self) -> AsyncEnrichmentsResource:
+        """Enrich documents with an Isaacus enrichment model."""
         from .resources.enrichments import AsyncEnrichmentsResource
 
         return AsyncEnrichmentsResource(self)
@@ -453,7 +455,7 @@ def __init__(self, client: Isaacus) -> None:
 
     @cached_property
     def embeddings(self) -> embeddings.EmbeddingsResourceWithRawResponse:
-        """Embed legal texts with Isaacus legal AI embedders."""
+        """Vectorize content with an Isaacus embedding model."""
         from .resources.embeddings import EmbeddingsResourceWithRawResponse
 
         return EmbeddingsResourceWithRawResponse(self._client.embeddings)
@@ -467,7 +469,7 @@ def classifications(self) -> classifications.ClassificationsResourceWithRawRespo
     @cached_property
     def rerankings(self) -> rerankings.RerankingsResourceWithRawResponse:
         """
-        Rerank legal documents by their relevance to queries with Isaacus legal AI rerankers.
+        Score and rank documents by their relevance to queries with an Isaacus reranker.
         """
         from .resources.rerankings import RerankingsResourceWithRawResponse
 
@@ -481,6 +483,7 @@ def extractions(self) -> extractions.ExtractionsResourceWithRawResponse:
 
     @cached_property
     def enrichments(self) -> enrichments.EnrichmentsResourceWithRawResponse:
+        """Enrich documents with an Isaacus enrichment model."""
         from .resources.enrichments import EnrichmentsResourceWithRawResponse
 
         return EnrichmentsResourceWithRawResponse(self._client.enrichments)
@@ -494,7 +497,7 @@ def __init__(self, client: AsyncIsaacus) -> None:
 
     @cached_property
     def embeddings(self) -> embeddings.AsyncEmbeddingsResourceWithRawResponse:
-        """Embed legal texts with Isaacus legal AI embedders."""
+        """Vectorize content with an Isaacus embedding model."""
         from .resources.embeddings import AsyncEmbeddingsResourceWithRawResponse
 
         return AsyncEmbeddingsResourceWithRawResponse(self._client.embeddings)
@@ -508,7 +511,7 @@ def classifications(self) -> classifications.AsyncClassificationsResourceWithRaw
     @cached_property
     def rerankings(self) -> rerankings.AsyncRerankingsResourceWithRawResponse:
         """
-        Rerank legal documents by their relevance to queries with Isaacus legal AI rerankers.
+        Score and rank documents by their relevance to queries with an Isaacus reranker.
         """
         from .resources.rerankings import AsyncRerankingsResourceWithRawResponse
 
@@ -522,6 +525,7 @@ def extractions(self) -> extractions.AsyncExtractionsResourceWithRawResponse:
 
     @cached_property
     def enrichments(self) -> enrichments.AsyncEnrichmentsResourceWithRawResponse:
+        """Enrich documents with an Isaacus enrichment model."""
         from .resources.enrichments import AsyncEnrichmentsResourceWithRawResponse
 
         return AsyncEnrichmentsResourceWithRawResponse(self._client.enrichments)
@@ -535,7 +539,7 @@ def __init__(self, client: Isaacus) -> None:
 
     @cached_property
     def embeddings(self) -> embeddings.EmbeddingsResourceWithStreamingResponse:
-        """Embed legal texts with Isaacus legal AI embedders."""
+        """Vectorize content with an Isaacus embedding model."""
         from .resources.embeddings import EmbeddingsResourceWithStreamingResponse
 
         return EmbeddingsResourceWithStreamingResponse(self._client.embeddings)
@@ -549,7 +553,7 @@ def classifications(self) -> classifications.ClassificationsResourceWithStreamin
     @cached_property
     def rerankings(self) -> rerankings.RerankingsResourceWithStreamingResponse:
         """
-        Rerank legal documents by their relevance to queries with Isaacus legal AI rerankers.
+        Score and rank documents by their relevance to queries with an Isaacus reranker.
         """
         from .resources.rerankings import RerankingsResourceWithStreamingResponse
 
@@ -563,6 +567,7 @@ def extractions(self) -> extractions.ExtractionsResourceWithStreamingResponse:
 
     @cached_property
     def enrichments(self) -> enrichments.EnrichmentsResourceWithStreamingResponse:
+        """Enrich documents with an Isaacus enrichment model."""
         from .resources.enrichments import EnrichmentsResourceWithStreamingResponse
 
         return EnrichmentsResourceWithStreamingResponse(self._client.enrichments)
@@ -576,7 +581,7 @@ def __init__(self, client: AsyncIsaacus) -> None:
 
     @cached_property
     def embeddings(self) -> embeddings.AsyncEmbeddingsResourceWithStreamingResponse:
-        """Embed legal texts with Isaacus legal AI embedders."""
+        """Vectorize content with an Isaacus embedding model."""
         from .resources.embeddings import AsyncEmbeddingsResourceWithStreamingResponse
 
         return AsyncEmbeddingsResourceWithStreamingResponse(self._client.embeddings)
@@ -590,7 +595,7 @@ def classifications(self) -> classifications.AsyncClassificationsResourceWithStr
     @cached_property
     def rerankings(self) -> rerankings.AsyncRerankingsResourceWithStreamingResponse:
         """
-        Rerank legal documents by their relevance to queries with Isaacus legal AI rerankers.
+        Score and rank documents by their relevance to queries with an Isaacus reranker.
         """
         from .resources.rerankings import AsyncRerankingsResourceWithStreamingResponse
 
@@ -604,6 +609,7 @@ def extractions(self) -> extractions.AsyncExtractionsResourceWithStreamingRespon
 
     @cached_property
     def enrichments(self) -> enrichments.AsyncEnrichmentsResourceWithStreamingResponse:
+        """Enrich documents with an Isaacus enrichment model."""
         from .resources.enrichments import AsyncEnrichmentsResourceWithStreamingResponse
 
         return AsyncEnrichmentsResourceWithStreamingResponse(self._client.enrichments)
diff --git a/src/isaacus/resources/classifications/classifications.py b/src/isaacus/resources/classifications/classifications.py
index 38fdf11..7b56aa8 100644
--- a/src/isaacus/resources/classifications/classifications.py
+++ b/src/isaacus/resources/classifications/classifications.py
@@ -19,7 +19,7 @@
 class ClassificationsResource(SyncAPIResource):
     @cached_property
     def universal(self) -> UniversalResource:
-        """Classify legal documents with Isaacus legal AI classifiers."""
+        """Classify documents with an Isaacus classification model."""
         return UniversalResource(self._client)
 
     @cached_property
@@ -45,7 +45,7 @@ def with_streaming_response(self) -> ClassificationsResourceWithStreamingRespons
 class AsyncClassificationsResource(AsyncAPIResource):
     @cached_property
     def universal(self) -> AsyncUniversalResource:
-        """Classify legal documents with Isaacus legal AI classifiers."""
+        """Classify documents with an Isaacus classification model."""
         return AsyncUniversalResource(self._client)
 
     @cached_property
@@ -74,7 +74,7 @@ def __init__(self, classifications: ClassificationsResource) -> None:
 
     @cached_property
     def universal(self) -> UniversalResourceWithRawResponse:
-        """Classify legal documents with Isaacus legal AI classifiers."""
+        """Classify documents with an Isaacus classification model."""
         return UniversalResourceWithRawResponse(self._classifications.universal)
 
 
@@ -84,7 +84,7 @@ def __init__(self, classifications: AsyncClassificationsResource) -> None:
 
     @cached_property
     def universal(self) -> AsyncUniversalResourceWithRawResponse:
-        """Classify legal documents with Isaacus legal AI classifiers."""
+        """Classify documents with an Isaacus classification model."""
         return AsyncUniversalResourceWithRawResponse(self._classifications.universal)
 
 
@@ -94,7 +94,7 @@ def __init__(self, classifications: ClassificationsResource) -> None:
 
     @cached_property
     def universal(self) -> UniversalResourceWithStreamingResponse:
-        """Classify legal documents with Isaacus legal AI classifiers."""
+        """Classify documents with an Isaacus classification model."""
         return UniversalResourceWithStreamingResponse(self._classifications.universal)
 
 
@@ -104,5 +104,5 @@ def __init__(self, classifications: AsyncClassificationsResource) -> None:
 
     @cached_property
     def universal(self) -> AsyncUniversalResourceWithStreamingResponse:
-        """Classify legal documents with Isaacus legal AI classifiers."""
+        """Classify documents with an Isaacus classification model."""
         return AsyncUniversalResourceWithStreamingResponse(self._classifications.universal)
diff --git a/src/isaacus/resources/classifications/universal/universal.py b/src/isaacus/resources/classifications/universal/universal.py
index e14aa5f..e139645 100644
--- a/src/isaacus/resources/classifications/universal/universal.py
+++ b/src/isaacus/resources/classifications/universal/universal.py
@@ -25,7 +25,7 @@
 
 
 class UniversalResource(SyncAPIResource):
-    """Classify legal documents with Isaacus legal AI classifiers."""
+    """Classify documents with an Isaacus classification model."""
 
     @cached_property
     def with_raw_response(self) -> UniversalResourceWithRawResponse:
@@ -63,8 +63,7 @@ def create(
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> UniversalClassificationResponse:
         """
-        Classify the relevance of legal documents to a query with an Isaacus universal
-        legal AI classifier.
+        Classify documents with an Isaacus universal classification model.
 
         Args:
           model: The ID of the [model](https://docs.isaacus.com/models#universal-classification)
@@ -128,7 +127,7 @@ def create(
 
 
 class AsyncUniversalResource(AsyncAPIResource):
-    """Classify legal documents with Isaacus legal AI classifiers."""
+    """Classify documents with an Isaacus classification model."""
 
     @cached_property
     def with_raw_response(self) -> AsyncUniversalResourceWithRawResponse:
@@ -166,8 +165,7 @@ async def create(
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> UniversalClassificationResponse:
         """
-        Classify the relevance of legal documents to a query with an Isaacus universal
-        legal AI classifier.
+        Classify documents with an Isaacus universal classification model.
 
         Args:
           model: The ID of the [model](https://docs.isaacus.com/models#universal-classification)
diff --git a/src/isaacus/resources/embeddings.py b/src/isaacus/resources/embeddings.py
index 5fda1b0..6550140 100644
--- a/src/isaacus/resources/embeddings.py
+++ b/src/isaacus/resources/embeddings.py
@@ -25,7 +25,7 @@
 
 
 class EmbeddingsResource(SyncAPIResource):
-    """Embed legal texts with Isaacus legal AI embedders."""
+    """Vectorize content with an Isaacus embedding model."""
 
     @cached_property
     def with_raw_response(self) -> EmbeddingsResourceWithRawResponse:
@@ -62,7 +62,7 @@ def create(
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> EmbeddingResponse:
         """
-        Embed legal texts with an Isaacus legal AI embedder.
+        Vectorize content with an Isaacus embedding model.
 
         Args:
           model: The ID of the [model](https://docs.isaacus.com/models#embedding) to use for
@@ -120,7 +120,7 @@ def create(
 
 
 class AsyncEmbeddingsResource(AsyncAPIResource):
-    """Embed legal texts with Isaacus legal AI embedders."""
+    """Vectorize content with an Isaacus embedding model."""
 
     @cached_property
     def with_raw_response(self) -> AsyncEmbeddingsResourceWithRawResponse:
@@ -157,7 +157,7 @@ async def create(
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> EmbeddingResponse:
         """
-        Embed legal texts with an Isaacus legal AI embedder.
+        Vectorize content with an Isaacus embedding model.
 
         Args:
           model: The ID of the [model](https://docs.isaacus.com/models#embedding) to use for
diff --git a/src/isaacus/resources/enrichments.py b/src/isaacus/resources/enrichments.py
index dba9061..d416910 100644
--- a/src/isaacus/resources/enrichments.py
+++ b/src/isaacus/resources/enrichments.py
@@ -25,6 +25,8 @@
 
 
 class EnrichmentsResource(SyncAPIResource):
+    """Enrich documents with an Isaacus enrichment model."""
+
     @cached_property
     def with_raw_response(self) -> EnrichmentsResourceWithRawResponse:
         """
@@ -58,7 +60,7 @@ def create(
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> EnrichmentResponse:
         """
-        Enrich documents with an Isaacus enricher model.
+        Enrich documents with an Isaacus enrichment model.
 
         Args:
           model: The ID of the [model](https://docs.isaacus.com/models#enrichment) to use for
@@ -113,6 +115,8 @@ def create(
 
 
 class AsyncEnrichmentsResource(AsyncAPIResource):
+    """Enrich documents with an Isaacus enrichment model."""
+
     @cached_property
     def with_raw_response(self) -> AsyncEnrichmentsResourceWithRawResponse:
         """
@@ -146,7 +150,7 @@ async def create(
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> EnrichmentResponse:
         """
-        Enrich documents with an Isaacus enricher model.
+        Enrich documents with an Isaacus enrichment model.
 
         Args:
           model: The ID of the [model](https://docs.isaacus.com/models#enrichment) to use for
diff --git a/src/isaacus/resources/extractions/extractions.py b/src/isaacus/resources/extractions/extractions.py
index 13c23d6..e17fe7b 100644
--- a/src/isaacus/resources/extractions/extractions.py
+++ b/src/isaacus/resources/extractions/extractions.py
@@ -19,7 +19,7 @@
 class ExtractionsResource(SyncAPIResource):
     @cached_property
     def qa(self) -> QAResource:
-        """Extract information from legal documents with Isaacus legal AI extractors."""
+        """Extract information from documents with an Isaacus extraction model."""
         return QAResource(self._client)
 
     @cached_property
@@ -45,7 +45,7 @@ def with_streaming_response(self) -> ExtractionsResourceWithStreamingResponse:
 class AsyncExtractionsResource(AsyncAPIResource):
     @cached_property
     def qa(self) -> AsyncQAResource:
-        """Extract information from legal documents with Isaacus legal AI extractors."""
+        """Extract information from documents with an Isaacus extraction model."""
         return AsyncQAResource(self._client)
 
     @cached_property
@@ -74,7 +74,7 @@ def __init__(self, extractions: ExtractionsResource) -> None:
 
     @cached_property
     def qa(self) -> QAResourceWithRawResponse:
-        """Extract information from legal documents with Isaacus legal AI extractors."""
+        """Extract information from documents with an Isaacus extraction model."""
         return QAResourceWithRawResponse(self._extractions.qa)
 
 
@@ -84,7 +84,7 @@ def __init__(self, extractions: AsyncExtractionsResource) -> None:
 
     @cached_property
     def qa(self) -> AsyncQAResourceWithRawResponse:
-        """Extract information from legal documents with Isaacus legal AI extractors."""
+        """Extract information from documents with an Isaacus extraction model."""
         return AsyncQAResourceWithRawResponse(self._extractions.qa)
 
 
@@ -94,7 +94,7 @@ def __init__(self, extractions: ExtractionsResource) -> None:
 
     @cached_property
     def qa(self) -> QAResourceWithStreamingResponse:
-        """Extract information from legal documents with Isaacus legal AI extractors."""
+        """Extract information from documents with an Isaacus extraction model."""
         return QAResourceWithStreamingResponse(self._extractions.qa)
 
 
@@ -104,5 +104,5 @@ def __init__(self, extractions: AsyncExtractionsResource) -> None:
 
     @cached_property
     def qa(self) -> AsyncQAResourceWithStreamingResponse:
-        """Extract information from legal documents with Isaacus legal AI extractors."""
+        """Extract information from documents with an Isaacus extraction model."""
         return AsyncQAResourceWithStreamingResponse(self._extractions.qa)
diff --git a/src/isaacus/resources/extractions/qa/qa.py b/src/isaacus/resources/extractions/qa/qa.py
index 9f040f8..39aebb9 100644
--- a/src/isaacus/resources/extractions/qa/qa.py
+++ b/src/isaacus/resources/extractions/qa/qa.py
@@ -25,7 +25,7 @@
 
 
 class QAResource(SyncAPIResource):
-    """Extract information from legal documents with Isaacus legal AI extractors."""
+    """Extract information from documents with an Isaacus extraction model."""
 
     @cached_property
     def with_raw_response(self) -> QAResourceWithRawResponse:
@@ -63,8 +63,8 @@ def create(
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> AnswerExtractionResponse:
         """
-        Extract answers to questions from legal documents with an Isaacus legal AI
-        answer extractor.
+        Extract information from documents with an Isaacus extractive question answering
+        model.
 
         Args:
           model: The ID of the
@@ -127,7 +127,7 @@ def create(
 
 
 class AsyncQAResource(AsyncAPIResource):
-    """Extract information from legal documents with Isaacus legal AI extractors."""
+    """Extract information from documents with an Isaacus extraction model."""
 
     @cached_property
     def with_raw_response(self) -> AsyncQAResourceWithRawResponse:
@@ -165,8 +165,8 @@ async def create(
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> AnswerExtractionResponse:
         """
-        Extract answers to questions from legal documents with an Isaacus legal AI
-        answer extractor.
+        Extract information from documents with an Isaacus extractive question answering
+        model.
 
         Args:
           model: The ID of the
diff --git a/src/isaacus/resources/rerankings.py b/src/isaacus/resources/rerankings.py
index 84c65ab..e80f2e3 100644
--- a/src/isaacus/resources/rerankings.py
+++ b/src/isaacus/resources/rerankings.py
@@ -26,7 +26,7 @@
 
 class RerankingsResource(SyncAPIResource):
     """
-    Rerank legal documents by their relevance to queries with Isaacus legal AI rerankers.
+    Score and rank documents by their relevance to queries with an Isaacus reranker.
     """
 
     @cached_property
@@ -66,8 +66,7 @@ def create(
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> RerankingResponse:
         """
-        Rank legal documents by their relevance to a query with an Isaacus legal AI
-        reranker.
+        Score and rank documents by their relevance to queries with an Isaacus reranker.
 
         Args:
           model: The ID of the model to use for reranking, being either a
@@ -144,7 +143,7 @@ def create(
 
 class AsyncRerankingsResource(AsyncAPIResource):
     """
-    Rerank legal documents by their relevance to queries with Isaacus legal AI rerankers.
+    Score and rank documents by their relevance to queries with an Isaacus reranker.
     """
 
     @cached_property
@@ -184,8 +183,7 @@ async def create(
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> RerankingResponse:
         """
-        Rank legal documents by their relevance to a query with an Isaacus legal AI
-        reranker.
+        Score and rank documents by their relevance to queries with an Isaacus reranker.
 
         Args:
           model: The ID of the model to use for reranking, being either a
diff --git a/src/isaacus/types/classifications/universal/universal_classification_response.py b/src/isaacus/types/classifications/universal/universal_classification_response.py
index b546438..f2d827a 100644
--- a/src/isaacus/types/classifications/universal/universal_classification_response.py
+++ b/src/isaacus/types/classifications/universal/universal_classification_response.py
@@ -78,7 +78,7 @@ class UniversalClassificationResponse(BaseModel):
     classifications: List[Classification]
     """
     The classifications of the texts, by relevance to the query, in order from
-    highest to lowest relevance score.
+    highest to lowest confidence score.
     """
 
     usage: Usage

From 0031fe3c4a60500981031dd78fa4fd010fac7eec Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Wed, 11 Mar 2026 02:40:36 +0000
Subject: [PATCH 6/7] feat(api): drop mini models

---
 .stats.yml                                                    | 4 ++--
 src/isaacus/resources/classifications/universal/universal.py  | 4 ++--
 src/isaacus/resources/extractions/qa/qa.py                    | 4 ++--
 src/isaacus/resources/rerankings.py                           | 4 ++--
 .../classifications/universal/universal_create_params.py      | 2 +-
 src/isaacus/types/extractions/qa/qa_create_params.py          | 2 +-
 src/isaacus/types/reranking_create_params.py                  | 2 +-
 7 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/.stats.yml b/.stats.yml
index d8a7631..f028d53 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 5
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/isaacus%2Fisaacus-a307f2351504c7d4d18a52c3cc7a120f2b1347bb5cfd8f89f8a95591bcc22eac.yml
-openapi_spec_hash: 5057bbce3b8a5c9561253624702d893d
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/isaacus%2Fisaacus-3fc0da1b03c07a47ee0a04ff61443710b99e6d24e8ba5986aab0b1c023c6f0d5.yml
+openapi_spec_hash: 5992dd036e090cc43fa15ea5ff985f77
 config_hash: 9040e7359f066240ad536041fb2c5185
diff --git a/src/isaacus/resources/classifications/universal/universal.py b/src/isaacus/resources/classifications/universal/universal.py
index e139645..39ca183 100644
--- a/src/isaacus/resources/classifications/universal/universal.py
+++ b/src/isaacus/resources/classifications/universal/universal.py
@@ -49,7 +49,7 @@ def with_streaming_response(self) -> UniversalResourceWithStreamingResponse:
     def create(
         self,
         *,
-        model: Literal["kanon-universal-classifier", "kanon-universal-classifier-mini"],
+        model: Literal["kanon-universal-classifier"],
         query: str,
         texts: SequenceNotStr[str],
         is_iql: bool | Omit = omit,
@@ -151,7 +151,7 @@ def with_streaming_response(self) -> AsyncUniversalResourceWithStreamingResponse
     async def create(
         self,
         *,
-        model: Literal["kanon-universal-classifier", "kanon-universal-classifier-mini"],
+        model: Literal["kanon-universal-classifier"],
         query: str,
         texts: SequenceNotStr[str],
         is_iql: bool | Omit = omit,
diff --git a/src/isaacus/resources/extractions/qa/qa.py b/src/isaacus/resources/extractions/qa/qa.py
index 39aebb9..b4a0559 100644
--- a/src/isaacus/resources/extractions/qa/qa.py
+++ b/src/isaacus/resources/extractions/qa/qa.py
@@ -49,7 +49,7 @@ def with_streaming_response(self) -> QAResourceWithStreamingResponse:
     def create(
         self,
         *,
-        model: Literal["kanon-answer-extractor", "kanon-answer-extractor-mini"],
+        model: Literal["kanon-answer-extractor"],
         query: str,
         texts: SequenceNotStr[str],
         ignore_inextractability: bool | Omit = omit,
@@ -151,7 +151,7 @@ def with_streaming_response(self) -> AsyncQAResourceWithStreamingResponse:
     async def create(
         self,
         *,
-        model: Literal["kanon-answer-extractor", "kanon-answer-extractor-mini"],
+        model: Literal["kanon-answer-extractor"],
         query: str,
         texts: SequenceNotStr[str],
         ignore_inextractability: bool | Omit = omit,
diff --git a/src/isaacus/resources/rerankings.py b/src/isaacus/resources/rerankings.py
index e80f2e3..b0fda3b 100644
--- a/src/isaacus/resources/rerankings.py
+++ b/src/isaacus/resources/rerankings.py
@@ -51,7 +51,7 @@ def with_streaming_response(self) -> RerankingsResourceWithStreamingResponse:
     def create(
         self,
         *,
-        model: Literal["kanon-2-reranker", "kanon-universal-classifier", "kanon-universal-classifier-mini"],
+        model: Literal["kanon-2-reranker", "kanon-universal-classifier"],
         query: str,
         texts: SequenceNotStr[str],
         top_n: Optional[int] | Omit = omit,
@@ -168,7 +168,7 @@ def with_streaming_response(self) -> AsyncRerankingsResourceWithStreamingRespons
     async def create(
         self,
         *,
-        model: Literal["kanon-2-reranker", "kanon-universal-classifier", "kanon-universal-classifier-mini"],
+        model: Literal["kanon-2-reranker", "kanon-universal-classifier"],
         query: str,
         texts: SequenceNotStr[str],
         top_n: Optional[int] | Omit = omit,
diff --git a/src/isaacus/types/classifications/universal/universal_create_params.py b/src/isaacus/types/classifications/universal/universal_create_params.py
index d5833ab..3228177 100644
--- a/src/isaacus/types/classifications/universal/universal_create_params.py
+++ b/src/isaacus/types/classifications/universal/universal_create_params.py
@@ -11,7 +11,7 @@
 
 
 class UniversalCreateParams(TypedDict, total=False):
-    model: Required[Literal["kanon-universal-classifier", "kanon-universal-classifier-mini"]]
+    model: Required[Literal["kanon-universal-classifier"]]
     """
     The ID of the [model](https://docs.isaacus.com/models#universal-classification)
     to use for universal classification.
diff --git a/src/isaacus/types/extractions/qa/qa_create_params.py b/src/isaacus/types/extractions/qa/qa_create_params.py
index fbd1715..c073f27 100644
--- a/src/isaacus/types/extractions/qa/qa_create_params.py
+++ b/src/isaacus/types/extractions/qa/qa_create_params.py
@@ -11,7 +11,7 @@
 
 
 class QACreateParams(TypedDict, total=False):
-    model: Required[Literal["kanon-answer-extractor", "kanon-answer-extractor-mini"]]
+    model: Required[Literal["kanon-answer-extractor"]]
     """
     The ID of the
     [model](https://docs.isaacus.com/models#extractive-question-answering) to use
diff --git a/src/isaacus/types/reranking_create_params.py b/src/isaacus/types/reranking_create_params.py
index 782b78a..95c1bc2 100644
--- a/src/isaacus/types/reranking_create_params.py
+++ b/src/isaacus/types/reranking_create_params.py
@@ -11,7 +11,7 @@
 
 
 class RerankingCreateParams(TypedDict, total=False):
-    model: Required[Literal["kanon-2-reranker", "kanon-universal-classifier", "kanon-universal-classifier-mini"]]
+    model: Required[Literal["kanon-2-reranker", "kanon-universal-classifier"]]
     """
     The ID of the model to use for reranking, being either a
     [reranking model](https://docs.isaacus.com/models/introduction#reranking) or

From 48a0f30a13b2da02ea027b931d678d8153a9a1fa Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Wed, 11 Mar 2026 02:40:54 +0000
Subject: [PATCH 7/7] release: 0.20.0

---
 .release-please-manifest.json |  2 +-
 CHANGELOG.md                  | 20 ++++++++++++++++++++
 pyproject.toml                |  2 +-
 src/isaacus/_version.py       |  2 +-
 4 files changed, 23 insertions(+), 3 deletions(-)

diff --git a/.release-please-manifest.json b/.release-please-manifest.json
index 1b4d3bf..0c2ecec 100644
--- a/.release-please-manifest.json
+++ b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "0.19.3"
+  ".": "0.20.0"
 }
\ No newline at end of file
diff --git a/CHANGELOG.md b/CHANGELOG.md
index f7365b1..0b47b22 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,25 @@
 # Changelog
 
+## 0.20.0 (2026-03-11)
+
+Full Changelog: [v0.19.3...v0.20.0](https://github.com/isaacus-dev/isaacus-python/compare/v0.19.3...v0.20.0)
+
+### Features
+
+* **api:** add kanon-2-reranker ([e3f7e03](https://github.com/isaacus-dev/isaacus-python/commit/e3f7e03cac7b73838a31bec0e1d0507a67a41f13))
+* **api:** drop mini models ([0031fe3](https://github.com/isaacus-dev/isaacus-python/commit/0031fe3c4a60500981031dd78fa4fd010fac7eec))
+
+
+### Chores
+
+* **ci:** skip uploading artifacts on stainless-internal branches ([54b727d](https://github.com/isaacus-dev/isaacus-python/commit/54b727d4799d95bce4143399039538f3c30c744f))
+* **internal:** codegen related update ([025587b](https://github.com/isaacus-dev/isaacus-python/commit/025587b946c3ece7a34a346280dbd688880a7276))
+
+
+### Documentation
+
+* **api:** reworded descriptions ([dd1a29d](https://github.com/isaacus-dev/isaacus-python/commit/dd1a29da595815016f988cf5e6a03cc6b160daf8))
+
 ## 0.19.3 (2026-03-03)
 
 Full Changelog: [v0.19.2...v0.19.3](https://github.com/isaacus-dev/isaacus-python/compare/v0.19.2...v0.19.3)
diff --git a/pyproject.toml b/pyproject.toml
index 5e636a5..5bfa1a0 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "isaacus"
-version = "0.19.3"
+version = "0.20.0"
 description = "The official Python library for the isaacus API"
 dynamic = ["readme"]
 license = "Apache-2.0"
diff --git a/src/isaacus/_version.py b/src/isaacus/_version.py
index c406bb8..7547219 100644
--- a/src/isaacus/_version.py
+++ b/src/isaacus/_version.py
@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "isaacus"
-__version__ = "0.19.3"  # x-release-please-version
+__version__ = "0.20.0"  # x-release-please-version