isaacus 0.3.2__tar.gz → 0.4.0__tar.gz

isaacus-0.4.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.4.0"
+}

{isaacus-0.3.2 → isaacus-0.4.0}/CHANGELOG.md

@@ -1,5 +1,47 @@
 # Changelog
 
+## 0.4.0 (2025-04-19)
+
+Full Changelog: [v0.3.3...v0.4.0](https://github.com/isaacus-dev/isaacus-python/compare/v0.3.3...v0.4.0)
+
+### ⚠ BREAKING CHANGES
+
+* **api:** made universal classification endpoint multi-input only
+
+### Features
+
+* **api:** made universal classification endpoint multi-input only ([4fb2535](https://github.com/isaacus-dev/isaacus-python/commit/4fb2535407d88d51c1db1e9a37c9ea767cdf06c0))
+
+
+### Chores
+
+* **internal:** bump pyright version ([2f992e7](https://github.com/isaacus-dev/isaacus-python/commit/2f992e788860d16739438a021bd8825a7999b1e4))
+* **internal:** update models test ([bb3df78](https://github.com/isaacus-dev/isaacus-python/commit/bb3df7823dd27e6482b5e97ef17019ee0a1e596c))
+
+## 0.3.3 (2025-04-16)
+
+Full Changelog: [v0.3.2...v0.3.3](https://github.com/isaacus-dev/isaacus-python/compare/v0.3.2...v0.3.3)
+
+### Bug Fixes
+
+* **perf:** optimize some hot paths ([eee757b](https://github.com/isaacus-dev/isaacus-python/commit/eee757ba44a895fcf2052b9981783b6cf233653f))
+* **perf:** skip traversing types for NotGiven values ([7705a99](https://github.com/isaacus-dev/isaacus-python/commit/7705a99e0efd9724eb3260550b4b58081af85878))
+
+
+### Chores
+
+* **client:** minor internal fixes ([a8dad58](https://github.com/isaacus-dev/isaacus-python/commit/a8dad5881d0f3f5d1929574efba483a8fcdbc322))
+* **internal:** codegen related update ([93cdfa0](https://github.com/isaacus-dev/isaacus-python/commit/93cdfa0c0dfc947ec76f10291887b90324301b32))
+* **internal:** expand CI branch coverage ([cc5df77](https://github.com/isaacus-dev/isaacus-python/commit/cc5df7771a9ea699b0e37533070e1cb5569d7ad9))
+* **internal:** reduce CI branch coverage ([2cb8fb8](https://github.com/isaacus-dev/isaacus-python/commit/2cb8fb81f4cea76d12ae3feeb09e4b43b743e8c4))
+* **internal:** slight transform perf improvement ([6f47eaf](https://github.com/isaacus-dev/isaacus-python/commit/6f47eafa0ebcd31741f24bea539a4c54e88a758e))
+* **internal:** update pyright settings ([7dd9ad4](https://github.com/isaacus-dev/isaacus-python/commit/7dd9ad4a4a25825929a4916168a07d74bcc52fbe))
+
+
+### Documentation
+
+* **api:** removed description of certain objects due to Mintlify bug ([9099926](https://github.com/isaacus-dev/isaacus-python/commit/90999261a360fef3ba92c52e4ad5361b79b499e6))
+
 ## 0.3.2 (2025-04-04)
 
 Full Changelog: [v0.3.1...v0.3.2](https://github.com/isaacus-dev/isaacus-python/compare/v0.3.1...v0.3.2)

{isaacus-0.3.2 → isaacus-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: isaacus
-Version: 0.3.2
+Version: 0.4.0
 Summary: The official Python library for the isaacus API
 Project-URL: Homepage, https://github.com/isaacus-dev/isaacus-python
 Project-URL: Repository, https://github.com/isaacus-dev/isaacus-python
@@ -65,9 +65,9 @@ client = Isaacus(
 universal_classification = client.classifications.universal.create(
     model="kanon-universal-classifier",
     query="This is a confidentiality clause.",
-    text="I agree not to tell anyone about the document.",
+    texts=["I agree not to tell anyone about the document."],
 )
-print(universal_classification.chunks)
+print(universal_classification.classifications)
 ```
 
 While you can provide an `api_key` keyword argument,
@@ -93,9 +93,9 @@ async def main() -> None:
     universal_classification = await client.classifications.universal.create(
         model="kanon-universal-classifier",
         query="This is a confidentiality clause.",
-        text="I agree not to tell anyone about the document.",
+        texts=["I agree not to tell anyone about the document."],
     )
-    print(universal_classification.chunks)
+    print(universal_classification.classifications)
 
 
 asyncio.run(main())
@@ -124,7 +124,7 @@ client = Isaacus()
 universal_classification = client.classifications.universal.create(
     model="kanon-universal-classifier",
     query="This is a confidentiality clause.",
-    text="I agree not to tell anyone about the document.",
+    texts=["I agree not to tell anyone about the document."],
     chunking_options={
         "overlap_ratio": 0.1,
         "overlap_tokens": None,
@@ -153,7 +153,7 @@ try:
     client.classifications.universal.create(
         model="kanon-universal-classifier",
         query="This is a confidentiality clause.",
-        text="I agree not to tell anyone about the document.",
+        texts=["I agree not to tell anyone about the document."],
     )
 except isaacus.APIConnectionError as e:
     print("The server could not be reached")
@@ -200,7 +200,7 @@ client = Isaacus(
 client.with_options(max_retries=5).classifications.universal.create(
     model="kanon-universal-classifier",
     query="This is a confidentiality clause.",
-    text="I agree not to tell anyone about the document.",
+    texts=["I agree not to tell anyone about the document."],
 )
 ```
 
@@ -227,7 +227,7 @@ client = Isaacus(
 client.with_options(timeout=5.0).classifications.universal.create(
     model="kanon-universal-classifier",
     query="This is a confidentiality clause.",
-    text="I agree not to tell anyone about the document.",
+    texts=["I agree not to tell anyone about the document."],
 )
 ```
 
@@ -272,12 +272,12 @@ client = Isaacus()
 response = client.classifications.universal.with_raw_response.create(
     model="kanon-universal-classifier",
     query="This is a confidentiality clause.",
-    text="I agree not to tell anyone about the document.",
+    texts=["I agree not to tell anyone about the document."],
 )
 print(response.headers.get('X-My-Header'))
 
 universal = response.parse()  # get the object that `classifications.universal.create()` would have returned
-print(universal.chunks)
+print(universal.classifications)
 ```
 
 These methods return an [`APIResponse`](https://github.com/isaacus-dev/isaacus-python/tree/main/src/isaacus/_response.py) object.
@@ -294,7 +294,7 @@ To stream the response body, use `.with_streaming_response` instead, which requi
 with client.classifications.universal.with_streaming_response.create(
     model="kanon-universal-classifier",
     query="This is a confidentiality clause.",
-    text="I agree not to tell anyone about the document.",
+    texts=["I agree not to tell anyone about the document."],
 ) as response:
     print(response.headers.get("X-My-Header"))
 

{isaacus-0.3.2 → isaacus-0.4.0}/README.md

@@ -34,9 +34,9 @@ client = Isaacus(
 universal_classification = client.classifications.universal.create(
     model="kanon-universal-classifier",
     query="This is a confidentiality clause.",
-    text="I agree not to tell anyone about the document.",
+    texts=["I agree not to tell anyone about the document."],
 )
-print(universal_classification.chunks)
+print(universal_classification.classifications)
 ```
 
 While you can provide an `api_key` keyword argument,
@@ -62,9 +62,9 @@ async def main() -> None:
     universal_classification = await client.classifications.universal.create(
         model="kanon-universal-classifier",
         query="This is a confidentiality clause.",
-        text="I agree not to tell anyone about the document.",
+        texts=["I agree not to tell anyone about the document."],
     )
-    print(universal_classification.chunks)
+    print(universal_classification.classifications)
 
 
 asyncio.run(main())
@@ -93,7 +93,7 @@ client = Isaacus()
 universal_classification = client.classifications.universal.create(
     model="kanon-universal-classifier",
     query="This is a confidentiality clause.",
-    text="I agree not to tell anyone about the document.",
+    texts=["I agree not to tell anyone about the document."],
     chunking_options={
         "overlap_ratio": 0.1,
         "overlap_tokens": None,
@@ -122,7 +122,7 @@ try:
     client.classifications.universal.create(
         model="kanon-universal-classifier",
         query="This is a confidentiality clause.",
-        text="I agree not to tell anyone about the document.",
+        texts=["I agree not to tell anyone about the document."],
     )
 except isaacus.APIConnectionError as e:
     print("The server could not be reached")
@@ -169,7 +169,7 @@ client = Isaacus(
 client.with_options(max_retries=5).classifications.universal.create(
     model="kanon-universal-classifier",
     query="This is a confidentiality clause.",
-    text="I agree not to tell anyone about the document.",
+    texts=["I agree not to tell anyone about the document."],
 )
 ```
 
@@ -196,7 +196,7 @@ client = Isaacus(
 client.with_options(timeout=5.0).classifications.universal.create(
     model="kanon-universal-classifier",
     query="This is a confidentiality clause.",
-    text="I agree not to tell anyone about the document.",
+    texts=["I agree not to tell anyone about the document."],
 )
 ```
 
@@ -241,12 +241,12 @@ client = Isaacus()
 response = client.classifications.universal.with_raw_response.create(
     model="kanon-universal-classifier",
     query="This is a confidentiality clause.",
-    text="I agree not to tell anyone about the document.",
+    texts=["I agree not to tell anyone about the document."],
 )
 print(response.headers.get('X-My-Header'))
 
 universal = response.parse()  # get the object that `classifications.universal.create()` would have returned
-print(universal.chunks)
+print(universal.classifications)
 ```
 
 These methods return an [`APIResponse`](https://github.com/isaacus-dev/isaacus-python/tree/main/src/isaacus/_response.py) object.
@@ -263,7 +263,7 @@ To stream the response body, use `.with_streaming_response` instead, which requi
 with client.classifications.universal.with_streaming_response.create(
     model="kanon-universal-classifier",
     query="This is a confidentiality clause.",
-    text="I agree not to tell anyone about the document.",
+    texts=["I agree not to tell anyone about the document."],
 ) as response:
     print(response.headers.get("X-My-Header"))
 

{isaacus-0.3.2 → isaacus-0.4.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "isaacus"
-version = "0.3.2"
+version = "0.4.0"
 description = "The official Python library for the isaacus API"
 dynamic = ["readme"]
 license = "Apache-2.0"
@@ -42,7 +42,7 @@ Repository = "https://github.com/isaacus-dev/isaacus-python"
 managed = true
 # version pins are in requirements-dev.lock
 dev-dependencies = [
-    "pyright>=1.1.359",
+    "pyright==1.1.399",
     "mypy",
     "respx",
     "pytest",
@@ -147,6 +147,7 @@ exclude = [
 ]
 
 reportImplicitOverride = true
+reportOverlappingOverload = false
 
 reportImportCycles = false
 reportPrivateUsage = false

{isaacus-0.3.2 → isaacus-0.4.0}/requirements-dev.lock

@@ -69,7 +69,7 @@ pydantic-core==2.27.1
     # via pydantic
 pygments==2.18.0
     # via rich
-pyright==1.1.392.post0
+pyright==1.1.399
 pytest==8.3.3
     # via pytest-asyncio
 pytest-asyncio==0.24.0

{isaacus-0.3.2 → isaacus-0.4.0}/src/isaacus/_base_client.py

@@ -98,7 +98,11 @@ _StreamT = TypeVar("_StreamT", bound=Stream[Any])
 _AsyncStreamT = TypeVar("_AsyncStreamT", bound=AsyncStream[Any])
 
 if TYPE_CHECKING:
-    from httpx._config import DEFAULT_TIMEOUT_CONFIG as HTTPX_DEFAULT_TIMEOUT
+    from httpx._config import (
+        DEFAULT_TIMEOUT_CONFIG,  # pyright: ignore[reportPrivateImportUsage]
+    )
+
+    HTTPX_DEFAULT_TIMEOUT = DEFAULT_TIMEOUT_CONFIG
 else:
     try:
         from httpx._config import DEFAULT_TIMEOUT_CONFIG as HTTPX_DEFAULT_TIMEOUT
@@ -409,7 +413,8 @@ class BaseClient(Generic[_HttpxClientT, _DefaultStreamT]):
 
         idempotency_header = self._idempotency_header
         if idempotency_header and options.method.lower() != "get" and idempotency_header not in headers:
-            headers[idempotency_header] = options.idempotency_key or self._idempotency_key()
+            options.idempotency_key = options.idempotency_key or self._idempotency_key()
+            headers[idempotency_header] = options.idempotency_key
 
         # Don't set these headers if they were already set or removed by the caller. We check
         # `custom_headers`, which can contain `Omit()`, instead of `headers` to account for the removal case.
@@ -943,6 +948,10 @@ class SyncAPIClient(BaseClient[httpx.Client, Stream[Any]]):
         request = self._build_request(options, retries_taken=retries_taken)
         self._prepare_request(request)
 
+        if options.idempotency_key:
+            # ensure the idempotency key is reused between requests
+            input_options.idempotency_key = options.idempotency_key
+
         kwargs: HttpxSendArgs = {}
         if self.custom_auth is not None:
             kwargs["auth"] = self.custom_auth
@@ -1475,6 +1484,10 @@ class AsyncAPIClient(BaseClient[httpx.AsyncClient, AsyncStream[Any]]):
         request = self._build_request(options, retries_taken=retries_taken)
         await self._prepare_request(request)
 
+        if options.idempotency_key:
+            # ensure the idempotency key is reused between requests
+            input_options.idempotency_key = options.idempotency_key
+
         kwargs: HttpxSendArgs = {}
         if self.custom_auth is not None:
             kwargs["auth"] = self.custom_auth

{isaacus-0.3.2 → isaacus-0.4.0}/src/isaacus/_models.py

@@ -19,7 +19,6 @@ from typing_extensions import (
 )
 
 import pydantic
-import pydantic.generics
 from pydantic.fields import FieldInfo
 
 from ._types import (

{isaacus-0.3.2 → isaacus-0.4.0}/src/isaacus/_utils/_transform.py

@@ -5,13 +5,15 @@ import base64
 import pathlib
 from typing import Any, Mapping, TypeVar, cast
 from datetime import date, datetime
-from typing_extensions import Literal, get_args, override, get_type_hints
+from typing_extensions import Literal, get_args, override, get_type_hints as _get_type_hints
 
 import anyio
 import pydantic
 
 from ._utils import (
     is_list,
+    is_given,
+    lru_cache,
     is_mapping,
     is_iterable,
 )
@@ -108,6 +110,7 @@ def transform(
     return cast(_T, transformed)
 
 
+@lru_cache(maxsize=8096)
 def _get_annotated_type(type_: type) -> type | None:
     """If the given type is an `Annotated` type then it is returned, if not `None` is returned.
 
@@ -142,6 +145,10 @@ def _maybe_transform_key(key: str, type_: type) -> str:
     return key
 
 
+def _no_transform_needed(annotation: type) -> bool:
+    return annotation == float or annotation == int
+
+
 def _transform_recursive(
     data: object,
     *,
@@ -184,6 +191,15 @@ def _transform_recursive(
             return cast(object, data)
 
         inner_type = extract_type_arg(stripped_type, 0)
+        if _no_transform_needed(inner_type):
+            # for some types there is no need to transform anything, so we can get a small
+            # perf boost from skipping that work.
+            #
+            # but we still need to convert to a list to ensure the data is json-serializable
+            if is_list(data):
+                return data
+            return list(data)
+
         return [_transform_recursive(d, annotation=annotation, inner_type=inner_type) for d in data]
 
     if is_union_type(stripped_type):
@@ -245,6 +261,11 @@ def _transform_typeddict(
     result: dict[str, object] = {}
     annotations = get_type_hints(expected_type, include_extras=True)
     for key, value in data.items():
+        if not is_given(value):
+            # we don't need to include `NotGiven` values here as they'll
+            # be stripped out before the request is sent anyway
+            continue
+
         type_ = annotations.get(key)
         if type_ is None:
             # we do not have a type annotation for this field, leave it as is
@@ -332,6 +353,15 @@ async def _async_transform_recursive(
             return cast(object, data)
 
         inner_type = extract_type_arg(stripped_type, 0)
+        if _no_transform_needed(inner_type):
+            # for some types there is no need to transform anything, so we can get a small
+            # perf boost from skipping that work.
+            #
+            # but we still need to convert to a list to ensure the data is json-serializable
+            if is_list(data):
+                return data
+            return list(data)
+
         return [await _async_transform_recursive(d, annotation=annotation, inner_type=inner_type) for d in data]
 
     if is_union_type(stripped_type):
@@ -393,6 +423,11 @@ async def _async_transform_typeddict(
     result: dict[str, object] = {}
     annotations = get_type_hints(expected_type, include_extras=True)
     for key, value in data.items():
+        if not is_given(value):
+            # we don't need to include `NotGiven` values here as they'll
+            # be stripped out before the request is sent anyway
+            continue
+
         type_ = annotations.get(key)
         if type_ is None:
             # we do not have a type annotation for this field, leave it as is
@@ -400,3 +435,13 @@ async def _async_transform_typeddict(
         else:
             result[_maybe_transform_key(key, type_)] = await _async_transform_recursive(value, annotation=type_)
     return result
+
+
+@lru_cache(maxsize=8096)
+def get_type_hints(
+    obj: Any,
+    globalns: dict[str, Any] | None = None,
+    localns: Mapping[str, Any] | None = None,
+    include_extras: bool = False,
+) -> dict[str, Any]:
+    return _get_type_hints(obj, globalns=globalns, localns=localns, include_extras=include_extras)

{isaacus-0.3.2 → isaacus-0.4.0}/src/isaacus/_utils/_typing.py

@@ -13,6 +13,7 @@ from typing_extensions import (
     get_origin,
 )
 
+from ._utils import lru_cache
 from .._types import InheritsGeneric
 from .._compat import is_union as _is_union
 
@@ -66,6 +67,7 @@ def is_type_alias_type(tp: Any, /) -> TypeIs[typing_extensions.TypeAliasType]:
 
 
 # Extracts T from Annotated[T, ...] or from Required[Annotated[T, ...]]
+@lru_cache(maxsize=8096)
 def strip_annotated_type(typ: type) -> type:
     if is_required_type(typ) or is_annotated_type(typ):
         return strip_annotated_type(cast(type, get_args(typ)[0]))
@@ -108,7 +110,7 @@ def extract_type_var_from_base(
     ```
     """
     cls = cast(object, get_origin(typ) or typ)
-    if cls in generic_bases:
+    if cls in generic_bases:  # pyright: ignore[reportUnnecessaryContains]
         # we're given the class directly
         return extract_type_arg(typ, index)
 

{isaacus-0.3.2 → isaacus-0.4.0}/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.3.2"  # x-release-please-version
+__version__ = "0.4.0"  # x-release-please-version

{isaacus-0.3.2 → isaacus-0.4.0}/src/isaacus/resources/classifications/universal.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Optional
+from typing import List, Optional
 from typing_extensions import Literal
 
 import httpx
@@ -52,7 +52,7 @@ class UniversalResource(SyncAPIResource):
         *,
         model: Literal["kanon-universal-classifier", "kanon-universal-classifier-mini"],
         query: str,
-        text: str,
+        texts: List[str],
         chunking_options: Optional[universal_create_params.ChunkingOptions] | NotGiven = NOT_GIVEN,
         is_iql: bool | NotGiven = NOT_GIVEN,
         scoring_method: Literal["auto", "chunk_max", "chunk_avg", "chunk_min"] | NotGiven = NOT_GIVEN,
@@ -64,7 +64,7 @@ class UniversalResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> UniversalClassification:
         """
-        Classify the relevance of a legal document to a query with an Isaacus universal
+        Classify the relevance of legal documents to a query with an Isaacus universal
         legal AI classifier.
 
         Args:
@@ -72,16 +72,16 @@ class UniversalResource(SyncAPIResource):
               to use for universal classification.
 
           query: The [Isaacus Query Language (IQL)](https://docs.isaacus.com/iql) query or, if
-              IQL is disabled, the statement, to evaluate the text against.
+              IQL is disabled, the statement, to evaluate the texts against.
 
               The query must contain at least one non-whitespace character.
 
-              Unlike the text being classified, the query cannot be so long that it exceeds
+              Unlike the texts being classified, the query cannot be so long that it exceeds
               the maximum input length of the universal classifier.
 
-          text: The text to classify.
+          texts: The texts to classify.
 
-              The text must contain at least one non-whitespace character.
+              The texts must contain at least one non-whitespace character.
 
           chunking_options: Options for how to split text into smaller chunks.
 
@@ -92,13 +92,13 @@ class UniversalResource(SyncAPIResource):
 
               `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
-              select the best method based on the model and input.
+              select the best method based on the model and inputs.
 
-              `chunk_max` uses the highest confidence score of all of the text's chunks.
+              `chunk_max` uses the highest confidence score of all of the texts' chunks.
 
-              `chunk_avg` averages the confidence scores of all of the text's chunks.
+              `chunk_avg` averages the confidence scores of all of the texts' chunks.
 
-              `chunk_min` uses the lowest confidence score of all of the text's chunks.
+              `chunk_min` uses the lowest confidence score of all of the texts' chunks.
 
           extra_headers: Send extra headers
 
@@ -114,7 +114,7 @@ class UniversalResource(SyncAPIResource):
                 {
                     "model": model,
                     "query": query,
-                    "text": text,
+                    "texts": texts,
                     "chunking_options": chunking_options,
                     "is_iql": is_iql,
                     "scoring_method": scoring_method,
@@ -153,7 +153,7 @@ class AsyncUniversalResource(AsyncAPIResource):
         *,
         model: Literal["kanon-universal-classifier", "kanon-universal-classifier-mini"],
         query: str,
-        text: str,
+        texts: List[str],
         chunking_options: Optional[universal_create_params.ChunkingOptions] | NotGiven = NOT_GIVEN,
         is_iql: bool | NotGiven = NOT_GIVEN,
         scoring_method: Literal["auto", "chunk_max", "chunk_avg", "chunk_min"] | NotGiven = NOT_GIVEN,
@@ -165,7 +165,7 @@ class AsyncUniversalResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> UniversalClassification:
         """
-        Classify the relevance of a legal document to a query with an Isaacus universal
+        Classify the relevance of legal documents to a query with an Isaacus universal
         legal AI classifier.
 
         Args:
@@ -173,16 +173,16 @@ class AsyncUniversalResource(AsyncAPIResource):
               to use for universal classification.
 
           query: The [Isaacus Query Language (IQL)](https://docs.isaacus.com/iql) query or, if
-              IQL is disabled, the statement, to evaluate the text against.
+              IQL is disabled, the statement, to evaluate the texts against.
 
               The query must contain at least one non-whitespace character.
 
-              Unlike the text being classified, the query cannot be so long that it exceeds
+              Unlike the texts being classified, the query cannot be so long that it exceeds
               the maximum input length of the universal classifier.
 
-          text: The text to classify.
+          texts: The texts to classify.
 
-              The text must contain at least one non-whitespace character.
+              The texts must contain at least one non-whitespace character.
 
           chunking_options: Options for how to split text into smaller chunks.
 
@@ -193,13 +193,13 @@ class AsyncUniversalResource(AsyncAPIResource):
 
               `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
-              select the best method based on the model and input.
+              select the best method based on the model and inputs.
 
-              `chunk_max` uses the highest confidence score of all of the text's chunks.
+              `chunk_max` uses the highest confidence score of all of the texts' chunks.
 
-              `chunk_avg` averages the confidence scores of all of the text's chunks.
+              `chunk_avg` averages the confidence scores of all of the texts' chunks.
 
-              `chunk_min` uses the lowest confidence score of all of the text's chunks.
+              `chunk_min` uses the lowest confidence score of all of the texts' chunks.
 
           extra_headers: Send extra headers
 
@@ -215,7 +215,7 @@ class AsyncUniversalResource(AsyncAPIResource):
                 {
                     "model": model,
                     "query": query,
-                    "text": text,
+                    "texts": texts,
                     "chunking_options": chunking_options,
                     "is_iql": is_iql,
                     "scoring_method": scoring_method,

{isaacus-0.3.2 → isaacus-0.4.0}/src/isaacus/types/classifications/universal_classification.py

@@ -4,15 +4,22 @@ from typing import List, Optional
 
 from ..._models import BaseModel
 
-__all__ = ["UniversalClassification", "Chunk", "Usage"]
+__all__ = ["UniversalClassification", "Classification", "ClassificationChunk", "Usage"]
 
 
-class Chunk(BaseModel):
+class ClassificationChunk(BaseModel):
     end: int
-    """The end index of the chunk in the original text."""
+    """
+    The index of the character in the original text where the chunk ends, beginning
+    from `0` (such that, in Python, the chunk is equivalent to `text[start:end+1]`).
+    """
 
     index: int
-    """The index of the chunk in the list of chunks."""
+    """
+    The original position of the chunk in the outputted list of chunks before
+    sorting, starting from `0` (and, therefore, ending at the number of chunks minus
+    `1`).
+    """
 
     score: float
     """
@@ -24,19 +31,17 @@ class Chunk(BaseModel):
     """
 
     start: int
-    """The start index of the chunk in the original text."""
+    """
+    The index of the character in the original text where the chunk starts,
+    beginning from `0`.
+    """
 
     text: str
     """The text of the chunk."""
 
 
-class Usage(BaseModel):
-    input_tokens: int
-    """The number of tokens inputted to the model."""
-
-
-class UniversalClassification(BaseModel):
-    chunks: Optional[List[Chunk]] = None
+class Classification(BaseModel):
+    chunks: Optional[List[ClassificationChunk]] = None
     """
     The text as broken into chunks by
     [semchunk](https://github.com/isaacus-dev/semchunk), each chunk with its own
@@ -45,6 +50,12 @@ class UniversalClassification(BaseModel):
     If no chunking occurred, this will be `null`.
     """
 
+    index: int
+    """
+    The index of the text in the input array of texts, starting from `0` (and,
+    therefore, ending at the number of texts minus `1`).
+    """
+
     score: float
     """
     A score of the likelihood that the query expressed about the text is supported
@@ -54,5 +65,18 @@ class UniversalClassification(BaseModel):
     score less than `0.5` indicates that the text does not support the query.
     """
 
+
+class Usage(BaseModel):
+    input_tokens: int
+    """The number of tokens inputted to the model."""
+
+
+class UniversalClassification(BaseModel):
+    classifications: List[Classification]
+    """
+    The classifications of the texts, by relevance to the query, in order from
+    highest to lowest relevance score.
+    """
+
     usage: Usage
     """Statistics about the usage of resources in the process of classifying the text."""

{isaacus-0.3.2 → isaacus-0.4.0}/src/isaacus/types/classifications/universal_create_params.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Optional
+from typing import List, Optional
 from typing_extensions import Literal, Required, TypedDict
 
 __all__ = ["UniversalCreateParams", "ChunkingOptions"]
@@ -18,18 +18,18 @@ class UniversalCreateParams(TypedDict, total=False):
     query: Required[str]
     """
     The [Isaacus Query Language (IQL)](https://docs.isaacus.com/iql) query or, if
-    IQL is disabled, the statement, to evaluate the text against.
+    IQL is disabled, the statement, to evaluate the texts against.
 
     The query must contain at least one non-whitespace character.
 
-    Unlike the text being classified, the query cannot be so long that it exceeds
+    Unlike the texts being classified, the query cannot be so long that it exceeds
     the maximum input length of the universal classifier.
     """
 
-    text: Required[str]
-    """The text to classify.
+    texts: Required[List[str]]
+    """The texts to classify.
 
-    The text must contain at least one non-whitespace character.
+    The texts must contain at least one non-whitespace character.
     """
 
     chunking_options: Optional[ChunkingOptions]
@@ -46,13 +46,13 @@ class UniversalCreateParams(TypedDict, total=False):
 
     `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
-    select the best method based on the model and input.
+    select the best method based on the model and inputs.
 
-    `chunk_max` uses the highest confidence score of all of the text's chunks.
+    `chunk_max` uses the highest confidence score of all of the texts' chunks.
 
-    `chunk_avg` averages the confidence scores of all of the text's chunks.
+    `chunk_avg` averages the confidence scores of all of the texts' chunks.
 
-    `chunk_min` uses the lowest confidence score of all of the text's chunks.
+    `chunk_min` uses the lowest confidence score of all of the texts' chunks.
     """
 
 

{isaacus-0.3.2 → isaacus-0.4.0}/tests/api_resources/classifications/test_universal.py

@@ -23,7 +23,7 @@ class TestUniversal:
         universal = client.classifications.universal.create(
             model="kanon-universal-classifier",
             query="This is a confidentiality clause.",
-            text="I agree not to tell anyone about the document.",
+            texts=["I agree not to tell anyone about the document."],
         )
         assert_matches_type(UniversalClassification, universal, path=["response"])
 
@@ -33,7 +33,7 @@ class TestUniversal:
         universal = client.classifications.universal.create(
             model="kanon-universal-classifier",
             query="This is a confidentiality clause.",
-            text="I agree not to tell anyone about the document.",
+            texts=["I agree not to tell anyone about the document."],
             chunking_options={
                 "overlap_ratio": 0.1,
                 "overlap_tokens": 0,
@@ -50,7 +50,7 @@ class TestUniversal:
         response = client.classifications.universal.with_raw_response.create(
             model="kanon-universal-classifier",
             query="This is a confidentiality clause.",
-            text="I agree not to tell anyone about the document.",
+            texts=["I agree not to tell anyone about the document."],
         )
 
         assert response.is_closed is True
@@ -64,7 +64,7 @@ class TestUniversal:
         with client.classifications.universal.with_streaming_response.create(
             model="kanon-universal-classifier",
             query="This is a confidentiality clause.",
-            text="I agree not to tell anyone about the document.",
+            texts=["I agree not to tell anyone about the document."],
         ) as response:
             assert not response.is_closed
             assert response.http_request.headers.get("X-Stainless-Lang") == "python"
@@ -84,7 +84,7 @@ class TestAsyncUniversal:
         universal = await async_client.classifications.universal.create(
             model="kanon-universal-classifier",
             query="This is a confidentiality clause.",
-            text="I agree not to tell anyone about the document.",
+            texts=["I agree not to tell anyone about the document."],
         )
         assert_matches_type(UniversalClassification, universal, path=["response"])
 
@@ -94,7 +94,7 @@ class TestAsyncUniversal:
         universal = await async_client.classifications.universal.create(
             model="kanon-universal-classifier",
             query="This is a confidentiality clause.",
-            text="I agree not to tell anyone about the document.",
+            texts=["I agree not to tell anyone about the document."],
             chunking_options={
                 "overlap_ratio": 0.1,
                 "overlap_tokens": 0,
@@ -111,7 +111,7 @@ class TestAsyncUniversal:
         response = await async_client.classifications.universal.with_raw_response.create(
             model="kanon-universal-classifier",
             query="This is a confidentiality clause.",
-            text="I agree not to tell anyone about the document.",
+            texts=["I agree not to tell anyone about the document."],
         )
 
         assert response.is_closed is True
@@ -125,7 +125,7 @@ class TestAsyncUniversal:
         async with async_client.classifications.universal.with_streaming_response.create(
             model="kanon-universal-classifier",
             query="This is a confidentiality clause.",
-            text="I agree not to tell anyone about the document.",
+            texts=["I agree not to tell anyone about the document."],
         ) as response:
             assert not response.is_closed
             assert response.http_request.headers.get("X-Stainless-Lang") == "python"

{isaacus-0.3.2 → isaacus-0.4.0}/tests/conftest.py

@@ -10,7 +10,7 @@ from pytest_asyncio import is_async_test
 from isaacus import Isaacus, AsyncIsaacus
 
 if TYPE_CHECKING:
-    from _pytest.fixtures import FixtureRequest
+    from _pytest.fixtures import FixtureRequest  # pyright: ignore[reportPrivateImportUsage]
 
 pytest.register_assert_rewrite("tests.utils")
 

{isaacus-0.3.2 → isaacus-0.4.0}/tests/test_client.py

@@ -723,7 +723,7 @@ class TestIsaacus:
                         dict(
                             model="kanon-universal-classifier",
                             query="This is a confidentiality clause.",
-                            text="I agree not to tell anyone about the document.",
+                            texts=["I agree not to tell anyone about the document."],
                         ),
                         UniversalCreateParams,
                     ),
@@ -748,7 +748,7 @@ class TestIsaacus:
                         dict(
                             model="kanon-universal-classifier",
                             query="This is a confidentiality clause.",
-                            text="I agree not to tell anyone about the document.",
+                            texts=["I agree not to tell anyone about the document."],
                         ),
                         UniversalCreateParams,
                     ),
@@ -788,7 +788,7 @@ class TestIsaacus:
         response = client.classifications.universal.with_raw_response.create(
             model="kanon-universal-classifier",
             query="This is a confidentiality clause.",
-            text="I agree not to tell anyone about the document.",
+            texts=["I agree not to tell anyone about the document."],
         )
 
         assert response.retries_taken == failures_before_success
@@ -816,7 +816,7 @@ class TestIsaacus:
         response = client.classifications.universal.with_raw_response.create(
             model="kanon-universal-classifier",
             query="This is a confidentiality clause.",
-            text="I agree not to tell anyone about the document.",
+            texts=["I agree not to tell anyone about the document."],
             extra_headers={"x-stainless-retry-count": Omit()},
         )
 
@@ -844,7 +844,7 @@ class TestIsaacus:
         response = client.classifications.universal.with_raw_response.create(
             model="kanon-universal-classifier",
             query="This is a confidentiality clause.",
-            text="I agree not to tell anyone about the document.",
+            texts=["I agree not to tell anyone about the document."],
             extra_headers={"x-stainless-retry-count": "42"},
         )
 
@@ -1533,7 +1533,7 @@ class TestAsyncIsaacus:
                         dict(
                             model="kanon-universal-classifier",
                             query="This is a confidentiality clause.",
-                            text="I agree not to tell anyone about the document.",
+                            texts=["I agree not to tell anyone about the document."],
                         ),
                         UniversalCreateParams,
                     ),
@@ -1558,7 +1558,7 @@ class TestAsyncIsaacus:
                         dict(
                             model="kanon-universal-classifier",
                             query="This is a confidentiality clause.",
-                            text="I agree not to tell anyone about the document.",
+                            texts=["I agree not to tell anyone about the document."],
                         ),
                         UniversalCreateParams,
                     ),
@@ -1599,7 +1599,7 @@ class TestAsyncIsaacus:
         response = await client.classifications.universal.with_raw_response.create(
             model="kanon-universal-classifier",
             query="This is a confidentiality clause.",
-            text="I agree not to tell anyone about the document.",
+            texts=["I agree not to tell anyone about the document."],
         )
 
         assert response.retries_taken == failures_before_success
@@ -1628,7 +1628,7 @@ class TestAsyncIsaacus:
         response = await client.classifications.universal.with_raw_response.create(
             model="kanon-universal-classifier",
             query="This is a confidentiality clause.",
-            text="I agree not to tell anyone about the document.",
+            texts=["I agree not to tell anyone about the document."],
             extra_headers={"x-stainless-retry-count": Omit()},
         )
 
@@ -1657,7 +1657,7 @@ class TestAsyncIsaacus:
         response = await client.classifications.universal.with_raw_response.create(
             model="kanon-universal-classifier",
             query="This is a confidentiality clause.",
-            text="I agree not to tell anyone about the document.",
+            texts=["I agree not to tell anyone about the document."],
             extra_headers={"x-stainless-retry-count": "42"},
         )
 

{isaacus-0.3.2 → isaacus-0.4.0}/tests/test_models.py

@@ -492,12 +492,15 @@ def test_omitted_fields() -> None:
         resource_id: Optional[str] = None
 
     m = Model.construct()
+    assert m.resource_id is None
     assert "resource_id" not in m.model_fields_set
 
     m = Model.construct(resource_id=None)
+    assert m.resource_id is None
     assert "resource_id" in m.model_fields_set
 
     m = Model.construct(resource_id="foo")
+    assert m.resource_id == "foo"
     assert "resource_id" in m.model_fields_set
 
 
@@ -832,7 +835,7 @@ def test_discriminated_unions_invalid_data_uses_cache() -> None:
 
 @pytest.mark.skipif(not PYDANTIC_V2, reason="TypeAliasType is not supported in Pydantic v1")
 def test_type_alias_type() -> None:
-    Alias = TypeAliasType("Alias", str)
+    Alias = TypeAliasType("Alias", str)  # pyright: ignore
 
     class Model(BaseModel):
         alias: Alias

{isaacus-0.3.2 → isaacus-0.4.0}/tests/test_transform.py

@@ -8,7 +8,7 @@ from typing_extensions import Required, Annotated, TypedDict
 
 import pytest
 
-from isaacus._types import Base64FileInput
+from isaacus._types import NOT_GIVEN, Base64FileInput
 from isaacus._utils import (
     PropertyInfo,
     transform as _transform,
@@ -432,3 +432,22 @@ async def test_base64_file_input(use_async: bool) -> None:
     assert await transform({"foo": io.BytesIO(b"Hello, world!")}, TypedDictBase64Input, use_async) == {
         "foo": "SGVsbG8sIHdvcmxkIQ=="
     }  # type: ignore[comparison-overlap]
+
+
+@parametrize
+@pytest.mark.asyncio
+async def test_transform_skipping(use_async: bool) -> None:
+    # lists of ints are left as-is
+    data = [1, 2, 3]
+    assert await transform(data, List[int], use_async) is data
+
+    # iterables of ints are converted to a list
+    data = iter([1, 2, 3])
+    assert await transform(data, Iterable[int], use_async) == [1, 2, 3]
+
+
+@parametrize
+@pytest.mark.asyncio
+async def test_strips_notgiven(use_async: bool) -> None:
+    assert await transform({"foo_bar": "bar"}, Foo1, use_async) == {"fooBar": "bar"}
+    assert await transform({"foo_bar": NOT_GIVEN}, Foo1, use_async) == {}

isaacus-0.3.2/.release-please-manifest.json

@@ -1,3 +0,0 @@
-{
-  ".": "0.3.2"
-}