landingai-ade 0.17.1__py3-none-any.whl → 0.18.1__py3-none-any.whl

landingai_ade/_client.py

@@ -41,6 +41,7 @@ from ._response import (
     async_to_raw_response_wrapper,
     async_to_streamed_response_wrapper,
 )
+from .resources import parse_jobs
 from ._streaming import Stream as Stream, AsyncStream as AsyncStream
 from ._exceptions import APIStatusError, LandingAiadeError
 from ._base_client import (
@@ -74,6 +75,7 @@ ENVIRONMENTS: Dict[str, str] = {
 
 
 class LandingAIADE(SyncAPIClient):
+    parse_jobs: parse_jobs.ParseJobsResource
     with_raw_response: LandingAIADEWithRawResponse
     with_streaming_response: LandingAIADEWithStreamedResponse
 
@@ -155,6 +157,7 @@ class LandingAIADE(SyncAPIClient):
             _strict_response_validation=_strict_response_validation,
         )
 
+        self.parse_jobs = parse_jobs.ParseJobsResource(self)
         self.with_raw_response = LandingAIADEWithRawResponse(self)
         self.with_streaming_response = LandingAIADEWithStreamedResponse(self)
 
@@ -422,6 +425,7 @@ class LandingAIADE(SyncAPIClient):
 
 
 class AsyncLandingAIADE(AsyncAPIClient):
+    parse_jobs: parse_jobs.AsyncParseJobsResource
     with_raw_response: AsyncLandingAIADEWithRawResponse
     with_streaming_response: AsyncLandingAIADEWithStreamedResponse
 
@@ -503,6 +507,7 @@ class AsyncLandingAIADE(AsyncAPIClient):
             _strict_response_validation=_strict_response_validation,
         )
 
+        self.parse_jobs = parse_jobs.AsyncParseJobsResource(self)
         self.with_raw_response = AsyncLandingAIADEWithRawResponse(self)
         self.with_streaming_response = AsyncLandingAIADEWithStreamedResponse(self)
 
@@ -771,6 +776,8 @@ class AsyncLandingAIADE(AsyncAPIClient):
 
 class LandingAIADEWithRawResponse:
     def __init__(self, client: LandingAIADE) -> None:
+        self.parse_jobs = parse_jobs.ParseJobsResourceWithRawResponse(client.parse_jobs)
+
         self.extract = to_raw_response_wrapper(
             client.extract,
         )
@@ -781,6 +788,8 @@ class LandingAIADEWithRawResponse:
 
 class AsyncLandingAIADEWithRawResponse:
     def __init__(self, client: AsyncLandingAIADE) -> None:
+        self.parse_jobs = parse_jobs.AsyncParseJobsResourceWithRawResponse(client.parse_jobs)
+
         self.extract = async_to_raw_response_wrapper(
             client.extract,
         )
@@ -791,6 +800,8 @@ class AsyncLandingAIADEWithRawResponse:
 
 class LandingAIADEWithStreamedResponse:
     def __init__(self, client: LandingAIADE) -> None:
+        self.parse_jobs = parse_jobs.ParseJobsResourceWithStreamingResponse(client.parse_jobs)
+
         self.extract = to_streamed_response_wrapper(
             client.extract,
         )
@@ -801,6 +812,8 @@ class LandingAIADEWithStreamedResponse:
 
 class AsyncLandingAIADEWithStreamedResponse:
     def __init__(self, client: AsyncLandingAIADE) -> None:
+        self.parse_jobs = parse_jobs.AsyncParseJobsResourceWithStreamingResponse(client.parse_jobs)
+
         self.extract = async_to_streamed_response_wrapper(
             client.extract,
         )

landingai_ade/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "landingai_ade"
-__version__ = "0.17.1"  # x-release-please-version
+__version__ = "0.18.1"  # x-release-please-version

landingai_ade/resources/__init__.py

