projectdavid 1.33.32__tar.gz → 1.34.0__tar.gz

{projectdavid-1.33.32 → projectdavid-1.34.0}/CHANGELOG.md

@@ -1,3 +1,18 @@
+# [1.34.0](https://github.com/frankie336/projectdavid/compare/v1.33.33...v1.34.0) (2025-08-12)
+
+
+### Features
+
+* Adding runs list methods. ([61975b2](https://github.com/frankie336/projectdavid/commit/61975b2c8fa44de254b979160566bd8e89b6799b))
+
+## [1.33.33](https://github.com/frankie336/projectdavid/compare/v1.33.32...v1.33.33) (2025-07-10)
+
+
+### Bug Fixes
+
+* wrap delete_message in a return envelope ([7ed1815](https://github.com/frankie336/projectdavid/commit/7ed18155b85d39cbecf0354c16b2a8a20131b9e2))
+* wrap delete_message in a return envelope ([3e9e6fb](https://github.com/frankie336/projectdavid/commit/3e9e6fbb93ec0670c0e9a39b7eb446bcb1e7df40))
+
 ## [1.33.32](https://github.com/frankie336/projectdavid/compare/v1.33.31...v1.33.32) (2025-07-09)
 
 

{projectdavid-1.33.32/src/projectdavid.egg-info → projectdavid-1.34.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: projectdavid
-Version: 1.33.32
+Version: 1.34.0
 Summary: Python SDK for interacting with the Entities Assistant API.
 Author-email: Francis Neequaye Armah <francis.neequaye@projectdavid.co.uk>
 License: PolyForm Noncommercial License 1.0.0
@@ -20,7 +20,7 @@ Requires-Dist: pydantic<3.0,>=2.0
 Requires-Dist: python-dotenv<2.0,>=1.0.1
 Requires-Dist: aiofiles<25.0,>=23.2.1
 Requires-Dist: ollama<0.5.0,>=0.4.4
-Requires-Dist: projectdavid_common==0.17.10
+Requires-Dist: projectdavid_common==0.17.12
 Requires-Dist: qdrant-client<2.0.0,>=1.0.0
 Requires-Dist: pdfplumber<0.12.0,>=0.11.0
 Requires-Dist: validators<0.35.0,>=0.29.0

{projectdavid-1.33.32 → projectdavid-1.34.0}/docs/runs.md

@@ -36,14 +36,18 @@ run = client.run_service.create_run(thread_id='some_thread_id',
                                     assistant_id='some_assistant_id')
 
 
+
+
 ```
 ---
 
 **Retrieve a Run**
 ```python
 print(get_run.dict())
+
 id='run_t16pOsi0Y2a3PXuPjcrjko' assistant_id='user_2uMMGBpU4H7dcZieeOahNv' cancelled_at=None completed_at=None created_at=1726617356 expires_at=1726620956 failed_at=None incomplete_details=None instructions='' last_error=None max_completion_tokens=1000 max_prompt_tokens=500 meta_data={} model='gpt-4' object='run' parallel_tool_calls=False required_action=None response_format='text' started_at=None status='queued' thread_id='thread_Ww3UGvvKkrxFfHD1hNFQVX' tool_choice='none' tools=[] truncation_strategy={} usage=None temperature=1.0 top_p=1.0 tool_resources={} actions=[]
 {'id': 'run_xsDpDica9weXH4eSfsRcPd', 'assistant_id': 'user_0D1D7j6UkZUsa9Gm7GdkU1', 'cancelled_at': None, 'completed_at': None, 'created_at': 1726620075, 'expires_at': 1726623675, 'failed_at': None, 'incomplete_details': None, 'instructions': '', 'last_error': None, 'max_completion_tokens': 1000, 'max_prompt_tokens': 500, 'meta_data': {}, 'model': 'gpt-4', 'object': 'run', 'parallel_tool_calls': False, 'required_action': None, 'response_format': 'text', 'started_at': None, 'status': 'queued', 'thread_id': 'thread_VaTTuMUa8EHtkr60hZGkju', 'tool_choice': 'none', 'tools': [], 'truncation_strategy': {}, 'usage': None, 'temperature': 1.0, 'top_p': 1.0, 'tool_resources': {}, 'actions': []}
+
 ```
 ---
 

{projectdavid-1.33.32 → projectdavid-1.34.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "projectdavid"
-version = "1.33.32"
+version = "1.34.0"
 description = "Python SDK for interacting with the Entities Assistant API."
 readme = "README.md"
 authors = [
@@ -20,7 +20,7 @@ dependencies = [
     "python-dotenv>=1.0.1,<2.0",
     "aiofiles>=23.2.1,<25.0",
     "ollama>=0.4.4,<0.5.0",
-    "projectdavid_common==0.17.10",
+    "projectdavid_common==0.17.12",
     "qdrant-client>=1.0.0,<2.0.0",
     "pdfplumber>=0.11.0,<0.12.0",
     "validators>=0.29.0,<0.35.0",
@@ -67,6 +67,7 @@ vision = [
     "torchaudio>=2.2.1",
 
     # OpenCLIP + captioning stack
+
     "open_clip_torch>=2.24",
     "pillow>=10.2",
     "transformers>=4.41",
@@ -77,6 +78,7 @@ vision = [
 
     # Geolocation package pending release (uncomment when available)
     # "geoloc-regio-net>=0.2.0 ; extra == 'vision'",
+
 ]
 
 [tool.isort]

{projectdavid-1.33.32 → projectdavid-1.34.0}/src/projectdavid/clients/messages_client.py

@@ -292,32 +292,19 @@ class MessagesClient(BaseAPIClient):
             logging_utility.error("An error occurred: %s", str(e))
             raise RuntimeError(f"An error occurred: {str(e)}")
 
-    def delete_message(self, message_id: str) -> Dict[str, Any]:
-        """
-        Delete a message by its ID.
-
-        Args:
-            message_id (str): The ID of the message.
-
-        Returns:
-            Dict[str, Any]: The deletion result.
-        """
+    def delete_message(self, message_id: str) -> ent_validator.MessageDeleted:
+        """Delete a message and return deletion envelope."""
         logging_utility.info("Deleting message with id: %s", message_id)
         try:
             response = self.client.delete(f"/v1/messages/{message_id}")
             response.raise_for_status()
-            result = response.json()
-            logging_utility.info("Message deleted successfully")
-            return result
+            return ent_validator.MessageDeleted(**response.json())
+
         except httpx.HTTPStatusError as e:
-            logging_utility.error(
-                "HTTP error occurred while deleting message: %s", str(e)
-            )
+            logging_utility.error("HTTP error while deleting message: %s", str(e))
             raise
         except Exception as e:
-            logging_utility.error(
-                "An error occurred while deleting message: %s", str(e)
-            )
+            logging_utility.error("Unexpected error while deleting message: %s", str(e))
             raise
 
     def save_assistant_message_chunk(

{projectdavid-1.33.32 → projectdavid-1.34.0}/src/projectdavid/clients/runs.py

@@ -2,7 +2,7 @@ import json
 import threading
 import time
 from enum import Enum
-from typing import Any, Callable, Dict, List, Optional
+from typing import Any, Callable, Dict, List, Optional, Tuple
 
 import httpx
 import requests
@@ -190,36 +190,6 @@ class RunsClient(BaseAPIClient):
             )
             raise
 
-    def list_runs(self, limit: int = 20, order: str = "asc") -> List[ent_validator.Run]:
-        """
-        List runs with the given limit and order.
-
-        Args:
-            limit (int): Maximum number of runs to retrieve.
-            order (str): 'asc' or 'desc' for ordering.
-
-        Returns:
-            List[Run]: A list of runs.
-        """
-        logging_utility.info("Listing runs with limit: %d, order: %s", limit, order)
-        params = {"limit": limit, "order": order}
-        try:
-            response = self.client.get("/v1/runs", params=params)
-            response.raise_for_status()
-            runs = response.json()
-            validated_runs = [ent_validator.Run(**run) for run in runs]
-            logging_utility.info("Retrieved %d runs", len(validated_runs))
-            return validated_runs
-        except ValidationError as e:
-            logging_utility.error("Validation error: %s", e.json())
-            raise ValueError(f"Validation error: {e}")
-        except httpx.HTTPStatusError as e:
-            logging_utility.error("HTTP error occurred while listing runs: %s", str(e))
-            raise
-        except Exception as e:
-            logging_utility.error("An error occurred while listing runs: %s", str(e))
-            raise
-
     def delete_run(self, run_id: str) -> Dict[str, Any]:
         """
         Delete a run by its ID.
@@ -637,3 +607,138 @@ class RunsClient(BaseAPIClient):
         t = threading.Thread(target=_listen_and_handle, daemon=True)
         t.start()
         t.join()
+
+    def list_runs(self, limit: int = 20, order: str = "asc") -> List[ent_validator.Run]:
+
+        logging_utility.info("Listing runs with limit: %d, order: %s", limit, order)
+        params = {"limit": limit, "order": order if order in ("asc", "desc") else "asc"}
+        try:
+            resp = self.client.get("/v1/runs", params=params)
+            resp.raise_for_status()
+            payload = resp.json()
+
+            # Preferred: envelope
+            if isinstance(payload, dict) and "data" in payload:
+                env = ent_validator.RunListResponse(**payload)
+                logging_utility.info("Retrieved %d runs", len(env.data))
+                return list(env.data)
+
+            # Legacy: raw list of dicts
+            runs = [ent_validator.Run(**item) for item in payload]
+            logging_utility.info("Retrieved %d runs (legacy)", len(runs))
+            return runs
+
+        except ValidationError as e:
+            logging_utility.error("Validation error: %s", e.json())
+            raise ValueError(f"Validation error: {e}")
+        except httpx.HTTPStatusError as e:
+            logging_utility.error("HTTP error occurred while listing runs: %s", str(e))
+            raise
+        except Exception as e:
+            logging_utility.error("An error occurred while listing runs: %s", str(e))
+            raise
+
+    def list_runs_with_meta(
+        self, limit: int = 20, order: str = "asc"
+    ) -> Tuple[List[ent_validator.Run], Optional[str], Optional[str], bool]:
+        """
+        Returns (runs, first_id, last_id, has_more).
+        """
+        logging_utility.info("Listing runs (with meta) limit=%d order=%s", limit, order)
+        params = {"limit": limit, "order": order if order in ("asc", "desc") else "asc"}
+        try:
+            resp = self.client.get("/v1/runs", params=params)
+            resp.raise_for_status()
+            payload = resp.json()
+
+            if isinstance(payload, dict) and "data" in payload:
+                env = ent_validator.RunListResponse(**payload)
+                return list(env.data), env.first_id, env.last_id, env.has_more
+
+            # Legacy fallback: compute minimal meta
+            runs = [ent_validator.Run(**item) for item in payload]
+            first_id = runs[0].id if runs else None
+            last_id = runs[-1].id if runs else None
+            return runs, first_id, last_id, False
+
+        except ValidationError as e:
+            logging_utility.error("Validation error: %s", e.json())
+            raise ValueError(f"Validation error: {e}")
+        except httpx.HTTPStatusError as e:
+            logging_utility.error("HTTP error occurred while listing runs: %s", str(e))
+            raise
+        except Exception as e:
+            logging_utility.error("An error occurred while listing runs: %s", str(e))
+            raise
+
+    def list_runs_for_thread(
+        self, thread_id: str, limit: int = 20, order: str = "asc"
+    ) -> List[ent_validator.Run]:
+        logging_utility.info(
+            "Listing runs for thread_id=%s (limit=%d, order=%s)",
+            thread_id,
+            limit,
+            order,
+        )
+        params = {"limit": limit, "order": order if order in ("asc", "desc") else "asc"}
+        try:
+            resp = self.client.get(f"/v1/threads/{thread_id}/runs", params=params)
+            resp.raise_for_status()
+            payload = resp.json()
+
+            if isinstance(payload, dict) and "data" in payload:
+                env = ent_validator.RunListResponse(**payload)
+                logging_utility.info(
+                    "Retrieved %d runs for thread %s", len(env.data), thread_id
+                )
+                return list(env.data)
+
+            runs = [ent_validator.Run(**item) for item in payload]
+            logging_utility.info(
+                "Retrieved %d runs (legacy) for thread %s", len(runs), thread_id
+            )
+            return runs
+
+        except ValidationError as e:
+            logging_utility.error("Validation error: %s", e.json())
+            raise ValueError(f"Validation error: {e}")
+        except httpx.HTTPStatusError as e:
+            logging_utility.error("HTTP error listing runs for thread: %s", str(e))
+            raise
+        except Exception as e:
+            logging_utility.error("Error listing runs for thread: %s", str(e))
+            raise
+
+    def list_runs_for_thread_with_meta(
+        self, thread_id: str, limit: int = 20, order: str = "asc"
+    ) -> Tuple[List[ent_validator.Run], Optional[str], Optional[str], bool]:
+        logging_utility.info(
+            "Listing runs for thread_id=%s (with meta) limit=%d order=%s",
+            thread_id,
+            limit,
+            order,
+        )
+        params = {"limit": limit, "order": order if order in ("asc", "desc") else "asc"}
+        try:
+            resp = self.client.get(f"/v1/threads/{thread_id}/runs", params=params)
+            resp.raise_for_status()
+            payload = resp.json()
+
+            if isinstance(payload, dict) and "data" in payload:
+                env = ent_validator.RunListResponse(**payload)
+                return list(env.data), env.first_id, env.last_id, env.has_more
+
+            runs = [ent_validator.Run(**item) for item in payload]
+            first_id = runs[0].id if runs else None
+            last_id = runs[-1].id if runs else None
+            return runs, first_id, last_id, False
+
+        except ValidationError as e:
+            logging_utility.error("Validation error: %s", e.json())
+            raise ValueError(f"Validation error: {e}")
+        except httpx.HTTPStatusError as e:
+            logging_utility.error("HTTP error listing runs for thread: %s", str(e))
+            raise
+        except Exception as e:
+            logging_utility.error("Error listing runs for thread: %s", str(e))
+            raise

{projectdavid-1.33.32 → projectdavid-1.34.0/src/projectdavid.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: projectdavid
-Version: 1.33.32
+Version: 1.34.0
 Summary: Python SDK for interacting with the Entities Assistant API.
 Author-email: Francis Neequaye Armah <francis.neequaye@projectdavid.co.uk>
 License: PolyForm Noncommercial License 1.0.0
@@ -20,7 +20,7 @@ Requires-Dist: pydantic<3.0,>=2.0
 Requires-Dist: python-dotenv<2.0,>=1.0.1
 Requires-Dist: aiofiles<25.0,>=23.2.1
 Requires-Dist: ollama<0.5.0,>=0.4.4
-Requires-Dist: projectdavid_common==0.17.10
+Requires-Dist: projectdavid_common==0.17.12
 Requires-Dist: qdrant-client<2.0.0,>=1.0.0
 Requires-Dist: pdfplumber<0.12.0,>=0.11.0
 Requires-Dist: validators<0.35.0,>=0.29.0

{projectdavid-1.33.32 → projectdavid-1.34.0}/src/projectdavid.egg-info/requires.txt

@@ -3,7 +3,7 @@ pydantic<3.0,>=2.0
 python-dotenv<2.0,>=1.0.1
 aiofiles<25.0,>=23.2.1
 ollama<0.5.0,>=0.4.4
-projectdavid_common==0.17.10
+projectdavid_common==0.17.12
 qdrant-client<2.0.0,>=1.0.0
 pdfplumber<0.12.0,>=0.11.0
 validators<0.35.0,>=0.29.0