isaacus 0.10.1__py3-none-any.whl → 0.12.0__py3-none-any.whl

isaacus/types/ilgs_v1_person.py

@@ -0,0 +1,195 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+from typing_extensions import Literal
+
+from .._models import BaseModel
+from .ilgs_v1_span import ILGSv1Span
+
+__all__ = ["ILGSv1Person"]
+
+
+class ILGSv1Person(BaseModel):
+    """A legal person identified in a document."""
+
+    id: str
+    """
+    The unique identifier of the person in the format `per:{index}` where `{index}`
+    is a non-negative incrementing integer starting from zero.
+    """
+
+    name: ILGSv1Span
+    """A zero-based, half-open span into the Unicode code point space of input text.
+
+    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.
+
+    A span cannot be empty and will never start or end at whitespace.
+
+    Note that, 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).
+    """
+
+    type: Literal["natural", "corporate", "politic"]
+    """
+    The legal entity type of the person, being one of `natural`, `corporate`, or
+    `politic`.
+
+    `natural` denotes a human being in their capacity as a natural legal person,
+    including when representing unincorporated entities such as partnerships and
+    trusts.
+
+    `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.
+    """
+
+    role: Literal[
+        "plaintiff",
+        "petitioner",
+        "applicant",
+        "appellant",
+        "appellee",
+        "claimant",
+        "complainant",
+        "defendant",
+        "respondent",
+        "prior_authority",
+        "prosecutor",
+        "defense_counsel",
+        "amicus",
+        "intervener",
+        "borrower",
+        "lender",
+        "guarantor",
+        "lessee",
+        "lessor",
+        "employer",
+        "employee",
+        "licensor",
+        "licensee",
+        "franchisor",
+        "franchisee",
+        "buyer",
+        "seller",
+        "contractor",
+        "shareholder",
+        "joint_venturer",
+        "investor",
+        "insurer",
+        "insured",
+        "enacting_authority",
+        "empowered_authority",
+        "settlor",
+        "trustee",
+        "beneficiary",
+        "debater",
+        "director",
+        "governing_jurisdiction",
+        "clerk",
+        "witness",
+        "other",
+        "non_party",
+    ]
+    """The role of the person in relation to the subject of the document.
+
+    The following roles are currently supported: | | | | ------------------------ |
+    ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
+    | | `plaintiff` | A party initiating the case that is the subject of the
+    document. | | `petitioner` | A party initiating the petition that is the subject
+    of the document. | | `applicant` | A party initiating the application that is
+    the subject of the document. | | `appellant` | A party appealing the decision
+    that is the subject of the document. | | `appellee` | A party responding to the
+    appeal that is the subject of the document if they are explicitly referred to as
+    an 'appellee'. | | `claimant` | A party making a claim in the case that is the
+    subject of the document. | | `complainant` | A party making a complaint in the
+    case that is the subject of the document. | | `defendant` | A party defending
+    against the case that is the subject of the document. | | `respondent` | A party
+    responding to the petition, appeal, or application that is the subject of the
+    document. | | `prior_authority` | An authority (e.g., judge, tribunal, court)
+    that made a prior decision in the case that is the subject of the document. Both
+    individual judges and courts should be annotated with this role where
+    applicable. This is not to be used for authorities cited as precedent, only for
+    those that made prior decisions in the same case. | | `prosecutor` | A lawyer
+    prosecuting the case that is the subject of the document. | | `defense_counsel`
+    | A lawyer defending the case that is the subject of the document. | | `amicus`
+    | A party filing an amicus curiae brief in the case that is the subject of the
+    document. | | `intervener` | A party attempting to or that has intervened in the
+    case that is the subject of the document. | | `borrower` | A party borrowing
+    money or other assets under the agreement that is the subject of the document,
+    including 'mortgagors' and 'debtors'. | | `lender` | A party lending money or
+    other assets under the agreement that is the subject of the document, including
+    'mortgagees' and 'creditors'. | | `guarantor` | A party guaranteeing obligations
+    under the agreement that is the subject of the document, including 'sureties'. |
+    | `lessee` | A party leasing goods or services under the agreement that is the
+    subject of the document, including 'tenants'. | | `lessor` | A party leasing
+    goods or services under the agreement that is the subject of the document,
+    including 'landlords'. | | `employer` | A party employing personnel under the
+    agreement that is the subject of the document. | | `employee` | A party employed
+    under the agreement that is the subject of the document. | | `licensor` | A
+    party licensing intellectual property or other rights under the agreement that
+    are the subject of the document. | | `licensee` | A party licensed to use
+    intellectual property or other rights under the agreement that are the subject
+    of the document. | | `franchisor` | A party granting a franchise under the
+    agreement that is the subject of the document. | | `franchisee` | A party
+    granted a franchise under the agreement that is the subject of the document. | |
+    `buyer` | A party purchasing goods or services under the agreement that is the
+    subject of the document, including 'purchasers', 'customers', and 'clients'. | |
+    `seller` | A party selling or providing goods or services under the agreement
+    that is the subject of the document, including 'Vendors', 'Suppliers', and
+    'Service Providers' (where such parties are actually providing goods or services
+    under the agreement). | | `contractor` | A party contracted to perform work or
+    services under the agreement that is the subject of the document, including
+    'consultants'. | | `shareholder` | A party holding shares or equity under the
+    agreement that is the subject of the document. | | `joint_venturer` | A party
+    participating in a joint venture under the agreement that is the subject of the
+    document. | | `investor` | A party investing money or assets under the agreement
+    that is the subject of the document. | | `insurer` | A party providing insurance
+    under the agreement that is the subject of the document. | | `insured` | A party
+    insured under the agreement that is the subject of the document. | | `settlor` |
+    A party establishing the trust that is the subject of the document. | |
+    `trustee` | A party managing the trust that is the subject of the document. | |
+    `beneficiary` | A party benefiting from the trust that is the subject of the
+    document. | | `enacting_authority` | An authority (e.g., legislature, regulator,
+    Minister/Secretary, President/Prime Minister, tribunal, court, judge) giving
+    legal effect to or authorizing the document. All relevant individuals and bodies
+    should be annotated with this role where applicable. | | `empowered_authority` |
+    An authority (e.g., government agency, regulator, Minister/Secretary,
+    President/Prime Minister, tribunal, court) empowered by the document to carry
+    out functions or duties. | | `debater` | A person participating in the debate
+    that is the subject of the document. | | `governing_jurisdiction` | The
+    jurisdiction whose laws govern the document. | | `director` | A director or
+    other officer of a corporate legal person mentioned in the document. | | `clerk`
+    | A clerk, notary, or other official certifying, witnessing, filing, recording,
+    registering, or otherwise administering the document. | | `witness` | A witness
+    witnessing the signing of the document, or whose testimony is part of the case
+    that is the subject of the document. | | `other` | A party to the case,
+    agreement, legislation, or regulation that is the subject of the document that
+    does not fit into any of the other roles. | | `non_party` | A legal person
+    mentioned in the document that is not a party to the case, agreement,
+    legislation, or regulation that is the subject of the document. |
+    """
+
+    parent: Optional[str] = None
+    """
+    A unique identifier for a legal person in the format `per:{index}` where
+    `{index}` is a non-negative incrementing integer starting from zero.
+    """
+
+    residence: Optional[str] = None
+    """
+    A unique identifier for a location in the format `loc:{index}` where `{index}`
+    is a non-negative incrementing integer starting from zero.
+    """
+
+    mentions: List[ILGSv1Span]
+    """
+    An array of one or more spans within the document's text where the person is
+    mentioned.
+    """

