hebbrix 2.1.0__tar.gz → 2.2.0__tar.gz

hebbrix-2.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Hebbrix
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

{hebbrix-2.1.0 → hebbrix-2.2.0}/MANIFEST.in

@@ -1,5 +1,4 @@
 include README.md
 include LICENSE
 include pyproject.toml
-recursive-include hebbrix_sdk *.py
-
+recursive-include hebbrix *.py

{hebbrix-2.1.0 → hebbrix-2.2.0}/PKG-INFO

@@ -1,12 +1,10 @@
 Metadata-Version: 2.4
 Name: hebbrix
-Version: 2.1.0
+Version: 2.2.0
 Summary: Advanced Memory API for AI Agents with Reinforcement Learning - 3-line integration
-Home-page: https://github.com/hebbrix/hebbrix-python
-Author: Hebbrix Team
 Author-email: Hebbrix Team <support@hebbrix.com>
 Maintainer-email: Hebbrix Team <support@hebbrix.com>
-License: MIT
+License-Expression: MIT
 Project-URL: Homepage, https://hebbrix.com
 Project-URL: Documentation, https://docs.hebbrix.com
 Project-URL: Repository, https://github.com/hebbrix/hebbrix-python
@@ -18,7 +16,6 @@ Classifier: Intended Audience :: Developers
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
 Classifier: Topic :: Database
-Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
@@ -29,6 +26,7 @@ Classifier: Operating System :: OS Independent
 Classifier: Framework :: AsyncIO
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
+License-File: LICENSE
 Requires-Dist: httpx>=0.25.0
 Requires-Dist: requests>=2.31.0
 Provides-Extra: dev
@@ -37,9 +35,7 @@ Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
 Requires-Dist: black>=23.0.0; extra == "dev"
 Requires-Dist: flake8>=6.0.0; extra == "dev"
 Requires-Dist: mypy>=1.0.0; extra == "dev"
-Dynamic: author
-Dynamic: home-page
-Dynamic: requires-python
+Dynamic: license-file
 
 # Hebbrix Python SDK
 
@@ -57,6 +53,7 @@ Official Python SDK for the Hebbrix api - **the only memory API with Reinforceme
 - ✅ **Procedural Memory** - Store and execute learned skills
 - ✅ **Working Memory** - Short-term context buffer for conversations
 - ✅ **Memory Consolidation** - Automatic compression of episodic memories
+- ✅ **ProofLoop** - Learn from outcomes with automatic, verifiable evidence receipts
 - ✅ **Async/Await** - Full async support with httpx
 - ✅ **Type Hints** - Complete type annotations
 - ✅ **Clean API** - Pythonic, intuitive interface
@@ -105,6 +102,27 @@ async def main():
 asyncio.run(main())
 ```
 
+## ProofLoop: search → decision → outcome → proof
+
+```python
+search = await client.search_with_proof(
+    "What should the agent do next?",
+    collection_id="collection-42",
+    user_id="customer-7",
+)
+decision = await client.proofloop.decide(
+    policy_key="agent.next_action",
+    candidates=[{"action_key": "act"}, {"action_key": "ask"}],
+    collection_id="collection-42",
+    user_id="customer-7",
+    proof_context=search["proof_context"],
+)
+await client.proofloop.record_outcome(
+    decision["decision_id"], success=True, idempotency_key="run-123-result"
+)
+proof = await client.proofloop.proof(decision["decision_id"])
+```
+
 ## 📚 Complete Documentation
 
 Visit https://docs.hebbrix.com for full documentation.

{hebbrix-2.1.0 → hebbrix-2.2.0}/README.md

@@ -14,6 +14,7 @@ Official Python SDK for the Hebbrix api - **the only memory API with Reinforceme
 - ✅ **Procedural Memory** - Store and execute learned skills
 - ✅ **Working Memory** - Short-term context buffer for conversations
 - ✅ **Memory Consolidation** - Automatic compression of episodic memories
+- ✅ **ProofLoop** - Learn from outcomes with automatic, verifiable evidence receipts
 - ✅ **Async/Await** - Full async support with httpx
 - ✅ **Type Hints** - Complete type annotations
 - ✅ **Clean API** - Pythonic, intuitive interface
@@ -62,6 +63,27 @@ async def main():
 asyncio.run(main())
 ```
 
+## ProofLoop: search → decision → outcome → proof
+
+```python
+search = await client.search_with_proof(
+    "What should the agent do next?",
+    collection_id="collection-42",
+    user_id="customer-7",
+)
+decision = await client.proofloop.decide(
+    policy_key="agent.next_action",
+    candidates=[{"action_key": "act"}, {"action_key": "ask"}],
+    collection_id="collection-42",
+    user_id="customer-7",
+    proof_context=search["proof_context"],
+)
+await client.proofloop.record_outcome(
+    decision["decision_id"], success=True, idempotency_key="run-123-result"
+)
+proof = await client.proofloop.proof(decision["decision_id"])
+```
+
 ## 📚 Complete Documentation
 
 Visit https://docs.hebbrix.com for full documentation.

