feat(api): add extract endpoint enums

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 2
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/landingai%2Fade-f84d9496fa149b2f58d90ebc2087565f460de0440c3752333ccde20a19989c3f.yml
-openapi_spec_hash: bcd7408092ab2ef07966e692f4f638f1
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/landingai%2Fade-542a8c1e91614660bfec8e61b9406f3d30e09e2678db8ea906bf021d71f1ed88.yml
+openapi_spec_hash: 8cb4f0857f891f556524d6ed09ed303b
 config_hash: 1cbb3ff883547f7baa6d75485cd2cad8

src/landingai_ade/_client.py

@@ -237,7 +237,7 @@ def extract(
         schema: str,
         markdown: Optional[FileTypes] | Omit = omit,
         markdown_url: Optional[str] | Omit = omit,
-        model: Optional[str] | Omit = omit,
+        model: Optional[Literal["extract-20250630", "extract-20250930"]] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -260,7 +260,7 @@ def extract(
               are extracted from the Markdown. The schema must be a valid JSON object and will
               be validated before processing the document.
 
-          markdown: The Markdown file to extract data from.
+          markdown: The Markdown file or Markdown content to extract data from.
 
           markdown_url: The URL to the Markdown file to extract data from.
 
@@ -330,15 +330,13 @@ def parse(
             `https://api.va.eu-west-1.landing.ai/v1/ade/parse`.
 
         Args:
-          document: A file to be parsed. The file can be a PDF (50 pages max) or an image (50MB).
-              See the list of supported file types here
-              (https://docs.landing.ai/ade/ade-file-types). Either this parameter or the
-              document_url parameter must be provided.
+          document: A file to be parsed. The file can be a PDF or an image. See the list of
+              supported file types here: https://docs.landing.ai/ade/ade-file-types. Either
+              this parameter or the `document_url` parameter must be provided.
 
-          document_url: The URL to the file to be parsed. The file can be a PDF (50 pages max) or an
-              image (50MB). See the list of supported file types here
-              (https://docs.landing.ai/ade/ade-file-types). Either this parameter or the
-              document parameter must be provided.
+          document_url: The URL to the file to be parsed. The file can be a PDF or an image. See the
+              list of supported file types here: https://docs.landing.ai/ade/ade-file-types.
+              Either this parameter or the `document` parameter must be provided.
 
           model: The version of the model to use for parsing.
 
@@ -585,7 +583,7 @@ async def extract(
         schema: str,
         markdown: Optional[FileTypes] | Omit = omit,
         markdown_url: Optional[str] | Omit = omit,
-        model: Optional[str] | Omit = omit,
+        model: Optional[Literal["extract-20250630", "extract-20250930"]] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -608,7 +606,7 @@ async def extract(
               are extracted from the Markdown. The schema must be a valid JSON object and will
               be validated before processing the document.
 
-          markdown: The Markdown file to extract data from.
+          markdown: The Markdown file or Markdown content to extract data from.
 
           markdown_url: The URL to the Markdown file to extract data from.
 
@@ -678,15 +676,13 @@ async def parse(
             `https://api.va.eu-west-1.landing.ai/v1/ade/parse`.
 
         Args:
-          document: A file to be parsed. The file can be a PDF (50 pages max) or an image (50MB).
-              See the list of supported file types here
-              (https://docs.landing.ai/ade/ade-file-types). Either this parameter or the
-              document_url parameter must be provided.
-
-          document_url: The URL to the file to be parsed. The file can be a PDF (50 pages max) or an
-              image (50MB). See the list of supported file types here
-              (https://docs.landing.ai/ade/ade-file-types). Either this parameter or the
-              document parameter must be provided.
+          document: A file to be parsed. The file can be a PDF or an image. See the list of
+              supported file types here: https://docs.landing.ai/ade/ade-file-types. Either
+              this parameter or the `document_url` parameter must be provided.
+
+          document_url: The URL to the file to be parsed. The file can be a PDF or an image. See the
+              list of supported file types here: https://docs.landing.ai/ade/ade-file-types.
+              Either this parameter or the `document` parameter must be provided.
 
           model: The version of the model to use for parsing.
 

src/landingai_ade/types/client_extract_params.py

@@ -3,7 +3,7 @@
 from __future__ import annotations
 
 from typing import Optional
-from typing_extensions import Required, TypedDict
+from typing_extensions import Literal, Required, TypedDict
 
 from .._types import FileTypes
 
@@ -20,10 +20,10 @@ class ClientExtractParams(TypedDict, total=False):
     """
 
     markdown: Optional[FileTypes]
-    """The Markdown file to extract data from."""
+    """The Markdown file or Markdown content to extract data from."""
 
     markdown_url: Optional[str]
     """The URL to the Markdown file to extract data from."""
 
-    model: Optional[str]
+    model: Optional[Literal["extract-20250630", "extract-20250930"]]
     """The version of the model to use for extraction."""

src/landingai_ade/types/client_parse_params.py

@@ -14,17 +14,17 @@ class ClientParseParams(TypedDict, total=False):
     document: Optional[FileTypes]
     """A file to be parsed.
 
-    The file can be a PDF (50 pages max) or an image (50MB). See the list of
-    supported file types here (https://docs.landing.ai/ade/ade-file-types). Either
-    this parameter or the document_url parameter must be provided.
+    The file can be a PDF or an image. See the list of supported file types here:
+    https://docs.landing.ai/ade/ade-file-types. Either this parameter or the
+    `document_url` parameter must be provided.
     """
 
     document_url: Optional[str]
     """The URL to the file to be parsed.
 
-    The file can be a PDF (50 pages max) or an image (50MB). See the list of
-    supported file types here (https://docs.landing.ai/ade/ade-file-types). Either
-    this parameter or the document parameter must be provided.
+    The file can be a PDF or an image. See the list of supported file types here:
+    https://docs.landing.ai/ade/ade-file-types. Either this parameter or the
+    `document` parameter must be provided.
     """
 
     model: Optional[str]

src/landingai_ade/types/parse_response.py

@@ -1,12 +1,22 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-from typing import List, Optional
+from typing import Dict, List, Optional
+from typing_extensions import Literal
 
 from pydantic import Field as FieldInfo
 
 from .._models import BaseModel
 
-__all__ = ["ParseResponse", "Chunk", "ChunkGrounding", "ChunkGroundingBox", "Metadata", "Split"]
+__all__ = [
+    "ParseResponse",
+    "Chunk",
+    "ChunkGrounding",
+    "ChunkGroundingBox",
+    "Metadata",
+    "Split",
+    "Grounding",
+    "GroundingBox",
+]
 
 
 class ChunkGroundingBox(BaseModel):
@@ -28,12 +38,12 @@ class ChunkGrounding(BaseModel):
 class Chunk(BaseModel):
     id: str
 
+    grounding: ChunkGrounding
+
     markdown: str
 
     type: str
 
-    grounding: Optional[ChunkGrounding] = None
-
 
 class Metadata(BaseModel):
     credit_usage: float
@@ -63,6 +73,41 @@ class Split(BaseModel):
     pages: List[int]
 
 
+class GroundingBox(BaseModel):
+    bottom: float
+
+    left: float
+
+    right: float
+
+    top: float
+
+
+class Grounding(BaseModel):
+    box: GroundingBox
+
+    page: int
+
+    type: Literal[
+        "chunkLogo",
+        "chunkCard",
+        "chunkAttestation",
+        "chunkScanCode",
+        "chunkForm",
+        "chunkTable",
+        "chunkFigure",
+        "chunkText",
+        "chunkMarginalia",
+        "chunkTitle",
+        "chunkPageHeader",
+        "chunkPageFooter",
+        "chunkPageNumber",
+        "chunkKeyValue",
+        "table",
+        "tableCell",
+    ]
+
+
 class ParseResponse(BaseModel):
     chunks: List[Chunk]
 
@@ -71,3 +116,5 @@ class ParseResponse(BaseModel):
     metadata: Metadata
 
     splits: List[Split]
+
+    grounding: Optional[Dict[str, Grounding]] = None

tests/api_resources/test_client.py

@@ -32,7 +32,7 @@ def test_method_extract_with_all_params(self, client: LandingAIADE) -> None:
             schema="schema",
             markdown=b"raw file contents",
             markdown_url="markdown_url",
-            model="model",
+            model="extract-20250630",
         )
         assert_matches_type(ExtractResponse, client_, path=["response"])
 
@@ -122,7 +122,7 @@ async def test_method_extract_with_all_params(self, async_client: AsyncLandingAI
             schema="schema",
             markdown=b"raw file contents",
             markdown_url="markdown_url",
-            model="model",
+            model="extract-20250630",
         )
         assert_matches_type(ExtractResponse, client, path=["response"])