isaacus 0.7.0__tar.gz → 0.9.0__tar.gz

{isaacus-0.7.0 → isaacus-0.9.0}/.gitignore

@@ -1,5 +1,4 @@
 .prism.log
-.vscode
 _dev
 
 __pycache__

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

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

{isaacus-0.7.0 → isaacus-0.9.0}/CHANGELOG.md

@@ -1,5 +1,103 @@
 # Changelog
 
+## 0.9.0 (2025-10-14)
+
+Full Changelog: [v0.8.0...v0.9.0](https://github.com/isaacus-dev/isaacus-python/compare/v0.8.0...v0.9.0)
+
+### ⚠ BREAKING CHANGES
+
+* **api:** reduce max length of embeddings input
+* **sdk:** add `_response` to response models to finally fix duplicated names
+
+### Features
+
+* **api:** added embedding endpoint ([88190d6](https://github.com/isaacus-dev/isaacus-python/commit/88190d6d33c8d5e3cf59dfd3c488b5ae9abec93b))
+* **api:** reduce max length of embeddings input ([0ad7114](https://github.com/isaacus-dev/isaacus-python/commit/0ad7114b5fec2fde9aaa830a6ba6163ad3b6fccc))
+* **api:** rename embedding -> embeddings ([204a05d](https://github.com/isaacus-dev/isaacus-python/commit/204a05d7b1504901766db3c0d0d8ea47a22a16ed))
+* **api:** revert embedding -> embeddings ([b934279](https://github.com/isaacus-dev/isaacus-python/commit/b9342795e50374817b8e3dc2e2f1163a2ff0805a))
+* **client:** support file upload requests ([2ab398d](https://github.com/isaacus-dev/isaacus-python/commit/2ab398dde07e98411c9b6efd76f7b7120a9633a8))
+* improve future compat with pydantic v3 ([5a20497](https://github.com/isaacus-dev/isaacus-python/commit/5a20497a9c4bbf88056df12a0c686566dc9bd162))
+* **sdk:** add embeddings endpoint ([920ae0b](https://github.com/isaacus-dev/isaacus-python/commit/920ae0b65f2362ac098f8b94979b1e821f5143d8))
+* **sdk:** toggle to force regen ([cf60482](https://github.com/isaacus-dev/isaacus-python/commit/cf60482ba0dd3933daee477fa9bd4ae29d900fb4))
+* **sdk:** untoggle to force regen ([25d2067](https://github.com/isaacus-dev/isaacus-python/commit/25d2067fad4bb46ca595001f6e82458fd3d24a23))
+* **types:** replace List[str] with SequenceNotStr in params ([d2733a9](https://github.com/isaacus-dev/isaacus-python/commit/d2733a9d0f16531537a9db017a8e29d2c8fb3912))
+
+
+### Bug Fixes
+
+* **api:** typo ([5d4a1b9](https://github.com/isaacus-dev/isaacus-python/commit/5d4a1b99e8a6ac2a1c3cc4e83e7b65108eea335a))
+* avoid newer type syntax ([10253fe](https://github.com/isaacus-dev/isaacus-python/commit/10253fe93ed8142b52cf5199486221e81ac6ce5a))
+* **sdk:** add `_response` to response models to finally fix duplicated names ([5c7462d](https://github.com/isaacus-dev/isaacus-python/commit/5c7462dd25c67c44126eb946a656a6b841dc6a50))
+
+
+### Chores
+
+* **api:** try to force regen SDK ([2fafb55](https://github.com/isaacus-dev/isaacus-python/commit/2fafb555c1a20d7c359c91c35fd1f54868cffe54))
+* do not install brew dependencies in ./scripts/bootstrap by default ([57b055e](https://github.com/isaacus-dev/isaacus-python/commit/57b055ed56fdcc58b4663e4ddad32afac25e7ec1))
+* improve example values ([35b03bd](https://github.com/isaacus-dev/isaacus-python/commit/35b03bdbf4ceaccd00102e23d639a01d5bea136a))
+* **internal:** add Sequence related utils ([5a2287e](https://github.com/isaacus-dev/isaacus-python/commit/5a2287ef854d250048c070f3fd88b00ca84b0d3c))
+* **internal:** change ci workflow machines ([f86cbce](https://github.com/isaacus-dev/isaacus-python/commit/f86cbcef2583658466e95eaba4aba61f79646ef9))
+* **internal:** codegen related update ([22b520b](https://github.com/isaacus-dev/isaacus-python/commit/22b520b3c67e570f9267135111a89542ee2bdf7f))
+* **internal:** fix ruff target version ([889d576](https://github.com/isaacus-dev/isaacus-python/commit/889d576cdc28d06404c6ee3ce0c67bf4d3be75c4))
+* **internal:** move mypy configurations to `pyproject.toml` file ([d5732d5](https://github.com/isaacus-dev/isaacus-python/commit/d5732d5e0145763723e8be24cbd8296f9a385264))
+* **internal:** update comment in script ([7af966e](https://github.com/isaacus-dev/isaacus-python/commit/7af966e1677b44d412eda96c5ee8e9866f77ccfb))
+* **internal:** update pydantic dependency ([68a7057](https://github.com/isaacus-dev/isaacus-python/commit/68a70578a2e269fa3b2c46e3c29e82ba770090d6))
+* **internal:** update pyright exclude list ([6f0ae86](https://github.com/isaacus-dev/isaacus-python/commit/6f0ae86899883fe77aa669d595c623bedc2dc5c8))
+* remove custom code ([491dbdc](https://github.com/isaacus-dev/isaacus-python/commit/491dbdcd82984d099b8ee11e94894ad450b2424d))
+* **sdk:** restore original example ([079645e](https://github.com/isaacus-dev/isaacus-python/commit/079645e85259c2e4d3f6aa86b2ca2c21ce97367a))
+* **tests:** simplify `get_platform` test ([e00ccd0](https://github.com/isaacus-dev/isaacus-python/commit/e00ccd0c41c3751eb3fae880223ebb05eae0f154))
+* **types:** change optional parameter type from NotGiven to Omit ([38d13e0](https://github.com/isaacus-dev/isaacus-python/commit/38d13e0514b001d1a34446b881783d559e246865))
+* update @stainless-api/prism-cli to v5.15.0 ([a3141f5](https://github.com/isaacus-dev/isaacus-python/commit/a3141f59b0ff6334fde2a9740fd2f86824fe5083))
+* update github action ([0518028](https://github.com/isaacus-dev/isaacus-python/commit/05180288265bc111dba1c62fbfcd90139a6299ad))
+
+
+### Documentation
+
+* **sdk:** make embeddings example first ([caa70f7](https://github.com/isaacus-dev/isaacus-python/commit/caa70f7acf6ce910d8cf80425437ca51970cd255))
+
+## 0.8.0 (2025-07-25)
+
+Full Changelog: [v0.7.0...v0.8.0](https://github.com/isaacus-dev/isaacus-python/compare/v0.7.0...v0.8.0)
+
+### Features
+
+* clean up environment call outs ([3ee6948](https://github.com/isaacus-dev/isaacus-python/commit/3ee69481b6a6198503d06c6aa137ba69f7940db6))
+* **client:** add support for aiohttp ([fba17e9](https://github.com/isaacus-dev/isaacus-python/commit/fba17e98279aa6d93dd3c9b6f9b95246b4fac813))
+
+
+### Bug Fixes
+
+* **ci:** correct conditional ([53c81d9](https://github.com/isaacus-dev/isaacus-python/commit/53c81d9e14882ae83a72c15481c8933226e668fa))
+* **ci:** release-doctor — report correct token name ([3cb8672](https://github.com/isaacus-dev/isaacus-python/commit/3cb8672052edf1d1c4e72a5866fde3776d43a4e2))
+* **client:** correctly parse binary response | stream ([5e316fe](https://github.com/isaacus-dev/isaacus-python/commit/5e316feaf5270e54321a917a9cd59efb2c42fcb3))
+* **client:** don't send Content-Type header on GET requests ([2a5d531](https://github.com/isaacus-dev/isaacus-python/commit/2a5d531e7553aa012352d9dd85d280f4374b7ae7))
+* **parsing:** correctly handle nested discriminated unions ([c5d5715](https://github.com/isaacus-dev/isaacus-python/commit/c5d571569cdafad9bd1392baf232287dca72855d))
+* **parsing:** ignore empty metadata ([dd88d17](https://github.com/isaacus-dev/isaacus-python/commit/dd88d179302966445c63831f4b6f20491fe5632e))
+* **parsing:** parse extra field types ([ba334c7](https://github.com/isaacus-dev/isaacus-python/commit/ba334c75676c37da235abfddd7c9746f89307c22))
+* **tests:** fix: tests which call HTTP endpoints directly with the example parameters ([638c7c4](https://github.com/isaacus-dev/isaacus-python/commit/638c7c4df7ecbc189480a0cba2d93125f9b97d2f))
+
+
+### Chores
+
+* **ci:** change upload type ([e79525c](https://github.com/isaacus-dev/isaacus-python/commit/e79525c4ffe9601c3b7c5e39a94c93c248cfbf33))
+* **ci:** enable for pull requests ([29244fd](https://github.com/isaacus-dev/isaacus-python/commit/29244fdb33a5706480e1c7314099a14ae177ee06))
+* **ci:** only run for pushes and fork pull requests ([94ed1eb](https://github.com/isaacus-dev/isaacus-python/commit/94ed1ebf9fc4111236f1db2a5d326f081079bdc8))
+* **internal:** bump pinned h11 dep ([5836163](https://github.com/isaacus-dev/isaacus-python/commit/58361635226de79f5ff27e953ec03dfeb392b3e0))
+* **internal:** codegen related update ([cdfe0be](https://github.com/isaacus-dev/isaacus-python/commit/cdfe0beceeeaa21e4a24b6cdc86264dcaa3808f1))
+* **internal:** update conftest.py ([e4a5936](https://github.com/isaacus-dev/isaacus-python/commit/e4a59368bd7d42d65fd368b03a208b2aa32a9144))
+* **package:** mark python 3.13 as supported ([0f7b5d1](https://github.com/isaacus-dev/isaacus-python/commit/0f7b5d1c588adf28b502727948dceaa9ed54ee86))
+* **project:** add settings file for vscode ([d6435b0](https://github.com/isaacus-dev/isaacus-python/commit/d6435b09a03f202867843ee83737b319ccef4ea6))
+* **readme:** fix version rendering on pypi ([b09f1ad](https://github.com/isaacus-dev/isaacus-python/commit/b09f1ad5ce2624d23a32fc1d966f7d9703cd4ad3))
+* **readme:** update badges ([cd48569](https://github.com/isaacus-dev/isaacus-python/commit/cd485693063d03f092d5be7f024b0f7e23da0897))
+* **tests:** add tests for httpx client instantiation & proxies ([5d2c5b9](https://github.com/isaacus-dev/isaacus-python/commit/5d2c5b9e20bd80acd05240217b6be3991b46aae2))
+* **tests:** run tests in parallel ([3f0e6da](https://github.com/isaacus-dev/isaacus-python/commit/3f0e6da6d9c6d9cd46cfa382da55a0b6a07d9d49))
+* **tests:** skip some failing tests on the latest python versions ([b2b3fa8](https://github.com/isaacus-dev/isaacus-python/commit/b2b3fa82b87e9cc7e23164cc5589b3e157e635df))
+
+
+### Documentation
+
+* **client:** fix httpx.Timeout documentation reference ([b68d394](https://github.com/isaacus-dev/isaacus-python/commit/b68d3944df0ca58b7df3e89e06e90799f7ade25b))
+
 ## 0.7.0 (2025-06-03)
 
 Full Changelog: [v0.6.1...v0.7.0](https://github.com/isaacus-dev/isaacus-python/compare/v0.6.1...v0.7.0)

{isaacus-0.7.0 → isaacus-0.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: isaacus
-Version: 0.7.0
+Version: 0.9.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
@@ -18,6 +18,7 @@ Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Typing :: Typed
 Requires-Python: >=3.8
@@ -27,11 +28,15 @@ Requires-Dist: httpx<1,>=0.23.0
 Requires-Dist: pydantic<3,>=1.9.0
 Requires-Dist: sniffio
 Requires-Dist: typing-extensions<5,>=4.10
+Provides-Extra: aiohttp
+Requires-Dist: aiohttp; extra == 'aiohttp'
+Requires-Dist: httpx-aiohttp>=0.1.8; extra == 'aiohttp'
 Description-Content-Type: text/markdown
 
 # Isaacus Python API library
 
-[![PyPI version](https://img.shields.io/pypi/v/isaacus.svg)](https://pypi.org/project/isaacus/)
+<!-- prettier-ignore -->
+[![PyPI version](https://img.shields.io/pypi/v/isaacus.svg?label=pypi%20(stable))](https://pypi.org/project/isaacus/)
 
 The Isaacus Python library provides convenient access to the Isaacus REST API from any Python 3.8+
 application. The library includes type definitions for all request params and response fields,
@@ -62,12 +67,14 @@ client = Isaacus(
     api_key=os.environ.get("ISAACUS_API_KEY"),  # This is the default and can be omitted
 )
 
-universal_classification = client.classifications.universal.create(
-    model="kanon-universal-classifier",
-    query="This is a confidentiality clause.",
-    texts=["I agree not to tell anyone about the document."],
+embedding_response = client.embeddings.create(
+    model="kanon-2-embedder",
+    texts=[
+        "Are restraints of trade enforceable under English law?",
+        "What is a non-compete clause?",
+    ],
 )
-print(universal_classification.classifications)
+print(embedding_response.embeddings)
 ```
 
 While you can provide an `api_key` keyword argument,
@@ -90,12 +97,14 @@ client = AsyncIsaacus(
 
 
 async def main() -> None:
-    universal_classification = await client.classifications.universal.create(
-        model="kanon-universal-classifier",
-        query="This is a confidentiality clause.",
-        texts=["I agree not to tell anyone about the document."],
+    embedding_response = await client.embeddings.create(
+        model="kanon-2-embedder",
+        texts=[
+            "Are restraints of trade enforceable under English law?",
+            "What is a non-compete clause?",
+        ],
     )
-    print(universal_classification.classifications)
+    print(embedding_response.embeddings)
 
 
 asyncio.run(main())
@@ -103,6 +112,43 @@ asyncio.run(main())
 
 Functionality between the synchronous and asynchronous clients is otherwise identical.
 
+### With aiohttp
+
+By default, the async client uses `httpx` for HTTP requests. However, for improved concurrency performance you may also use `aiohttp` as the HTTP backend.
+
+You can enable this by installing `aiohttp`:
+
+```sh
+# install from PyPI
+pip install isaacus[aiohttp]
+```
+
+Then you can enable it by instantiating the client with `http_client=DefaultAioHttpClient()`:
+
+```python
+import asyncio
+from isaacus import DefaultAioHttpClient
+from isaacus import AsyncIsaacus
+
+
+async def main() -> None:
+    async with AsyncIsaacus(
+        api_key="My API Key",
+        http_client=DefaultAioHttpClient(),
+    ) as client:
+        embedding_response = await client.embeddings.create(
+            model="kanon-2-embedder",
+            texts=[
+                "Are restraints of trade enforceable under English law?",
+                "What is a non-compete clause?",
+            ],
+        )
+        print(embedding_response.embeddings)
+
+
+asyncio.run(main())
+```
+
 ## Using types
 
 Nested request parameters are [TypedDicts](https://docs.python.org/3/library/typing.html#typing.TypedDict). Responses are [Pydantic models](https://docs.pydantic.dev) which also provide helper methods for things like:
@@ -121,7 +167,7 @@ from isaacus import Isaacus
 
 client = Isaacus()
 
-universal_classification = client.classifications.universal.create(
+universal_classification_response = client.classifications.universal.create(
     model="kanon-universal-classifier",
     query="This is a confidentiality clause.",
     texts=["I agree not to tell anyone about the document."],
@@ -131,7 +177,7 @@ universal_classification = client.classifications.universal.create(
         "size": 512,
     },
 )
-print(universal_classification.classifications)
+print(universal_classification_response.classifications)
 ```
 
 ## Handling errors
@@ -150,10 +196,12 @@ from isaacus import Isaacus
 client = Isaacus()
 
 try:
-    client.classifications.universal.create(
-        model="kanon-universal-classifier",
-        query="This is a confidentiality clause.",
-        texts=["I agree not to tell anyone about the document."],
+    client.embeddings.create(
+        model="kanon-2-embedder",
+        texts=[
+            "Are restraints of trade enforceable under English law?",
+            "What is a non-compete clause?",
+        ],
     )
 except isaacus.APIConnectionError as e:
     print("The server could not be reached")
@@ -197,17 +245,19 @@ client = Isaacus(
 )
 
 # Or, configure per-request:
-client.with_options(max_retries=5).classifications.universal.create(
-    model="kanon-universal-classifier",
-    query="This is a confidentiality clause.",
-    texts=["I agree not to tell anyone about the document."],
+client.with_options(max_retries=5).embeddings.create(
+    model="kanon-2-embedder",
+    texts=[
+        "Are restraints of trade enforceable under English law?",
+        "What is a non-compete clause?",
+    ],
 )
 ```
 
 ### Timeouts
 
 By default requests time out after 1 minute. You can configure this with a `timeout` option,
-which accepts a float or an [`httpx.Timeout`](https://www.python-httpx.org/advanced/#fine-tuning-the-configuration) object:
+which accepts a float or an [`httpx.Timeout`](https://www.python-httpx.org/advanced/timeouts/#fine-tuning-the-configuration) object:
 
 ```python
 from isaacus import Isaacus
@@ -224,10 +274,12 @@ client = Isaacus(
 )
 
 # Override per-request:
-client.with_options(timeout=5.0).classifications.universal.create(
-    model="kanon-universal-classifier",
-    query="This is a confidentiality clause.",
-    texts=["I agree not to tell anyone about the document."],
+client.with_options(timeout=5.0).embeddings.create(
+    model="kanon-2-embedder",
+    texts=[
+        "Are restraints of trade enforceable under English law?",
+        "What is a non-compete clause?",
+    ],
 )
 ```
 
@@ -269,15 +321,14 @@ The "raw" Response object can be accessed by prefixing `.with_raw_response.` to
 from isaacus import Isaacus
 
 client = Isaacus()
-response = client.classifications.universal.with_raw_response.create(
-    model="kanon-universal-classifier",
-    query="This is a confidentiality clause.",
-    texts=["I agree not to tell anyone about the document."],
+response = client.embeddings.with_raw_response.create(
+    model="kanon-2-embedder",
+    texts=["Are restraints of trade enforceable under English law?", "What is a non-compete clause?"],
 )
 print(response.headers.get('X-My-Header'))
 
-universal = response.parse()  # get the object that `classifications.universal.create()` would have returned
-print(universal.classifications)
+embedding = response.parse()  # get the object that `embeddings.create()` would have returned
+print(embedding.embeddings)
 ```
 
 These methods return an [`APIResponse`](https://github.com/isaacus-dev/isaacus-python/tree/main/src/isaacus/_response.py) object.
@@ -291,10 +342,12 @@ The above interface eagerly reads the full response body when you make the reque
 To stream the response body, use `.with_streaming_response` instead, which requires a context manager and only reads the response body once you call `.read()`, `.text()`, `.json()`, `.iter_bytes()`, `.iter_text()`, `.iter_lines()` or `.parse()`. In the async client, these are async methods.
 
 ```python
-with client.classifications.universal.with_streaming_response.create(
-    model="kanon-universal-classifier",
-    query="This is a confidentiality clause.",
-    texts=["I agree not to tell anyone about the document."],
+with client.embeddings.with_streaming_response.create(
+    model="kanon-2-embedder",
+    texts=[
+        "Are restraints of trade enforceable under English law?",
+        "What is a non-compete clause?",
+    ],
 ) as response:
     print(response.headers.get("X-My-Header"))
 

{isaacus-0.7.0 → isaacus-0.9.0}/README.md

@@ -1,6 +1,7 @@
 # Isaacus Python API library
 
-[![PyPI version](https://img.shields.io/pypi/v/isaacus.svg)](https://pypi.org/project/isaacus/)
+<!-- prettier-ignore -->
+[![PyPI version](https://img.shields.io/pypi/v/isaacus.svg?label=pypi%20(stable))](https://pypi.org/project/isaacus/)
 
 The Isaacus Python library provides convenient access to the Isaacus REST API from any Python 3.8+
 application. The library includes type definitions for all request params and response fields,
@@ -31,12 +32,14 @@ client = Isaacus(
     api_key=os.environ.get("ISAACUS_API_KEY"),  # This is the default and can be omitted
 )
 
-universal_classification = client.classifications.universal.create(
-    model="kanon-universal-classifier",
-    query="This is a confidentiality clause.",
-    texts=["I agree not to tell anyone about the document."],
+embedding_response = client.embeddings.create(
+    model="kanon-2-embedder",
+    texts=[
+        "Are restraints of trade enforceable under English law?",
+        "What is a non-compete clause?",
+    ],
 )
-print(universal_classification.classifications)
+print(embedding_response.embeddings)
 ```
 
 While you can provide an `api_key` keyword argument,
@@ -59,12 +62,14 @@ client = AsyncIsaacus(
 
 
 async def main() -> None:
-    universal_classification = await client.classifications.universal.create(
-        model="kanon-universal-classifier",
-        query="This is a confidentiality clause.",
-        texts=["I agree not to tell anyone about the document."],
+    embedding_response = await client.embeddings.create(
+        model="kanon-2-embedder",
+        texts=[
+            "Are restraints of trade enforceable under English law?",
+            "What is a non-compete clause?",
+        ],
     )
-    print(universal_classification.classifications)
+    print(embedding_response.embeddings)
 
 
 asyncio.run(main())
@@ -72,6 +77,43 @@ asyncio.run(main())
 
 Functionality between the synchronous and asynchronous clients is otherwise identical.
 
+### With aiohttp
+
+By default, the async client uses `httpx` for HTTP requests. However, for improved concurrency performance you may also use `aiohttp` as the HTTP backend.
+
+You can enable this by installing `aiohttp`:
+
+```sh
+# install from PyPI
+pip install isaacus[aiohttp]
+```
+
+Then you can enable it by instantiating the client with `http_client=DefaultAioHttpClient()`:
+
+```python
+import asyncio
+from isaacus import DefaultAioHttpClient
+from isaacus import AsyncIsaacus
+
+
+async def main() -> None:
+    async with AsyncIsaacus(
+        api_key="My API Key",
+        http_client=DefaultAioHttpClient(),
+    ) as client:
+        embedding_response = await client.embeddings.create(
+            model="kanon-2-embedder",
+            texts=[
+                "Are restraints of trade enforceable under English law?",
+                "What is a non-compete clause?",
+            ],
+        )
+        print(embedding_response.embeddings)
+
+
+asyncio.run(main())
+```
+
 ## Using types
 
 Nested request parameters are [TypedDicts](https://docs.python.org/3/library/typing.html#typing.TypedDict). Responses are [Pydantic models](https://docs.pydantic.dev) which also provide helper methods for things like:
@@ -90,7 +132,7 @@ from isaacus import Isaacus
 
 client = Isaacus()
 
-universal_classification = client.classifications.universal.create(
+universal_classification_response = client.classifications.universal.create(
     model="kanon-universal-classifier",
     query="This is a confidentiality clause.",
     texts=["I agree not to tell anyone about the document."],
@@ -100,7 +142,7 @@ universal_classification = client.classifications.universal.create(
         "size": 512,
     },
 )
-print(universal_classification.classifications)
+print(universal_classification_response.classifications)
 ```
 
 ## Handling errors
@@ -119,10 +161,12 @@ from isaacus import Isaacus
 client = Isaacus()
 
 try:
-    client.classifications.universal.create(
-        model="kanon-universal-classifier",
-        query="This is a confidentiality clause.",
-        texts=["I agree not to tell anyone about the document."],
+    client.embeddings.create(
+        model="kanon-2-embedder",
+        texts=[
+            "Are restraints of trade enforceable under English law?",
+            "What is a non-compete clause?",
+        ],
     )
 except isaacus.APIConnectionError as e:
     print("The server could not be reached")
@@ -166,17 +210,19 @@ client = Isaacus(
 )
 
 # Or, configure per-request:
-client.with_options(max_retries=5).classifications.universal.create(
-    model="kanon-universal-classifier",
-    query="This is a confidentiality clause.",
-    texts=["I agree not to tell anyone about the document."],
+client.with_options(max_retries=5).embeddings.create(
+    model="kanon-2-embedder",
+    texts=[
+        "Are restraints of trade enforceable under English law?",
+        "What is a non-compete clause?",
+    ],
 )
 ```
 
 ### Timeouts
 
 By default requests time out after 1 minute. You can configure this with a `timeout` option,
-which accepts a float or an [`httpx.Timeout`](https://www.python-httpx.org/advanced/#fine-tuning-the-configuration) object:
+which accepts a float or an [`httpx.Timeout`](https://www.python-httpx.org/advanced/timeouts/#fine-tuning-the-configuration) object:
 
 ```python
 from isaacus import Isaacus
@@ -193,10 +239,12 @@ client = Isaacus(
 )
 
 # Override per-request:
-client.with_options(timeout=5.0).classifications.universal.create(
-    model="kanon-universal-classifier",
-    query="This is a confidentiality clause.",
-    texts=["I agree not to tell anyone about the document."],
+client.with_options(timeout=5.0).embeddings.create(
+    model="kanon-2-embedder",
+    texts=[
+        "Are restraints of trade enforceable under English law?",
+        "What is a non-compete clause?",
+    ],
 )
 ```
 
@@ -238,15 +286,14 @@ The "raw" Response object can be accessed by prefixing `.with_raw_response.` to
 from isaacus import Isaacus
 
 client = Isaacus()
-response = client.classifications.universal.with_raw_response.create(
-    model="kanon-universal-classifier",
-    query="This is a confidentiality clause.",
-    texts=["I agree not to tell anyone about the document."],
+response = client.embeddings.with_raw_response.create(
+    model="kanon-2-embedder",
+    texts=["Are restraints of trade enforceable under English law?", "What is a non-compete clause?"],
 )
 print(response.headers.get('X-My-Header'))
 
-universal = response.parse()  # get the object that `classifications.universal.create()` would have returned
-print(universal.classifications)
+embedding = response.parse()  # get the object that `embeddings.create()` would have returned
+print(embedding.embeddings)
 ```
 
 These methods return an [`APIResponse`](https://github.com/isaacus-dev/isaacus-python/tree/main/src/isaacus/_response.py) object.
@@ -260,10 +307,12 @@ The above interface eagerly reads the full response body when you make the reque
 To stream the response body, use `.with_streaming_response` instead, which requires a context manager and only reads the response body once you call `.read()`, `.text()`, `.json()`, `.iter_bytes()`, `.iter_text()`, `.iter_lines()` or `.parse()`. In the async client, these are async methods.
 
 ```python
-with client.classifications.universal.with_streaming_response.create(
-    model="kanon-universal-classifier",
-    query="This is a confidentiality clause.",
-    texts=["I agree not to tell anyone about the document."],
+with client.embeddings.with_streaming_response.create(
+    model="kanon-2-embedder",
+    texts=[
+        "Are restraints of trade enforceable under English law?",
+        "What is a non-compete clause?",
+    ],
 ) as response:
     print(response.headers.get("X-My-Header"))
 

{isaacus-0.7.0 → isaacus-0.9.0}/api.md

@@ -1,3 +1,15 @@
+# Embeddings
+
+Types:
+
+```python
+from isaacus.types import EmbeddingResponse
+```
+
+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_response.py">EmbeddingResponse</a></code>
+
 # Classifications
 
 ## Universal
@@ -5,24 +17,24 @@
 Types:
 
 ```python
-from isaacus.types.classifications import UniversalClassification
+from isaacus.types.classifications import UniversalClassificationResponse
 ```
 
 Methods:
 
-- <code title="post /classifications/universal">client.classifications.universal.<a href="./src/isaacus/resources/classifications/universal.py">create</a>(\*\*<a href="src/isaacus/types/classifications/universal_create_params.py">params</a>) -> <a href="./src/isaacus/types/classifications/universal_classification.py">UniversalClassification</a></code>
+- <code title="post /classifications/universal">client.classifications.universal.<a href="./src/isaacus/resources/classifications/universal.py">create</a>(\*\*<a href="src/isaacus/types/classifications/universal_create_params.py">params</a>) -> <a href="./src/isaacus/types/classifications/universal_classification_response.py">UniversalClassificationResponse</a></code>
 
 # Rerankings
 
 Types:
 
 ```python
-from isaacus.types import Reranking
+from isaacus.types import RerankingResponse
 ```
 
 Methods:
 
-- <code title="post /rerankings">client.rerankings.<a href="./src/isaacus/resources/rerankings.py">create</a>(\*\*<a href="src/isaacus/types/reranking_create_params.py">params</a>) -> <a href="./src/isaacus/types/reranking.py">Reranking</a></code>
+- <code title="post /rerankings">client.rerankings.<a href="./src/isaacus/resources/rerankings.py">create</a>(\*\*<a href="src/isaacus/types/reranking_create_params.py">params</a>) -> <a href="./src/isaacus/types/reranking_response.py">RerankingResponse</a></code>
 
 # Extractions
 
@@ -31,9 +43,9 @@ Methods:
 Types:
 
 ```python
-from isaacus.types.extractions import AnswerExtraction
+from isaacus.types.extractions import AnswerExtractionResponse
 ```
 
 Methods:
 
-- <code title="post /extractions/qa">client.extractions.qa.<a href="./src/isaacus/resources/extractions/qa.py">create</a>(\*\*<a href="src/isaacus/types/extractions/qa_create_params.py">params</a>) -> <a href="./src/isaacus/types/extractions/answer_extraction.py">AnswerExtraction</a></code>
+- <code title="post /extractions/qa">client.extractions.qa.<a href="./src/isaacus/resources/extractions/qa.py">create</a>(\*\*<a href="src/isaacus/types/extractions/qa_create_params.py">params</a>) -> <a href="./src/isaacus/types/extractions/answer_extraction_response.py">AnswerExtractionResponse</a></code>

{isaacus-0.7.0 → isaacus-0.9.0}/bin/check-release-environment

@@ -3,7 +3,7 @@
 errors=()
 
 if [ -z "${PYPI_TOKEN}" ]; then
-  errors+=("The ISAACUS_PYPI_TOKEN secret has not been set. Please set it in either this repository's secrets or your organization secrets.")
+  errors+=("The PYPI_TOKEN secret has not been set. Please set it in either this repository's secrets or your organization secrets.")
 fi
 
 lenErrors=${#errors[@]}