isaacus/types/ilgs_v1_phone_number.py

@@ -0,0 +1,30 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List
+
+from .._models import BaseModel
+from .ilgs_v1_span import ILGSv1Span
+
+__all__ = ["ILGSv1PhoneNumber"]
+
+
+class ILGSv1PhoneNumber(BaseModel):
+    """A valid phone number identified in a document belonging to a legal person.
+
+    If a phone number was mentioned in the document but is not valid, possible, or attributable to a legal person, it will not be extracted.
+    """
+
+    number: str
+    """
+    The normalized phone number in E.123 international notation conforming with
+    local conventions on the use of spaces and hyphens as separators.
+    """
+
+    person: str
+    """The unique identifier of the person that this phone number belongs to."""
+
+    mentions: List[ILGSv1Span]
+    """
+    An array of one or more spans within the document's text where the phone number
+    is mentioned.
+    """

isaacus/types/ilgs_v1_quote.py

@@ -0,0 +1,52 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+
+from .._models import BaseModel
+from .ilgs_v1_span import ILGSv1Span
+
+__all__ = ["ILGSv1Quote"]
+
+
+class ILGSv1Quote(BaseModel):
+    """A quotation within a document."""
+
+    source_segment: Optional[str] = None
+    """
+    A unique identifier for a segment in the format `seg:{index}` where `{index}` is
+    a non-negative incrementing integer starting from zero.
+    """
+
+    source_document: Optional[str] = None
+    """
+    A unique identifier for an external document in the format `exd:{index}` where
+    `{index}` is a non-negative incrementing integer starting from zero.
+    """
+
+    source_person: Optional[str] = None
+    """
+    A unique identifier for a legal person in the format `per:{index}` where
+    `{index}` is a non-negative incrementing integer starting from zero.
+    """
+
+    amending: bool
+    """
+    Whether the quote is being used to amend or modify content, typically in other
+    documents.
+    """
+
+    span: ILGSv1Span
+    """A zero-based, half-open span into the Unicode code point space of input text.
+
+    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.
+
+    A span cannot be empty and will never start or end at whitespace.
+
+    Note that, 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).
+    """

