llama-deploy-appserver 0.3.26__tar.gz → 0.4.0__tar.gz

{llama_deploy_appserver-0.3.26 → llama_deploy_appserver-0.4.0}/PKG-INFO

@@ -1,22 +1,21 @@
 Metadata-Version: 2.3
 Name: llama-deploy-appserver
-Version: 0.3.26
+Version: 0.4.0
 Summary: Application server components for LlamaDeploy
 Author: Massimiliano Pippi, Adrian Lyjak
 Author-email: Massimiliano Pippi <mpippi@gmail.com>, Adrian Lyjak <adrianlyjak@gmail.com>
 License: MIT
-Requires-Dist: llama-index-workflows[server]>=2.11.3
+Requires-Dist: llama-index-workflows[server]>=2.12.0,<2.13.0
 Requires-Dist: pydantic-settings>=2.10.1
 Requires-Dist: fastapi>=0.100.0
 Requires-Dist: websockets>=12.0
-Requires-Dist: llama-deploy-core>=0.3.26,<0.4.0
+Requires-Dist: llama-deploy-core>=0.4.0,<0.5.0
 Requires-Dist: httpx>=0.24.0,<1.0.0
 Requires-Dist: prometheus-fastapi-instrumentator>=7.1.0
 Requires-Dist: packaging>=25.0
 Requires-Dist: structlog>=25.4.0
 Requires-Dist: rich>=14.1.0
 Requires-Dist: pyyaml>=6.0.2
-Requires-Dist: llama-cloud-services>=0.6.60
 Requires-Dist: watchfiles>=1.1.0
 Requires-Dist: uvicorn>=0.35.0
 Requires-Dist: typing-extensions>=4.15.0 ; python_full_version < '3.12'

{llama_deploy_appserver-0.3.26 → llama_deploy_appserver-0.4.0}/pyproject.toml

