@agenr/openclaw-plugin 1.5.0 → 3.3.0

package/openclaw.plugin.json

@@ -1,11 +1,11 @@
 {
   "id": "agenr",
   "name": "agenr",
-  "version": "1.4.0",
+  "version": "3.3.0",
   "description": "agenr memory plugin for OpenClaw",
   "kind": "memory",
   "contracts": {
-    "tools": ["agenr_store", "agenr_recall", "agenr_retire", "agenr_update", "agenr_trace"]
+    "tools": ["agenr_store", "agenr_recall", "agenr_fetch", "agenr_retire", "agenr_update", "agenr_trace"]
   },
   "uiHints": {
     "dbPath": {
@@ -27,6 +27,18 @@
     "claimExtractionModel": {
       "label": "Claim extraction model",
       "help": "Model used for claim-key extraction when storing entries. Uses OpenClaw's configured auth. Format: provider/model (for example, openai/gpt-5.4-nano). Defaults to the agent's primary model."
+    },
+    "storeNudge": {
+      "label": "Store nudge",
+      "help": "Optional mid-session reminder settings for prompting durable memory storage after several turns of memory silence."
+    },
+    "memoryPolicy": {
+      "label": "Memory policy",
+      "help": "Optional runtime overrides for claim-aware read behavior, session-start memory injection, and proactive before-turn surfacing."
+    },
+    "debug": {
+      "label": "Debug log",
+      "help": "Optional opt-in JSONL debug sink that records recall, session-start, and before-turn decisions into a dedicated agenr log file separate from OpenClaw host logs."
     }
   },
   "configSchema": {
@@ -55,6 +67,140 @@
         "type": "string",
         "minLength": 1,
         "description": "Model override for claim-key extraction at store time (e.g. 'openai/gpt-5.4-mini'). Uses OpenClaw auth and falls back to the agent's primary model."
+      },
+      "storeNudge": {
+        "type": "object",
+        "additionalProperties": false,
+        "description": "Optional mid-session reminder settings for prompting durable memory storage after several turns without memory activity.",
+        "properties": {
+          "enabled": {
+            "type": "boolean",
+            "description": "Enable or disable mid-session store nudges. Defaults to true."
+          },
+          "threshold": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "Turns without durable memory activity before prompting the agent to review recent conversation. Defaults to 8."
+          },
+          "maxPerSession": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "Maximum nudges injected during one session lifetime. Defaults to 5."
+          }
+        }
+      },
+      "debug": {
+        "type": "object",
+        "additionalProperties": false,
+        "description": "Optional opt-in JSONL debug sink for live OpenClaw runs. Writes agenr-only events to a dedicated log file rather than the shared host log.",
+        "properties": {
+          "enabled": {
+            "type": "boolean",
+            "description": "Enable or disable the agenr JSONL debug sink. Defaults to false."
+          },
+          "logPath": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Optional explicit log-file path. Defaults to agenr-debug.jsonl inside the OpenClaw state directory."
+          },
+          "eventLevel": {
+            "type": "string",
+            "enum": ["basic", "detailed"],
+            "description": "Event detail level. Detailed enables bounded top-K candidate breakdowns for recall and before-turn events. Defaults to basic."
+          },
+          "perSessionFiles": {
+            "type": "boolean",
+            "description": "Split one JSONL file per OpenClaw session id. Defaults to false."
+          },
+          "maxTopCandidates": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 25,
+            "description": "Cap for top-K candidate breakdowns included in detailed events. Defaults to 10."
+          }
+        }
+      },
+      "memoryPolicy": {
+        "type": "object",
+        "additionalProperties": false,
+        "description": "Optional runtime overrides for claim-aware read behavior exposed by the OpenClaw adapter.",
+        "properties": {
+          "sessionStart": {
+            "type": "object",
+            "additionalProperties": false,
+            "description": "Optional session-start overrides for prompt-time memory injection behavior.",
+            "properties": {
+              "enabled": {
+                "type": "boolean",
+                "description": "Enable or disable all session-start memory injection. Defaults to true."
+              },
+              "coreMemory": {
+                "type": "boolean",
+                "description": "Enable or disable always-on Core Memory injection at session start. Defaults to true."
+              },
+              "relevantDurableMemory": {
+                "type": "boolean",
+                "description": "Enable or disable artifact-grounded Relevant Durable Memory injection at session start. Defaults to true."
+              }
+            }
+          },
+          "beforeTurn": {
+            "type": "object",
+            "additionalProperties": false,
+            "description": "Optional before-turn overrides for proactive prompt-time memory injection behavior.",
+            "properties": {
+              "enabled": {
+                "type": "boolean",
+                "description": "Enable or disable the proactive before-turn memory patch. Defaults to true."
+              },
+              "procedureSuggestion": {
+                "type": "boolean",
+                "description": "Enable or disable proactive high-confidence procedure suggestion inside the before-turn patch. Defaults to true."
+              },
+              "maxDurableEntries": {
+                "type": "integer",
+                "minimum": 1,
+                "description": "Normal durable-item cap for before-turn recall. Defaults to 1 and only expands when all surfaced items are very high confidence."
+              },
+              "recallThreshold": {
+                "type": "number",
+                "minimum": 0,
+                "maximum": 1,
+                "description": "Durable-recall score threshold required before an entry can surface during before-turn recall. Defaults to 0.6."
+              },
+              "highConfidenceRecallThreshold": {
+                "type": "number",
+                "minimum": 0,
+                "maximum": 1,
+                "description": "Durable-recall score threshold required before before-turn recall can expand beyond the normal durable-item cap. Defaults to 0.85."
+              },
+              "procedureThreshold": {
+                "type": "number",
+                "minimum": 0,
+                "maximum": 1,
+                "description": "Procedure-recall score threshold required before a proactive procedure can surface. Defaults to 0.72."
+              }
+            }
+          },
+          "slotPolicies": {
+            "type": "object",
+            "additionalProperties": false,
+            "description": "Claim-slot policy overrides keyed by canonical claim-key attribute head.",
+            "properties": {
+              "attributeHeads": {
+                "type": "object",
+                "description": "Map canonical attribute heads such as `integration` or `preference` to `exclusive` or `multivalued` read-time slot behavior.",
+                "propertyNames": {
+                  "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]*$"
+                },
+                "additionalProperties": {
+                  "type": "string",
+                  "enum": ["exclusive", "multivalued"]
+                }
+              }
+            }
+          }
+        }
       }
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agenr/openclaw-plugin",
-  "version": "1.5.0",
+  "version": "3.3.0",
   "description": "agenr memory plugin for OpenClaw",
   "type": "module",
   "exports": {
@@ -17,15 +17,17 @@
     ]
   },
   "dependencies": {
+    "@earendil-works/pi-ai": "^0.78.0",
     "@libsql/client": "^0.17.2",
-    "openclaw": "^2026.3.24"
+    "openclaw": "^2026.4.9",
+    "yaml": "^2.8.3"
   },
   "engines": {
     "node": ">=24"
   },
-  "license": "AGPL-3.0",
+  "license": "MIT",
   "scripts": {
-    "build": "tsup --config tsup.config.ts",
-    "build:debug": "tsup --config tsup.config.ts --sourcemap"
+    "build": "node build.mjs",
+    "build:debug": "node build.mjs"
   }
 }