isaacus/types/ilgs_v1_segment.py

@@ -0,0 +1,205 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+from typing_extensions import Literal
+
+from .._models import BaseModel
+from .ilgs_v1_span import ILGSv1Span
+
+__all__ = ["ILGSv1Segment"]
+
+
+class ILGSv1Segment(BaseModel):
+    """
+    A segment within the document representing a structurally distinct portion of the document's content.
+    """
+
+    id: str
+    """
+    The unique identifier of the segment in the format `seg:{index}` where `{index}`
+    is a non-negative incrementing integer starting from zero.
+    """
+
+    kind: Literal["container", "unit", "item", "figure"]
+    """
+    The structural 'kind' of the segment, being one of `container`, `unit`, `item`,
+    or `figure`.
+
+    A `container` is a structural or semantic grouping of content such as a chapter.
+    It can contain segments of any kind or none at all.
+
+    A `unit` is a single syntactically independent unit of text such as a paragraph.
+    It can only contain `item`s and `figure`s.
+
+    An `item` is a syntactically subordinate unit of text such as an item in a
+    run-in list. It can only contain other `item`s. Note that an `item` is
+    conceptually distinct from a list item—it is perfectly possible to encounter
+    list items that are syntactically independent of their surrounding items just as
+    it is possible to encounter dependent clauses that do not appear as part of a
+    list.
+
+    A `figure` is a visually structured or tabular unit of content such as a
+    diagram, equation, or table. It cannot contain segments.
+    """
+
+    type: Optional[
+        Literal[
+            "title",
+            "book",
+            "part",
+            "chapter",
+            "subchapter",
+            "division",
+            "subdivision",
+            "subpart",
+            "subtitle",
+            "table_of_contents",
+            "article",
+            "section",
+            "regulation",
+            "rule",
+            "clause",
+            "paragraph",
+            "subarticle",
+            "subsection",
+            "subregulation",
+            "subrule",
+            "subclause",
+            "subparagraph",
+            "item",
+            "subitem",
+            "point",
+            "indent",
+            "schedule",
+            "annex",
+            "appendix",
+            "exhibit",
+            "recital",
+            "signature",
+            "note",
+            "figure",
+            "table",
+            "formula",
+        ]
+    ] = None
+    """
+    The addressable 'type' of the segment within the document's referential scheme
+    and hierarchy, whether defined explicitly (e.g., by headings, such as
+    'Section 2. Definitions'), implicitly (e.g., by way of reference, such as 'as
+    defined in Section 2'), or by convention (e.g., [42] in a judgment often denotes
+    a `paragraph`, independent provisions in statute are often `section`s, etc.). If
+    the type is not known or not applicable, it will be set to `null`.
+
+    Note that, although many segment types may coincide with syntactic constructs,
+    they should be thought of purely as distinct formal citable units. Most
+    paragraphs (in the syntactic sense) will not have the `paragraph` type, for
+    example. That type is reserved for segments that would formally be cited as a
+    'Paragraph' within the document's referential scheme.
+
+    The following types are currently supported: `title`, `book`, `part`, `chapter`,
+    `subchapter`, `division`, `subdivision`, `subpart`, `subtitle`,
+    `table_of_contents`, `article`, `section`, `regulation`, `rule`, `clause`,
+    `paragraph`, `subarticle`, `subsection`, `subregulation`, `subrule`,
+    `subclause`, `subparagraph`, `item`, `subitem`, `point`, `indent`, `schedule`,
+    `annex`, `appendix`, `exhibit`, `recital`, `signature`, `note`, `figure`,
+    `table`, and `formula`.
+
+    The `title`, `book`, `part`, `chapter`, `subchapter`, `division`, `subdivision`,
+    `subpart`, `subtitle`, and `table_of_contents` types are exclusive to the
+    `container` kind.
+
+    The `figure` kind only supports the `figure`, `table`, and `formula` types, all
+    of which are exclusive to it.
+    """
+
+    category: Literal["front_matter", "scope", "main", "annotation", "back_matter", "other"]
+    """
+    The functional 'category' of the segment within the document, being one of
+    `front_matter`, `scope`, `main`, `annotation`, `back_matter`, or `other`.
+
+    `front_matter` denotes non-operative contextualizing content occurring at the
+    start of a document such as a preamble or recitals.
+
+    `scope` denotes operative content defining the application or interpretation of
+    a document such as definition sections and governing law clauses.
+
+    `main` denotes operative, non-scopal content.
+
+    `annotation` denotes non-operative annotative content providing explanatory or
+    referential information such as commentary, footnotes, and endnotes.
+
+    `back_matter` denotes non-operative contextualizing content occurring at the end
+    of a document such as authority statements.
+
+    `other` denotes content that does not fit into any of the other categories.
+    """
+
+    type_name: Optional[ILGSv1Span] = None
+    """A zero-based, half-open span into the Unicode code point space of input text.
+
+    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.
+
+    A span cannot be empty and will never start or end at whitespace.
+
+    Note that, 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).
+    """
+
+    code: Optional[ILGSv1Span] = None
+    """A zero-based, half-open span into the Unicode code point space of input text.
+
+    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.
+
+    A span cannot be empty and will never start or end at whitespace.
+
+    Note that, 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).
+    """
+
+    title: Optional[ILGSv1Span] = None
+    """A zero-based, half-open span into the Unicode code point space of input text.
+
+    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.
+
+    A span cannot be empty and will never start or end at whitespace.
+
+    Note that, 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).
+    """
+
+    parent: Optional[str] = None
+    """
+    A unique identifier for a segment in the format `seg:{index}` where `{index}` is
+    a non-negative incrementing integer starting from zero.
+    """
+
+    span: ILGSv1Span
+    """A zero-based, half-open span into the Unicode code point space of input text.
+
+    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.
+
+    A span cannot be empty and will never start or end at whitespace.
+
+    Note that, 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).
+    """

