llama-cloud 2.2.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.2.0 → llama_cloud-2.4.0}/CHANGELOG.md

@@ -1,5 +1,40 @@
 # 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)
+
+### Features
+
+* **api:** remove parse configurations, superseded by generic configurations from 2.2.0 ([ef96778](https://github.com/run-llama/llama-cloud-py/commit/ef9677851bec9ffb3d1cfedd431efd881b3ef7f9))
+
+
+### Bug Fixes
+
+* **client:** preserve hardcoded query params when merging with user params ([53c3d0a](https://github.com/run-llama/llama-cloud-py/commit/53c3d0aa13ccb9b3d6aa7b18c1943b52802c1aaa))
+* use agentic parse for citation bounding box demo ([#78](https://github.com/run-llama/llama-cloud-py/issues/78)) ([4f0c201](https://github.com/run-llama/llama-cloud-py/commit/4f0c201b2f91e9d765d061a9450c6fce519585f2))
+
 ## 2.2.0 (2026-04-03)
 
 Full Changelog: [v2.1.0...v2.2.0](https://github.com/run-llama/llama-cloud-py/compare/v2.1.0...v2.2.0)

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: llama_cloud
-Version: 2.2.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.2.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>
@@ -438,26 +438,6 @@ Methods:
 - <code title="get /api/v1/beta/agent-data/{item_id}">client.beta.agent_data.<a href="./src/llama_cloud/resources/beta/agent_data.py">get</a>(item_id, \*\*<a href="src/llama_cloud/types/beta/agent_data_get_params.py">params</a>) -> <a href="./src/llama_cloud/types/beta/agent_data.py">AgentData</a></code>
 - <code title="post /api/v1/beta/agent-data/:search">client.beta.agent_data.<a href="./src/llama_cloud/resources/beta/agent_data.py">search</a>(\*\*<a href="src/llama_cloud/types/beta/agent_data_search_params.py">params</a>) -> <a href="./src/llama_cloud/types/beta/agent_data.py">SyncPaginatedCursorPost[AgentData]</a></code>
 
-## ParseConfigurations
-
-Types:
-
-```python
-from llama_cloud.types.beta import (
-    ParseConfiguration,
-    ParseConfigurationCreate,
-    ParseConfigurationQueryResponse,
-)
-```
-
-Methods:
-
-- <code title="post /api/v1/beta/parse-configurations">client.beta.parse_configurations.<a href="./src/llama_cloud/resources/beta/parse_configurations.py">create</a>(\*\*<a href="src/llama_cloud/types/beta/parse_configuration_create_params.py">params</a>) -> <a href="./src/llama_cloud/types/beta/parse_configuration.py">ParseConfiguration</a></code>
-- <code title="put /api/v1/beta/parse-configurations/{config_id}">client.beta.parse_configurations.<a href="./src/llama_cloud/resources/beta/parse_configurations.py">update</a>(config_id, \*\*<a href="src/llama_cloud/types/beta/parse_configuration_update_params.py">params</a>) -> <a href="./src/llama_cloud/types/beta/parse_configuration.py">ParseConfiguration</a></code>
-- <code title="get /api/v1/beta/parse-configurations">client.beta.parse_configurations.<a href="./src/llama_cloud/resources/beta/parse_configurations.py">list</a>(\*\*<a href="src/llama_cloud/types/beta/parse_configuration_list_params.py">params</a>) -> <a href="./src/llama_cloud/types/beta/parse_configuration.py">SyncPaginatedCursor[ParseConfiguration]</a></code>
-- <code title="delete /api/v1/beta/parse-configurations/{config_id}">client.beta.parse_configurations.<a href="./src/llama_cloud/resources/beta/parse_configurations.py">delete</a>(config_id, \*\*<a href="src/llama_cloud/types/beta/parse_configuration_delete_params.py">params</a>) -> None</code>
-- <code title="get /api/v1/beta/parse-configurations/{config_id}">client.beta.parse_configurations.<a href="./src/llama_cloud/resources/beta/parse_configurations.py">get</a>(config_id, \*\*<a href="src/llama_cloud/types/beta/parse_configuration_get_params.py">params</a>) -> <a href="./src/llama_cloud/types/beta/parse_configuration.py">ParseConfiguration</a></code>
-
 ## Sheets
 
 Types:

{llama_cloud-2.2.0 → llama_cloud-2.4.0}/examples/extract/extract_v2_complete_walkthrough.ipynb

@@ -386,7 +386,7 @@
     "        \"data_schema\": citation_schema,\n",
     "        \"extraction_target\": \"per_doc\",\n",
     "        \"tier\": \"cost_effective\",\n",
-    "        \"cite_sources\": True,\n",
+    "        \"cite_sources\": True,\n        \"parse_tier\": \"agentic\",  # agentic parse produces tighter bounding boxes\n",
     "    },\n",
     "    verbose=True,\n",
     ")\n",

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

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

{llama_cloud-2.2.0 → llama_cloud-2.4.0}/src/llama_cloud/_base_client.py

@@ -540,6 +540,10 @@ class BaseClient(Generic[_HttpxClientT, _DefaultStreamT]):
                 files = cast(HttpxRequestFiles, ForceMultipartDict())
 
         prepared_url = self._prepare_url(options.url)
+        # preserve hard-coded query params from the url
+        if params and prepared_url.query:
+            params = {**dict(prepared_url.params.items()), **params}
+            prepared_url = prepared_url.copy_with(raw_path=prepared_url.raw_path.split(b"?", 1)[0])
         if "_" in prepared_url.host:
             # work around https://github.com/encode/httpx/discussions/2880
             kwargs["extensions"] = {"sni_hostname": prepared_url.host.replace("_", "-")}

{llama_cloud-2.2.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.2.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.2.0"  # x-release-please-version
+__version__ = "2.4.0"  # x-release-please-version

{llama_cloud-2.2.0 → llama_cloud-2.4.0}/src/llama_cloud/resources/beta/__init__.py

@@ -48,14 +48,6 @@ from .directories import (
     DirectoriesResourceWithStreamingResponse,
     AsyncDirectoriesResourceWithStreamingResponse,
 )
-from .parse_configurations import (
-    ParseConfigurationsResource,
-    AsyncParseConfigurationsResource,
-    ParseConfigurationsResourceWithRawResponse,
-    AsyncParseConfigurationsResourceWithRawResponse,
-    ParseConfigurationsResourceWithStreamingResponse,
-    AsyncParseConfigurationsResourceWithStreamingResponse,
-)
 
 __all__ = [
     "AgentDataResource",
@@ -64,12 +56,6 @@ __all__ = [
     "AsyncAgentDataResourceWithRawResponse",
     "AgentDataResourceWithStreamingResponse",
     "AsyncAgentDataResourceWithStreamingResponse",
-    "ParseConfigurationsResource",
-    "AsyncParseConfigurationsResource",
-    "ParseConfigurationsResourceWithRawResponse",
-    "AsyncParseConfigurationsResourceWithRawResponse",
-    "ParseConfigurationsResourceWithStreamingResponse",
-    "AsyncParseConfigurationsResourceWithStreamingResponse",
     "SheetsResource",
     "AsyncSheetsResource",
     "SheetsResourceWithRawResponse",

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

@@ -36,14 +36,6 @@ from .batch.batch import (
     BatchResourceWithStreamingResponse,
     AsyncBatchResourceWithStreamingResponse,
 )
-from .parse_configurations import (
-    ParseConfigurationsResource,
-    AsyncParseConfigurationsResource,
-    ParseConfigurationsResourceWithRawResponse,
-    AsyncParseConfigurationsResourceWithRawResponse,
-    ParseConfigurationsResourceWithStreamingResponse,
-    AsyncParseConfigurationsResourceWithStreamingResponse,
-)
 from .directories.directories import (
     DirectoriesResource,
     AsyncDirectoriesResource,
@@ -61,10 +53,6 @@ class BetaResource(SyncAPIResource):
     def agent_data(self) -> AgentDataResource:
         return AgentDataResource(self._client)
 
-    @cached_property
-    def parse_configurations(self) -> ParseConfigurationsResource:
-        return ParseConfigurationsResource(self._client)
-
     @cached_property
     def sheets(self) -> SheetsResource:
         return SheetsResource(self._client)
@@ -106,10 +94,6 @@ class AsyncBetaResource(AsyncAPIResource):
     def agent_data(self) -> AsyncAgentDataResource:
         return AsyncAgentDataResource(self._client)
 
-    @cached_property
-    def parse_configurations(self) -> AsyncParseConfigurationsResource:
-        return AsyncParseConfigurationsResource(self._client)
-
     @cached_property
     def sheets(self) -> AsyncSheetsResource:
         return AsyncSheetsResource(self._client)
@@ -154,10 +138,6 @@ class BetaResourceWithRawResponse:
     def agent_data(self) -> AgentDataResourceWithRawResponse:
         return AgentDataResourceWithRawResponse(self._beta.agent_data)
 
-    @cached_property
-    def parse_configurations(self) -> ParseConfigurationsResourceWithRawResponse:
-        return ParseConfigurationsResourceWithRawResponse(self._beta.parse_configurations)
-
     @cached_property
     def sheets(self) -> SheetsResourceWithRawResponse:
         return SheetsResourceWithRawResponse(self._beta.sheets)
@@ -183,10 +163,6 @@ class AsyncBetaResourceWithRawResponse:
     def agent_data(self) -> AsyncAgentDataResourceWithRawResponse:
         return AsyncAgentDataResourceWithRawResponse(self._beta.agent_data)
 
-    @cached_property
-    def parse_configurations(self) -> AsyncParseConfigurationsResourceWithRawResponse:
-        return AsyncParseConfigurationsResourceWithRawResponse(self._beta.parse_configurations)
-
     @cached_property
     def sheets(self) -> AsyncSheetsResourceWithRawResponse:
         return AsyncSheetsResourceWithRawResponse(self._beta.sheets)
@@ -212,10 +188,6 @@ class BetaResourceWithStreamingResponse:
     def agent_data(self) -> AgentDataResourceWithStreamingResponse:
         return AgentDataResourceWithStreamingResponse(self._beta.agent_data)
 
-    @cached_property
-    def parse_configurations(self) -> ParseConfigurationsResourceWithStreamingResponse:
-        return ParseConfigurationsResourceWithStreamingResponse(self._beta.parse_configurations)
-
     @cached_property
     def sheets(self) -> SheetsResourceWithStreamingResponse:
         return SheetsResourceWithStreamingResponse(self._beta.sheets)
@@ -241,10 +213,6 @@ class AsyncBetaResourceWithStreamingResponse:
     def agent_data(self) -> AsyncAgentDataResourceWithStreamingResponse:
         return AsyncAgentDataResourceWithStreamingResponse(self._beta.agent_data)
 
-    @cached_property
-    def parse_configurations(self) -> AsyncParseConfigurationsResourceWithStreamingResponse:
-        return AsyncParseConfigurationsResourceWithStreamingResponse(self._beta.parse_configurations)
-
     @cached_property
     def sheets(self) -> AsyncSheetsResourceWithStreamingResponse:
         return AsyncSheetsResourceWithStreamingResponse(self._beta.sheets)

{llama_cloud-2.2.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.2.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