cuemap 0.2.2__tar.gz → 0.4.0__tar.gz

{cuemap-0.2.2/cuemap.egg-info → cuemap-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cuemap
-Version: 0.2.2
+Version: 0.4.0
 Summary: Redis for AI Agents - High-performance temporal-associative memory
 Author-email: CueMap Team <hello@cuemap.dev>
 License: MIT
@@ -98,6 +98,7 @@ memory_id = client.add(
 ### Recall Memories
 
 ```python
+# OR logic (default): matches any cue
 results = client.recall(
     cues=["meeting", "john"],
     limit=10
@@ -105,6 +106,18 @@ results = client.recall(
 
 for result in results:
     print(f"{result.content} (score: {result.score})")
+
+# AND logic: requires all cues to match
+results = client.recall(
+    cues=["meeting", "john"],
+    min_intersection=2  # Both cues must match
+)
+
+# Cross-domain query (multi-tenant mode)
+results = client.recall(
+    cues=["urgent"],
+    projects=["sales", "support", "engineering"]
+)
 ```
 
 ### Reinforce Memory

{cuemap-0.2.2 → cuemap-0.4.0}/README.md

@@ -63,6 +63,7 @@ memory_id = client.add(
 ### Recall Memories
 
 ```python
+# OR logic (default): matches any cue
 results = client.recall(
     cues=["meeting", "john"],
     limit=10
@@ -70,6 +71,18 @@ results = client.recall(
 
 for result in results:
     print(f"{result.content} (score: {result.score})")
+
+# AND logic: requires all cues to match
+results = client.recall(
+    cues=["meeting", "john"],
+    min_intersection=2  # Both cues must match
+)
+
+# Cross-domain query (multi-tenant mode)
+results = client.recall(
+    cues=["urgent"],
+    projects=["sales", "support", "engineering"]
+)
 ```
 
 ### Reinforce Memory

{cuemap-0.2.2 → cuemap-0.4.0}/cuemap/client.py

@@ -48,14 +48,10 @@ class CueMap:
         """Get request headers."""
         headers = {}
         if self.api_key:
-            headers["x-api-key"] = self.api_key
-        return headers
-    
-    def _endpoint(self, path: str) -> str:
-        """Get endpoint with optional project_id."""
+            headers["X-API-Key"] = self.api_key
         if self.project_id:
-            return f"/v1/{self.project_id}{path}"
-        return path
+            headers["X-Project-ID"] = self.project_id
+        return headers
     
     def add(
         self,
@@ -81,7 +77,7 @@ class CueMap:
             ... )
         """
         response = self.client.post(
-            self._endpoint("/memories"),
+            "/memories",
             json={
                 "content": content,
                 "cues": cues,
@@ -101,7 +97,9 @@ class CueMap:
         self,
         cues: List[str],
         limit: int = 10,
-        auto_reinforce: bool = False
+        auto_reinforce: bool = False,
+        min_intersection: Optional[int] = None,
+        projects: Optional[List[str]] = None
     ) -> List[RecallResult]:
         """
         Recall memories by cues.
@@ -110,22 +108,37 @@ class CueMap:
             cues: List of cues to search for
             limit: Maximum results to return
             auto_reinforce: Automatically reinforce retrieved memories
+            min_intersection: Minimum number of cues that must match (for strict AND logic)
+            projects: List of project IDs for cross-domain queries (multi-tenant only)
             
         Returns:
             List of recall results
             
         Example:
+            >>> # OR logic (default): matches any cue
             >>> results = client.recall(["meeting", "john"])
-            >>> for r in results:
-            ...     print(r.content)
+            
+            >>> # AND logic: requires both cues
+            >>> results = client.recall(["meeting", "john"], min_intersection=2)
+            
+            >>> # Cross-domain query (multi-tenant)
+            >>> results = client.recall(["urgent"], projects=["sales", "support"])
         """
+        payload = {
+            "cues": cues,
+            "limit": limit,
+            "auto_reinforce": auto_reinforce
+        }
+        
+        if min_intersection is not None:
+            payload["min_intersection"] = min_intersection
+        
+        if projects is not None:
+            payload["projects"] = projects
+        
         response = self.client.post(
-            self._endpoint("/recall"),
-            json={
-                "cues": cues,
-                "limit": limit,
-                "auto_reinforce": auto_reinforce
-            },
+            "/recall",
+            json=payload,
             headers=self._headers()
         )
         
@@ -147,7 +160,7 @@ class CueMap:
             Success status
         """
         response = self.client.patch(
-            self._endpoint(f"/memories/{memory_id}/reinforce"),
+            f"/memories/{memory_id}/reinforce",
             json={"cues": cues},
             headers=self._headers()
         )
@@ -157,7 +170,7 @@ class CueMap:
     def get(self, memory_id: str) -> Memory:
         """Get a memory by ID."""
         response = self.client.get(
-            self._endpoint(f"/memories/{memory_id}"),
+            f"/memories/{memory_id}",
             headers=self._headers()
         )
         
@@ -171,7 +184,7 @@ class CueMap:
     def stats(self) -> Dict[str, Any]:
         """Get server statistics."""
         response = self.client.get(
-            self._endpoint("/stats"),
+            "/stats",
             headers=self._headers()
         )
         
@@ -217,13 +230,10 @@ class AsyncCueMap:
     def _headers(self) -> Dict[str, str]:
         headers = {}
         if self.api_key:
-            headers["x-api-key"] = self.api_key
-        return headers
-    
-    def _endpoint(self, path: str) -> str:
+            headers["X-API-Key"] = self.api_key
         if self.project_id:
-            return f"/v1/{self.project_id}{path}"
-        return path
+            headers["X-Project-ID"] = self.project_id
+        return headers
     
     async def add(
         self,
@@ -233,7 +243,7 @@ class AsyncCueMap:
     ) -> str:
         """Add a memory (async)."""
         response = await self.client.post(
-            self._endpoint("/memories"),
+            "/memories",
             json={
                 "content": content,
                 "cues": cues,
@@ -253,16 +263,26 @@ class AsyncCueMap:
         self,
         cues: List[str],
         limit: int = 10,
-        auto_reinforce: bool = False
+        auto_reinforce: bool = False,
+        min_intersection: Optional[int] = None,
+        projects: Optional[List[str]] = None
     ) -> List[RecallResult]:
         """Recall memories (async)."""
+        payload = {
+            "cues": cues,
+            "limit": limit,
+            "auto_reinforce": auto_reinforce
+        }
+        
+        if min_intersection is not None:
+            payload["min_intersection"] = min_intersection
+        
+        if projects is not None:
+            payload["projects"] = projects
+        
         response = await self.client.post(
-            self._endpoint("/recall"),
-            json={
-                "cues": cues,
-                "limit": limit,
-                "auto_reinforce": auto_reinforce
-            },
+            "/recall",
+            json=payload,
             headers=self._headers()
         )
         
@@ -275,7 +295,7 @@ class AsyncCueMap:
     async def reinforce(self, memory_id: str, cues: List[str]) -> bool:
         """Reinforce a memory (async)."""
         response = await self.client.patch(
-            self._endpoint(f"/memories/{memory_id}/reinforce"),
+            f"/memories/{memory_id}/reinforce",
             json={"cues": cues},
             headers=self._headers()
         )
@@ -285,7 +305,7 @@ class AsyncCueMap:
     async def get(self, memory_id: str) -> Memory:
         """Get a memory by ID (async)."""
         response = await self.client.get(
-            self._endpoint(f"/memories/{memory_id}"),
+            f"/memories/{memory_id}",
             headers=self._headers()
         )
         
@@ -299,7 +319,7 @@ class AsyncCueMap:
     async def stats(self) -> Dict[str, Any]:
         """Get server statistics (async)."""
         response = await self.client.get(
-            self._endpoint("/stats"),
+            "/stats",
             headers=self._headers()
         )
         

{cuemap-0.2.2 → cuemap-0.4.0/cuemap.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cuemap
-Version: 0.2.2
+Version: 0.4.0
 Summary: Redis for AI Agents - High-performance temporal-associative memory
 Author-email: CueMap Team <hello@cuemap.dev>
 License: MIT
@@ -98,6 +98,7 @@ memory_id = client.add(
 ### Recall Memories
 
 ```python
+# OR logic (default): matches any cue
 results = client.recall(
     cues=["meeting", "john"],
     limit=10
@@ -105,6 +106,18 @@ results = client.recall(
 
 for result in results:
     print(f"{result.content} (score: {result.score})")
+
+# AND logic: requires all cues to match
+results = client.recall(
+    cues=["meeting", "john"],
+    min_intersection=2  # Both cues must match
+)
+
+# Cross-domain query (multi-tenant mode)
+results = client.recall(
+    cues=["urgent"],
+    projects=["sales", "support", "engineering"]
+)
 ```
 
 ### Reinforce Memory

{cuemap-0.2.2 → cuemap-0.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "cuemap"
-version = "0.2.2"
+version = "0.4.0"
 description = "Redis for AI Agents - High-performance temporal-associative memory"
 readme = "README.md"
 requires-python = ">=3.8"