feat(sdk): untoggle to force regen

stainless-app[bot] · stainless-app[bot] · commit 25d2067fad4b · 2025-10-12T08:15:22.000Z
diff --git a/.stats.yml b/.stats.yml
@@ -1,4 +1,4 @@
-configured_endpoints: 3
+configured_endpoints: 4
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/isaacus%2Fisaacus-30c23c1facb9383eb94d78d16d6a45b7e6afd943caf94cddeb75fd86357294f7.yml
 openapi_spec_hash: 48a6b3192add4f538615ac6f190123c5
-config_hash: 83740a990f84ee8d189fc4071a009a83
+config_hash: 886b5eef0dbd90b8e6686e987a07b816
diff --git a/api.md b/api.md
@@ -1,3 +1,15 @@
+# Embeddings
+
+Types:
+
+```python
+from isaacus.types import Embedding
+```
+
+Methods:
+
+- <code title="post /embeddings">client.embeddings.<a href="./src/isaacus/resources/embeddings.py">create</a>(\*\*<a href="src/isaacus/types/embedding_create_params.py">params</a>) -> <a href="./src/isaacus/types/embedding.py">Embedding</a></code>
+
 # Classifications
 
 ## Universal
diff --git a/src/isaacus/_client.py b/src/isaacus/_client.py
@@ -21,7 +21,7 @@
 )
 from ._utils import is_given, get_async_library
 from ._version import __version__
