hebbrix 2.0.3__tar.gz → 2.1.1__tar.gz

{hebbrix-2.0.3 → hebbrix-2.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hebbrix
-Version: 2.0.3
+Version: 2.1.1
 Summary: Advanced Memory API for AI Agents with Reinforcement Learning - 3-line integration
 Home-page: https://github.com/hebbrix/hebbrix-python
 Author: Hebbrix Team

{hebbrix-2.0.3 → hebbrix-2.1.1}/hebbrix/__init__.py

@@ -41,7 +41,7 @@ Features:
 - ✅ Type hints throughout
 """
 
-__version__ = "2.0.3"
+__version__ = "2.1.1"
 __author__ = "Hebbrix Team"
 __license__ = "MIT"
 

{hebbrix-2.0.3 → hebbrix-2.1.1}/hebbrix/resources.py

@@ -196,35 +196,63 @@ class MemoriesResource(BaseResource):
         self,
         collection_id: str,
         content: str,
-        importance: float = 0.5,
+        importance: Optional[float] = None,
         source_type: str = "text",
         source_reference: Optional[str] = None,
         metadata: Optional[Dict[str, Any]] = None,
+        infer: bool = False,
     ) -> Dict[str, Any]:
         """
-        Create a new memory.
+        Create a memory.
+
+        By default (``infer=False``) the content is stored verbatim as a single
+        memory and the response's ``results[0].id`` is that memory's real,
+        immediately-resolvable id — so ``create()`` round-trips with ``get()``.
+
+        Behavior change (SDK 2.1.0): previously ``create()`` implicitly used the
+        server's LLM extract-and-resolve path (``infer=true``), which rewrote the
+        content, could emit zero or several fact rows, and — when the server ran
+        extraction asynchronously — returned a transient job id that ``get()``
+        could not resolve. That transient id is why a create/get round-trip
+        failed. Storing verbatim by default makes the returned id stable.
+
+        Pass ``infer=True`` to opt into fact extraction (``POST /v1/memories``
+        with server-side inference). In that mode ``results`` may contain several
+        extracted-fact ids, or the response may be ``{"job_id": ...}`` if the
+        server extracts asynchronously — poll that job rather than treating it as
+        a memory id.
 
         Args:
             collection_id: Collection ID
             content: Memory content
-            importance: Importance score (0-1)
+            importance: Importance (0-1). When set, the direct-store path
+                (``infer=False``) uses this EXACT value. Leave as ``None`` to let
+                the server auto-score. Ignored when ``infer=True``.
             source_type: Type of source
             source_reference: Reference to source
             metadata: Optional metadata
+            infer: When True, extract facts via the LLM pipeline instead of
+                storing ``content`` verbatim. Default False (direct store).
 
         Returns:
-            Created memory
-        """
+            Created memory (MemoryAddResponse). With ``infer=False`` (default),
+            ``results[0].id`` is the real, get-able memory id.
+        """
+        payload: Dict[str, Any] = {
+            "collection_id": collection_id,
+            "content": content,
+            "source_type": source_type,
+            "source_reference": source_reference,
+            "metadata": metadata or {},
+            "infer": infer,
+        }
+        # Send importance ONLY when the caller set it, so an unspecified
+        # importance keeps the server's auto-scoring instead of pinning a value.
+        if importance is not None:
+            payload["importance"] = importance
         return await self.client.post(
             "/v1/memories",
-            json={
-                "collection_id": collection_id,
-                "content": content,
-                "importance": importance,
-                "source_type": source_type,
-                "source_reference": source_reference,
-                "metadata": metadata or {},
-            },
+            json=payload,
         )
 
     async def list_page(

{hebbrix-2.0.3 → hebbrix-2.1.1}/hebbrix.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hebbrix
-Version: 2.0.3
+Version: 2.1.1
 Summary: Advanced Memory API for AI Agents with Reinforcement Learning - 3-line integration
 Home-page: https://github.com/hebbrix/hebbrix-python
 Author: Hebbrix Team

{hebbrix-2.0.3 → hebbrix-2.1.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "hebbrix"
-version = "2.0.3"
+version = "2.1.1"
 description = "Advanced Memory API for AI Agents with Reinforcement Learning - 3-line integration"
 readme = "README.md"
 requires-python = ">=3.8"

{hebbrix-2.0.3 → hebbrix-2.1.1}/setup.py

@@ -9,7 +9,7 @@ with open("README.md", "r", encoding="utf-8") as fh:
 
 setup(
     name="hebbrix",
-    version="2.0.3",
+    version="2.1.1",
     author="Hebbrix Team",
     author_email="support@hebbrix.com",
     description="Advanced Memory API for AI Agents with Reinforcement Learning - 3-line integration",