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

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

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

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

@@ -1,5 +1,19 @@
 # Changelog
 
+## 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.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: llama_cloud
-Version: 2.2.0
+Version: 2.3.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.3.0}/api.md

@@ -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.3.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.3.0}/pyproject.toml

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

{llama_cloud-2.2.0 → llama_cloud-2.3.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.3.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.3.0"  # x-release-please-version

{llama_cloud-2.2.0 → llama_cloud-2.3.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.3.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.3.0}/src/llama_cloud/types/beta/__init__.py

@@ -14,7 +14,6 @@ from .split_get_response import SplitGetResponse as SplitGetResponse
 from .batch_cancel_params import BatchCancelParams as BatchCancelParams
 from .batch_create_params import BatchCreateParams as BatchCreateParams
 from .batch_list_response import BatchListResponse as BatchListResponse
-from .parse_configuration import ParseConfiguration as ParseConfiguration
 from .sheet_create_params import SheetCreateParams as SheetCreateParams
 from .split_create_params import SplitCreateParams as SplitCreateParams
 from .split_list_response import SplitListResponse as SplitListResponse
@@ -49,11 +48,5 @@ from .sheets_parsing_config_param import SheetsParsingConfigParam as SheetsParsi
 from .agent_data_agent_data_params import AgentDataAgentDataParams as AgentDataAgentDataParams
 from .agent_data_aggregate_response import AgentDataAggregateResponse as AgentDataAggregateResponse
 from .sheet_get_result_table_params import SheetGetResultTableParams as SheetGetResultTableParams
-from .parse_configuration_get_params import ParseConfigurationGetParams as ParseConfigurationGetParams
-from .parse_configuration_list_params import ParseConfigurationListParams as ParseConfigurationListParams
 from .agent_data_delete_by_query_params import AgentDataDeleteByQueryParams as AgentDataDeleteByQueryParams
-from .parse_configuration_create_params import ParseConfigurationCreateParams as ParseConfigurationCreateParams
-from .parse_configuration_delete_params import ParseConfigurationDeleteParams as ParseConfigurationDeleteParams
-from .parse_configuration_update_params import ParseConfigurationUpdateParams as ParseConfigurationUpdateParams
-from .parse_configuration_query_response import ParseConfigurationQueryResponse as ParseConfigurationQueryResponse
 from .agent_data_delete_by_query_response import AgentDataDeleteByQueryResponse as AgentDataDeleteByQueryResponse

{llama_cloud-2.2.0 → llama_cloud-2.3.0}/tests/test_client.py

@@ -429,6 +429,30 @@ class TestLlamaCloud:
 
         client.close()
 
+    def test_hardcoded_query_params_in_url(self, client: LlamaCloud) -> None:
+        request = client._build_request(FinalRequestOptions(method="get", url="/foo?beta=true"))
+        url = httpx.URL(request.url)
+        assert dict(url.params) == {"beta": "true"}
+
+        request = client._build_request(
+            FinalRequestOptions(
+                method="get",
+                url="/foo?beta=true",
+                params={"limit": "10", "page": "abc"},
+            )
+        )
+        url = httpx.URL(request.url)
+        assert dict(url.params) == {"beta": "true", "limit": "10", "page": "abc"}
+
+        request = client._build_request(
+            FinalRequestOptions(
+                method="get",
+                url="/files/a%2Fb?beta=true",
+                params={"limit": "10"},
+            )
+        )
+        assert request.url.raw_path == b"/files/a%2Fb?beta=true&limit=10"
+
     def test_request_extra_json(self, client: LlamaCloud) -> None:
         request = client._build_request(
             FinalRequestOptions(
@@ -1328,6 +1352,30 @@ class TestAsyncLlamaCloud:
 
         await client.close()
 
+    async def test_hardcoded_query_params_in_url(self, async_client: AsyncLlamaCloud) -> None:
+        request = async_client._build_request(FinalRequestOptions(method="get", url="/foo?beta=true"))
+        url = httpx.URL(request.url)
+        assert dict(url.params) == {"beta": "true"}
+
+        request = async_client._build_request(
+            FinalRequestOptions(
+                method="get",
+                url="/foo?beta=true",
+                params={"limit": "10", "page": "abc"},
+            )
+        )
+        url = httpx.URL(request.url)
+        assert dict(url.params) == {"beta": "true", "limit": "10", "page": "abc"}
+
+        request = async_client._build_request(
+            FinalRequestOptions(
+                method="get",
+                url="/files/a%2Fb?beta=true",
+                params={"limit": "10"},
+            )
+        )
+        assert request.url.raw_path == b"/files/a%2Fb?beta=true&limit=10"
+
     def test_request_extra_json(self, client: LlamaCloud) -> None:
         request = client._build_request(
             FinalRequestOptions(

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

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