@gamaze/hicortex 0.19.1 → 0.19.3

package/dist/retrieval.js

@@ -61,6 +61,7 @@ exports.getScoringWeights = getScoringWeights;
 exports.configureSessionIntent = configureSessionIntent;
 exports.getSessionIntent = getSessionIntent;
 exports.blendQueryVector = blendQueryVector;
+exports.recallQueryVector = recallQueryVector;
 exports.findSupersededIds = findSupersededIds;
 exports.l2ToCosine = l2ToCosine;
 exports.effectiveStrength = effectiveStrength;
@@ -250,6 +251,16 @@ function blendQueryVector(promptEmb, centroid, weight) {
         ? (0, schema_prototypes_js_1.l2Normalize)((0, schema_prototypes_js_1.weightedAdd)(promptEmb, 1 - weight, centroid, weight))
         : promptEmb;
 }
+function recallQueryVector(registry, sessionId, promptEmb, opts) {
+    if (opts.purePrompt)
+        return promptEmb;
+    // weight=0 (kill-switch): the centroid is neither read nor written.
+    const centroid = opts.weight > 0 ? registry.getCentroid(sessionId) : undefined;
+    const queryVec = blendQueryVector(promptEmb, centroid, opts.weight);
+    if (opts.weight > 0)
+        registry.updateCentroid(sessionId, promptEmb, opts.alpha);
+    return queryVec;
+}
 /**
  * Ids among `candidateIds` that have been superseded by a later memory — i.e.
  * they are the SOURCE of a `superseded_by` link (stageSupersession links

package/dist/types.d.ts

@@ -399,6 +399,20 @@ export interface HicortexConfig {
      * leaner system prompts.
      */
     lessonsLimit?: number;
+    /**
+     * Default project name for the OpenClaw plugin (#316, Hermes `default_project`
+     * parity): sent as the `project` fallback on /recall-index, the pre-0.14
+     * /search fallback, and the search/recent/ingest tools whenever the gateway
+     * supplies no project. Absent ⇒ no scope sent.
+     */
+    defaultProject?: string;
+    /**
+     * Max memories per recall on the OpenClaw plugin's legacy /search fallback
+     * (pre-0.14 servers, #316). Default 8. Does NOT size the pushed
+     * /recall-index — that is server config (`recallMaxItems`); the server
+     * accepts no client limit.
+     */
+    recallLimit?: number;
     /**
      * Soft cap on the memory corpus (default 10000). When the corpus exceeds this,
      * the nightly's capacity-eviction stage (#245) removes the lowest-

package/hermes-plugin/hicortex/provider.py

@@ -123,22 +123,38 @@ def _title_case_section(name: str) -> str:
     return " ".join(w[:1].upper() + w[1:] for w in words)
 
 
+# #313 scope labels — mirror of the TS ``SECTION_LABELS`` in
+# identity-store.ts (keep in sync). "Global rules" marks the section as
+# fleet-wide; unknown section names fall back to title-case.
+_SECTION_LABELS = {
+    "agent_identity": "Agent identity",
+    "user": "User",
+    "rules": "Global rules",
+}
+
+
 def _order_section_names(names: Iterable[str]) -> List[str]:
-    """Stable ordering: user, rules, then the rest alphabetically."""
+    """Stable ordering — the #313 precedence contract, mirroring the TS
+    ``SECTION_PRECEDENCE`` (keep in sync): ``agent_identity`` (the agent's own
+    self + role conduct, per-agent only) first, then ``user`` (the principal),
+    then ``rules`` (fleet-wide house rules), then the rest alphabetically."""
     names = list(names)
-    primaries = [p for p in ("user", "rules") if p in names]
-    rest = sorted(n for n in names if n not in ("user", "rules"))
+    primaries = [p for p in ("agent_identity", "user", "rules") if p in names]
+    rest = sorted(n for n in names if n not in ("agent_identity", "user", "rules"))
     return primaries + rest
 
 
 def _render_context_block(sections: Dict[str, Any]) -> str:
-    """Render the ``## Identity`` block, or "" when every section is blank."""
+    """Render the ``## Identity`` block, or "" when every section is blank.
+    Headings use the #313 scope labels (``_SECTION_LABELS``); unknown sections
+    fall back to title-case."""
     body_parts: List[str] = []
     for name in _order_section_names(sections.keys()):
         body = sections.get(name)
         if not isinstance(body, str) or not body.strip():
             continue
-        body_parts.extend([f"### {_title_case_section(name)}", "", body.strip()])
+        label = _SECTION_LABELS.get(name) or _title_case_section(name)
+        body_parts.extend([f"### {label}", "", body.strip()])
     if not body_parts:
         return ""
     return "\n".join(["## Identity", "", *body_parts])

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "hicortex",
   "name": "Hicortex — Long-term Memory That Learns",
   "description": "Your agents remember past decisions, avoid repeated mistakes, and get smarter every day. Nightly reflection generates actionable lessons that automatically update agent behavior.",
-  "version": "0.19.1",
+  "version": "0.19.3",
   "kind": "lifecycle",
   "skills": ["./skills/hicortex-memory"],
   "configSchema": {
@@ -17,9 +17,14 @@
         "type": "string",
         "description": "Bearer token for the Hicortex server. Localhost bypasses auth automatically. Required for remote servers — use the authToken from ~/.hicortex/config.json on the server."
       },
-      "licenseKey": {
+      "defaultProject": {
         "type": "string",
-        "description": "Hicortex license key (hctx-...). Leave empty for free tier (250 memory cap)."
+        "description": "Optional default project name scoping recall, search, and ingest when the gateway supplies no project (Hermes default_project parity)."
+      },
+      "recallLimit": {
+        "type": "number",
+        "default": 8,
+        "description": "Max memories per recall on the pre-0.14 /search fallback (default 8). The pushed recall index is sized by SERVER config (recallMaxItems) — the server accepts no client limit."
       }
     },
     "required": []
@@ -34,10 +39,13 @@
       "sensitive": true,
       "placeholder": "Required for remote servers"
     },
-    "licenseKey": {
-      "label": "License Key",
-      "placeholder": "hctx-... (optional, free tier without key)",
-      "sensitive": true
+    "defaultProject": {
+      "label": "Default Project",
+      "placeholder": "Optional — scopes recall/ingest when the gateway sends no project"
+    },
+    "recallLimit": {
+      "label": "Recall Limit",
+      "placeholder": "8"
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gamaze/hicortex",
-  "version": "0.19.1",
+  "version": "0.19.3",
   "description": "Persistent agent identity for AI agents \u2014 a hand-edited identity layer, nightly-distilled experience, and lessons injected every session, shared across your whole fleet. Works with Hermes, OpenClaw, Claude Code, and Pi.",
   "main": "dist/index.js",
   "bin": {