{hebbrix-2.1.0 → hebbrix-2.2.0}/hebbrix/__init__.py

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

{hebbrix-2.1.0 → hebbrix-2.2.0}/hebbrix/client.py

@@ -8,14 +8,28 @@ import os
 from typing import Any, Dict, List, Optional
 
 import httpx
-from hebbrix.exceptions import (AuthenticationError, HebbrixError,
-                                NotFoundError, RateLimitError, ServerError,
-                                ValidationError)
-from hebbrix.resources import (AuthResource, CollectionsResource,
-                               ConsolidationResource, MemoriesResource,
-                               MemoryToolsResource, ProceduralResource,
-                               RLResource, SearchResource, TemporalResource,
-                               WorkingMemoryResource, WorldModelResource)
+from hebbrix.exceptions import (
+    AuthenticationError,
+    HebbrixError,
+    NotFoundError,
+    RateLimitError,
+    ServerError,
+    ValidationError,
+)
+from hebbrix.resources import (
+    AuthResource,
+    CollectionsResource,
+    ConsolidationResource,
+    MemoriesResource,
+    MemoryToolsResource,
+    ProceduralResource,
+    ProofLoopResource,
+    RLResource,
+    SearchResource,
+    TemporalResource,
+    WorkingMemoryResource,
+    WorldModelResource,
+)
 
 
 class MemoryClient:
@@ -60,6 +74,7 @@ class MemoryClient:
         self.collections = CollectionsResource(self)
         self.memories = MemoriesResource(self)
         self.search_resource = SearchResource(self)
+        self.proofloop = ProofLoopResource(self)
         self.rl = RLResource(self)
         self.procedural = ProceduralResource(self)
         self.temporal = TemporalResource(self)
@@ -72,7 +87,7 @@ class MemoryClient:
         """Get request headers."""
         headers = {
             "Content-Type": "application/json",
-            "User-Agent": "hebbrix-python/2.0.0",
+            "User-Agent": "hebbrix-python/2.2.0",
         }
 
         if self.api_key:
@@ -182,6 +197,26 @@ class MemoryClient:
             filters=filters or {},
         )
 
