projectdavid 1.33.1__tar.gz → 1.33.3__tar.gz

{projectdavid-1.33.1 → projectdavid-1.33.3}/CHANGELOG.md

@@ -1,3 +1,17 @@
+## [1.33.3](https://github.com/frankie336/projectdavid/compare/v1.33.2...v1.33.3) (2025-06-11)
+
+
+### Bug Fixes
+
+* Place vision features in dormant experimental mode with [@experimental](https://github.com/experimental) decorators.py ([1c41702](https://github.com/frankie336/projectdavid/commit/1c41702a55ec9c6c7ad89de559cfa309ace88174))
+
+## [1.33.2](https://github.com/frankie336/projectdavid/compare/v1.33.1...v1.33.2) (2025-06-11)
+
+
+### Bug Fixes
+
+* pass file_processor_kwargs from public interface  and add default fallbacks. ([597b274](https://github.com/frankie336/projectdavid/commit/597b274e0f54fc87ac5449ac8259c8ad244b0214))
+
 ## [1.33.1](https://github.com/frankie336/projectdavid/compare/v1.33.0...v1.33.1) (2025-06-10)
 
 

{projectdavid-1.33.1/src/projectdavid.egg-info → projectdavid-1.33.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: projectdavid
-Version: 1.33.1
+Version: 1.33.3
 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.1 → projectdavid-1.33.3}/docs/vector_store.md

@@ -78,6 +78,14 @@ save_file_to_store = client.vectors.add_file_to_vector_store(
 
 At this point, your file has been vectorized to your store.
 
+
+---
+
+
+## Supporting image vectors
+
+Entities now ingests and vectorizes a wide range of image formats for semantic search. You can leverage these image embeddings to extend text-only models into powerful multi-modal workflows; enriching chatbots, document search, recommendation engines, and more.
+
 ---
 
 ### Making Searches Against Files in a Store

{projectdavid-1.33.1 → projectdavid-1.33.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "projectdavid"
-version = "1.33.1"
+version = "1.33.3"
 description = "Python SDK for interacting with the Entities Assistant API."
 readme = "README.md"
 authors = [

{projectdavid-1.33.1 → projectdavid-1.33.3}/src/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
@@ -72,8 +73,9 @@ class VectorStoreClient:
         api_key: Optional[str] = None,
         *,
         vector_store_host: str = "localhost",
-        file_processor_kwargs: Optional[dict] = None,  # 🔶 add arg
+        file_processor_kwargs: Optional[dict] = None,
     ):
+
         self.base_url = (base_url or os.getenv("BASE_URL", "")).rstrip("/")
         self.api_key = api_key or os.getenv("API_KEY")
         if not self.base_url:
@@ -94,7 +96,18 @@ class VectorStoreClient:
         self.identifier_service = UtilsInterface.IdentifierService()
 
         # 🔶 forward kwargs into the upgraded FileProcessor
-        self.file_processor = FileProcessor(**(file_processor_kwargs or {}))
+
+        self.file_processor = FileProcessor(
+            **(
+                file_processor_kwargs
+                or {
+                    "use_gpu": False,
+                    "use_detection": True,
+                    "use_geo": True,
+                    "use_ocr": True,
+                }
+            )
+        )
 
         log.info("VectorStoreClient → %s", self.base_url)
 
@@ -492,6 +505,7 @@ class VectorStoreClient:
             )
         )
 
+    @experimental
     def create_vector_vision_store(
         self,
         name: str,
@@ -532,6 +546,7 @@ class VectorStoreClient:
             )
         )
 
+    @experimental
     def create_vector_vision_store_for_user(
         self,
         owner_id: str,
@@ -952,6 +967,7 @@ class VectorStoreClient:
 
         return hits
 
+    @experimental
     def image_similarity_search(
         self,
         vector_store_id: str,
@@ -969,6 +985,7 @@ class VectorStoreClient:
             vector_field="image_vector",
         )
 
+    @experimental
     def search_images(
         self,
         vector_store_id: str,

projectdavid-1.33.3/src/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.1 → projectdavid-1.33.3}/src/projectdavid/entity.py

@@ -30,11 +30,15 @@ class Entity:
         self,
         base_url: Optional[str] = None,
         api_key: Optional[str] = None,
+        file_processor_kwargs: Optional[dict] = None,
     ):
         """
         Initialize the main client with configuration.
         Optionally, a configuration object can be injected to decouple from environment variables.
         """
+
+        self.file_processor_kwargs = file_processor_kwargs
+
         self.base_url = base_url or os.getenv(
             "ENTITIES_BASE_URL", "http://localhost:9000/"
         )
@@ -145,7 +149,9 @@ class Entity:
     def vectors(self) -> VectorStoreClient:
         if self._vectors_client is None:
             self._vectors_client = VectorStoreClient(
-                base_url=self.base_url, api_key=self.api_key
+                base_url=self.base_url,
+                api_key=self.api_key,
+                file_processor_kwargs=self.file_processor_kwargs,
             )
 
         return self._vectors_client

{projectdavid-1.33.1 → projectdavid-1.33.3/src/projectdavid.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: projectdavid
-Version: 1.33.1
+Version: 1.33.3
 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.1 → projectdavid-1.33.3}/src/projectdavid.egg-info/SOURCES.txt

@@ -24,6 +24,7 @@ docs/vector_store.md
 docs/versioning.md
 src/projectdavid/__init__.py
 src/projectdavid/_version.py
+src/projectdavid/decorators.py
 src/projectdavid/entity.py
 src/projectdavid/events.py
 src/projectdavid/serializers.py