isaacus-dev · umarbutler · Feb 7, 2026 · Feb 6, 2026 · Feb 7, 2026 · Feb 7, 2026
diff --git a/.release-please-manifest.json b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "0.17.0"
+  ".": "0.17.1"
 }
diff --git 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-fd2419c8cf8666e821f55c4cc5a5402900c443e2db59b3e53cfb46fd5bb52316.yml
+openapi_spec_hash: a92a4436234b019c9c23feb11b1f2f28
 config_hash: 9040e7359f066240ad536041fb2c5185
diff --git 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
@@ -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
@@ -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
diff --git a/src/isaacus/types/enrichment_response.py b/src/isaacus/types/enrichment_response.py
@@ -18,25 +18,12 @@ class Result(BaseModel):
     """
 
     document: Document
-    """The enriched document."""
-
-
-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).
+    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. 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
@@ -56,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
@@ -22,7 +22,21 @@
 
 
 class Document(BaseModel):
-    """The enriched document."""
+    """
+    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
     """The text of the document."""
@@ -73,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.
     """

diff --git 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[