dhee 7.2.6__tar.gz → 7.2.7__tar.gz

{dhee-7.2.6/dhee.egg-info → dhee-7.2.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dhee
-Version: 7.2.6
+Version: 7.2.7
 Summary: Dhee - world memory layer and context compiler for AI agents
 Author: Sankhya AI Labs
 License-Expression: MIT
@@ -29,7 +29,6 @@ Requires-Dist: cryptography>=42.0.0
 Requires-Dist: fastapi>=0.100.0
 Requires-Dist: uvicorn>=0.20.0
 Requires-Dist: python-multipart>=0.0.9
-Requires-Dist: kuzu>=0.11.3
 Requires-Dist: tree-sitter<0.26,>=0.23.2
 Requires-Dist: tree-sitter-python<0.26,>=0.23.6
 Requires-Dist: tree-sitter-javascript<0.26,>=0.23.1
@@ -49,7 +48,7 @@ Requires-Dist: zvec>=0.4.0; python_version >= "3.11" and extra == "zvec"
 Provides-Extra: sqlite-vec
 Requires-Dist: sqlite-vec>=0.1.1; extra == "sqlite-vec"
 Provides-Extra: graph
-Requires-Dist: kuzu>=0.11.3; extra == "graph"
+Requires-Dist: kuzu>=0.11.3; python_version < "3.14" and extra == "graph"
 Provides-Extra: swe
 Requires-Dist: tree-sitter<0.26,>=0.23.2; extra == "swe"
 Requires-Dist: tree-sitter-python<0.26,>=0.23.6; extra == "swe"
@@ -90,7 +89,7 @@ Requires-Dist: mcp>=1.0.0; python_version >= "3.10" and extra == "all"
 Requires-Dist: fastapi>=0.100.0; extra == "all"
 Requires-Dist: uvicorn>=0.20.0; extra == "all"
 Requires-Dist: python-multipart>=0.0.9; extra == "all"
-Requires-Dist: kuzu>=0.11.3; extra == "all"
+Requires-Dist: kuzu>=0.11.3; python_version < "3.14" and extra == "all"
 Requires-Dist: huggingface_hub>=0.24.0; extra == "all"
 Requires-Dist: llama-cpp-python>=0.3; extra == "all"
 Requires-Dist: sentence-transformers>=3.0; extra == "all"

{dhee-7.2.6 → dhee-7.2.7}/dhee/__init__.py

@@ -50,7 +50,7 @@ from dhee.memory.admission import (
 # Default import remains model-free for backwards compatibility.
 Memory = CoreMemory
 
-__version__ = "7.2.6"
+__version__ = "7.2.7"
 __all__ = [
     # Memory classes
     "Engram",

{dhee-7.2.6 → dhee-7.2.7}/dhee/cli.py

@@ -263,7 +263,7 @@ def _get_memory_os_service(*, with_memory: bool = False):
         world_store=WorldMemoryStore(str(memory_os_dir / "world_memory.db")),
         graph_store=SessionGraphStore(str(runtime_root / "capture" / "sessions")),
         memory_client=memory_client,
-        graph_projection=CausalGraphProjection(str(memory_os_dir / "causal_scene.kuzu")),
+        graph_projection=CausalGraphProjection.if_available(str(memory_os_dir / "causal_scene.kuzu")),
     )
 
 
@@ -2063,7 +2063,11 @@ def cmd_graph(args: argparse.Namespace) -> None:
     service = _get_memory_os_service(with_memory=False)
     projection = service.graph_projection
     if projection is None:
-        raise RuntimeError("Causal graph projection is not configured")
+        from dhee.world_memory.causal_graph import KUZU_AVAILABLE, KUZU_INSTALL_HINT
+
+        raise RuntimeError(
+            KUZU_INSTALL_HINT if not KUZU_AVAILABLE else "Causal graph projection is not configured"
+        )
 
     action = args.graph_action
     user_id = getattr(args, "user_id", "default")

{dhee-7.2.6 → dhee-7.2.7}/dhee/world_memory/causal_graph.py

@@ -6,7 +6,17 @@ import shutil
 from pathlib import Path
 from typing import Any, Dict, Iterable, List, Optional, Sequence, Tuple
 
-import kuzu
+try:
+    import kuzu
+except ImportError:  # optional dependency; no cp314+ wheels exist
+    kuzu = None  # type: ignore[assignment]
+
+KUZU_AVAILABLE = kuzu is not None
+KUZU_INSTALL_HINT = (
+    "Causal graph features need the optional kuzu dependency: "
+    "pip install 'dhee[graph]' (requires Python <= 3.13; kuzu ships no "
+    "wheels for newer Pythons). Memory capture and recall work without it."
+)
 
 from .capture_store import CaptureStore
 from .schema import (
@@ -34,6 +44,8 @@ class CausalGraphProjection:
     """Kuzu projection over the SQLite causal-scene truth tables."""
 
     def __init__(self, db_path: str):
+        if not KUZU_AVAILABLE:
+            raise RuntimeError(KUZU_INSTALL_HINT)
         path = Path(db_path).expanduser()
         if path.suffix:
             self.db_path = path
@@ -43,6 +55,13 @@ class CausalGraphProjection:
             self.db_path = path / "causal_scene.kuzu"
         self.root_dir.mkdir(parents=True, exist_ok=True)
 
+    @classmethod
+    def if_available(cls, db_path: str) -> Optional["CausalGraphProjection"]:
+        """Build a projection, or None when kuzu is not installed."""
+        if not KUZU_AVAILABLE:
+            return None
+        return cls(db_path)
+
     def rebuild(self, capture_store: CaptureStore, *, user_id: str = "default") -> Dict[str, Any]:
         self.delete()
         conn = self._connect()

{dhee-7.2.6 → dhee-7.2.7}/dhee/world_memory/service.py

@@ -170,7 +170,7 @@ class MemoryOSService:
             world_store=WorldMemoryStore(str(memory_os_dir / "world_memory.db")),
             graph_store=SessionGraphStore(str(runtime_root / "capture" / "sessions")),
             memory_client=DheeMemoryClient(memory),
-            graph_projection=CausalGraphProjection(str(memory_os_dir / "causal_scene.kuzu")),
+            graph_projection=CausalGraphProjection.if_available(str(memory_os_dir / "causal_scene.kuzu")),
         )
 
     def _ensure_default_policies(self) -> None:
@@ -1303,6 +1303,10 @@ class MemoryOSService:
 
     def _require_causal_projection(self) -> CausalGraphProjection:
         if not self.graph_projection:
+            from .causal_graph import KUZU_AVAILABLE, KUZU_INSTALL_HINT
+
+            if not KUZU_AVAILABLE:
+                raise RuntimeError(KUZU_INSTALL_HINT)
             raise RuntimeError("Causal graph projection is not configured")
         return self.graph_projection
 

{dhee-7.2.6 → dhee-7.2.7/dhee.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dhee
-Version: 7.2.6
+Version: 7.2.7
 Summary: Dhee - world memory layer and context compiler for AI agents
 Author: Sankhya AI Labs
 License-Expression: MIT
@@ -29,7 +29,6 @@ Requires-Dist: cryptography>=42.0.0
 Requires-Dist: fastapi>=0.100.0
 Requires-Dist: uvicorn>=0.20.0
 Requires-Dist: python-multipart>=0.0.9
-Requires-Dist: kuzu>=0.11.3
 Requires-Dist: tree-sitter<0.26,>=0.23.2
 Requires-Dist: tree-sitter-python<0.26,>=0.23.6
 Requires-Dist: tree-sitter-javascript<0.26,>=0.23.1
@@ -49,7 +48,7 @@ Requires-Dist: zvec>=0.4.0; python_version >= "3.11" and extra == "zvec"
 Provides-Extra: sqlite-vec
 Requires-Dist: sqlite-vec>=0.1.1; extra == "sqlite-vec"
 Provides-Extra: graph
-Requires-Dist: kuzu>=0.11.3; extra == "graph"
+Requires-Dist: kuzu>=0.11.3; python_version < "3.14" and extra == "graph"
 Provides-Extra: swe
 Requires-Dist: tree-sitter<0.26,>=0.23.2; extra == "swe"
 Requires-Dist: tree-sitter-python<0.26,>=0.23.6; extra == "swe"
@@ -90,7 +89,7 @@ Requires-Dist: mcp>=1.0.0; python_version >= "3.10" and extra == "all"
 Requires-Dist: fastapi>=0.100.0; extra == "all"
 Requires-Dist: uvicorn>=0.20.0; extra == "all"
 Requires-Dist: python-multipart>=0.0.9; extra == "all"
-Requires-Dist: kuzu>=0.11.3; extra == "all"
+Requires-Dist: kuzu>=0.11.3; python_version < "3.14" and extra == "all"
 Requires-Dist: huggingface_hub>=0.24.0; extra == "all"
 Requires-Dist: llama-cpp-python>=0.3; extra == "all"
 Requires-Dist: sentence-transformers>=3.0; extra == "all"

{dhee-7.2.6 → dhee-7.2.7}/dhee.egg-info/requires.txt

@@ -5,7 +5,6 @@ cryptography>=42.0.0
 fastapi>=0.100.0
 uvicorn>=0.20.0
 python-multipart>=0.0.9
-kuzu>=0.11.3
 tree-sitter<0.26,>=0.23.2
 tree-sitter-python<0.26,>=0.23.6
 tree-sitter-javascript<0.26,>=0.23.1
@@ -19,11 +18,13 @@ ollama>=0.4.0
 fastapi>=0.100.0
 uvicorn>=0.20.0
 python-multipart>=0.0.9
-kuzu>=0.11.3
 huggingface_hub>=0.24.0
 llama-cpp-python>=0.3
 sentence-transformers>=3.0
 
+[all:python_version < "3.14"]
+kuzu>=0.11.3
+
 [all:python_version >= "3.10"]
 mcp>=1.0.0
 
@@ -65,6 +66,8 @@ elevenlabs>=2.49.0
 google-genai>=1.0.0
 
 [graph]
+
+[graph:python_version < "3.14"]
 kuzu>=0.11.3
 
 [local]

{dhee-7.2.6 → dhee-7.2.7}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "dhee"
-version = "7.2.6"
+version = "7.2.7"
 description = "Dhee - world memory layer and context compiler for AI agents"
 readme = "README.md"
 requires-python = ">=3.9"
@@ -34,7 +34,6 @@ dependencies = [
     "fastapi>=0.100.0",
     "uvicorn>=0.20.0",
     "python-multipart>=0.0.9",
-    "kuzu>=0.11.3",
     "tree-sitter>=0.23.2,<0.26",
     "tree-sitter-python>=0.23.6,<0.26",
     "tree-sitter-javascript>=0.23.1,<0.26",
@@ -51,7 +50,10 @@ ollama = ["ollama>=0.4.0"]
 nvidia = ["openai>=1.0.0"]
 zvec = ["zvec>=0.4.0; python_version >= '3.11'"]
 sqlite_vec = ["sqlite-vec>=0.1.1"]
-graph = ["kuzu>=0.11.3"]
+# Causal-scene graph projection. Kuzu ships no cp314+ wheels (upstream
+# development stopped), so the marker keeps installs from attempting a
+# source build on newer Pythons.
+graph = ["kuzu>=0.11.3; python_version < '3.14'"]
 swe = [
     "tree-sitter>=0.23.2,<0.26",
     "tree-sitter-python>=0.23.6,<0.26",
@@ -87,7 +89,7 @@ all = [
     "fastapi>=0.100.0",
     "uvicorn>=0.20.0",
     "python-multipart>=0.0.9",
-    "kuzu>=0.11.3",
+    "kuzu>=0.11.3; python_version < '3.14'",
     "huggingface_hub>=0.24.0",
     "llama-cpp-python>=0.3",
     "sentence-transformers>=3.0",

{dhee-7.2.6 → dhee-7.2.7}/tests/test_causal_scene_memory.py

@@ -4,6 +4,8 @@ from pathlib import Path
 
 import pytest
 
+pytest.importorskip("kuzu", reason="causal graph tests need the optional dhee[graph] extra")
+
 from dhee.core.learnings import LearningExchange
 from dhee.world_memory.capture_store import CaptureStore
 from dhee.world_memory.causal_graph import CausalGraphProjection