-from .resources import rerankings
+from .resources import embeddings, rerankings
 from ._streaming import Stream as Stream, AsyncStream as AsyncStream
 from ._exceptions import IsaacusError, APIStatusError
 from ._base_client import (
@@ -36,6 +36,7 @@
 
 
 class Isaacus(SyncAPIClient):
+    embeddings: embeddings.EmbeddingsResource
     classifications: classifications.ClassificationsResource
     rerankings: rerankings.RerankingsResource
     extractions: extractions.ExtractionsResource
@@ -96,6 +97,7 @@ def __init__(
             _strict_response_validation=_strict_response_validation,
         )
 
+        self.embeddings = embeddings.EmbeddingsResource(self)
         self.classifications = classifications.ClassificationsResource(self)
         self.rerankings = rerankings.RerankingsResource(self)
         self.extractions = extractions.ExtractionsResource(self)
@@ -208,6 +210,7 @@ def _make_status_error(
 
 
 class AsyncIsaacus(AsyncAPIClient):
+    embeddings: embeddings.AsyncEmbeddingsResource
     classifications: classifications.AsyncClassificationsResource
     rerankings: rerankings.AsyncRerankingsResource
     extractions: extractions.AsyncExtractionsResource
@@ -268,6 +271,7 @@ def __init__(
             _strict_response_validation=_strict_response_validation,
         )
 
+        self.embeddings = embeddings.AsyncEmbeddingsResource(self)
         self.classifications = classifications.AsyncClassificationsResource(self)
         self.rerankings = rerankings.AsyncRerankingsResource(self)
         self.extractions = extractions.AsyncExtractionsResource(self)
@@ -381,27 +385,31 @@ def _make_status_error(
 
 class IsaacusWithRawResponse:
     def __init__(self, client: Isaacus) -> None:
+        self.embeddings = embeddings.EmbeddingsResourceWithRawResponse(client.embeddings)
         self.classifications = classifications.ClassificationsResourceWithRawResponse(client.classifications)
         self.rerankings = rerankings.RerankingsResourceWithRawResponse(client.rerankings)
         self.extractions = extractions.ExtractionsResourceWithRawResponse(client.extractions)
 
 
 class AsyncIsaacusWithRawResponse:
     def __init__(self, client: AsyncIsaacus) -> None:
+        self.embeddings = embeddings.AsyncEmbeddingsResourceWithRawResponse(client.embeddings)
         self.classifications = classifications.AsyncClassificationsResourceWithRawResponse(client.classifications)
         self.rerankings = rerankings.AsyncRerankingsResourceWithRawResponse(client.rerankings)
         self.extractions = extractions.AsyncExtractionsResourceWithRawResponse(client.extractions)
 
 
 class IsaacusWithStreamedResponse:
     def __init__(self, client: Isaacus) -> None:
+        self.embeddings = embeddings.EmbeddingsResourceWithStreamingResponse(client.embeddings)
         self.classifications = classifications.ClassificationsResourceWithStreamingResponse(client.classifications)
         self.rerankings = rerankings.RerankingsResourceWithStreamingResponse(client.rerankings)
         self.extractions = extractions.ExtractionsResourceWithStreamingResponse(client.extractions)
 
 
 class AsyncIsaacusWithStreamedResponse:
     def __init__(self, client: AsyncIsaacus) -> None:
+        self.embeddings = embeddings.AsyncEmbeddingsResourceWithStreamingResponse(client.embeddings)
         self.classifications = classifications.AsyncClassificationsResourceWithStreamingResponse(client.classifications)
         self.rerankings = rerankings.AsyncRerankingsResourceWithStreamingResponse(client.rerankings)
         self.extractions = extractions.AsyncExtractionsResourceWithStreamingResponse(client.extractions)
diff --git a/src/isaacus/resources/__init__.py b/src/isaacus/resources/__init__.py
@@ -1,5 +1,13 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+from .embeddings import (
+    EmbeddingsResource,
+    AsyncEmbeddingsResource,
+    EmbeddingsResourceWithRawResponse,
+    AsyncEmbeddingsResourceWithRawResponse,
+    EmbeddingsResourceWithStreamingResponse,
+    AsyncEmbeddingsResourceWithStreamingResponse,
+)
 from .rerankings import (
     RerankingsResource,
     AsyncRerankingsResource,
@@ -26,6 +34,12 @@
 )
 
 __all__ = [
+    "EmbeddingsResource",
+    "AsyncEmbeddingsResource",
+    "EmbeddingsResourceWithRawResponse",
+    "AsyncEmbeddingsResourceWithRawResponse",
+    "EmbeddingsResourceWithStreamingResponse",
+    "AsyncEmbeddingsResourceWithStreamingResponse",
     "ClassificationsResource",
     "AsyncClassificationsResource",
     "ClassificationsResourceWithRawResponse",
diff --git a/src/isaacus/resources/embeddings.py b/src/isaacus/resources/embeddings.py
@@ -0,0 +1,246 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Union, Optional
+from typing_extensions import Literal
+
+import httpx
+
+from ..types import embedding_create_params
+from .._types import Body, Omit, Query, Headers, NotGiven, SequenceNotStr, omit, not_given
+from .._utils import maybe_transform, async_maybe_transform
+from .._compat import cached_property
+from .._resource import SyncAPIResource, AsyncAPIResource
+from .._response import (
+    to_raw_response_wrapper,
+    to_streamed_response_wrapper,
+    async_to_raw_response_wrapper,
+    async_to_streamed_response_wrapper,
+)
+from .._base_client import make_request_options
+from ..types.embedding import Embedding
+
+__all__ = ["EmbeddingsResource", "AsyncEmbeddingsResource"]
+
+
+class EmbeddingsResource(SyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> EmbeddingsResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/isaacus-dev/isaacus-python#accessing-raw-response-data-eg-headers
+        """
+        return EmbeddingsResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> EmbeddingsResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/isaacus-dev/isaacus-python#with_streaming_response
+        """
+        return EmbeddingsResourceWithStreamingResponse(self)
+
+    def create(
+        self,
+        *,
+        model: Literal["kanon-2-embedder"],
+        texts: Union[SequenceNotStr[str], str],
+        dimensions: Optional[int] | Omit = omit,
+        overflow_strategy: Optional[Literal["drop_end"]] | Omit = omit,
+        task: Optional[Literal["retrieval/query", "retrieval/document"]] | Omit = omit,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> Embedding:
+        """
+        Embed legal texts with an Isaacus legal AI embedder.
+
+        Args:
+          model: The ID of the [model](https://docs.isaacus.com/models#embedding) to use for
+              embedding.
+
+          texts: The text or array of texts to embed.
+
+              Each text must contain at least one non-whitespace character.
+
+              No more than 1,000 texts can be embedded in a single request.
+
+          dimensions: A whole number greater than or equal to 1.
+
+          overflow_strategy: The strategy to employ when content exceeds the model's maximum input length.
+
+              `drop_end`, which is the default setting, drops tokens from the end of the
+              content exceeding the limit.
+
+              If `null`, an error will be raised if any content exceeds the model's maximum
+              input length.
+
+          task: The task the embeddings will be used for.
+
+              `retrieval/query` is meant for queries and statements, and `retrieval/document`
+              is meant for anything to be retrieved using query embeddings.
+
+              If `null`, which is the default setting, embeddings will not be optimized for
+              any particular task.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        return self._post(
+            "/embeddings",
+            body=maybe_transform(
+                {
+                    "model": model,
+                    "texts": texts,
+                    "dimensions": dimensions,
+                    "overflow_strategy": overflow_strategy,
+                    "task": task,
+                },
+                embedding_create_params.EmbeddingCreateParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=Embedding,
+        )
+
+
+class AsyncEmbeddingsResource(AsyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> AsyncEmbeddingsResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/isaacus-dev/isaacus-python#accessing-raw-response-data-eg-headers
+        """
+        return AsyncEmbeddingsResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> AsyncEmbeddingsResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/isaacus-dev/isaacus-python#with_streaming_response
+        """
+        return AsyncEmbeddingsResourceWithStreamingResponse(self)
+
+    async def create(
+        self,
+        *,
+        model: Literal["kanon-2-embedder"],
+        texts: Union[SequenceNotStr[str], str],
+        dimensions: Optional[int] | Omit = omit,
+        overflow_strategy: Optional[Literal["drop_end"]] | Omit = omit,
+        task: Optional[Literal["retrieval/query", "retrieval/document"]] | Omit = omit,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> Embedding:
+        """
+        Embed legal texts with an Isaacus legal AI embedder.
+
+        Args:
+          model: The ID of the [model](https://docs.isaacus.com/models#embedding) to use for
+              embedding.
+
+          texts: The text or array of texts to embed.
+
+              Each text must contain at least one non-whitespace character.
+
+              No more than 1,000 texts can be embedded in a single request.
+
+          dimensions: A whole number greater than or equal to 1.
+
+          overflow_strategy: The strategy to employ when content exceeds the model's maximum input length.
+
+              `drop_end`, which is the default setting, drops tokens from the end of the
+              content exceeding the limit.
+
+              If `null`, an error will be raised if any content exceeds the model's maximum
+              input length.
+
+          task: The task the embeddings will be used for.
+
+              `retrieval/query` is meant for queries and statements, and `retrieval/document`
+              is meant for anything to be retrieved using query embeddings.
+
+              If `null`, which is the default setting, embeddings will not be optimized for
+              any particular task.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        return await self._post(
+            "/embeddings",
+            body=await async_maybe_transform(
+                {
+                    "model": model,
+                    "texts": texts,
+                    "dimensions": dimensions,
+                    "overflow_strategy": overflow_strategy,
+                    "task": task,
+                },
+                embedding_create_params.EmbeddingCreateParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=Embedding,
+        )
+
+
+class EmbeddingsResourceWithRawResponse:
+    def __init__(self, embeddings: EmbeddingsResource) -> None:
+        self._embeddings = embeddings
+
+        self.create = to_raw_response_wrapper(
+            embeddings.create,
+        )
+
+
+class AsyncEmbeddingsResourceWithRawResponse:
+    def __init__(self, embeddings: AsyncEmbeddingsResource) -> None:
+        self._embeddings = embeddings
+
+        self.create = async_to_raw_response_wrapper(
+            embeddings.create,
+        )
+
+
+class EmbeddingsResourceWithStreamingResponse:
+    def __init__(self, embeddings: EmbeddingsResource) -> None:
+        self._embeddings = embeddings
+
+        self.create = to_streamed_response_wrapper(
+            embeddings.create,
+        )
+
+
+class AsyncEmbeddingsResourceWithStreamingResponse:
+    def __init__(self, embeddings: AsyncEmbeddingsResource) -> None:
+        self._embeddings = embeddings
+
+        self.create = async_to_streamed_response_wrapper(
+            embeddings.create,
+        )
diff --git a/src/isaacus/types/__init__.py b/src/isaacus/types/__init__.py
@@ -2,5 +2,7 @@
 
 from __future__ import annotations
 
+from .embedding import Embedding as Embedding
 from .reranking import Reranking as Reranking
+from .embedding_create_params import EmbeddingCreateParams as EmbeddingCreateParams
 from .reranking_create_params import RerankingCreateParams as RerankingCreateParams
diff --git a/src/isaacus/types/embedding.py b/src/isaacus/types/embedding.py
@@ -0,0 +1,20 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List
+
+from .._models import BaseModel
+
+__all__ = ["Embedding", "Usage"]
+
+
+class Usage(BaseModel):
+    input_tokens: int
+    """The number of tokens inputted to the model."""
+
+
+class Embedding(BaseModel):
+    embeddings: List[Embedding]
+    """The embeddings of the inputs."""
+
+    usage: Usage
+    """Statistics about the usage of resources in the process of embedding the inputs."""
diff --git a/src/isaacus/types/embedding_create_params.py b/src/isaacus/types/embedding_create_params.py
diff --git a/tests/api_resources/test_embeddings.py b/tests/api_resources/test_embeddings.py
