hebbrix 2.6.2__tar.gz → 2.6.3__tar.gz

{hebbrix-2.6.2 → hebbrix-2.6.3}/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 2.6.3 — 2026-10-14 (candidate memory_ids)
+
+- Candidates may carry optional `memory_ids` (at most 50 ids of 1-255 characters) naming the exact memories that action applies; when the candidate becomes the decision's action, its outcome is credited to those memories.
+- The advisor input snapshot (`decide_with_advice`) admits and validates `memory_ids` before any evidence read, callback or write; `proofloop.decide` documents the candidate shape.
+- Requires the server release that credits outcomes only to memories bound to the action taken; a `proof_context` attests what was retrieved and no longer earns per-memory outcome credit by itself.
+
 ## 2.6.2 — 2026-10-06 (compact advice, batches and confirmation)
 
 - Correct canonical documentation metadata and simplify the stable three-call guide.

{hebbrix-2.6.2/hebbrix.egg-info → hebbrix-2.6.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hebbrix
-Version: 2.6.2
+Version: 2.6.3
 Summary: Typed Python client for Hebbrix memory, retrieval, and outcome-learning APIs
 Author-email: Hebbrix Team <support@hebbrix.com>
 Maintainer-email: Hebbrix Team <support@hebbrix.com>
@@ -65,14 +65,14 @@ Dynamic: license-file
 
 Typed Python client for Hebbrix memory, retrieval, and outcome-learning APIs.
 
-The current stable package is **2.6.2**. Start with memory storage and search, or
+The current stable package is **2.6.3**. Start with memory storage and search, or
 the three-call outcome-learning workflow below. Advanced evidence and execution
 permission transports are opt-in; installing the SDK never permits an action.
 
 ## Install
 
 ```bash
-pip install hebbrix==2.6.2
+pip install hebbrix==2.6.3
 ```
 
 Python 3.8+ is supported. `MemoryClient` is asynchronous. `SyncMemoryClient`
@@ -151,6 +151,11 @@ The canonical `gate` is `ASK`, `REVIEW`, `ACT`, or `BLOCK`. `BLOCK` dominates;
 `ACT` is advice, not permission. Apply your own current authorization and human
 approval policy before executing any tool. Do not infer permission from a score.
 
+Version 2.6.3 lets each `proofloop.decide` candidate carry `memory_ids`: the exact
+memories that action applies. When that candidate becomes the decision's action,
+its outcome is credited to those memories; a `proof_context` attests what was
+retrieved but never earns per-memory outcome credit by itself.
+
 Version 2.6.2 adds compact advice, batch, and explicit confirmation helpers.
 They require matching Round9 server routes. Compact views retain scope and safety
 caveats; complete receipts remain on the server.

{hebbrix-2.6.2 → hebbrix-2.6.3}/README.md

@@ -2,14 +2,14 @@
 
 Typed Python client for Hebbrix memory, retrieval, and outcome-learning APIs.
 
-The current stable package is **2.6.2**. Start with memory storage and search, or
+The current stable package is **2.6.3**. Start with memory storage and search, or
 the three-call outcome-learning workflow below. Advanced evidence and execution
 permission transports are opt-in; installing the SDK never permits an action.
 
 ## Install
 
 ```bash
-pip install hebbrix==2.6.2
+pip install hebbrix==2.6.3
 ```
 
 Python 3.8+ is supported. `MemoryClient` is asynchronous. `SyncMemoryClient`
@@ -88,6 +88,11 @@ The canonical `gate` is `ASK`, `REVIEW`, `ACT`, or `BLOCK`. `BLOCK` dominates;
 `ACT` is advice, not permission. Apply your own current authorization and human
 approval policy before executing any tool. Do not infer permission from a score.
 
+Version 2.6.3 lets each `proofloop.decide` candidate carry `memory_ids`: the exact
+memories that action applies. When that candidate becomes the decision's action,
+its outcome is credited to those memories; a `proof_context` attests what was
+retrieved but never earns per-memory outcome credit by itself.
+
 Version 2.6.2 adds compact advice, batch, and explicit confirmation helpers.
 They require matching Round9 server routes. Compact views retain scope and safety
 caveats; complete receipts remain on the server.

{hebbrix-2.6.2 → hebbrix-2.6.3}/hebbrix/__init__.py

@@ -5,7 +5,7 @@ production OpenAPI and ``GET /v1/users/me/capabilities``. The experimental
 World Model is intentionally absent from this release.
 """
 
-__version__ = "2.6.2"
+__version__ = "2.6.3"
 __author__ = "Hebbrix Team"
 __license__ = "MIT"
 

{hebbrix-2.6.2 → hebbrix-2.6.3}/hebbrix/_advice.py

@@ -121,9 +121,11 @@ def _snapshot_advisor_inputs(candidates, context):
             "action_key",
             "description",
             "features",
+            "memory_ids",
         }:
             raise ValueError(
-                "candidates must contain only action_key, description and features"
+                "candidates must contain only action_key, description, features "
+                "and memory_ids"
             )
         key = candidate.get("action_key")
         if (
@@ -145,6 +147,18 @@ def _snapshot_advisor_inputs(candidates, context):
             )
         if "features" in candidate and type(candidate["features"]) is not dict:
             raise ValueError("candidate features must be a JSON object")
+        memory_ids = candidate.get("memory_ids")
+        if memory_ids is not None and (
+            type(memory_ids) is not list
+            or len(memory_ids) > 50
+            or any(
+                type(memory_id) is not str or not 1 <= len(memory_id) <= 255
+                for memory_id in memory_ids
+            )
+        ):
+            raise ValueError(
+                "candidate memory_ids must be a list of at most 50 memory ids"
+            )
         keys.append(key)
     return candidates_copy, context_copy, keys
 

{hebbrix-2.6.2 → hebbrix-2.6.3}/hebbrix/client.py

@@ -93,7 +93,7 @@ class MemoryClient:
         """Get request headers."""
         headers = {
             "Content-Type": "application/json",
-            "User-Agent": "hebbrix-python/2.6.2",
+            "User-Agent": "hebbrix-python/2.6.3",
         }
 
         if self.api_key:

{hebbrix-2.6.2 → hebbrix-2.6.3}/hebbrix/resources.py

@@ -1170,6 +1170,15 @@ class ProofLoopResource(BaseResource):
         idempotency_key: Optional[str] = None,
         **kwargs,
     ) -> Dict[str, Any]:
+        """Log one decision among 1-50 candidate actions.
+
+        Each candidate is ``{"action_key": str, "description"?: str,
+        "features"?: dict, "memory_ids"?: list[str]}``. ``memory_ids`` (at most
+        50) names the exact memories the action applies, such as its runbook;
+        when that candidate becomes the decision's action, its outcome is
+        credited to those memories. A ``proof_context`` attests what was
+        retrieved but never earns per-memory outcome credit by itself.
+        """
         token = (
             proof_context.get("token")
             if isinstance(proof_context, dict)

{hebbrix-2.6.2 → hebbrix-2.6.3}/hebbrix/sync_client.py

@@ -649,6 +649,15 @@ class SyncProofLoopResource:
         idempotency_key: Optional[str] = None,
         **kwargs,
     ) -> Dict[str, Any]:
+        """Log one decision among 1-50 candidate actions.
+
+        Each candidate is ``{"action_key": str, "description"?: str,
+        "features"?: dict, "memory_ids"?: list[str]}``. ``memory_ids`` (at most
+        50) names the exact memories the action applies, such as its runbook;
+        when that candidate becomes the decision's action, its outcome is
+        credited to those memories. A ``proof_context`` attests what was
+        retrieved but never earns per-memory outcome credit by itself.
+        """
         token = (
             proof_context.get("token")
             if isinstance(proof_context, dict)
@@ -1110,7 +1119,7 @@ class SyncMemoryClient:
         self.source = source or os.getenv("HEBBRIX_SOURCE")
         headers = {
             "Content-Type": "application/json",
-            "User-Agent": "hebbrix-python/2.6.2",
+            "User-Agent": "hebbrix-python/2.6.3",
         }
         if api_key:
             headers["Authorization"] = f"Bearer {api_key}"

{hebbrix-2.6.2 → hebbrix-2.6.3/hebbrix.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hebbrix
-Version: 2.6.2
+Version: 2.6.3
 Summary: Typed Python client for Hebbrix memory, retrieval, and outcome-learning APIs
 Author-email: Hebbrix Team <support@hebbrix.com>
 Maintainer-email: Hebbrix Team <support@hebbrix.com>
@@ -65,14 +65,14 @@ Dynamic: license-file
 
 Typed Python client for Hebbrix memory, retrieval, and outcome-learning APIs.
 
-The current stable package is **2.6.2**. Start with memory storage and search, or
+The current stable package is **2.6.3**. Start with memory storage and search, or
 the three-call outcome-learning workflow below. Advanced evidence and execution
 permission transports are opt-in; installing the SDK never permits an action.
 
 ## Install
 
 ```bash
-pip install hebbrix==2.6.2
+pip install hebbrix==2.6.3
 ```
 
 Python 3.8+ is supported. `MemoryClient` is asynchronous. `SyncMemoryClient`
@@ -151,6 +151,11 @@ The canonical `gate` is `ASK`, `REVIEW`, `ACT`, or `BLOCK`. `BLOCK` dominates;
 `ACT` is advice, not permission. Apply your own current authorization and human
 approval policy before executing any tool. Do not infer permission from a score.
 
+Version 2.6.3 lets each `proofloop.decide` candidate carry `memory_ids`: the exact
+memories that action applies. When that candidate becomes the decision's action,
+its outcome is credited to those memories; a `proof_context` attests what was
+retrieved but never earns per-memory outcome credit by itself.
+
 Version 2.6.2 adds compact advice, batch, and explicit confirmation helpers.
 They require matching Round9 server routes. Compact views retain scope and safety
 caveats; complete receipts remain on the server.

{hebbrix-2.6.2 → hebbrix-2.6.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "hebbrix"
-version = "2.6.2"
+version = "2.6.3"
 description = "Typed Python client for Hebbrix memory, retrieval, and outcome-learning APIs"
 readme = "README.md"
 requires-python = ">=3.8"

{hebbrix-2.6.2 → hebbrix-2.6.3}/tests/test_advisor_integrity.py

@@ -274,3 +274,33 @@ async def test_cyclic_json_is_refused_before_read(kind):
     with pytest.raises(ValueError):
         await invoke(kind, client, params, advisor)
     client.get.assert_not_called()
+
+
+@pytest.mark.asyncio
+@pytest.mark.parametrize("kind", ["sync", "async"])
+async def test_candidate_memory_ids_reach_the_decision_unchanged(kind):
+    """A candidate may bind the memories its action applies (outcome credit)."""
+    client = transport(kind)
+    params = inputs()
+    params["candidates"][1]["memory_ids"] = ["runbook-memory", "checklist-memory"]
+    await invoke(kind, client, params, Mock(return_value=choice()))
+    candidates = client.post.call_args.kwargs["json"]["candidates"]
+    assert candidates[1]["memory_ids"] == ["runbook-memory", "checklist-memory"]
+    assert "memory_ids" not in candidates[0]
+
+
+@pytest.mark.asyncio
+@pytest.mark.parametrize("kind", ["sync", "async"])
+@pytest.mark.parametrize(
+    "memory_ids",
+    ["runbook-memory", [""], ["x" * 256], [7], ["m"] * 51, {"id": "m"}],
+)
+async def test_invalid_candidate_memory_ids_fail_before_reads(kind, memory_ids):
+    client, advisor = transport(kind), Mock(return_value=choice())
+    params = inputs()
+    params["candidates"][0]["memory_ids"] = memory_ids
+    with pytest.raises(ValueError):
+        await invoke(kind, client, params, advisor)
+    client.get.assert_not_called()
+    client.post.assert_not_called()
+    advisor.assert_not_called()

{hebbrix-2.6.2 → hebbrix-2.6.3}/tests/test_customer_developer_experience.py

@@ -162,6 +162,6 @@ def test_package_docs_metadata_uses_canonical_host():
     assert 'Documentation = "https://hebbrix.com/docs"' in text
     assert "docs.hebbrix.com" not in text
     readme = (root / "README.md").read_text()
-    assert "pip install hebbrix==2.6.2" in readme
+    assert "pip install hebbrix==2.6.3" in readme
     assert "three calls" in readme
     assert "schema `" not in readme