llama-cloud 2.3.0__tar.gz → 2.4.0__tar.gz

llama_cloud-2.4.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "2.4.0"
+}

{llama_cloud-2.3.0 → llama_cloud-2.4.0}/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## 2.4.0 (2026-04-16)
+
+Full Changelog: [v2.3.0...v2.4.0](https://github.com/run-llama/llama-cloud-py/compare/v2.3.0...v2.4.0)
+
+### Features
+
+* **api:** api update ([9ae910d](https://github.com/run-llama/llama-cloud-py/commit/9ae910d188ce74a3c34d3b0ca646f826dd571d8b))
+* **api:** api update ([2ef67a1](https://github.com/run-llama/llama-cloud-py/commit/2ef67a11dba6bf311d8653a1ba9a48014178163a))
+* **api:** api update ([fc7d45d](https://github.com/run-llama/llama-cloud-py/commit/fc7d45d5792e53c34b0606c5016b63fbf7b5dfe3))
+* **classify:** add wait_for_completion and run() helpers ([#82](https://github.com/run-llama/llama-cloud-py/issues/82)) ([2e0feda](https://github.com/run-llama/llama-cloud-py/commit/2e0fedad3407ad270bc7fd2532bad2cb79cbd127))
+
+
+### Bug Fixes
+
+* ensure file data are only sent as 1 parameter ([7e8e651](https://github.com/run-llama/llama-cloud-py/commit/7e8e6519cb12b6cb2a0a896996563f63ce7614ea))
+
+
+### Documentation
+
+* update examples ([55dce5f](https://github.com/run-llama/llama-cloud-py/commit/55dce5f39923174d07b0ce87cc5633bfaa9a9333))
+
 ## 2.3.0 (2026-04-07)
 
 Full Changelog: [v2.2.0...v2.3.0](https://github.com/run-llama/llama-cloud-py/compare/v2.2.0...v2.3.0)

{llama_cloud-2.3.0 → llama_cloud-2.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: llama_cloud
-Version: 2.3.0
+Version: 2.4.0
 Summary: The official Python library for the llama-cloud API
 Project-URL: Homepage, https://github.com/run-llama/llama-cloud-py
 Project-URL: Repository, https://github.com/run-llama/llama-cloud-py

{llama_cloud-2.3.0 → llama_cloud-2.4.0}/api.md

@@ -402,7 +402,7 @@ Methods:
 - <code title="post /api/v1/retrievers">client.retrievers.<a href="./src/llama_cloud/resources/retrievers/retrievers.py">create</a>(\*\*<a href="src/llama_cloud/types/retriever_create_params.py">params</a>) -> <a href="./src/llama_cloud/types/retriever.py">Retriever</a></code>
 - <code title="put /api/v1/retrievers/{retriever_id}">client.retrievers.<a href="./src/llama_cloud/resources/retrievers/retrievers.py">update</a>(retriever_id, \*\*<a href="src/llama_cloud/types/retriever_update_params.py">params</a>) -> <a href="./src/llama_cloud/types/retriever.py">Retriever</a></code>
 - <code title="get /api/v1/retrievers">client.retrievers.<a href="./src/llama_cloud/resources/retrievers/retrievers.py">list</a>(\*\*<a href="src/llama_cloud/types/retriever_list_params.py">params</a>) -> <a href="./src/llama_cloud/types/retriever_list_response.py">RetrieverListResponse</a></code>
-- <code title="delete /api/v1/retrievers/{retriever_id}">client.retrievers.<a href="./src/llama_cloud/resources/retrievers/retrievers.py">delete</a>(retriever_id) -> None</code>
+- <code title="delete /api/v1/retrievers/{retriever_id}">client.retrievers.<a href="./src/llama_cloud/resources/retrievers/retrievers.py">delete</a>(retriever_id, \*\*<a href="src/llama_cloud/types/retriever_delete_params.py">params</a>) -> None</code>
 - <code title="get /api/v1/retrievers/{retriever_id}">client.retrievers.<a href="./src/llama_cloud/resources/retrievers/retrievers.py">get</a>(retriever_id, \*\*<a href="src/llama_cloud/types/retriever_get_params.py">params</a>) -> <a href="./src/llama_cloud/types/retriever.py">Retriever</a></code>
 - <code title="post /api/v1/retrievers/retrieve">client.retrievers.<a href="./src/llama_cloud/resources/retrievers/retrievers.py">search</a>(\*\*<a href="src/llama_cloud/types/retriever_search_params.py">params</a>) -> <a href="./src/llama_cloud/types/composite_retrieval_result.py">CompositeRetrievalResult</a></code>
 - <code title="put /api/v1/retrievers">client.retrievers.<a href="./src/llama_cloud/resources/retrievers/retrievers.py">upsert</a>(\*\*<a href="src/llama_cloud/types/retriever_upsert_params.py">params</a>) -> <a href="./src/llama_cloud/types/retriever.py">Retriever</a></code>

{llama_cloud-2.3.0 → llama_cloud-2.4.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "llama_cloud"
-version = "2.3.0"
+version = "2.4.0"
 description = "The official Python library for the llama-cloud API"
 dynamic = ["readme"]
 license = "MIT"

{llama_cloud-2.3.0 → llama_cloud-2.4.0}/src/llama_cloud/_utils/_utils.py

@@ -86,8 +86,9 @@ def _extract_items(
     index += 1
     if is_dict(obj):
         try:
-            # We are at the last entry in the path so we must remove the field
-            if (len(path)) == index:
+            # Remove the field if there are no more dict keys in the path,
+            # only "<array>" traversal markers or end.
+            if all(p == "<array>" for p in path[index:]):
                 item = obj.pop(key)
             else:
                 item = obj[key]

{llama_cloud-2.3.0 → llama_cloud-2.4.0}/src/llama_cloud/_version.py

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

{llama_cloud-2.3.0 → llama_cloud-2.4.0}/src/llama_cloud/resources/beta/directories/files.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Mapping, Optional, cast
+from typing import Dict, Union, Mapping, Optional, cast
 
 import httpx
 
@@ -64,6 +64,7 @@ class FilesResource(SyncAPIResource):
         project_id: Optional[str] | Omit = omit,
         body_directory_id: Optional[str] | Omit = omit,
         display_name: Optional[str] | Omit = omit,
+        metadata: Optional[Dict[str, Union[str, float, bool, None]]] | Omit = omit,
         unique_id: Optional[str] | 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.
@@ -86,6 +87,8 @@ class FilesResource(SyncAPIResource):
 
           display_name: Updated display name.
 
+          metadata: User-defined metadata key-value pairs. Replaces the user metadata layer.
+
           unique_id: Updated unique identifier.
 
           extra_headers: Send extra headers
@@ -110,6 +113,7 @@ class FilesResource(SyncAPIResource):
                 {
                     "body_directory_id": body_directory_id,
                     "display_name": display_name,
+                    "metadata": metadata,
                     "unique_id": unique_id,
                 },
                 file_update_params.FileUpdateParams,
@@ -256,6 +260,7 @@ class FilesResource(SyncAPIResource):
         organization_id: Optional[str] | Omit = omit,
         project_id: Optional[str] | Omit = omit,
         display_name: Optional[str] | Omit = omit,
+        metadata: Optional[Dict[str, Union[str, float, bool, None]]] | Omit = omit,
         unique_id: Optional[str] | 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.
@@ -275,6 +280,8 @@ class FilesResource(SyncAPIResource):
 
           display_name: Display name for the file. If not provided, will use the file's name.
 
+          metadata: User-defined metadata key-value pairs to associate with the file.
+
           unique_id: Unique identifier for the file in the directory. If not provided, will use the
               file's external_file_id or name.
 
@@ -294,6 +301,7 @@ class FilesResource(SyncAPIResource):
                 {
                     "file_id": file_id,
                     "display_name": display_name,
+                    "metadata": metadata,
                     "unique_id": unique_id,
                 },
                 file_add_params.FileAddParams,
@@ -467,6 +475,7 @@ class AsyncFilesResource(AsyncAPIResource):
         project_id: Optional[str] | Omit = omit,
         body_directory_id: Optional[str] | Omit = omit,
         display_name: Optional[str] | Omit = omit,
+        metadata: Optional[Dict[str, Union[str, float, bool, None]]] | Omit = omit,
         unique_id: Optional[str] | 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.
@@ -489,6 +498,8 @@ class AsyncFilesResource(AsyncAPIResource):
 
           display_name: Updated display name.
 
+          metadata: User-defined metadata key-value pairs. Replaces the user metadata layer.
+
           unique_id: Updated unique identifier.
 
           extra_headers: Send extra headers
@@ -513,6 +524,7 @@ class AsyncFilesResource(AsyncAPIResource):
                 {
                     "body_directory_id": body_directory_id,
                     "display_name": display_name,
+                    "metadata": metadata,
                     "unique_id": unique_id,
                 },
                 file_update_params.FileUpdateParams,
@@ -659,6 +671,7 @@ class AsyncFilesResource(AsyncAPIResource):
         organization_id: Optional[str] | Omit = omit,
         project_id: Optional[str] | Omit = omit,
         display_name: Optional[str] | Omit = omit,
+        metadata: Optional[Dict[str, Union[str, float, bool, None]]] | Omit = omit,
         unique_id: Optional[str] | 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.
@@ -678,6 +691,8 @@ class AsyncFilesResource(AsyncAPIResource):
 
           display_name: Display name for the file. If not provided, will use the file's name.
 
+          metadata: User-defined metadata key-value pairs to associate with the file.
+
           unique_id: Unique identifier for the file in the directory. If not provided, will use the
               file's external_file_id or name.
 
@@ -697,6 +712,7 @@ class AsyncFilesResource(AsyncAPIResource):
                 {
                     "file_id": file_id,
                     "display_name": display_name,
+                    "metadata": metadata,
                     "unique_id": unique_id,
                 },
                 file_add_params.FileAddParams,

{llama_cloud-2.3.0 → llama_cloud-2.4.0}/src/llama_cloud/resources/beta/split.py

@@ -71,10 +71,8 @@ class SplitResource(SyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> SplitCreateResponse:
-        """Create a document split job.
-
-        Experimental: This endpoint is not yet ready for
-        production use and is subject to change at any time.
+        """
+        Create a document split job.
 
         Args:
           document_input: Document to be split.
@@ -135,10 +133,8 @@ class SplitResource(SyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> SyncPaginatedCursor[SplitListResponse]:
-        """List document split jobs.
-
-        Experimental: This endpoint is not yet ready for
-        production use and is subject to change at any time.
+        """
+        List document split jobs.
 
         Args:
           created_at_on_or_after: Include items created at or after this timestamp (inclusive)
@@ -198,9 +194,6 @@ class SplitResource(SyncAPIResource):
         """
         Get a document split job.
 
-        Experimental: This endpoint is not yet ready for production use and is subject
-        to change at any time.
-
         Args:
           extra_headers: Send extra headers
 
@@ -501,10 +494,8 @@ class AsyncSplitResource(AsyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> SplitCreateResponse:
-        """Create a document split job.
-
-        Experimental: This endpoint is not yet ready for
-        production use and is subject to change at any time.
+        """
+        Create a document split job.
 
         Args:
           document_input: Document to be split.
@@ -565,10 +556,8 @@ class AsyncSplitResource(AsyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> AsyncPaginator[SplitListResponse, AsyncPaginatedCursor[SplitListResponse]]:
-        """List document split jobs.
-
-        Experimental: This endpoint is not yet ready for
-        production use and is subject to change at any time.
+        """
+        List document split jobs.
 
         Args:
           created_at_on_or_after: Include items created at or after this timestamp (inclusive)
@@ -628,9 +617,6 @@ class AsyncSplitResource(AsyncAPIResource):
         """
         Get a document split job.
 
-        Experimental: This endpoint is not yet ready for production use and is subject
-        to change at any time.
-
         Args:
           extra_headers: Send extra headers
 

{llama_cloud-2.3.0 → llama_cloud-2.4.0}/src/llama_cloud/resources/classify.py

@@ -12,6 +12,12 @@ from ..types import classify_get_params, classify_list_params, classify_create_p
 from .._types import Body, Omit, Query, Headers, NotGiven, SequenceNotStr, omit, not_given
 from .._utils import path_template, maybe_transform, async_maybe_transform
 from .._compat import cached_property
+from .._polling import (
+    DEFAULT_TIMEOUT,
+    BackoffStrategy,
+    poll_until_complete,
+    poll_until_complete_async,
+)
 from .._resource import SyncAPIResource, AsyncAPIResource
 from .._response import (
     to_raw_response_wrapper,
@@ -254,6 +260,189 @@ class ClassifyResource(SyncAPIResource):
             cast_to=ClassifyGetResponse,
         )
 
+    def wait_for_completion(
+        self,
+        job_id: str,
+        *,
+        organization_id: Optional[str] | Omit = omit,
+        project_id: Optional[str] | Omit = omit,
+        polling_interval: float = 1.0,
+        max_interval: float = 5.0,
+        timeout: float = DEFAULT_TIMEOUT,
+        backoff: BackoffStrategy = "linear",
+        verbose: bool = False,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+    ) -> ClassifyGetResponse:
+        """
+        Wait for a classify job to complete by polling until it reaches a terminal state.
+
+        Args:
+            job_id: The ID of the classify job to wait for
+
+            organization_id: Optional organization ID
+
+            project_id: Optional project ID
+
+            polling_interval: Initial polling interval in seconds (default: 1.0)
+
+            max_interval: Maximum polling interval for backoff in seconds (default: 5.0)
+
+            timeout: Maximum time to wait in seconds (default: 2 hours)
+
+            backoff: Backoff strategy: "constant", "linear" (default), or "exponential"
+
+            verbose: Print progress indicators every 10 polls (default: False)
+
+            extra_headers: Send extra headers
+
+            extra_query: Add additional query parameters to the request
+
+            extra_body: Add additional JSON properties to the request
+
+        Returns:
+            The completed classify job
+
+        Raises:
+            PollingTimeoutError: If the job doesn't complete within the timeout period
+
+            PollingError: If the job fails
+
+        Example:
+            ```python
+            from llama_cloud import LlamaCloud
+
+            client = LlamaCloud(api_key="...")
+
+            job = client.classify.create(file_input="file-abc123", configuration_id="cfg-...")
+            completed_job = client.classify.wait_for_completion(job.id, verbose=True)
+            print(completed_job.result)
+            ```
+        """
+        if not job_id:
+            raise ValueError(f"Expected a non-empty value for `job_id` but received {job_id!r}")
+
+        def get_status() -> ClassifyGetResponse:
+            return self.get(
+                job_id,
+                organization_id=organization_id,
+                project_id=project_id,
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+            )
+
+        def is_complete(job: ClassifyGetResponse) -> bool:
+            return job.status == "COMPLETED"
+
+        def is_error(job: ClassifyGetResponse) -> bool:
+            return job.status == "FAILED"
+
+        def get_error_message(job: ClassifyGetResponse) -> str:
+            error_parts = [f"Job {job_id} failed with status: {job.status}"]
+            if job.error_message:
+                error_parts.append(f"Error: {job.error_message}")
+            return " | ".join(error_parts)
+
+        return poll_until_complete(
+            get_status_fn=get_status,
+            is_complete_fn=is_complete,
+            is_error_fn=is_error,
+            get_error_message_fn=get_error_message,
+            polling_interval=polling_interval,
+            max_interval=max_interval,
+            timeout=timeout,
+            backoff=backoff,
+            verbose=verbose,
+        )
+
+    def run(
+        self,
+        *,
+        organization_id: Optional[str] | Omit = omit,
+        project_id: Optional[str] | Omit = omit,
+        configuration: Optional[ClassifyConfigurationParam] | Omit = omit,
+        configuration_id: Optional[str] | Omit = omit,
+        file_id: Optional[str] | Omit = omit,
+        file_input: Optional[str] | Omit = omit,
+        parse_job_id: Optional[str] | Omit = omit,
+        transaction_id: Optional[str] | Omit = omit,
+        # Polling parameters
+        polling_interval: float = 1.0,
+        max_interval: float = 5.0,
+        polling_timeout: float = DEFAULT_TIMEOUT,
+        backoff: BackoffStrategy = "linear",
+        verbose: bool = False,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> ClassifyGetResponse:
+        """
+        Create a classify job, wait for it to complete, and return the result.
+
+        This is a convenience method that combines create() and wait_for_completion()
+        into a single call for the most common end-to-end workflow.
+
+        Args:
+            configuration: Inline classify configuration with rules.
+
+            configuration_id: Saved classify configuration ID (mutually exclusive with configuration).
+
+            file_input: File ID (`dfl-...`) or parse job ID (`pjb-...`) to classify.
+
+            transaction_id: Idempotency key scoped to the project.
+
+            polling_interval: Initial polling interval in seconds (default: 1.0).
+
+            max_interval: Maximum polling interval for backoff in seconds (default: 5.0).
+
+            polling_timeout: Maximum time to wait in seconds (default: 2 hours).
+
+            backoff: Backoff strategy: "constant", "linear" (default), or "exponential".
+
+            verbose: Print progress indicators every 10 polls (default: False).
+
+        Example:
+            ```python
+            result = client.classify.run(
+                file_input="dfl-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
+                configuration={"rules": [{"type": "invoice", "description": "..."}]},
+                verbose=True,
+            )
+            print(result.result)
+            ```
+        """
+        job = self.create(
+            organization_id=organization_id,
+            project_id=project_id,
+            configuration=configuration,
+            configuration_id=configuration_id,
+            file_id=file_id,
+            file_input=file_input,
+            parse_job_id=parse_job_id,
+            transaction_id=transaction_id,
+            extra_headers=extra_headers,
+            extra_query=extra_query,
+            extra_body=extra_body,
+            timeout=timeout,
+        )
+
+        return self.wait_for_completion(
+            job.id,
+            organization_id=organization_id,
+            project_id=project_id,
+            polling_interval=polling_interval,
+            max_interval=max_interval,
+            timeout=polling_timeout,
+            backoff=backoff,
+            verbose=verbose,
+            extra_headers=extra_headers,
+            extra_query=extra_query,
+            extra_body=extra_body,
+        )
+
 
 class AsyncClassifyResource(AsyncAPIResource):
     @cached_property
@@ -480,6 +669,189 @@ class AsyncClassifyResource(AsyncAPIResource):
             cast_to=ClassifyGetResponse,
         )
 
+    async def wait_for_completion(
+        self,
+        job_id: str,
+        *,
+        organization_id: Optional[str] | Omit = omit,
+        project_id: Optional[str] | Omit = omit,
+        polling_interval: float = 1.0,
+        max_interval: float = 5.0,
+        timeout: float = DEFAULT_TIMEOUT,
+        backoff: BackoffStrategy = "linear",
+        verbose: bool = False,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+    ) -> ClassifyGetResponse:
+        """
+        Wait for a classify job to complete by polling until it reaches a terminal state.
+
+        Args:
+            job_id: The ID of the classify job to wait for
+
+            organization_id: Optional organization ID
+
+            project_id: Optional project ID
+
+            polling_interval: Initial polling interval in seconds (default: 1.0)
+
+            max_interval: Maximum polling interval for backoff in seconds (default: 5.0)
+
+            timeout: Maximum time to wait in seconds (default: 2 hours)
+
+            backoff: Backoff strategy: "constant", "linear" (default), or "exponential"
+
+            verbose: Print progress indicators every 10 polls (default: False)
+
+            extra_headers: Send extra headers
+
+            extra_query: Add additional query parameters to the request
+
+            extra_body: Add additional JSON properties to the request
+
+        Returns:
+            The completed classify job
+
+        Raises:
+            PollingTimeoutError: If the job doesn't complete within the timeout period
+
+            PollingError: If the job fails
+
+        Example:
+            ```python
+            from llama_cloud import AsyncLlamaCloud
+
+            client = AsyncLlamaCloud(api_key="...")
+
+            job = await client.classify.create(file_input="file-abc123", configuration_id="cfg-...")
+            completed_job = await client.classify.wait_for_completion(job.id, verbose=True)
+            print(completed_job.result)
+            ```
+        """
+        if not job_id:
+            raise ValueError(f"Expected a non-empty value for `job_id` but received {job_id!r}")
+
+        async def get_status() -> ClassifyGetResponse:
+            return await self.get(
+                job_id,
+                organization_id=organization_id,
+                project_id=project_id,
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+            )
+
+        def is_complete(job: ClassifyGetResponse) -> bool:
+            return job.status == "COMPLETED"
+
+        def is_error(job: ClassifyGetResponse) -> bool:
+            return job.status == "FAILED"
+
+        def get_error_message(job: ClassifyGetResponse) -> str:
+            error_parts = [f"Job {job_id} failed with status: {job.status}"]
+            if job.error_message:
+                error_parts.append(f"Error: {job.error_message}")
+            return " | ".join(error_parts)
+
+        return await poll_until_complete_async(
+            get_status_fn=get_status,
+            is_complete_fn=is_complete,
+            is_error_fn=is_error,
+            get_error_message_fn=get_error_message,
+            polling_interval=polling_interval,
+            max_interval=max_interval,
+            timeout=timeout,
+            backoff=backoff,
+            verbose=verbose,
+        )
+
+    async def run(
+        self,
+        *,
+        organization_id: Optional[str] | Omit = omit,
+        project_id: Optional[str] | Omit = omit,
+        configuration: Optional[ClassifyConfigurationParam] | Omit = omit,
+        configuration_id: Optional[str] | Omit = omit,
+        file_id: Optional[str] | Omit = omit,
+        file_input: Optional[str] | Omit = omit,
+        parse_job_id: Optional[str] | Omit = omit,
+        transaction_id: Optional[str] | Omit = omit,
+        # Polling parameters
+        polling_interval: float = 1.0,
+        max_interval: float = 5.0,
+        polling_timeout: float = DEFAULT_TIMEOUT,
+        backoff: BackoffStrategy = "linear",
+        verbose: bool = False,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> ClassifyGetResponse:
+        """
+        Create a classify job, wait for it to complete, and return the result.
+
+        This is a convenience method that combines create() and wait_for_completion()
+        into a single call for the most common end-to-end workflow.
+
+        Args:
+            configuration: Inline classify configuration with rules.
+
+            configuration_id: Saved classify configuration ID (mutually exclusive with configuration).
+
+            file_input: File ID (`dfl-...`) or parse job ID (`pjb-...`) to classify.
+
+            transaction_id: Idempotency key scoped to the project.
+
+            polling_interval: Initial polling interval in seconds (default: 1.0).
+
+            max_interval: Maximum polling interval for backoff in seconds (default: 5.0).
+
+            polling_timeout: Maximum time to wait in seconds (default: 2 hours).
+
+            backoff: Backoff strategy: "constant", "linear" (default), or "exponential".
+
+            verbose: Print progress indicators every 10 polls (default: False).
+
+        Example:
+            ```python
+            result = await client.classify.run(
+                file_input="dfl-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
+                configuration={"rules": [{"type": "invoice", "description": "..."}]},
+                verbose=True,
+            )
+            print(result.result)
+            ```
+        """
+        job = await self.create(
+            organization_id=organization_id,
+            project_id=project_id,
+            configuration=configuration,
+            configuration_id=configuration_id,
+            file_id=file_id,
+            file_input=file_input,
+            parse_job_id=parse_job_id,
+            transaction_id=transaction_id,
+            extra_headers=extra_headers,
+            extra_query=extra_query,
+            extra_body=extra_body,
+            timeout=timeout,
+        )
+
+        return await self.wait_for_completion(
+            job.id,
+            organization_id=organization_id,
+            project_id=project_id,
+            polling_interval=polling_interval,
+            max_interval=max_interval,
+            timeout=polling_timeout,
+            backoff=backoff,
+            verbose=verbose,
+            extra_headers=extra_headers,
+            extra_query=extra_query,
+            extra_body=extra_body,
+        )
+
 
 class ClassifyResourceWithRawResponse:
     def __init__(self, classify: ClassifyResource) -> None:

{llama_cloud-2.3.0 → llama_cloud-2.4.0}/src/llama_cloud/resources/configurations.py

@@ -220,7 +220,9 @@ class ConfigurationsResource(SyncAPIResource):
         organization_id: Optional[str] | Omit = omit,
         page_size: Optional[int] | Omit = omit,
         page_token: Optional[str] | Omit = omit,
-        product_type: Optional[List[Literal["split_v1", "extract_v2", "classify_v2", "parse_v2", "unknown"]]]
+        product_type: Optional[
+            List[Literal["split_v1", "extract_v2", "classify_v2", "parse_v2", "spreadsheet_v1", "unknown"]]
+        ]
         | Omit = omit,
         project_id: Optional[str] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -512,7 +514,9 @@ class AsyncConfigurationsResource(AsyncAPIResource):
         organization_id: Optional[str] | Omit = omit,
         page_size: Optional[int] | Omit = omit,
         page_token: Optional[str] | Omit = omit,
-        product_type: Optional[List[Literal["split_v1", "extract_v2", "classify_v2", "parse_v2", "unknown"]]]
+        product_type: Optional[
+            List[Literal["split_v1", "extract_v2", "classify_v2", "parse_v2", "spreadsheet_v1", "unknown"]]
+        ]
         | Omit = omit,
         project_id: Optional[str] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.