atmem 2.3.2__tar.gz → 2.3.3__tar.gz

{atmem-2.3.2/atmem.egg-info → atmem-2.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: atmem
-Version: 2.3.2
+Version: 2.3.3
 Summary: Host-neutral Agent Black Box and reversible memory control plane.
 Author-email: Javad Taghia <taghia.javad@gmail.com>
 Maintainer-email: Aetna / AtMem <aetna000@gmail.com>
@@ -31,6 +31,8 @@ Requires-Dist: pytest>=8.0.0; extra == "dev"
 Requires-Dist: tomli>=2.0; python_version < "3.11" and extra == "dev"
 Provides-Extra: semantic
 Requires-Dist: sentence-transformers<6.0.0,>=5.0.0; extra == "semantic"
+Provides-Extra: semantic-accelerated
+Requires-Dist: numpy<3,>=1.26; extra == "semantic-accelerated"
 Provides-Extra: mem0
 Requires-Dist: mem0ai<3,>=2.0.20; extra == "mem0"
 Provides-Extra: langgraph-provider
@@ -75,12 +77,12 @@ Dynamic: license-file
 
 # AtMem
 
-[![Version 2.3.2](https://img.shields.io/badge/version-2.3.2-blue)](./docs/releases/v2.3.2.md)
+[![Version 2.3.3](https://img.shields.io/badge/version-2.3.3-blue)](./docs/releases/v2.3.3.md)
 [![CI](https://github.com/aetna000/atmem/actions/workflows/ci.yml/badge.svg)](https://github.com/aetna000/atmem/actions/workflows/ci.yml)
 
 **AtMem is a host-neutral Agent Black Box and reversible memory control plane.**
 
-> **Release status:** AtMem 2.3.2 is the stable encrypted Agent Black Box release.
+> **Release status:** AtMem 2.3.3 is the stable encrypted Agent Black Box release.
 > It records exact host-observed text and supported multimodal boundaries by default,
 > while keeping every claim limited to what the connected agent actually supplied.
 
@@ -97,7 +99,7 @@ authorizes, stores, scopes, injects, corrects, and deletes memory.
 ### 1. Install AtMem and choose memory intelligence
 
 ```bash
-python -m pip install --upgrade atmem==2.3.2
+python -m pip install --upgrade atmem==2.3.3
 atmem atbot setup
 atmem atbot doctor
 atmem init
@@ -130,7 +132,7 @@ package yourself.
 Already using AtMem 2.1 with OpenClaw? Upgrade in place:
 
 ```bash
-python -m pip install --upgrade atmem==2.3.2
+python -m pip install --upgrade atmem==2.3.3
 atmem openclaw upgrade
 atmem control verify
 ```
@@ -153,7 +155,7 @@ selected by `python`, rather than an unrelated `pip` executable on `PATH`.
 #### Pydantic AI — native capability
 
 ```bash
-python -m pip install 'atmem[pydantic-ai]==2.3.2'
+python -m pip install 'atmem[pydantic-ai]==2.3.3'
 atmem control shadow --host generic --memory-db ~/.atmem/memories.db
 ```
 
@@ -178,7 +180,7 @@ agent = Agent("openai:gpt-5-mini", capabilities=[memory])
 #### LangChain/LangGraph — native middleware
 
 ```bash
-python -m pip install 'atmem[langgraph]==2.3.2'
+python -m pip install 'atmem[langgraph]==2.3.3'
 atmem control shadow --host generic --memory-db ~/.atmem/memories.db
 ```
 
@@ -242,7 +244,7 @@ open tasks. AtBot may propose a change, but AtMem revalidates and commits it.
 
 See the [Governed Task State guide](docs/governed-task-state.md) for lifecycle,
 correction, provenance, expiry, benchmark, and automation examples, and read
-the [2.3.2 release notes](docs/releases/v2.3.2.md) before upgrading.
+the [2.3.3 release notes](docs/releases/v2.3.3.md) before upgrading.
 
 ### Prove memory quality locally
 
@@ -250,12 +252,16 @@ the [2.3.2 release notes](docs/releases/v2.3.2.md) before upgrading.
 atmem benchmark run --output benchmark.json
 ```
 
-This offline release gate runs 16 isolated extraction, contradiction, recall,
+This offline release gate runs 24 isolated extraction, contradiction, recall,
 withholding, injection, privacy, poisoning and fallback cases. Safety must be
 perfect; other quality metrics cannot fall below checked-in baselines. Optional
 local/hosted profiles, LongMemEval import and fair Mem0 OSS comparison are also
 available without adding Mem0 or model SDKs to the base install. See the
 [memory benchmark guide](docs/benchmarks.md) for commands and honest limits.
+The [2.3.3 release](docs/releases/v2.3.3.md) improves local retrieval work and
+archive layout while retaining existing retrieval defaults. Developer opt-in
+fusion, scoped graph nomination and matrix reuse are available for evaluation;
+broader performance targets remain research, not release claims.
 
 ### 3. Review, then activate
 
@@ -340,7 +346,7 @@ and restores it exactly.
 ## Installation details
 
 ```bash
-python -m pip install atmem==2.3.2
+python -m pip install atmem==2.3.3
 atmem --version
 ```
 
@@ -350,7 +356,7 @@ embedding model, while the semantic extra adds local sentence-transformer
 choices:
 
 ```bash
-python -m pip install 'atmem[semantic]==2.3.2'
+python -m pip install 'atmem[semantic]==2.3.3'
 ```
 
 For repository development, install both workspace packages:
@@ -538,7 +544,7 @@ atmem control restore
 Existing 2.1 installations upgrade without starting a new migration:
 
 ```bash
-python -m pip install --upgrade atmem==2.3.2
+python -m pip install --upgrade atmem==2.3.3
 atmem openclaw upgrade
 atmem control verify
 ```
@@ -766,8 +772,8 @@ npm test
 npm run smoke
 ```
 
-Current repository metadata is version **2.3.2**, with the matched OpenClaw
-bridge **2.3.2**. Release validation requires exact Python/bridge alignment;
+Current repository metadata is version **2.3.3**, with the matched OpenClaw
+bridge **2.3.3**. Release validation requires exact Python/bridge alignment;
 AtBot retains its independent stable compatible version **0.1.0**.
 
 ## License

{atmem-2.3.2 → atmem-2.3.3}/README.md

@@ -1,11 +1,11 @@
 # AtMem
 
-[![Version 2.3.2](https://img.shields.io/badge/version-2.3.2-blue)](./docs/releases/v2.3.2.md)
+[![Version 2.3.3](https://img.shields.io/badge/version-2.3.3-blue)](./docs/releases/v2.3.3.md)
 [![CI](https://github.com/aetna000/atmem/actions/workflows/ci.yml/badge.svg)](https://github.com/aetna000/atmem/actions/workflows/ci.yml)
 
 **AtMem is a host-neutral Agent Black Box and reversible memory control plane.**
 
-> **Release status:** AtMem 2.3.2 is the stable encrypted Agent Black Box release.
+> **Release status:** AtMem 2.3.3 is the stable encrypted Agent Black Box release.
 > It records exact host-observed text and supported multimodal boundaries by default,
 > while keeping every claim limited to what the connected agent actually supplied.
 
@@ -22,7 +22,7 @@ authorizes, stores, scopes, injects, corrects, and deletes memory.
 ### 1. Install AtMem and choose memory intelligence
 
 ```bash
-python -m pip install --upgrade atmem==2.3.2
+python -m pip install --upgrade atmem==2.3.3
 atmem atbot setup
 atmem atbot doctor
 atmem init
@@ -55,7 +55,7 @@ package yourself.
 Already using AtMem 2.1 with OpenClaw? Upgrade in place:
 
 ```bash
-python -m pip install --upgrade atmem==2.3.2
+python -m pip install --upgrade atmem==2.3.3
 atmem openclaw upgrade
 atmem control verify
 ```
@@ -78,7 +78,7 @@ selected by `python`, rather than an unrelated `pip` executable on `PATH`.
 #### Pydantic AI — native capability
 
 ```bash
-python -m pip install 'atmem[pydantic-ai]==2.3.2'
+python -m pip install 'atmem[pydantic-ai]==2.3.3'
 atmem control shadow --host generic --memory-db ~/.atmem/memories.db
 ```
 
@@ -103,7 +103,7 @@ agent = Agent("openai:gpt-5-mini", capabilities=[memory])
 #### LangChain/LangGraph — native middleware
 
 ```bash
-python -m pip install 'atmem[langgraph]==2.3.2'
+python -m pip install 'atmem[langgraph]==2.3.3'
 atmem control shadow --host generic --memory-db ~/.atmem/memories.db
 ```
 
@@ -167,7 +167,7 @@ open tasks. AtBot may propose a change, but AtMem revalidates and commits it.
 
 See the [Governed Task State guide](docs/governed-task-state.md) for lifecycle,
 correction, provenance, expiry, benchmark, and automation examples, and read
-the [2.3.2 release notes](docs/releases/v2.3.2.md) before upgrading.
+the [2.3.3 release notes](docs/releases/v2.3.3.md) before upgrading.
 
 ### Prove memory quality locally
 
@@ -175,12 +175,16 @@ the [2.3.2 release notes](docs/releases/v2.3.2.md) before upgrading.
 atmem benchmark run --output benchmark.json
 ```
 
-This offline release gate runs 16 isolated extraction, contradiction, recall,
+This offline release gate runs 24 isolated extraction, contradiction, recall,
 withholding, injection, privacy, poisoning and fallback cases. Safety must be
 perfect; other quality metrics cannot fall below checked-in baselines. Optional
 local/hosted profiles, LongMemEval import and fair Mem0 OSS comparison are also
 available without adding Mem0 or model SDKs to the base install. See the
 [memory benchmark guide](docs/benchmarks.md) for commands and honest limits.
+The [2.3.3 release](docs/releases/v2.3.3.md) improves local retrieval work and
+archive layout while retaining existing retrieval defaults. Developer opt-in
+fusion, scoped graph nomination and matrix reuse are available for evaluation;
+broader performance targets remain research, not release claims.
 
 ### 3. Review, then activate
 
@@ -265,7 +269,7 @@ and restores it exactly.
 ## Installation details
 
 ```bash
-python -m pip install atmem==2.3.2
+python -m pip install atmem==2.3.3
 atmem --version
 ```
 
@@ -275,7 +279,7 @@ embedding model, while the semantic extra adds local sentence-transformer
 choices:
 
 ```bash
-python -m pip install 'atmem[semantic]==2.3.2'
+python -m pip install 'atmem[semantic]==2.3.3'
 ```
 
 For repository development, install both workspace packages:
@@ -463,7 +467,7 @@ atmem control restore
 Existing 2.1 installations upgrade without starting a new migration:
 
 ```bash
-python -m pip install --upgrade atmem==2.3.2
+python -m pip install --upgrade atmem==2.3.3
 atmem openclaw upgrade
 atmem control verify
 ```
@@ -691,8 +695,8 @@ npm test
 npm run smoke
 ```
 
-Current repository metadata is version **2.3.2**, with the matched OpenClaw
-bridge **2.3.2**. Release validation requires exact Python/bridge alignment;
+Current repository metadata is version **2.3.3**, with the matched OpenClaw
+bridge **2.3.3**. Release validation requires exact Python/bridge alignment;
 AtBot retains its independent stable compatible version **0.1.0**.
 
 ## License

atmem-2.3.3/atmem/benchmark/data/mem0-head-to-head-2.3.3b1-v1.json

@@ -0,0 +1,48 @@
+{
+  "format": "atmem-mem0-head-to-head-manifest-v1",
+  "frozen_at": "2026-09-16",
+  "dataset": {
+    "name": "LongMemEval-S cleaned",
+    "upstream_commit": "98d7416c24c778c2fee6e6f3006e7a073259d48f",
+    "source_sha256": "d6f21ea9d60a0d56f34a05b609c79c88a451d2ae03597821ea3d5a9678c3a442"
+  },
+  "selection": {
+    "rule": "sha256-question-id-stratified-v1",
+    "calibration_case_ids": [
+      "07741c45", "b6019101", "720133ac", "gpt4_7fce9456",
+      "c4f10528", "1d4da289", "54026fce", "06878be2",
+      "58bf7951", "c8c3f81d", "gpt4_d31cdae3", "gpt4_4edbafa2"
+    ],
+    "heldout_case_ids": [
+      "6071bd76", "a2f3aa27", "09ba9854", "00ca467f",
+      "70b3e69b", "ceb54acb", "195a1a1b", "6b7dfb22",
+      "ad7109d1", "36580ce8", "bcbe585f", "gpt4_6ed717ea"
+    ],
+    "heldout_selection_sha256": "sha256:4bd9ee57ced759f74e09283da571dd0b1283c1560aa26afabde50a2dd8e050a5"
+  },
+  "raw_retrieval": {
+    "ingestion": "raw-infer-disabled",
+    "chunk_chars": 1600,
+    "embedding_provider": "ollama",
+    "embedding_model": "nomic-embed-text:latest",
+    "embedding_model_id": "0a109f422b47",
+    "retrieved_chunk_limit": 100,
+    "session_cutoff": 5,
+    "quality_metrics": ["session_recall_any_at_5", "session_recall_all_at_5", "session_mrr_at_5"],
+    "latency_boundary": "query embedding through returned search candidates; excludes admission/indexing"
+  },
+  "native_preparation": {
+    "quality_metrics": ["useful_context_precision", "answerable_recall", "no_answer_correctness", "incorrect_injection_rate"],
+    "latency_boundary": "native control_prepare entry through authorized prepared context return",
+    "final_delivery_is_separately_confirmed": true
+  },
+  "competition": {
+    "mem0_oss_version": "2.0.20",
+    "mem0_nlp_and_bm25_status": "explicitly report base and hybrid-enabled profiles separately",
+    "speed_ratio_target": 2.0,
+    "speed_ratio_stretch": 10.0,
+    "speed_metric": "matched warm p95 on the same declared boundary",
+    "quality_condition": "no lower held-out answer/source quality and zero authority violations",
+    "claim_policy": "no cross-profile ratio or beta publication if a required comparable 2x gate fails"
+  }
+}

{atmem-2.3.2 → atmem-2.3.3}/atmem/benchmark/external.py

@@ -25,6 +25,8 @@ _METRIC_DIRECTIONS = {
     "fallback_completion": "higher",
     "latency_p50_ms": "lower",
     "latency_p95_ms": "lower",
+    "warm_latency_p50_ms": "lower",
+    "warm_latency_p95_ms": "lower",
     "token_usage": "lower",
     "model_cost_usd": "lower",
 }

{atmem-2.3.2 → atmem-2.3.3}/atmem/contracts/models.py

@@ -212,9 +212,22 @@ class RecallRequest(Contract):
     reranker_model: str = "none"
     egress_class: Literal["local", "remote", "none"] = "local"
     min_score: float = 0.0
+    retrieval_strategy: Literal['legacy', 'core-rrf-v1'] = 'legacy'
+
+    def to_dict(self) -> dict[str, Any]:
+        value = Contract.to_dict(self)
+        if self.retrieval_strategy == 'legacy':
+            value.pop('retrieval_strategy')
+        return value
 
     def __post_init__(self) -> None:
         _required_id("request_id", self.request_id)
+        if self.retrieval_strategy not in {'legacy', 'core-rrf-v1'}:
+            raise ValueError('unknown retrieval strategy')
+        if self.retrieval_strategy == 'core-rrf-v1' and not 1 <= int(self.candidate_limit) <= 2000:
+            raise ValueError('candidate_limit must be between 1 and 2000')
+        if self.retrieval_strategy == 'core-rrf-v1' and not {'lexical', 'semantic', 'graph'}.intersection(self.signals):
+            raise ValueError('core-rrf-v1 requires lexical, semantic or graph signals')
         if not str(self.query).strip():
             raise ValueError("query is required")
         if not 1 <= int(self.limit) <= 100:

{atmem-2.3.2 → atmem-2.3.3}/atmem/control/assets/app.css

@@ -473,6 +473,31 @@ body:has(.memorychat.collapsed){padding-bottom:70px}
 @media(max-width:760px){.activityrow .activitytime{display:flex}.activityclock{font-size:11px}}
 @media(max-width:780px){.insightmetrics{grid-template-columns:1fr 1fr}.healthcharthead{display:block}.chartlegend{margin-top:8px}}
 
+/* The archive can be narrow on a wide screen when evidence is open. Size its
+   contents against the pane, not the viewport or the drawer's former parent. */
+#blackboxArchiveCard{container-type:inline-size;min-width:0;align-self:start}
+.flightfilters>.field{min-width:0}
+.flightfilters input,.flightfilters select{min-width:0;max-width:100%;width:100%}
+.flightidentity>.mono{white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
+.flightstat{min-width:0;overflow-wrap:anywhere}
+@container (max-width:850px){
+  .flightfilters{grid-template-columns:repeat(2,minmax(0,1fr))}
+  .flightfilters>.field:first-child{grid-column:1/-1}
+  .flightfilters>button{align-self:end;white-space:normal}
+  .blackboxhead{flex-direction:column;gap:8px}
+  .flight,.blackboxworkspace.detail-open .flight{grid-template-columns:repeat(3,minmax(0,1fr));gap:10px;align-items:start;padding:12px}
+  .flight>.flightidentity{grid-column:1/-1}
+  .flight>.flightstat,.blackboxworkspace.detail-open .flight>.flightstat{display:block}
+  .flight>.secondary,.blackboxworkspace.detail-open .flight>.secondary{grid-column:1/-1;grid-row:auto;justify-self:start;max-width:100%;white-space:normal}
+  .flighttimestamp{white-space:normal}
+}
+@container (max-width:380px){
+  .flightfilters{grid-template-columns:minmax(0,1fr)}
+  .flight,.blackboxworkspace.detail-open .flight{grid-template-columns:minmax(0,1fr)}
+  .flightstat{display:flex;gap:8px;justify-content:space-between}
+  .flightstat small{flex-shrink:0}
+}
+
 .activitylegend{margin:12px 0 18px;padding:12px 14px;border:1px solid var(--line);border-radius:10px;color:var(--muted);font-size:12px;line-height:1.5}
 .activitylegend .legendlabel{font-weight:600;color:var(--ink)}
 .activitylegend ul{display:flex;flex-wrap:wrap;gap:6px 16px;list-style:none;margin:7px 0;padding:0}

{atmem-2.3.2 → atmem-2.3.3}/atmem/control/atbot_companion.py

@@ -87,52 +87,21 @@ class AtBotCompanionClient:
             return _fallback(query, candidates, {**health, "reason": str(exc)})
 
     def expand_query(self, query: str) -> dict[str, Any]:
-        """Send query text only; candidate content is prohibited on this call."""
+        """Expand locally; AtBot v1 uses these same deterministic rules."""
         clean = " ".join(query.split())
         from atmem.control.atbot_service import AtBotServiceManager
+        from atmem.control.query_expansion import expand_query_v1
 
-        health = (
-            {"available": False, "reason": "safe fallback was selected"}
-            if AtBotServiceManager().fallback_selected()
-            else self.health()
-        )
-        fallback = {
+        fallback_selected = AtBotServiceManager().fallback_selected()
+        return {
             "format": "atbot-query-expansion-v1",
             "query": clean,
-            "expanded_queries": [clean],
+            "expanded_queries": [clean] if fallback_selected and clean else expand_query_v1(clean),
             "content_received": False,
-            "companion": {"available": False, "fallback": True},
+            "provider": "atbot-policy",
+            "model": "query-concepts-v1",
+            "companion": {"available": False, "fallback": True, "local_rules": not fallback_selected},
         }
-        if not health.get("available"):
-            return fallback
-        request = Request(
-            f"{self.endpoint}/api/companion/expand-query",
-            data=json.dumps({"query": clean}).encode("utf-8"),
-            headers={
-                "Content-Type": "application/json",
-                "X-AtBot-CSRF": str(health["csrf_token"]),
-            },
-            method="POST",
-        )
-        try:
-            with urlopen(request, timeout=min(self.timeout, 10.0)) as response:
-                value = json.loads(response.read())
-            queries: list[str] = []
-            for raw in value.get("expanded_queries") or []:
-                item = " ".join(str(raw).split())[:200]
-                if item and item.casefold() not in {row.casefold() for row in queries}:
-                    queries.append(item)
-                if len(queries) >= 6:
-                    break
-            if not queries or value.get("content_received") is not False:
-                raise ValueError("invalid content-free expansion result")
-            return {
-                **value,
-                "expanded_queries": queries,
-                "companion": {"available": True, "fallback": False},
-            }
-        except (OSError, ValueError, HTTPError, URLError, json.JSONDecodeError):
-            return fallback
 
     def propose(self, message: str) -> dict[str, Any]:
         """Request interpretation only; AtMem remains responsible for admission."""

atmem-2.3.3/atmem/control/query_expansion.py

@@ -0,0 +1,27 @@
+"""Local, content-free query expansion matching AtBot's v1 rules."""
+
+from __future__ import annotations
+
+
+def expand_query_v1(query: str) -> list[str]:
+    clean = " ".join(query.split())
+    if not clean:
+        return []
+    lowered = clean.casefold()
+    expansions = [clean]
+    concept_rules = (
+        (("fav food", "favorite food", "favourite food"), ("favorite food", "food preference", "preferred meal", "likes to eat")),
+        (("fav car", "favorite car", "favourite car"), ("favorite car", "car preference", "preferred vehicle")),
+        (("fav book", "favorite book", "favourite book"), ("favorite book", "book preference", "preferred reading")),
+    )
+    for triggers, values in concept_rules:
+        if any(trigger in lowered for trigger in triggers):
+            expansions.extend(values)
+    normalized: list[str] = []
+    for value in expansions:
+        item = " ".join(str(value).split())[:200]
+        if item and item.casefold() not in {row.casefold() for row in normalized}:
+            normalized.append(item)
+        if len(normalized) >= 6:
+            break
+    return normalized

{atmem-2.3.2 → atmem-2.3.3}/atmem/mcp/server.py

@@ -27,7 +27,7 @@ try:
 
     SERVER_VERSION = _pkg_version("atmem")
 except Exception:  # not installed (e.g. run from a checkout)
-    SERVER_VERSION = "2.3.2"
+    SERVER_VERSION = "2.3.3"
 
 _SUBJECT_PROPERTY = {
     "subject_id": {

{atmem-2.3.2 → atmem-2.3.3}/atmem/memory.py

@@ -734,6 +734,13 @@ class Memory:
 
         if not isinstance(request, RecallRequest):
             raise TypeError("request must be RecallRequest")
+        if request.retrieval_strategy == 'core-rrf-v1':
+            from dataclasses import replace
+            from atmem.retrieve.hybrid import collect
+            rows, metadata = collect(self, request)
+            # Channel quotas are independent; bound the ranked publication prefix.
+            publication = replace(request, candidate_limit=max(request.candidate_limit, request.limit))
+            return self.create_candidate_set_v1(publication, rows, retrieval_metadata=metadata)
         scope = request.scope
         recalled = self.recall(
             scope.subject_id,
@@ -884,7 +891,7 @@ class Memory:
 
     @_atomic
     def create_candidate_set_v1(
-        self, request: Any, candidates: list[dict[str, Any]]
+        self, request: Any, candidates: list[dict[str, Any]], *, retrieval_metadata: dict[str, Any] | None = None
     ) -> Any:
         """Persist one revalidated union of already-governed retrieval signals.
 
@@ -969,7 +976,7 @@ class Memory:
             aggregation_signal_digest,
         )
 
-        aggregated = aggregate_supporting_evidence(
+        aggregated = eligible_rows if retrieval_metadata is not None else aggregate_supporting_evidence(
             eligible_rows,
             subject_id=scope.subject_id,
             workspace_id=scope.workspace_id,
@@ -1024,7 +1031,14 @@ class Memory:
                         for query in row.get("matched_queries") or ()
                     }
                 ),
-                "support_aggregation_version": SUPPORT_AGGREGATION_VERSION,
+                "support_aggregation_version": None if retrieval_metadata is not None else SUPPORT_AGGREGATION_VERSION,
+                **({'retrieval_fusion': {**retrieval_metadata, 'candidate_ranks': {
+                    row.record_id: row.signals.get('fusion', {}).get('channel_ranks', {})
+                    for row in durable
+                }, 'graph_support_record_ids': {
+                    row.record_id: [step['record_id'] for step in row.signals.get('fusion', {}).get('graph_path', ())]
+                    for row in durable if row.signals.get('fusion', {}).get('graph_path')
+                }}} if retrieval_metadata is not None else {}),
                 "aggregation_signal_digest": aggregation_digest,
                 "grouped_candidate_count": len(grouped_candidates),
                 "supported_group_count": len(

{atmem-2.3.2 → atmem-2.3.3}/atmem/openclaw_install.py

@@ -17,7 +17,7 @@ from atmem.control.manager import DEFAULT_STATE_PATH, DEFAULT_CONTROL_ROOT
 
 OPENCLAW_PLUGIN_ID = "memory-atmem"
 OPENCLAW_PLUGIN_PACKAGE = "openclaw-memory-atmem"
-OPENCLAW_PLUGIN_VERSION = "2.3.2"
+OPENCLAW_PLUGIN_VERSION = "2.3.3"
 _CONFIG_KEY = "plugins.entries.memory-atmem"
 
 

atmem-2.3.3/atmem/retrieve/fusion.py

@@ -0,0 +1,18 @@
+"""Deterministic rank fusion; scores are nomination priors, not confidence."""
+from collections import defaultdict
+
+FUSION_VERSION = 'core-rrf-v1'
+RANK_CONSTANT = 60
+
+
+def fuse_rankings(channels):
+    active = {name: list(dict.fromkeys(ids)) for name, ids in channels.items() if ids}
+    ranks = defaultdict(dict)
+    for name, ids in active.items():
+        for rank, record_id in enumerate(ids, 1):
+            ranks[record_id][name] = rank
+    denominator = len(active) / (RANK_CONSTANT + 1) if active else 1
+    result = [dict(record_id=record_id, channel_ranks=positions,
+                   score=sum(1 / (RANK_CONSTANT + rank) for rank in positions.values()) / denominator)
+              for record_id, positions in ranks.items()]
+    return sorted(result, key=lambda row: (-row['score'], row['record_id']))