@@ -14,7 +14,7 @@ dev = [
 
 [project]
 name = "llama-deploy-appserver"
-version = "0.3.26"
+version = "0.4.0"
 description = "Application server components for LlamaDeploy"
 readme = "README.md"
 license = {text = "MIT"}
@@ -24,18 +24,17 @@ authors = [
 ]
 requires-python = ">=3.10, <4"
 dependencies = [
-  "llama-index-workflows[server]>=2.11.3",
+  "llama-index-workflows[server]>=2.12.0,<2.13.0",
   "pydantic-settings>=2.10.1",
   "fastapi>=0.100.0",
   "websockets>=12.0",
-  "llama-deploy-core>=0.3.26,<0.4.0",
+  "llama-deploy-core>=0.4.0,<0.5.0",
   "httpx>=0.24.0,<1.0.0",
   "prometheus-fastapi-instrumentator>=7.1.0",
   "packaging>=25.0",
   "structlog>=25.4.0",
   "rich>=14.1.0",
   "pyyaml>=6.0.2",
-  "llama-cloud-services>=0.6.60",
   "watchfiles>=1.1.0",
   "uvicorn>=0.35.0",
   "typing-extensions>=4.15.0 ; python_full_version < '3.12'"

{llama_deploy_appserver-0.3.26 → llama_deploy_appserver-0.4.0}/src/llama_deploy/appserver/app.py

@@ -426,7 +426,7 @@ def export_json_graph(
     This follows the same initialization path as preflight validation and writes
     a workflows.json-style structure compatible with the CLI expectations.
     """
-    from workflows.representation_utils import extract_workflow_structure
+    from workflows.representation.build import get_workflow_representation
 
     configure_settings(
         app_root=cwd,
@@ -439,9 +439,7 @@ def export_json_graph(
 
     graph: dict[str, dict[str, Any]] = {}
     for name, workflow in workflows.items():
-        wf_repr_dict = (
-            extract_workflow_structure(workflow).to_response_model().model_dump()
-        )
+        wf_repr_dict = get_workflow_representation(workflow).model_dump()
         graph[name] = wf_repr_dict
 
     output_path = output or (Path.cwd() / "workflows.json")

llama_deploy_appserver-0.4.0/src/llama_deploy/appserver/workflow_store/agent_data_store.py

@@ -0,0 +1,216 @@
+import asyncio
+import logging
+import os
+import sys
+from typing import Any, List
+
+import httpx
+from llama_deploy.appserver.settings import ApiserverSettings
+from llama_deploy.core.client.ssl_util import get_httpx_verify_param
+from llama_deploy.core.deployment_config import DeploymentConfig
+from workflows.server import AbstractWorkflowStore, HandlerQuery, PersistentHandler
+
+from .keyed_lock import AsyncKeyedLock
+from .lru_cache import LRUCache
+
+if sys.version_info <= (3, 11):
+    from typing_extensions import override
+else:
+    from typing import override
+
+logger = logging.getLogger(__name__)
+
+DEFAULT_BASE_URL = "https://api.cloud.llamaindex.ai"
+
+
+class AgentDataStore(AbstractWorkflowStore):
+    """Workflow store backed by LlamaCloud Agent Data API using raw httpx."""
+
+    def __init__(
+        self, settings: DeploymentConfig, server_settings: ApiserverSettings
+    ) -> None:
+        agent_url_id: str | None = server_settings.cloud_persistence_name
+        collection = "workflow_contexts"
+        if agent_url_id is not None:
+            parts = agent_url_id.split(":")
+            if len(parts) > 1:
+                collection = parts[1]
+            agent_url_id = parts[0]
+        else:
+            agent_url_id = settings.name
+
+        self.settings = settings
+        self.collection = collection
+        self.deployment_name = agent_url_id
+
+        self.base_url = os.getenv("LLAMA_CLOUD_BASE_URL", DEFAULT_BASE_URL).rstrip("/")
+        self.api_key = os.getenv("LLAMA_CLOUD_API_KEY")
+        self.project_id = os.getenv("LLAMA_DEPLOY_PROJECT_ID")
+
+        self.lock = AsyncKeyedLock()
+        # workflow id -> agent data id
+        self.cache = LRUCache[str, str](maxsize=1024)
+
+    def _get_headers(self) -> dict[str, str]:
+        """Build HTTP headers for API requests."""
+        headers = {
+            "Content-Type": "application/json",
+        }
+        if self.api_key:
+            headers["Authorization"] = f"Bearer {self.api_key}"
+        if self.project_id:
+            headers["Project-Id"] = self.project_id
+        return headers
+
+    def _get_client(self) -> httpx.AsyncClient:
+        """Create a new httpx client."""
+        return httpx.AsyncClient(
+            headers=self._get_headers(),
+            verify=get_httpx_verify_param(),
+        )
+
+    @override
+    async def query(self, query: HandlerQuery) -> List[PersistentHandler]:
+        filters = self._build_filters(query)
+        search_request = {
+            "deployment_name": self.deployment_name,
+            "collection": self.collection,
+            "filter": filters,
+            "page_size": 1000,
+        }
+        async with self._get_client() as client:
+            response = await client.post(
+                f"{self.base_url}/api/v1/beta/agent-data/:search",
+                json=search_request,
+            )
+            response.raise_for_status()
+            data = response.json()
+
+        items = data.get("items", [])
+        return [PersistentHandler(**item["data"]) for item in items]
+
+    @override
+    async def update(self, handler: PersistentHandler) -> None:
+        async with self.lock.acquire(handler.handler_id):
+            id = await self._get_item_id(handler)
+            if id is None:
+                item = await self._create_item(handler)
+                item_id = item.get("id")
+                if item_id is None:
+                    raise ValueError(f"Failed to create handler {handler.handler_id}")
+                self.cache.set(handler.handler_id, item_id)
+            else:
+                await self._update_item(id, handler)
+
+    @override
+    async def delete(self, query: HandlerQuery) -> int:
+        filters = self._build_filters(query)
+        search_request = {
+            "deployment_name": self.deployment_name,
+            "collection": self.collection,
+            "filter": filters,
+            "page_size": 1000,
+        }
+        async with self._get_client() as client:
+            response = await client.post(
+                f"{self.base_url}/api/v1/beta/agent-data/:search",
+                json=search_request,
+            )
+            response.raise_for_status()
+            data = response.json()
+
+        items = data.get("items", [])
+        await asyncio.gather(
+            *[self._delete_item(item["id"]) for item in items if item.get("id")]
+        )
+        return len(items)
+
+    async def _create_item(self, handler: PersistentHandler) -> dict[str, Any]:
+        """Create a new agent data item."""
+        create_request = {
+            "deployment_name": self.deployment_name,
+            "collection": self.collection,
+            "data": handler.model_dump(mode="json"),
+        }
+        async with self._get_client() as client:
+            response = await client.post(
+                f"{self.base_url}/api/v1/beta/agent-data",
+                json=create_request,
+            )
+            response.raise_for_status()
+            return response.json()
+
+    async def _update_item(self, item_id: str, handler: PersistentHandler) -> None:
+        """Update an existing agent data item."""
+        update_request = {
+            "data": handler.model_dump(mode="json"),
+        }
+        async with self._get_client() as client:
+            response = await client.put(
+                f"{self.base_url}/api/v1/beta/agent-data/{item_id}",
+                json=update_request,
+            )
+            response.raise_for_status()
+
+    async def _delete_item(self, item_id: str) -> None:
+        """Delete an agent data item."""
+        async with self._get_client() as client:
+            response = await client.delete(
+                f"{self.base_url}/api/v1/beta/agent-data/{item_id}",
+            )
+            response.raise_for_status()
+
+    async def _get_item_id(self, handler: PersistentHandler) -> str | None:
+        cached_id = self.cache.get(handler.handler_id)
+        if cached_id is not None:
+            return cached_id
+        search_filter = {"handler_id": {"eq": handler.handler_id}}
+        search_request = {
+            "deployment_name": self.deployment_name,
+            "collection": self.collection,
+            "filter": search_filter,
+            "page_size": 1,
+        }
+        async with self._get_client() as client:
+            response = await client.post(
+                f"{self.base_url}/api/v1/beta/agent-data/:search",
+                json=search_request,
+            )
+            response.raise_for_status()
+            data = response.json()
+
+        items = data.get("items", [])
+        if not items:
+            return None
+        id = items[0].get("id")
+        if id is None:
+            return None
+        self.cache.set(handler.handler_id, id)
+        return id
+
+    def _build_filters(self, query: HandlerQuery) -> dict[str, Any]:
+        filters: dict[str, Any] = {}
+        if query.handler_id_in is not None:
+            filters["handler_id"] = {
+                "includes": query.handler_id_in,
+            }
+        if query.workflow_name_in is not None:
+            filters["workflow_name"] = {
+                "includes": query.workflow_name_in,
+            }
+        if query.status_in is not None:
+            filters["status"] = {
+                "includes": query.status_in,
+            }
+        if query.is_idle is not None:
+            if query.is_idle:
+                # Filter for handlers where idle_since is set (any valid datetime)
+                filters["idle_since"] = {
+                    "gte": "1970-01-01T00:00:00Z",
+                }
+            else:
+                # Filter for handlers where idle_since is not set (null)
+                filters["idle_since"] = {
+                    "eq": None,
+                }
+        return filters

llama_deploy_appserver-0.3.26/src/llama_deploy/appserver/workflow_store/agent_data_store.py

@@ -1,124 +0,0 @@
-import asyncio
-import logging
-import os
-import sys
-from typing import Any, List, cast
-
-from llama_cloud.client import AsyncLlamaCloud, httpx
-from llama_cloud_services.beta.agent_data import AsyncAgentDataClient
-from llama_deploy.appserver.settings import ApiserverSettings
-from llama_deploy.core.client.ssl_util import get_httpx_verify_param
-from llama_deploy.core.deployment_config import DeploymentConfig
-from workflows.server import AbstractWorkflowStore, HandlerQuery, PersistentHandler
-
-from .keyed_lock import AsyncKeyedLock
-from .lru_cache import LRUCache
-
-if sys.version_info <= (3, 11):
-    from typing_extensions import override
-else:
-    from typing import override
-
-logger = logging.getLogger(__name__)
-
-
-class AgentDataStore(AbstractWorkflowStore):
-    def __init__(
-        self, settings: DeploymentConfig, server_settings: ApiserverSettings
-    ) -> None:
-        agent_url_id: str | None = server_settings.cloud_persistence_name
-        collection = "workflow_contexts"
-        if agent_url_id is not None:
-            parts = agent_url_id.split(":")
-            if len(parts) > 1:
-                collection = parts[1]
-            agent_url_id = parts[0]
-        else:
-            agent_url_id = settings.name
-
-        self.settings = settings
-        project_id = os.getenv("LLAMA_DEPLOY_PROJECT_ID")
-        self.client = AsyncAgentDataClient(
-            type=PersistentHandler,
-            collection=collection,
-            agent_url_id=agent_url_id,
-            client=AsyncLlamaCloud(
-                base_url=os.getenv("LLAMA_CLOUD_BASE_URL"),
-                token=os.getenv("LLAMA_CLOUD_API_KEY"),
-                httpx_client=httpx.AsyncClient(
-                    headers={"Project-Id": project_id} if project_id else None,
-                    verify=get_httpx_verify_param(),
-                ),
-            ),
-        )
-        self.lock = AsyncKeyedLock()
-        # workflow id -> agent data id
-        self.cache = LRUCache[str, str](maxsize=1024)
-
-    @override
-    async def query(self, query: HandlerQuery) -> List[PersistentHandler]:
-        filters = self._build_filters(query)
-        results = await self.client.search(
-            filter=filters,
-            page_size=1000,
-        )
-        return [x.data for x in results.items]
-
-    @override
-    async def update(self, handler: PersistentHandler) -> None:
-        async with self.lock.acquire(handler.handler_id):
-            id = await self._get_item_id(handler)
-            if id is None:
-                item = await self.client.create_item(
-                    data=handler,
-                )
-                if item.id is None:
-                    raise ValueError(f"Failed to create handler {handler.handler_id}")
-                self.cache.set(handler.handler_id, item.id)
-            else:
-                await self.client.update_item(
-                    item_id=id,
-                    data=handler,
-                )
-
-    @override
-    async def delete(self, query: HandlerQuery) -> int:
-        filters = self._build_filters(query)
-        results = await self.client.search(filter=filters, page_size=1000)
-        await asyncio.gather(
-            *[self.client.delete_item(item_id=x.id) for x in results.items if x.id]
-        )
-        return len(results.items)
-
-    async def _get_item_id(self, handler: PersistentHandler) -> str | None:
-        cached_id = self.cache.get(handler.handler_id)
-        if cached_id is not None:
-            return cached_id
-        search_filter = {"handler_id": {"eq": handler.handler_id}}
-        results = await self.client.search(
-            filter=cast(Any, search_filter),
-            page_size=1,
-        )
-        if not results.items:
-            return None
-        id = results.items[0].id
-        if id is None:
-            return None
-        self.cache.set(handler.handler_id, id)
-        return id
-
-    def _build_filters(self, query: HandlerQuery) -> dict[str, Any]:
-        filters: dict[str, Any] = {}
-        if query.handler_id_in is not None:
-            filters["handler_id"] = {
-                "includes": query.handler_id_in,
-            }
-        if query.workflow_name_in is not None:
-            filters["workflow_name"] = {
-                "includes": query.workflow_name_in,
-            }
-        if query.status_in is not None:
-            filters["status"] = {
-                "includes": query.status_in,
-            }
-        return filters