projectdavid 1.34.2__py3-none-any.whl → 1.34.4__py3-none-any.whl

projectdavid/clients/runs.py

@@ -148,6 +148,25 @@ class RunsClient(BaseAPIClient):
             )
             raise
 
+    def update_run(self, run_id: str, metadata: Dict[str, Any]) -> ent_validator.Run:
+        """
+        Shallow-merge metadata into a run. Returns the updated Run.
+        """
+        logging_utility.info("Updating metadata for run_id: %s", run_id)
+        try:
+            resp = self.client.put(f"/v1/runs/{run_id}/metadata", json=metadata)
+            resp.raise_for_status()
+            return ent_validator.Run(**resp.json())
+        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 updating run metadata: %s", str(e))
+            raise
+        except Exception as e:
+            logging_utility.error("Unexpected error updating run metadata: %s", str(e))
+            raise
+
     def update_run_status(self, run_id: str, new_status: str) -> ent_validator.Run:
         """
         Update the status of a run.
@@ -609,18 +628,17 @@ class RunsClient(BaseAPIClient):
         t.join()
 
     # ------------------------------------------------------------
-    # These are helpers that build the run lists
+    # List all runs by thread_id
     # ------------------------------------------------------------
-    def list_runs_enveloped(
-        self, limit: int = 20, order: str = "asc"
+    def list_runs(
+        self, thread_id: str, limit: int = 20, order: str = "asc"
     ) -> ent_validator.RunListResponse:
         params = {"limit": limit, "order": order if order in ("asc", "desc") else "asc"}
-        resp = self.client.get("/v1/runs", params=params)
+        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:
             return ent_validator.RunListResponse(**payload)
-        # legacy fallback: wrap raw list
         runs = [ent_validator.Run(**item) for item in payload]
         return ent_validator.RunListResponse(
             object="list",
@@ -630,15 +648,19 @@ class RunsClient(BaseAPIClient):
             has_more=False,
         )
 
-    def list_runs_for_thread_enveloped(
-        self, thread_id: str, limit: int = 20, order: str = "asc"
+    # ------------------------------------------------------------
+    # List all runs by user
+    # ------------------------------------------------------------
+    def list_all_runs(
+        self, limit: int = 20, order: str = "asc"
     ) -> ent_validator.RunListResponse:
         params = {"limit": limit, "order": order if order in ("asc", "desc") else "asc"}
-        resp = self.client.get(f"/v1/threads/{thread_id}/runs", params=params)
+        resp = self.client.get("/v1/runs", params=params)
         resp.raise_for_status()
         payload = resp.json()
         if isinstance(payload, dict) and "data" in payload:
             return ent_validator.RunListResponse(**payload)
+        # legacy fallback: wrap raw list
         runs = [ent_validator.Run(**item) for item in payload]
         return ent_validator.RunListResponse(
             object="list",
@@ -647,153 +669,3 @@ class RunsClient(BaseAPIClient):
             last_id=runs[-1].id if runs else None,
             has_more=False,
         )
-
-    def list_runs(self, limit: int = 20, order: str = "asc") -> List[ent_validator.Run]:
-        # soft-deprecate in logs if you want
-        env = self.list_runs_enveloped(limit=limit, order=order)
-        return list(env.data)
-
-    def list_runs_for_thread(
-        self, thread_id: str, limit: int = 20, order: str = "asc"
-    ) -> List[ent_validator.Run]:
-        env = self.list_runs_for_thread_enveloped(
-            thread_id=thread_id, limit=limit, order=order
-        )
-        return list(env.data)
-
-    def list_runsX(
-        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_metaX(
-        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_threadX(
-        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_metaX(
-        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.34.2.dist-info → projectdavid-1.34.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: projectdavid
-Version: 1.34.2
+Version: 1.34.4
 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

{projectdavid-1.34.2.dist-info → projectdavid-1.34.4.dist-info}/RECORD

@@ -15,7 +15,7 @@ projectdavid/clients/file_search.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG
 projectdavid/clients/files_client.py,sha256=XkIDzbQFGDrd88taf0Kouc_4YJOPIYEHiIyWYLKDofI,15581
 projectdavid/clients/inference_client.py,sha256=xz4ACPv5Tkis604QxO5mJX1inH_TGDfQP-31geETYpE,6609
 projectdavid/clients/messages_client.py,sha256=-tUubr5f62nLER6BxVY3ihp3vn3pnZH-ceigvQRSlYs,16825
-projectdavid/clients/runs.py,sha256=23pTcTRjuvEnBRpveFVeYQD8B-2SAsJjKqVrhmHq5ts,32112
+projectdavid/clients/runs.py,sha256=lW2gYkMEfiddZYvsEMkdmbb2MFRP6rUpdkKG_020iy0,26772
 projectdavid/clients/synchronous_inference_wrapper.py,sha256=qh94rtNlLqgIxiA_ZbQ1ncOwQTi9aBj5os3sMExLh4E,7070
 projectdavid/clients/threads_client.py,sha256=9RshJD09kfYxfarTysQz_Bwbv4XxQaHQXhCLRMdaWcI,7392
 projectdavid/clients/tools_client.py,sha256=GkCVOmwpAoPqVt6aYmH0G1HIFha3iEwR9IIf9teR0j8,11487
@@ -37,8 +37,8 @@ projectdavid/utils/monitor_launcher.py,sha256=3YAgJdeuaUvq3JGvpA4ymqFsAnk29nH5q9
 projectdavid/utils/peek_gate.py,sha256=5whMRnDOQjATRpThWDJkvY9ScXuJ7Sd_-9rvGgXeTAQ,2532
 projectdavid/utils/run_monitor.py,sha256=F_WkqIP-qnWH-4llIbileWWLfRj2Q1Cg-ni23SR1rec,3786
 projectdavid/utils/vector_search_formatter.py,sha256=YTe3HPGec26qGY7uxY8_GS8lc4QaN6aNXMzkl29nZpI,1735
-projectdavid-1.34.2.dist-info/licenses/LICENSE,sha256=_8yjiEGttpS284BkfhXxfERqTRZW_tUaHiBB0GTJTMg,4563
-projectdavid-1.34.2.dist-info/METADATA,sha256=yt-iVqj07cA22xv_rGkVk7poOsKbPiaDwRiaK3Qru4Y,11555
-projectdavid-1.34.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-projectdavid-1.34.2.dist-info/top_level.txt,sha256=kil8GU4s7qYRfNnzGnFHhZnSNRSxgNG-J4HLgQMmMtw,13
-projectdavid-1.34.2.dist-info/RECORD,,
+projectdavid-1.34.4.dist-info/licenses/LICENSE,sha256=_8yjiEGttpS284BkfhXxfERqTRZW_tUaHiBB0GTJTMg,4563
+projectdavid-1.34.4.dist-info/METADATA,sha256=DptMF63609KaYskIGlnnmpyCFrvK0jGkfBCxXCP2ImI,11555
+projectdavid-1.34.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+projectdavid-1.34.4.dist-info/top_level.txt,sha256=kil8GU4s7qYRfNnzGnFHhZnSNRSxgNG-J4HLgQMmMtw,13
+projectdavid-1.34.4.dist-info/RECORD,,