isaacus/types/ilgs_v1_span.py

@@ -0,0 +1,28 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from .._models import BaseModel
+
+__all__ = ["ILGSv1Span"]
+
+
+class ILGSv1Span(BaseModel):
+    """A zero-based, half-open span into the Unicode code point space of input text.
+
+    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.
+
+    A span cannot be empty and will never start or end at whitespace.
+
+    Note that, 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).
+    """
+
+    start: int
+    """
+    The zero-based start index of the half-open span of Unicode code points in the
+    input text.
+    """
+
+    end: int
+    """
+    The zero-based end index of the half-open span (i.e., the end is exclusive) of
+    Unicode code points in the input text.
+    """

isaacus/types/ilgs_v1_term.py

@@ -0,0 +1,59 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List
+
+from .._models import BaseModel
+from .ilgs_v1_span import ILGSv1Span
+
+__all__ = ["ILGSv1Term"]
+
+
+class ILGSv1Term(BaseModel):
+    """A term assigned a definite meaning within a document."""
+
+    id: str
+    """
+    The unique identifier of the term in the format `term:{index}` where `{index}`
+    is a non-negative incrementing integer starting from zero.
+    """
+
+    name: ILGSv1Span
+    """A zero-based, half-open span into the Unicode code point space of input text.
+
+    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.
+
+    A span cannot be empty and will never start or end at whitespace.
+
+    Note that, 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).
+    """
+
+    meaning: ILGSv1Span
+    """A zero-based, half-open span into the Unicode code point space of input text.
+
+    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.
+
+    A span cannot be empty and will never start or end at whitespace.
+
+    Note that, 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).
+    """
+
+    mentions: List[ILGSv1Span]
+    """
+    An array of spans within the document's text where the term is mentioned outside
+    of its definition.
+
+    It is possible for the term to have no mentions if, outside of its definition,
+    it is never referred to in the document.
+    """