+    async def search_with_proof(
+        self,
+        query: str,
+        collection_id: Optional[str] = None,
+        limit: int = 10,
+        search_type: str = "hybrid",
+        filters: Optional[Dict[str, Any]] = None,
+        user_id: Optional[str] = None,
+    ) -> Dict[str, Any]:
+        """Search and return both results and the automatic ProofLoop context."""
+
+        return await self.search_resource.search_with_proof(
+            query=query,
+            collection_id=collection_id,
+            limit=limit,
+            search_type=search_type,
+            filters=filters or {},
+            user_id=user_id,
+        )
+
     async def reason(
         self,
         query: str,

{hebbrix-2.1.0 → hebbrix-2.2.0}/hebbrix/resources.py

@@ -3,7 +3,8 @@ API Resource classes
 
 Each resource class wraps a specific set of API endpoints.
 """
-from typing import Optional, Dict, Any, List, AsyncIterator, TYPE_CHECKING
+
+from typing import TYPE_CHECKING, Any, AsyncIterator, Dict, List, Optional
 
 if TYPE_CHECKING:
     from hebbrix.client import MemoryClient
@@ -196,7 +197,7 @@ 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,
@@ -225,7 +226,9 @@ class MemoriesResource(BaseResource):
         Args:
             collection_id: Collection ID
             content: Memory content
-            importance: Importance hint (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
@@ -236,17 +239,21 @@ class MemoriesResource(BaseResource):
             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 {},
-                "infer": infer,
-            },
+            json=payload,
         )
 
     async def list_page(
@@ -425,6 +432,33 @@ class SearchResource(BaseResource):
 
         return response.get("results", [])
 
+    async def search_with_proof(
+        self,
+        query: str,
+        collection_id: Optional[str] = None,
+        limit: int = 10,
+        search_type: str = "hybrid",
+        filters: Optional[Dict[str, Any]] = None,
+        user_id: Optional[str] = None,
+    ) -> Dict[str, Any]:
+        """Search and preserve the automatic ProofLoop context.
+
+        The legacy ``search`` method still returns only the result list. Use
+        this method when the selected evidence will feed a learned decision.
+        """
+
+        return await self.client.post(
+            "/v1/search",
+            json={
+                "query": query,
+                "collection_id": collection_id,
+                "user_id": user_id,
+                "limit": limit,
+                "search_type": search_type,
+                "filters": filters or {},
+            },
+        )
+
     async def similar(
         self,
         memory_id: str,
@@ -477,6 +511,61 @@ class SearchResource(BaseResource):
         )
 
 
+class ProofLoopResource(BaseResource):
+    """Outcome Memory decisions with automatic evidence and verifiable proofs."""
+
+    async def decide(
+        self,
+        *,
+        policy_key: str,
+        candidates: List[Dict[str, Any]],
+        proof_context: Optional[Any] = None,
+        collection_id: Optional[str] = None,
+        user_id: Optional[str] = None,
+        **kwargs,
+    ) -> Dict[str, Any]:
+        token = (
+            proof_context.get("token")
+            if isinstance(proof_context, dict)
+            else proof_context
+        )
+        body = {
+            "policy_key": policy_key,
+            "candidates": candidates,
+            "collection_id": collection_id,
+            "user_id": user_id,
+            **kwargs,
+        }
+        if token:
+            body["proof_context_token"] = token
+        return await self.client.post("/v1/learning/decisions", json=body)
+
+    async def record_outcome(
+        self,
+        decision_id: str,
+        *,
+        observations: Optional[List[Dict[str, Any]]] = None,
+        reward: Optional[float] = None,
+        success: Optional[bool] = None,
+        idempotency_key: Optional[str] = None,
+    ) -> Dict[str, Any]:
+        return await self.client.post(
+            f"/v1/learning/decisions/{decision_id}/outcomes",
+            json={
+                "observations": observations or [],
+                "reward": reward,
+                "success": success,
+                "idempotency_key": idempotency_key,
+            },
+        )
+
+    async def proof(self, decision_id: str) -> Dict[str, Any]:
+        return await self.client.get(f"/v1/learning/decisions/{decision_id}/proof")
+
+    async def public_key(self) -> Dict[str, Any]:
+        return await self.client.get("/v1/learning/proof-key")
+
+
 class RLResource(BaseResource):
     """Reinforcement Learning training endpoints."""
 

{hebbrix-2.1.0 → hebbrix-2.2.0}/hebbrix.egg-info/PKG-INFO

@@ -1,12 +1,10 @@
 Metadata-Version: 2.4
 Name: hebbrix
-Version: 2.1.0
+Version: 2.2.0
 Summary: Advanced Memory API for AI Agents with Reinforcement Learning - 3-line integration
-Home-page: https://github.com/hebbrix/hebbrix-python
-Author: Hebbrix Team
 Author-email: Hebbrix Team <support@hebbrix.com>
 Maintainer-email: Hebbrix Team <support@hebbrix.com>
-License: MIT
+License-Expression: MIT
 Project-URL: Homepage, https://hebbrix.com
 Project-URL: Documentation, https://docs.hebbrix.com
 Project-URL: Repository, https://github.com/hebbrix/hebbrix-python
@@ -18,7 +16,6 @@ Classifier: Intended Audience :: Developers
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
 Classifier: Topic :: Database
-Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
@@ -29,6 +26,7 @@ Classifier: Operating System :: OS Independent
 Classifier: Framework :: AsyncIO
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
+License-File: LICENSE
 Requires-Dist: httpx>=0.25.0
 Requires-Dist: requests>=2.31.0
 Provides-Extra: dev
@@ -37,9 +35,7 @@ Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
 Requires-Dist: black>=23.0.0; extra == "dev"
 Requires-Dist: flake8>=6.0.0; extra == "dev"
 Requires-Dist: mypy>=1.0.0; extra == "dev"
-Dynamic: author
-Dynamic: home-page
-Dynamic: requires-python
+Dynamic: license-file
 
 # Hebbrix Python SDK
 
@@ -57,6 +53,7 @@ Official Python SDK for the Hebbrix api - **the only memory API with Reinforceme
 - ✅ **Procedural Memory** - Store and execute learned skills
 - ✅ **Working Memory** - Short-term context buffer for conversations
 - ✅ **Memory Consolidation** - Automatic compression of episodic memories
+- ✅ **ProofLoop** - Learn from outcomes with automatic, verifiable evidence receipts
 - ✅ **Async/Await** - Full async support with httpx
 - ✅ **Type Hints** - Complete type annotations
 - ✅ **Clean API** - Pythonic, intuitive interface
@@ -105,6 +102,27 @@ async def main():
 asyncio.run(main())
 ```
 
+## ProofLoop: search → decision → outcome → proof
+
+```python
+search = await client.search_with_proof(
+    "What should the agent do next?",
+    collection_id="collection-42",
+    user_id="customer-7",
+)
+decision = await client.proofloop.decide(
+    policy_key="agent.next_action",
+    candidates=[{"action_key": "act"}, {"action_key": "ask"}],
+    collection_id="collection-42",
+    user_id="customer-7",
+    proof_context=search["proof_context"],
+)
+await client.proofloop.record_outcome(
+    decision["decision_id"], success=True, idempotency_key="run-123-result"
+)
+proof = await client.proofloop.proof(decision["decision_id"])
+```
+
 ## 📚 Complete Documentation
 
 Visit https://docs.hebbrix.com for full documentation.

{hebbrix-2.1.0 → hebbrix-2.2.0}/hebbrix.egg-info/SOURCES.txt

@@ -1,7 +1,7 @@
+LICENSE
 MANIFEST.in
 README.md
 pyproject.toml
-setup.py
 hebbrix/__init__.py
 hebbrix/chat.py
 hebbrix/client.py

{hebbrix-2.1.0 → hebbrix-2.2.0}/pyproject.toml

@@ -1,14 +1,15 @@
 [build-system]
-requires = ["setuptools>=61.0", "wheel"]
+requires = ["setuptools>=77.0", "wheel"]
 build-backend = "setuptools.build_meta"
 
 [project]
 name = "hebbrix"
-version = "2.1.0"
+version = "2.2.0"
 description = "Advanced Memory API for AI Agents with Reinforcement Learning - 3-line integration"
 readme = "README.md"
 requires-python = ">=3.8"
-license = {text = "MIT"}
+license = "MIT"
+license-files = ["LICENSE"]
 authors = [
     {name = "Hebbrix Team", email = "support@hebbrix.com"}
 ]
@@ -37,7 +38,6 @@ classifiers = [
     "Topic :: Software Development :: Libraries :: Python Modules",
     "Topic :: Scientific/Engineering :: Artificial Intelligence",
     "Topic :: Database",
-    "License :: OSI Approved :: MIT License",
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3.8",
     "Programming Language :: Python :: 3.9",
@@ -72,4 +72,3 @@ Repository = "https://github.com/hebbrix/hebbrix-python"
 where = ["."]
 include = ["hebbrix*"]
 exclude = ["tests*", "memory_ai*", "memory_ai_sdk*"]
-

hebbrix-2.1.0/setup.py

@@ -1,57 +0,0 @@
-"""
-Hebbrix Python SDK Setup
-Official Python SDK for the Hebbrix Memory API
-"""
-from setuptools import setup, find_packages
-
-with open("README.md", "r", encoding="utf-8") as fh:
-    long_description = fh.read()
-
-setup(
-    name="hebbrix",
-    version="2.1.0",
-    author="Hebbrix Team",
-    author_email="support@hebbrix.com",
-    description="Advanced Memory API for AI Agents with Reinforcement Learning - 3-line integration",
-    long_description=long_description,
-    long_description_content_type="text/markdown",
-    url="https://github.com/hebbrix/hebbrix-python",
-    project_urls={
-        "Documentation": "https://docs.hebbrix.com",
-        "Bug Tracker": "https://github.com/hebbrix/hebbrix-python/issues",
-        "Source": "https://github.com/hebbrix/hebbrix-python",
-        "API Reference": "https://api.hebbrix.com/docs",
-    },
-    packages=find_packages(include=["hebbrix", "hebbrix.*"]),
-    classifiers=[
-        "Development Status :: 5 - Production/Stable",
-        "Intended Audience :: Developers",
-        "License :: OSI Approved :: MIT License",
-        "Operating System :: OS Independent",
-        "Programming Language :: Python :: 3",
-        "Programming Language :: Python :: 3.8",
-        "Programming Language :: Python :: 3.9",
-        "Programming Language :: Python :: 3.10",
-        "Programming Language :: Python :: 3.11",
-        "Programming Language :: Python :: 3.12",
-        "Topic :: Software Development :: Libraries :: Python Modules",
-        "Topic :: Scientific/Engineering :: Artificial Intelligence",
-        "Topic :: Database",
-        "Framework :: AsyncIO",
-    ],
-    keywords="ai memory agents llm chatbot rag vector-search knowledge-graph reinforcement-learning",
-    python_requires=">=3.8",
-    install_requires=[
-        "httpx>=0.25.0",
-        "requests>=2.31.0",
-    ],
-    extras_require={
-        "dev": [
-            "pytest>=7.0.0",
-            "pytest-asyncio>=0.21.0",
-            "pytest-cov>=4.0.0",
-            "black>=23.0.0",
-            "mypy>=1.0.0",
-        ],
-    },
-)