@@ -1 +1,19 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from .parse_jobs import (
+    ParseJobsResource,
+    AsyncParseJobsResource,
+    ParseJobsResourceWithRawResponse,
+    AsyncParseJobsResourceWithRawResponse,
+    ParseJobsResourceWithStreamingResponse,
+    AsyncParseJobsResourceWithStreamingResponse,
+)
+
+__all__ = [
+    "ParseJobsResource",
+    "AsyncParseJobsResource",
+    "ParseJobsResourceWithRawResponse",
+    "AsyncParseJobsResourceWithRawResponse",
+    "ParseJobsResourceWithStreamingResponse",
+    "AsyncParseJobsResourceWithStreamingResponse",
+]

landingai_ade/resources/parse_jobs.py

@@ -0,0 +1,462 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Mapping, Optional, cast
+from typing_extensions import Literal
+
+import httpx
+
+from ..types import parse_job_list_params, parse_job_create_params
+from .._types import Body, Omit, Query, Headers, NotGiven, FileTypes, omit, not_given
+from .._utils import extract_files, maybe_transform, deepcopy_minimal, async_maybe_transform
+from .._compat import cached_property
+from .._resource import SyncAPIResource, AsyncAPIResource
+from .._response import (
+    to_raw_response_wrapper,
+    to_streamed_response_wrapper,
+    async_to_raw_response_wrapper,
+    async_to_streamed_response_wrapper,
+)
+from .._base_client import make_request_options
+from ..types.parse_job_get_response import ParseJobGetResponse
+from ..types.parse_job_list_response import ParseJobListResponse
+from ..types.parse_job_create_response import ParseJobCreateResponse
+
+__all__ = ["ParseJobsResource", "AsyncParseJobsResource"]
+
+
+class ParseJobsResource(SyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> ParseJobsResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/landing-ai/ade-python#accessing-raw-response-data-eg-headers
+        """
+        return ParseJobsResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> ParseJobsResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/landing-ai/ade-python#with_streaming_response
+        """
+        return ParseJobsResourceWithStreamingResponse(self)
+
+    def create(
+        self,
+        *,
+        document: Optional[FileTypes] | Omit = omit,
+        document_url: Optional[str] | Omit = omit,
+        model: Optional[str] | Omit = omit,
+        output_save_url: Optional[str] | Omit = omit,
+        split: Optional[Literal["page"]] | 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,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> ParseJobCreateResponse:
+        """
+        Parse documents asynchronously.
+
+        This endpoint creates a job that handles the processing for both large documents
+        and large batches of documents.
+
+        For EU users, use this endpoint:
+
+            `https://api.va.eu-west-1.landing.ai/v1/ade/parse/jobs`.
+
+        Args:
+          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.
+
+          output_save_url: If zero data retention (ZDR) is enabled, you must enter a URL for the parsed
+              output to be saved to. When ZDR is enabled, the parsed content will not be in
+              the API response.
+
+          split: If you want to split documents into smaller sections, include the split
+              parameter. Set the parameter to page to split documents at the page level. The
+              splits object in the API output will contain a set of data for each page.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        body = deepcopy_minimal(
+            {
+                "document": document,
+                "document_url": document_url,
+                "model": model,
+                "output_save_url": output_save_url,
+                "split": split,
+            }
+        )
+        files = extract_files(cast(Mapping[str, object], body), paths=[["document"]])
+        # It should be noted that the actual Content-Type header that will be
+        # sent to the server will contain a `boundary` parameter, e.g.
+        # multipart/form-data; boundary=---abc--
+        extra_headers = {"Content-Type": "multipart/form-data", **(extra_headers or {})}
+        return self._post(
+            "/v1/ade/parse/jobs",
+            body=maybe_transform(body, parse_job_create_params.ParseJobCreateParams),
+            files=files,
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=ParseJobCreateResponse,
+        )
+
+    def list(
+        self,
+        *,
+        page: int | Omit = omit,
+        page_size: int | Omit = omit,
+        status: Optional[Literal["cancelled", "completed", "failed", "pending", "processing"]] | 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,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> ParseJobListResponse:
+        """List all async parse jobs associated with your API key.
+
+        Returns the list of jobs
+        or an error response. For EU users, use this endpoint:
+
+        `https://api.va.eu-west-1.landing.ai/v1/ade/parse/jobs`.
+
+        Args:
+          page: Page number (0-indexed)
+
+          page_size: Number of items per page
+
+          status: Filter by job status.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        return self._get(
+            "/v1/ade/parse/jobs",
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=maybe_transform(
+                    {
+                        "page": page,
+                        "page_size": page_size,
+                        "status": status,
+                    },
+                    parse_job_list_params.ParseJobListParams,
+                ),
+            ),
+            cast_to=ParseJobListResponse,
+        )
+
+    def get(
+        self,
+        job_id: str,
+        *,
+        # 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,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> ParseJobGetResponse:
+        """
+        Get the status for an async parse job.
+
+        Returns the job status or an error response. For EU users, use this endpoint:
+
+        `https://api.va.eu-west-1.landing.ai/v1/ade/parse/jobs/{job_id}`.
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not job_id:
+            raise ValueError(f"Expected a non-empty value for `job_id` but received {job_id!r}")
+        return self._get(
+            f"/v1/ade/parse/jobs/{job_id}",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=ParseJobGetResponse,
+        )
+
+
+class AsyncParseJobsResource(AsyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> AsyncParseJobsResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/landing-ai/ade-python#accessing-raw-response-data-eg-headers
+        """
+        return AsyncParseJobsResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> AsyncParseJobsResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/landing-ai/ade-python#with_streaming_response
+        """
+        return AsyncParseJobsResourceWithStreamingResponse(self)
+
+    async def create(
+        self,
+        *,
+        document: Optional[FileTypes] | Omit = omit,
+        document_url: Optional[str] | Omit = omit,
+        model: Optional[str] | Omit = omit,
+        output_save_url: Optional[str] | Omit = omit,
+        split: Optional[Literal["page"]] | 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,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> ParseJobCreateResponse:
+        """
+        Parse documents asynchronously.
+
+        This endpoint creates a job that handles the processing for both large documents
+        and large batches of documents.
+
+        For EU users, use this endpoint:
+
+            `https://api.va.eu-west-1.landing.ai/v1/ade/parse/jobs`.
+
+        Args:
+          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.
+
+          output_save_url: If zero data retention (ZDR) is enabled, you must enter a URL for the parsed
+              output to be saved to. When ZDR is enabled, the parsed content will not be in
+              the API response.
+
+          split: If you want to split documents into smaller sections, include the split
+              parameter. Set the parameter to page to split documents at the page level. The
+              splits object in the API output will contain a set of data for each page.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        body = deepcopy_minimal(
+            {
+                "document": document,
+                "document_url": document_url,
+                "model": model,
+                "output_save_url": output_save_url,
+                "split": split,
+            }
+        )
+        files = extract_files(cast(Mapping[str, object], body), paths=[["document"]])
+        # It should be noted that the actual Content-Type header that will be
+        # sent to the server will contain a `boundary` parameter, e.g.
+        # multipart/form-data; boundary=---abc--
+        extra_headers = {"Content-Type": "multipart/form-data", **(extra_headers or {})}
+        return await self._post(
+            "/v1/ade/parse/jobs",
+            body=await async_maybe_transform(body, parse_job_create_params.ParseJobCreateParams),
+            files=files,
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=ParseJobCreateResponse,
+        )
+
+    async def list(
+        self,
+        *,
+        page: int | Omit = omit,
+        page_size: int | Omit = omit,
+        status: Optional[Literal["cancelled", "completed", "failed", "pending", "processing"]] | 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,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> ParseJobListResponse:
+        """List all async parse jobs associated with your API key.
+
+        Returns the list of jobs
+        or an error response. For EU users, use this endpoint:
+
+        `https://api.va.eu-west-1.landing.ai/v1/ade/parse/jobs`.
+
+        Args:
+          page: Page number (0-indexed)
+
+          page_size: Number of items per page
+
+          status: Filter by job status.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        return await self._get(
+            "/v1/ade/parse/jobs",
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=await async_maybe_transform(
+                    {
+                        "page": page,
+                        "page_size": page_size,
+                        "status": status,
+                    },
+                    parse_job_list_params.ParseJobListParams,
+                ),
+            ),
+            cast_to=ParseJobListResponse,
+        )
+
+    async def get(
+        self,
+        job_id: str,
+        *,
+        # 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,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> ParseJobGetResponse:
+        """
+        Get the status for an async parse job.
+
+        Returns the job status or an error response. For EU users, use this endpoint:
+
+        `https://api.va.eu-west-1.landing.ai/v1/ade/parse/jobs/{job_id}`.
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not job_id:
+            raise ValueError(f"Expected a non-empty value for `job_id` but received {job_id!r}")
+        return await self._get(
+            f"/v1/ade/parse/jobs/{job_id}",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=ParseJobGetResponse,
+        )
+
+
+class ParseJobsResourceWithRawResponse:
+    def __init__(self, parse_jobs: ParseJobsResource) -> None:
+        self._parse_jobs = parse_jobs
+
+        self.create = to_raw_response_wrapper(
+            parse_jobs.create,
+        )
+        self.list = to_raw_response_wrapper(
+            parse_jobs.list,
+        )
+        self.get = to_raw_response_wrapper(
+            parse_jobs.get,
+        )
+
+
+class AsyncParseJobsResourceWithRawResponse:
+    def __init__(self, parse_jobs: AsyncParseJobsResource) -> None:
+        self._parse_jobs = parse_jobs
+
+        self.create = async_to_raw_response_wrapper(
+            parse_jobs.create,
+        )
+        self.list = async_to_raw_response_wrapper(
+            parse_jobs.list,
+        )
+        self.get = async_to_raw_response_wrapper(
+            parse_jobs.get,
+        )
+
+
+class ParseJobsResourceWithStreamingResponse:
+    def __init__(self, parse_jobs: ParseJobsResource) -> None:
+        self._parse_jobs = parse_jobs
+
+        self.create = to_streamed_response_wrapper(
+            parse_jobs.create,
+        )
+        self.list = to_streamed_response_wrapper(
+            parse_jobs.list,
+        )
+        self.get = to_streamed_response_wrapper(
+            parse_jobs.get,
+        )
+
+
+class AsyncParseJobsResourceWithStreamingResponse:
+    def __init__(self, parse_jobs: AsyncParseJobsResource) -> None:
+        self._parse_jobs = parse_jobs
+
+        self.create = async_to_streamed_response_wrapper(
+            parse_jobs.create,
+        )
+        self.list = async_to_streamed_response_wrapper(
+            parse_jobs.list,
+        )
+        self.get = async_to_streamed_response_wrapper(
+            parse_jobs.get,
+        )

landingai_ade/types/__init__.py

@@ -2,7 +2,13 @@
 
 from __future__ import annotations
 
+from .shared import ParseMetadata as ParseMetadata, ParseGroundingBox as ParseGroundingBox
 from .parse_response import ParseResponse as ParseResponse
 from .extract_response import ExtractResponse as ExtractResponse
 from .client_parse_params import ClientParseParams as ClientParseParams
 from .client_extract_params import ClientExtractParams as ClientExtractParams
+from .parse_job_list_params import ParseJobListParams as ParseJobListParams
+from .parse_job_get_response import ParseJobGetResponse as ParseJobGetResponse
+from .parse_job_create_params import ParseJobCreateParams as ParseJobCreateParams
+from .parse_job_list_response import ParseJobListResponse as ParseJobListResponse
+from .parse_job_create_response import ParseJobCreateResponse as ParseJobCreateResponse

landingai_ade/types/parse_job_create_params.py

@@ -0,0 +1,45 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Optional
+from typing_extensions import Literal, TypedDict
+
+from .._types import FileTypes
+
+__all__ = ["ParseJobCreateParams"]
+
+
+class ParseJobCreateParams(TypedDict, total=False):
+    document: Optional[FileTypes]
+    """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: Optional[str]
+    """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: Optional[str]
+    """The version of the model to use for parsing."""
+
+    output_save_url: Optional[str]
+    """
+    If zero data retention (ZDR) is enabled, you must enter a URL for the parsed
+    output to be saved to. When ZDR is enabled, the parsed content will not be in
+    the API response.
+    """
+
+    split: Optional[Literal["page"]]
+    """
+    If you want to split documents into smaller sections, include the split
+    parameter. Set the parameter to page to split documents at the page level. The
+    splits object in the API output will contain a set of data for each page.
+    """

landingai_ade/types/parse_job_create_response.py

@@ -0,0 +1,9 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from .._models import BaseModel
+
+__all__ = ["ParseJobCreateResponse"]
+
+
+class ParseJobCreateResponse(BaseModel):
+    job_id: str

landingai_ade/types/parse_job_get_response.py

@@ -0,0 +1,111 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Dict, List, Optional
+from typing_extensions import Literal
+
+from pydantic import Field as FieldInfo
+
+from .._models import BaseModel
+from .shared.parse_metadata import ParseMetadata
+from .shared.parse_grounding_box import ParseGroundingBox
+
+__all__ = ["ParseJobGetResponse", "Data", "DataChunk", "DataChunkGrounding", "DataSplit", "DataGrounding"]
+
+
+class DataChunkGrounding(BaseModel):
+    box: ParseGroundingBox
+
+    page: int
+
+
+class DataChunk(BaseModel):
+    id: str
+
+    grounding: DataChunkGrounding
+
+    markdown: str
+
+    type: str
+
+
+class DataSplit(BaseModel):
+    chunks: List[str]
+
+    class_: str = FieldInfo(alias="class")
+
+    identifier: str
+
+    markdown: str
+
+    pages: List[int]
+
+
+class DataGrounding(BaseModel):
+    box: ParseGroundingBox
+
+    page: int
+
+    type: Literal[
+        "chunkLogo",
+        "chunkCard",
+        "chunkAttestation",
+        "chunkScanCode",
+        "chunkForm",
+        "chunkTable",
+        "chunkFigure",
+        "chunkText",
+        "chunkMarginalia",
+        "chunkTitle",
+        "chunkPageHeader",
+        "chunkPageFooter",
+        "chunkPageNumber",
+        "chunkKeyValue",
+        "table",
+        "tableCell",
+    ]
+
+
+class Data(BaseModel):
+    chunks: List[DataChunk]
+
+    markdown: str
+
+    metadata: ParseMetadata
+
+    splits: List[DataSplit]
+
+    grounding: Optional[Dict[str, DataGrounding]] = None
+
+
+class ParseJobGetResponse(BaseModel):
+    job_id: str
+
+    progress: float
+    """
+    Job completion progress as a decimal from 0 to 1, where 0 is not started, 1 is
+    finished, and values between 0 and 1 indicate work in progress.
+    """
+
+    received_at: int
+
+    status: str
+
+    data: Optional[Data] = None
+    """
+    The parsed output, if the job is complete and the `output_save_url` parameter
+    was not used.
+    """
+
+    failure_reason: Optional[str] = None
+
+    metadata: Optional[ParseMetadata] = None
+
+    org_id: Optional[str] = None
+
+    output_url: Optional[str] = None
+    """
+    The URL to the parsed content, if the job is complete and the result is larger
+    than 1MB or the `output_save_url` parameter was used.
+    """
+
+    version: Optional[str] = None

landingai_ade/types/parse_job_list_params.py

@@ -0,0 +1,21 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Optional
+from typing_extensions import Literal, Annotated, TypedDict
+
+from .._utils import PropertyInfo
+
+__all__ = ["ParseJobListParams"]
+
+
+class ParseJobListParams(TypedDict, total=False):
+    page: int
+    """Page number (0-indexed)"""
+
+    page_size: Annotated[int, PropertyInfo(alias="pageSize")]
+    """Number of items per page"""
+
+    status: Optional[Literal["cancelled", "completed", "failed", "pending", "processing"]]
+    """Filter by job status."""

landingai_ade/types/parse_job_list_response.py

@@ -0,0 +1,31 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+
+from .._models import BaseModel
+
+__all__ = ["ParseJobListResponse", "Job"]
+
+
+class Job(BaseModel):
+    job_id: str
+
+    progress: float
+    """
+    Job completion progress as a decimal from 0 to 1, where 0 is not started, 1 is
+    finished, and values between 0 and 1 indicate work in progress.
+    """
+
+    received_at: int
+
+    status: str
+
+    failure_reason: Optional[str] = None
+
+
+class ParseJobListResponse(BaseModel):
+    jobs: List[Job]
+
+    has_more: Optional[bool] = None
+
+    org_id: Optional[str] = None

landingai_ade/types/parse_response.py

@@ -6,31 +6,14 @@ from typing_extensions import Literal
 from pydantic import Field as FieldInfo
 
 from .._models import BaseModel
+from .shared.parse_metadata import ParseMetadata
+from .shared.parse_grounding_box import ParseGroundingBox
 
-__all__ = [
-    "ParseResponse",
-    "Chunk",
-    "ChunkGrounding",
-    "ChunkGroundingBox",
-    "Metadata",
-    "Split",
-    "Grounding",
-    "GroundingBox",
-]
-
-
-class ChunkGroundingBox(BaseModel):
-    bottom: float
-
-    left: float
-
-    right: float
-
-    top: float
+__all__ = ["ParseResponse", "Chunk", "ChunkGrounding", "Split", "Grounding"]
 
 
 class ChunkGrounding(BaseModel):
-    box: ChunkGroundingBox
+    box: ParseGroundingBox
 
     page: int
 
@@ -45,22 +28,6 @@ class Chunk(BaseModel):
     type: str
 
 
-class Metadata(BaseModel):
-    credit_usage: float
-
-    duration_ms: int
-
-    filename: str
-
-    job_id: str
-
-    org_id: Optional[str] = None
-
-    page_count: int
-
-    version: Optional[str] = None
-
-
 class Split(BaseModel):
     chunks: List[str]
 
@@ -73,18 +40,8 @@ class Split(BaseModel):
     pages: List[int]
 
 
-class GroundingBox(BaseModel):
-    bottom: float
-
-    left: float
-
-    right: float
-
-    top: float
-
-
 class Grounding(BaseModel):
-    box: GroundingBox
+    box: ParseGroundingBox
 
     page: int
 
@@ -113,7 +70,7 @@ class ParseResponse(BaseModel):
 
     markdown: str
 
-    metadata: Metadata
+    metadata: ParseMetadata
 
     splits: List[Split]
 

landingai_ade/types/shared/__init__.py

@@ -0,0 +1,4 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from .parse_metadata import ParseMetadata as ParseMetadata
+from .parse_grounding_box import ParseGroundingBox as ParseGroundingBox

landingai_ade/types/shared/parse_grounding_box.py

@@ -0,0 +1,15 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from ..._models import BaseModel
+
+__all__ = ["ParseGroundingBox"]
+
+
+class ParseGroundingBox(BaseModel):
+    bottom: float
+
+    left: float
+
+    right: float
+
+    top: float

landingai_ade/types/shared/parse_metadata.py

@@ -0,0 +1,23 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+
+from ..._models import BaseModel
+
+__all__ = ["ParseMetadata"]
+
+
+class ParseMetadata(BaseModel):
+    credit_usage: float
+
+    duration_ms: int
+
+    filename: str
+
+    job_id: str
+
+    org_id: Optional[str] = None
+
+    page_count: int
+
+    version: Optional[str] = None

{landingai_ade-0.17.1.dist-info → landingai_ade-0.18.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: landingai-ade
-Version: 0.17.1
+Version: 0.18.1
 Summary: The official Python library for the landingai-ade API
 Project-URL: Homepage, https://github.com/landing-ai/ade-python
 Project-URL: Repository, https://github.com/landing-ai/ade-python
@@ -110,6 +110,39 @@ response = client.extract(
 )
 ```
 
+### Parse Jobs
+
+For processing large documents or batches of documents asynchronously:
+
+```python
+import os
+from landingai_ade import LandingAIADE
+
+client = LandingAIADE(
+    apikey=os.environ.get("VISION_AGENT_API_KEY"),
+)
+
+# Create an async parse job
+job = client.parse_jobs.create(
+    document_url="path/to/large_file.pdf",
+    model="dpt-2-latest",
+)
+print(f"Job created with ID: {job.job_id}")
+
+# Get job status
+job_status = client.parse_jobs.get(job.job_id)
+print(f"Status: {job_status.status}")
+
+# List all jobs (with optional filtering)
+response = client.parse_jobs.list(
+    status="completed",
+    page=0,
+    page_size=10,
+)
+for job in response.jobs:
+    print(f"Job {job.job_id}: {job.status}")
+```
+
 ## Async usage
 
 Simply import `AsyncLandingAIADE` instead of `LandingAIADE` and use `await` with each API call:

{landingai_ade-0.17.1.dist-info → landingai_ade-0.18.1.dist-info}/RECORD

@@ -1,6 +1,6 @@
 landingai_ade/__init__.py,sha256=tyK5QngTNcumeBQ-uhvyRts2TtXr0eAR5rofvktz7JA,2760
 landingai_ade/_base_client.py,sha256=vIP54_-Z2Yetpi2x_3RCVmlu7G48VMSe8j18zhXzunQ,67054
-landingai_ade/_client.py,sha256=vdEFrGlNYiZP9A5O_f66VGuHKN_xOhXlAWyALHbLN4k,31628
+landingai_ade/_client.py,sha256=gycUxuygm0f3-PHdir_SXe1kSRrAEA66csjModozggE,32266
 landingai_ade/_compat.py,sha256=DQBVORjFb33zch24jzkhM14msvnzY7mmSmgDLaVFUM8,6562
 landingai_ade/_constants.py,sha256=GTZei0iejG5c3XydQEK4LDinwvGVxPC4N-6h-xuhSHU,464
 landingai_ade/_exceptions.py,sha256=bunb9U_h8wb2_IA8tRYVuTx-clbqqDgX8pjmdgX10d8,3232
@@ -11,7 +11,7 @@ landingai_ade/_resource.py,sha256=fZFMI9zYnf0F6ACBB8teJVzhBelkymH2SMQripxfTvI,11
 landingai_ade/_response.py,sha256=qUH6kfV7CszYHyJKTrJXtJY5b2zPizEM6HyGgsisLtI,28858
 landingai_ade/_streaming.py,sha256=V4RaEBKfcNOdOfTAwMzlx_klsTLILvpnS7PvBWC5Exw,10124
 landingai_ade/_types.py,sha256=8of7ETx2GzlS0kq-JMky4iQt-ZtOQeppgwjQMFF85nw,7253
-landingai_ade/_version.py,sha256=ZVdIAXL52rfwaxCCW0ymN4W-ZIHvacOWmjq5N06Tzt4,166
+landingai_ade/_version.py,sha256=J0nnSdAhAwIhIfQCi8w7YdO3y9QHkqbcM9bCD03XT6g,166
 landingai_ade/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 landingai_ade/_utils/__init__.py,sha256=7fch0GT9zpNnErbciSpUNa-SjTxxjY6kxHxKMOM4AGs,2305
 landingai_ade/_utils/_compat.py,sha256=D8gtAvjJQrDWt9upS0XaG9Rr5l1QhiAx_I_1utT_tt0,1195
@@ -29,13 +29,22 @@ landingai_ade/lib/.keep,sha256=wuNrz-5SXo3jJaJOJgz4vFHM41YH_g20F5cRQo0vLes,224
 landingai_ade/lib/__init__.py,sha256=3a77mMSE61vT4VRcNc5b73fFsbw3vJrrYyAbvQaxUHA,237
 landingai_ade/lib/schema_utils.py,sha256=TdfJbeyRaKuaaNpookuFwqasjxcYBXp0nvp3h9kXPDw,2517
 landingai_ade/lib/url_utils.py,sha256=ydhsvrpcdM4DBoZOIbp83dME9FeKotUDtpzFVU9FZUE,1797
-landingai_ade/resources/__init__.py,sha256=ikKh5ucm9qFI-Z42nOKxhBhEI-YHaaxvsSddO_Nx0-Y,86
-landingai_ade/types/__init__.py,sha256=afoInmNk4PL0G9bmARTsVXzAhFCGNtx5LFSKwm9VYq8,397
+landingai_ade/resources/__init__.py,sha256=uP_UKFsmplo1qU_TnDP8rwXTxU79sg8GN1hlS_Q5nB4,592
+landingai_ade/resources/parse_jobs.py,sha256=tznIAGBItox2dzX7cpCm_3pQCOEjb91vk7IPgin7aZY,18389
+landingai_ade/types/__init__.py,sha256=s_wWgLvdXN0Hzs8vLc5U632eNNXha3I5B2IrOnGePQ8,895
 landingai_ade/types/client_extract_params.py,sha256=efQQ2wiFompakO6LC0fxL6TzuqFsw5FdXInxhTTIUXU,921
 landingai_ade/types/client_parse_params.py,sha256=sTqMewspihj9q4BcgBYGoSJJlDjapsvPYBeoYlUAXp0,1250
 landingai_ade/types/extract_response.py,sha256=mAxHf_kqtu5y46GRTaq4KxhZ97oI-t7LD4qvEUduxf4,657
-landingai_ade/types/parse_response.py,sha256=K-Ig1Ak2S7pMyBNbnR5yM5ZXkOAtH3PAnu4NtFNusrc,1793
-landingai_ade-0.17.1.dist-info/METADATA,sha256=qT9UMtr1wDM_kIeSbFPoButmcNhF11wJw4dKYxAQYmE,15290
-landingai_ade-0.17.1.dist-info/WHEEL,sha256=C2FUgwZgiLbznR-k0b_5k3Ai_1aASOXDss3lzCUsUug,87
-landingai_ade-0.17.1.dist-info/licenses/LICENSE,sha256=xQsP4c8KA_Ov7OhSD-tj_2U8RQ8z9MQUy-WEjgbJdZU,11343
-landingai_ade-0.17.1.dist-info/RECORD,,
+landingai_ade/types/parse_job_create_params.py,sha256=9SnmYVO8drEli7s6vAAPTTjn_0Q0q8iqYOKrz1Pm0lI,1493
+landingai_ade/types/parse_job_create_response.py,sha256=zUwhgmLwinXwOUMSY9uNNxJitcKAZ7TRjd9Y8kprG1o,216
+landingai_ade/types/parse_job_get_response.py,sha256=DFqbKV_brsPxQYI1r5z3TEp4_SMU8IEaZLHVrGCNmxk,2253
+landingai_ade/types/parse_job_list_params.py,sha256=iAbSMFwDYnL7mmFWHy0h4xzsCzZgGkAp5rzuDwRPSXs,602
+landingai_ade/types/parse_job_list_response.py,sha256=hLqYNT7qzqaC0Ri7FYswWxuoGGUzAnhqNYLQu1b6znQ,638
+landingai_ade/types/parse_response.py,sha256=yr_IvBPWJBwK22FJ3spqcdvaD19enADGBZxn8fdQVjo,1416
+landingai_ade/types/shared/__init__.py,sha256=n7dKpO8IQEstmlDczxcje4R_Kkg9EKn3UMejh8Q7_ns,218
+landingai_ade/types/shared/parse_grounding_box.py,sha256=tZ85sGAtkcTs-_jiVjD-hK8tHTn6vh6VHEW_ndmBB3w,260
+landingai_ade/types/shared/parse_metadata.py,sha256=r509Ig1rWW96pplh3PR25wNH40mGJBFENgsLvSFmHgY,384
+landingai_ade-0.18.1.dist-info/METADATA,sha256=bL72j-YFnz8_lHPdeluZ_hqIni-cd0KPgOJ6naF3xJ4,16003
+landingai_ade-0.18.1.dist-info/WHEEL,sha256=C2FUgwZgiLbznR-k0b_5k3Ai_1aASOXDss3lzCUsUug,87
+landingai_ade-0.18.1.dist-info/licenses/LICENSE,sha256=xQsP4c8KA_Ov7OhSD-tj_2U8RQ8z9MQUy-WEjgbJdZU,11343
+landingai_ade-0.18.1.dist-info/RECORD,,