projectdavid 1.33.2__py3-none-any.whl → 1.33.4__py3-none-any.whl

projectdavid/clients/synchronous_inference_wrapper.py

@@ -113,17 +113,21 @@ class SynchronousInferenceStream:
                     yield chunk
                     continue
 
-                if chunk.get("type") in ("hot_code", "hot_code_output"):
+                if chunk.get("type") == "code_interpreter_stream":
                     yield chunk
                     continue
 
-                if (
-                    chunk.get("stream_type") == "code_execution"
-                    and chunk.get("chunk", {}).get("type") == "code_interpreter_stream"
-                ):
+                if chunk.get("type") in ("hot_code", "hot_code_output"):
                     yield chunk
                     continue
 
+                # if (
+                #    chunk.get("stream_type") == "code_execution"
+                #    and chunk.get("chunk", {}).get("type") == "code_interpreter_stream"
+                # ):
+                #    yield chunk
+                #    continue
+
                 if isinstance(chunk.get("content"), str):
                     chunk["content"] = _filter_text(chunk["content"])
                     if chunk["content"] == "":

projectdavid/clients/vectors.py

@@ -20,6 +20,7 @@ from qdrant_client.http import models as qdrant
 
 from projectdavid.clients.file_processor import FileProcessor
 from projectdavid.clients.vector_store_manager import VectorStoreManager
+from projectdavid.decorators import experimental
 from projectdavid.synthesis import reranker, retriever
 from projectdavid.synthesis.llm_synthesizer import synthesize_envelope
 from projectdavid.utils.vector_search_formatter import make_envelope
@@ -504,6 +505,7 @@ class VectorStoreClient:
             )
         )
 
+    @experimental
     def create_vector_vision_store(
         self,
         name: str,
@@ -544,6 +546,7 @@ class VectorStoreClient:
             )
         )
 