isaacus/types/ilgs_v1_website.py

@@ -0,0 +1,28 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List
+
+from .._models import BaseModel
+from .ilgs_v1_span import ILGSv1Span
+
+__all__ = ["ILGSv1Website"]
+
+
+class ILGSv1Website(BaseModel):
+    """A website identified in a document belonging to a legal person.
+
+    If a website was mentioned in the document but is not attributable to a legal person, it will not be extracted.
+    """
+
+    url: str
+    """The normalized URL of the website in the form `https://{host}/`."""
+
+    person: str
+    """The unique identifier of the person that this website belongs to."""
+
+    mentions: List[ILGSv1Span]
+    """
+    An array of one or more spans within the document's text where the website is
+    mentioned (including paths and slugs which are not part of the website's
+    normalized URL).
+    """

isaacus/types/reranking_create_params.py

@@ -34,8 +34,8 @@ class RerankingCreateParams(TypedDict, total=False):
     Each text must contain at least one non-whitespace character.
     """
 
-    chunking_options: Optional[ChunkingOptions]
-    """Options for how to split text into smaller chunks."""
+    top_n: Optional[int]
+    """A whole number greater than or equal to 1."""
 
     is_iql: bool
     """
@@ -62,18 +62,18 @@ class RerankingCreateParams(TypedDict, total=False):
     `chunk_min` uses the lowest relevance score of all of a text's chunks.
     """
 
-    top_n: Optional[int]
-    """A whole number greater than or equal to 1."""
+    chunking_options: Optional[ChunkingOptions]
+    """Options for how to split text into smaller chunks."""
 
 
 class ChunkingOptions(TypedDict, total=False):
     """Options for how to split text into smaller chunks."""
 
+    size: Optional[int]
+    """A whole number greater than or equal to 1."""
+
     overlap_ratio: Optional[float]
     """A number greater than or equal to 0 and less than 1."""
 
     overlap_tokens: Optional[int]
     """A whole number greater than or equal to 0."""
-
-    size: Optional[int]
-    """A whole number greater than or equal to 1."""

{isaacus-0.10.1.dist-info → isaacus-0.12.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: isaacus
-Version: 0.10.1
+Version: 0.12.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