From 27a7ced29864194a693b7ae3e72f75e77ebe55ee Mon Sep 17 00:00:00 2001 From: "stainless-app[bot]" <142633134+stainless-app[bot]@users.noreply.github.com> Date: Fri, 6 Feb 2026 03:42:49 +0000 Subject: [PATCH 1/6] docs(api): note docs are enriched into ilgs v1 --- .stats.yml | 4 ++-- src/isaacus/types/enrichment_response.py | 5 ++++- src/isaacus/types/ilgs/v1/document.py | 4 +++- 3 files changed, 9 insertions(+), 4 deletions(-) diff --git a/.stats.yml b/.stats.yml index c2ea1e0..0126540 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-a9cacf65cf152a5f4fdd8de8d28c979452c67c28a7e765075638b817d330d121.yml -openapi_spec_hash: 8343f878342e9d128695b85fecb93dc5 +openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/isaacus%2Fisaacus-3d30398ce36763aa90f81282ad98137f5c8165e5421b7ac3475557134557de86.yml +openapi_spec_hash: 7fda17ba5bd5e3d2b3d539e6d8660a3d config_hash: 9040e7359f066240ad536041fb2c5185 diff --git a/src/isaacus/types/enrichment_response.py b/src/isaacus/types/enrichment_response.py index 809bcf4..6ad0a75 100644 --- a/src/isaacus/types/enrichment_response.py +++ b/src/isaacus/types/enrichment_response.py @@ -18,7 +18,10 @@ class Result(BaseModel): """ document: Document - """The enriched document.""" + """ + The document enriched into version 1.0.0 of the Isaacus Legal Graph Schema + (ILGS). + """ class Usage(BaseModel): diff --git a/src/isaacus/types/ilgs/v1/document.py b/src/isaacus/types/ilgs/v1/document.py index 3481d46..6ad632c 100644 --- a/src/isaacus/types/ilgs/v1/document.py +++ b/src/isaacus/types/ilgs/v1/document.py @@ -22,7 +22,9 @@ class Document(BaseModel): - """The enriched document.""" + """ + The document enriched into version 1.0.0 of the Isaacus Legal Graph Schema (ILGS). + """ text: str """The text of the document.""" From 7c959e9c159cd22ccfbd7d608428ef2c0c9df921 Mon Sep 17 00:00:00 2001 From: "stainless-app[bot]" <142633134+stainless-app[bot]@users.noreply.github.com> Date: Sat, 7 Feb 2026 02:16:19 +0000 Subject: [PATCH 2/6] docs(api): move around attribute comments --- .stats.yml | 4 +-- src/isaacus/types/enrichment_response.py | 35 ++++++++++++------------ src/isaacus/types/ilgs/v1/document.py | 14 +++++++++- 3 files changed, 32 insertions(+), 21 deletions(-) diff --git a/.stats.yml b/.stats.yml index 0126540..7c255ac 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-3d30398ce36763aa90f81282ad98137f5c8165e5421b7ac3475557134557de86.yml -openapi_spec_hash: 7fda17ba5bd5e3d2b3d539e6d8660a3d +openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/isaacus%2Fisaacus-1ac4ab9a8019f580de9a0cdf695fc1d6e933e28d3421eaed6fbb108ef0f66d9e.yml +openapi_spec_hash: c5a97cf51cd410674412c8c509f3fcc5 config_hash: 9040e7359f066240ad536041fb2c5185 diff --git a/src/isaacus/types/enrichment_response.py b/src/isaacus/types/enrichment_response.py index 6ad0a75..41e8e38 100644 --- a/src/isaacus/types/enrichment_response.py +++ b/src/isaacus/types/enrichment_response.py @@ -20,26 +20,10 @@ class Result(BaseModel): document: Document """ The document enriched into version 1.0.0 of the Isaacus Legal Graph Schema - (ILGS). - """ - - -class Usage(BaseModel): - """Statistics about the usage of resources in the process of enriching the input.""" - - input_tokens: int - """The total number of tokens inputted to the model.""" - - -class EnrichmentResponse(BaseModel): - results: List[Result] - """ - The input documents enriched into version 1.0.0 of the Isaacus Legal Graph - Schema (IGLS). + (IGLS). All spans in an enriched document graph are indexed into the Unicode code point - space of a source document. Access to source documents is thus required to - resolve spans into text. + space of a source document. The start and end indices of spans are zero-based (i.e., the first Unicode code point in the document is at index 0) and half-open (i.e., the end index is @@ -59,5 +43,20 @@ class EnrichmentResponse(BaseModel): instead of Unicode code points). """ + +class Usage(BaseModel): + """Statistics about the usage of resources in the process of enriching the input.""" + + input_tokens: int + """The total number of tokens inputted to the model.""" + + +class EnrichmentResponse(BaseModel): + results: List[Result] + """ + The enriched documents alongside, and in order of, their indices in the input + array of texts. + """ + usage: Usage """Statistics about the usage of resources in the process of enriching the input.""" diff --git a/src/isaacus/types/ilgs/v1/document.py b/src/isaacus/types/ilgs/v1/document.py index 6ad632c..08ca581 100644 --- a/src/isaacus/types/ilgs/v1/document.py +++ b/src/isaacus/types/ilgs/v1/document.py @@ -23,7 +23,19 @@ class Document(BaseModel): """ - The document enriched into version 1.0.0 of the Isaacus Legal Graph Schema (ILGS). + The document enriched into version 1.0.0 of the Isaacus Legal Graph Schema (IGLS). + + All spans in an enriched document graph are indexed into the Unicode code point space of a source document. + + The start and end indices of spans are zero-based (i.e., the first Unicode code point in the document is at index 0) and half-open (i.e., the end index is exclusive). + + All spans are globally laminar and well-nested similar to XML—it is impossible for any two spans to partially overlap; they can only be disjoint, adjacent, or wholly nested. + + Spans of the exact same type (e.g., segments) will never be duplicated. + + Spans cannot be empty and will never start or end at whitespace. + + When using programming languages other than Python (which uses zero-based, half-open, Unicode code point-spaced string indexing), indices may need to be translated accordingly (for example, JavaScript slices into UTF-16 code units instead of Unicode code points). """ text: str From 5c31f2a090879eceef8d808c5d9684d6452289ef Mon Sep 17 00:00:00 2001 From: "stainless-app[bot]" <142633134+stainless-app[bot]@users.noreply.github.com> Date: Sat, 7 Feb 2026 02:32:30 +0000 Subject: [PATCH 3/6] docs(api): documented ILGS `contract` type --- .stats.yml | 4 ++-- src/isaacus/types/ilgs/v1/document.py | 2 ++ 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/.stats.yml b/.stats.yml index 7c255ac..c0c01a0 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-1ac4ab9a8019f580de9a0cdf695fc1d6e933e28d3421eaed6fbb108ef0f66d9e.yml -openapi_spec_hash: c5a97cf51cd410674412c8c509f3fcc5 +openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/isaacus%2Fisaacus-56aa7f7c98d3bc3e3c058e8a0bfea293ef83c2cec58775d3f22cfeee1b6883e4.yml +openapi_spec_hash: 8e3333a444404872b417b734e3a1856e config_hash: 9040e7359f066240ad536041fb2c5185 diff --git a/src/isaacus/types/ilgs/v1/document.py b/src/isaacus/types/ilgs/v1/document.py index 08ca581..dbd1845 100644 --- a/src/isaacus/types/ilgs/v1/document.py +++ b/src/isaacus/types/ilgs/v1/document.py @@ -87,6 +87,8 @@ class Document(BaseModel): `decision` denotes judicial or quasi-judicial decisions such as court judgments, judicial opinions, and tribunal rulings. + `contract` denotes contracts, covenants, and agreements. + `other` is used for all other types of legal documents that do not fit into any of the predefined types. """ From 8c481eef0f1a7e6f42bba929fe6070746d5bc222 Mon Sep 17 00:00:00 2001 From: "stainless-app[bot]" <142633134+stainless-app[bot]@users.noreply.github.com> Date: Sat, 7 Feb 2026 04:19:15 +0000 Subject: [PATCH 4/6] codegen metadata --- .stats.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/.stats.yml b/.stats.yml index c0c01a0..ad22992 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-56aa7f7c98d3bc3e3c058e8a0bfea293ef83c2cec58775d3f22cfeee1b6883e4.yml -openapi_spec_hash: 8e3333a444404872b417b734e3a1856e +openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/isaacus%2Fisaacus-50a24b0ce9e84227ad5bed58af4bdc4200ed7cd10d656c7b9967239c02eebe8a.yml +openapi_spec_hash: 4c411411227190163c5af5ba4532c78f config_hash: 9040e7359f066240ad536041fb2c5185 From 92e2ee6510a765a774fab72b2481b9aeb5b69ba0 Mon Sep 17 00:00:00 2001 From: "stainless-app[bot]" <142633134+stainless-app[bot]@users.noreply.github.com> Date: Sat, 7 Feb 2026 07:33:02 +0000 Subject: [PATCH 5/6] docs(api): alter def of politic person type --- .stats.yml | 4 ++-- src/isaacus/types/ilgs/v1/person.py | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/.stats.yml b/.stats.yml index ad22992..7df263c 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-50a24b0ce9e84227ad5bed58af4bdc4200ed7cd10d656c7b9967239c02eebe8a.yml -openapi_spec_hash: 4c411411227190163c5af5ba4532c78f +openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/isaacus%2Fisaacus-fd2419c8cf8666e821f55c4cc5a5402900c443e2db59b3e53cfb46fd5bb52316.yml +openapi_spec_hash: a92a4436234b019c9c23feb11b1f2f28 config_hash: 9040e7359f066240ad536041fb2c5185 diff --git a/src/isaacus/types/ilgs/v1/person.py b/src/isaacus/types/ilgs/v1/person.py index 3b1855f..38c9fdc 100644 --- a/src/isaacus/types/ilgs/v1/person.py +++ b/src/isaacus/types/ilgs/v1/person.py @@ -46,8 +46,8 @@ class Person(BaseModel): `corporate` denotes a body corporate such as a company, incorporated partnership, or statutory corporation. - `politic` denotes a body politic such as a court, state, government, or - intergovernmental organization. + `politic` denotes a body politic, political entity, or part thereof such as a + court, state, government, or intergovernmental organization. """ role: Literal[ From 03f1f76f2982adcad0bd7624f28a5c3e429a348d Mon Sep 17 00:00:00 2001 From: "stainless-app[bot]" <142633134+stainless-app[bot]@users.noreply.github.com> Date: Sat, 7 Feb 2026 07:33:19 +0000 Subject: [PATCH 6/6] release: 0.17.1 --- .release-please-manifest.json | 2 +- CHANGELOG.md | 11 +++++++++++ pyproject.toml | 2 +- src/isaacus/_version.py | 2 +- 4 files changed, 14 insertions(+), 3 deletions(-) diff --git a/.release-please-manifest.json b/.release-please-manifest.json index 6db19b9..463488b 100644 --- a/.release-please-manifest.json +++ b/.release-please-manifest.json @@ -1,3 +1,3 @@ { - ".": "0.17.0" + ".": "0.17.1" } \ No newline at end of file diff --git a/CHANGELOG.md b/CHANGELOG.md index 757914b..4f21e42 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,16 @@ # Changelog +## 0.17.1 (2026-02-07) + +Full Changelog: [v0.17.0...v0.17.1](https://github.com/isaacus-dev/isaacus-python/compare/v0.17.0...v0.17.1) + +### Documentation + +* **api:** alter def of politic person type ([92e2ee6](https://github.com/isaacus-dev/isaacus-python/commit/92e2ee6510a765a774fab72b2481b9aeb5b69ba0)) +* **api:** documented ILGS `contract` type ([5c31f2a](https://github.com/isaacus-dev/isaacus-python/commit/5c31f2a090879eceef8d808c5d9684d6452289ef)) +* **api:** move around attribute comments ([7c959e9](https://github.com/isaacus-dev/isaacus-python/commit/7c959e9c159cd22ccfbd7d608428ef2c0c9df921)) +* **api:** note docs are enriched into ilgs v1 ([27a7ced](https://github.com/isaacus-dev/isaacus-python/commit/27a7ced29864194a693b7ae3e72f75e77ebe55ee)) + ## 0.17.0 (2026-02-05) Full Changelog: [v0.16.0...v0.17.0](https://github.com/isaacus-dev/isaacus-python/compare/v0.16.0...v0.17.0) diff --git a/pyproject.toml b/pyproject.toml index 8112e7a..7e15307 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -1,6 +1,6 @@ [project] name = "isaacus" -version = "0.17.0" +version = "0.17.1" 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 52bc8e2..0f07b05 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.17.0" # x-release-please-version +__version__ = "0.17.1" # x-release-please-version