+    @experimental
     def create_vector_vision_store_for_user(
         self,
         owner_id: str,
@@ -964,6 +967,7 @@ class VectorStoreClient:
 
         return hits
 
+    @experimental
     def image_similarity_search(
         self,
         vector_store_id: str,
@@ -981,6 +985,7 @@ class VectorStoreClient:
             vector_field="image_vector",
         )
 
+    @experimental
     def search_images(
         self,
         vector_store_id: str,

projectdavid/decorators.py

@@ -0,0 +1,64 @@
+# decorators.py
+
+import functools
+import warnings
+from typing import Optional
+
+
+class ExperimentalWarning(UserWarning):
+    """
+    API is experimental, may be incomplete (and possibly not fully functional),
+    and may change or be removed without notice.
+    """
+
+
+class InternalWarning(UserWarning):
+    """
+    API is internal/admin-only. Intended for framework authors and
+    superusers—will likely change or go away without notice.
+    """
+
+
+def experimental(func):
+    """
+    Decorator to mark methods as experimental.
+    Emits an ExperimentalWarning on first call.
+    """
+
+    @functools.wraps(func)
+    def wrapper(*args, **kwargs):
+        warnings.warn(
+            f"{func.__name__} is experimental, may be incomplete, and may change in a future release",
+            ExperimentalWarning,
+            stacklevel=2,
+        )
+        return func(*args, **kwargs)
+
+    wrapper.__experimental__ = True
+    return wrapper
+
+
+def internal(func):
+    """
+    Decorator to mark a method as internal/admin-only.
+    Raises PermissionError if self.is_admin is False or missing.
+    Emits an InternalWarning on use.
+    """
+
+    @functools.wraps(func)
+    def wrapper(self, *args, **kwargs):
+        # 1️⃣ Enforce admin
+        if not getattr(self, "is_admin", False):
+            raise PermissionError(
+                f"{func.__name__} is for admin use only; your client.is_admin is False."
+            )
+        # 2️⃣ Warn about internal usage
+        warnings.warn(
+            f"{func.__name__} is internal/admin-only and may change without notice",
+            InternalWarning,
+            stacklevel=2,
+        )
+        return func(self, *args, **kwargs)
+
+    wrapper.__internal__ = True
+    return wrapper

{projectdavid-1.33.2.dist-info → projectdavid-1.33.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: projectdavid
-Version: 1.33.2
+Version: 1.33.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.33.2.dist-info → projectdavid-1.33.4.dist-info}/RECORD

@@ -1,5 +1,6 @@
 projectdavid/__init__.py,sha256=QKjYL0-e4ifiRWyp05lK_dGm0u_jaxo36fyF-c0qqeI,224
 projectdavid/_version.py,sha256=_qiy4uXbgWEU-in9CM9h6tk4Ddhzpvv-HnoAYSuiGg0,100
+projectdavid/decorators.py,sha256=xwjzSNJdg8pOeicdtWEeJeuwAwfrWfM2_cH9tI5O-l0,1730
 projectdavid/entity.py,sha256=SRZg3E9Cifz3O0Ax4FNeWXWSgOZFKUBzLYtdjbH-e_w,5832
 projectdavid/events.py,sha256=m_vu5BgphrM6dpBmnkTXK8jczwyYXO1UwXXI9340vjQ,720
 projectdavid/serializers.py,sha256=OdipJGXGGjRoZBcPkpmHSDgsNptXUg0CMn2TQoCZIOI,1723
@@ -15,12 +16,12 @@ projectdavid/clients/files_client.py,sha256=XkIDzbQFGDrd88taf0Kouc_4YJOPIYEHiIyW
 projectdavid/clients/inference_client.py,sha256=xz4ACPv5Tkis604QxO5mJX1inH_TGDfQP-31geETYpE,6609
 projectdavid/clients/messages_client.py,sha256=467xeIt3VYs6cG8-bl-eDRi_auWOPmfd5tSJDmQSJUI,17232
 projectdavid/clients/runs.py,sha256=-fXOq5L9w2efDPmZkNxb0s2yjl6oN0XN4_aLXqaeceo,25270
-projectdavid/clients/synchronous_inference_wrapper.py,sha256=mN5WAHmv0aRoeMIb7XPgv3cuqrMPzu378UsZ02jEvRY,5090
+projectdavid/clients/synchronous_inference_wrapper.py,sha256=Ll8t_dyJjuEKLxnWBi8hqMSvpW_qhh9IpkVDpHpxvlE,5227
 projectdavid/clients/threads_client.py,sha256=ekzU5w14zftmtmFkiec3NC90Of-_KVSUY1qH9cmfSFg,6771
 projectdavid/clients/tools_client.py,sha256=GkCVOmwpAoPqVt6aYmH0G1HIFha3iEwR9IIf9teR0j8,11487
 projectdavid/clients/users_client.py,sha256=eCuUb9qvyH1GUFhZu6TRL9zdoK-qzHSs8-Vmrk_0mmg,13729
 projectdavid/clients/vector_store_manager.py,sha256=q-ZgRQVX_S3nMrKYhmvkVrDjDRzM3ZFzUF55HBGRTe8,12861
-projectdavid/clients/vectors.py,sha256=co6CStRnsWk0yO5EyH5AV2c9vMYaGk3VAwIQD4Y-N20,40108
+projectdavid/clients/vectors.py,sha256=cysPVbUzW3byB82MTqG2X1Iz5ZAe82WTS1JfQcoqVhE,40229
 projectdavid/constants/platform.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 projectdavid/services/logging_service.py,sha256=jdoRL46E42Ar8JFTDOV-xVD67CulcHSN-xhcEqA5CXQ,2643
 projectdavid/synthesis/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -34,8 +35,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.33.2.dist-info/licenses/LICENSE,sha256=_8yjiEGttpS284BkfhXxfERqTRZW_tUaHiBB0GTJTMg,4563
-projectdavid-1.33.2.dist-info/METADATA,sha256=AXinjpf8D5k2ySQ7SE_roXMsr8SaPHlklAYwXW6cjG0,11554
-projectdavid-1.33.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-projectdavid-1.33.2.dist-info/top_level.txt,sha256=kil8GU4s7qYRfNnzGnFHhZnSNRSxgNG-J4HLgQMmMtw,13
-projectdavid-1.33.2.dist-info/RECORD,,
+projectdavid-1.33.4.dist-info/licenses/LICENSE,sha256=_8yjiEGttpS284BkfhXxfERqTRZW_tUaHiBB0GTJTMg,4563
+projectdavid-1.33.4.dist-info/METADATA,sha256=S5dDCeIzHHNHzmmw4uAouBr1jJK-P-MUrPhxp0n1v7Q,11554
+projectdavid-1.33.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+projectdavid-1.33.4.dist-info/top_level.txt,sha256=kil8GU4s7qYRfNnzGnFHhZnSNRSxgNG-J4HLgQMmMtw,13
+projectdavid-1.33.4.dist-info/RECORD,,