@joshuaswarren/openclaw-engram 9.3.19 → 9.3.21

package/README.md

@@ -16,7 +16,7 @@ For full migration details, see the [Rename Guide](https://github.com/joshuaswar
 
 ## What is Remnic?
 
-Remnic is persistent, private memory for AI agents. Your agents forget everything between sessions -- Remnic fixes that. All data stays on your machine as plain markdown files.
+Remnic is open-source memory and context for user-aware agents. It helps agents understand preferences, projects, constraints, decisions, patterns, and definitions of good while keeping memory inspectable as plain markdown files.
 
 - **Repository**: [github.com/joshuaswarren/remnic](https://github.com/joshuaswarren/remnic)
 - **Core package**: [`@remnic/core`](https://www.npmjs.com/package/@remnic/core)

package/openclaw.plugin.json

@@ -1,21 +1,10 @@
 {
   "id": "openclaw-engram",
   "name": "Remnic OpenClaw Plugin",
-  "version": "9.3.19",
+  "version": "9.3.21",
   "kind": "memory",
   "description": "Local semantic memory for OpenClaw with bundled Remnic core runtime. Requires plugins.slots.memory set to this plugin id for hooks to fire.",
   "setup": {
-    "providers": [
-      {
-        "id": "openai",
-        "authMethods": [
-          "api-key"
-        ],
-        "envVars": [
-          "OPENAI_API_KEY"
-        ]
-      }
-    ],
     "requiresRuntime": false
   },
   "providerAuthEnvVars": {
@@ -70,34 +59,6 @@
     "beforeReset": true
   },
   "contracts": {
-    "commands": [
-      "remnic"
-    ],
-    "hooks": [
-      "before_prompt_build",
-      "before_agent_start",
-      "agent_end",
-      "before_compaction",
-      "after_compaction",
-      "before_reset",
-      "session_start",
-      "session_end",
-      "before_tool_call",
-      "after_tool_call",
-      "llm_output",
-      "subagent_spawning",
-      "subagent_ended",
-      "commands.list"
-    ],
-    "memoryCapabilities": [
-      "openclaw-engram"
-    ],
-    "memoryPromptSections": [
-      "engram-memory"
-    ],
-    "services": [
-      "openclaw-engram"
-    ],
     "tools": [
       "compounding_promote_candidate",
       "compounding_weekly_synthesize",
@@ -747,7 +708,7 @@
       "commandsListEnabled": {
         "type": "boolean",
         "default": true,
-        "description": "Advertise Remnic slash-command descriptors through the commands.list runtime surface."
+        "description": "Advertise Remnic slash-command descriptors through the registerCommand runtime surface."
       },
       "openclawToolsEnabled": {
         "type": "boolean",
@@ -2366,6 +2327,122 @@
         "minimum": 0,
         "description": "Maximum query-visible cues expanded by explicit cue recall."
       },
+      "targetedFactRecallEnabled": {
+        "type": "boolean",
+        "default": false,
+        "description": "Enable targeted fact evidence recall for direct answer questions."
+      },
+      "targetedFactRecallMaxChars": {
+        "type": "integer",
+        "default": 2400,
+        "minimum": 0,
+        "description": "Character budget for the targeted fact evidence recall section."
+      },
+      "targetedFactRecallMaxResults": {
+        "type": "integer",
+        "default": 48,
+        "minimum": 0,
+        "description": "Maximum recalled items for targeted fact evidence."
+      },
+      "targetedFactRecallScanWindowTurns": {
+        "type": "integer",
+        "default": 8,
+        "minimum": 1,
+        "description": "Recent-turn scan window for targeted fact evidence."
+      },
+      "targetedFactRecallScanWindowTokens": {
+        "type": "integer",
+        "default": 12000,
+        "minimum": 1,
+        "description": "Recent-token scan window for targeted fact evidence."
+      },
+      "focusedListRecallEnabled": {
+        "type": "boolean",
+        "default": false,
+        "description": "Enable focused list evidence recall for count, relation, and recommendation questions."
+      },
+      "focusedListRecallMaxChars": {
+        "type": "integer",
+        "default": 2600,
+        "minimum": 0,
+        "description": "Character budget for the focused list evidence recall section."
+      },
+      "focusedListRecallMaxResults": {
+        "type": "integer",
+        "default": 40,
+        "minimum": 0,
+        "description": "Maximum recalled items for focused list evidence."
+      },
+      "focusedListRecallScanWindowTurns": {
+        "type": "integer",
+        "default": 64,
+        "minimum": 1,
+        "description": "Recent-turn scan window for focused list evidence."
+      },
+      "focusedListRecallScanWindowTokens": {
+        "type": "integer",
+        "default": 14000,
+        "minimum": 1,
+        "description": "Recent-token scan window for focused list evidence."
+      },
+      "responseGuidanceRecallEnabled": {
+        "type": "boolean",
+        "default": false,
+        "description": "Enable response guidance recall for user answer-shape preferences."
+      },
+      "responseGuidanceRecallMaxChars": {
+        "type": "integer",
+        "default": 2400,
+        "minimum": 0,
+        "description": "Character budget for the response guidance recall section."
+      },
+      "responseGuidanceRecallMaxResults": {
+        "type": "integer",
+        "default": 48,
+        "minimum": 0,
+        "description": "Maximum recalled items for response guidance."
+      },
+      "responseGuidanceRecallScanWindowTurns": {
+        "type": "integer",
+        "default": 64,
+        "minimum": 1,
+        "description": "Recent-turn scan window for response guidance."
+      },
+      "responseGuidanceRecallScanWindowTokens": {
+        "type": "integer",
+        "default": 16000,
+        "minimum": 1,
+        "description": "Recent-token scan window for response guidance."
+      },
+      "eventOrderRecallEnabled": {
+        "type": "boolean",
+        "default": false,
+        "description": "Enable event-order evidence recall for chronology questions."
+      },
+      "eventOrderRecallMaxChars": {
+        "type": "integer",
+        "default": 2400,
+        "minimum": 0,
+        "description": "Character budget for the event-order evidence recall section."
+      },
+      "eventOrderRecallMaxResults": {
+        "type": "integer",
+        "default": 24,
+        "minimum": 0,
+        "description": "Maximum recalled items for event-order evidence."
+      },
+      "eventOrderRecallScanWindowTurns": {
+        "type": "integer",
+        "default": 12,
+        "minimum": 1,
+        "description": "Recent-turn scan window for event-order evidence."
+      },
+      "eventOrderRecallScanWindowTokens": {
+        "type": "integer",
+        "default": 24000,
+        "minimum": 1,
+        "description": "Recent-token scan window for event-order evidence."
+      },
       "queryExpansionEnabled": {
         "type": "boolean",
         "default": false,
@@ -3045,6 +3122,11 @@
         "default": "low",
         "description": "Minimum locally-scored importance level required to persist an extracted fact. Facts below this level are dropped before write and counted toward the importance_gated metric. Default \"low\" drops only trivial turn-level chatter (greetings, single-word replies); raise to \"normal\" or higher for a stricter gate."
       },
+      "extractionTelemetryPrefilterEnabled": {
+        "type": "boolean",
+        "default": true,
+        "description": "Skip semantic durable-memory extraction for mechanical action/state telemetry transcripts that contain no durable-memory cue. Raw transcript storage and recall still run. Disable this if you intentionally want fact extraction from action logs."
+      },
       "extractionScopeClassificationEnabled": {
         "type": "boolean",
         "default": true,
@@ -4378,6 +4460,9 @@
             },
             "maxPatterns": {
               "type": "number"
+            },
+            "forceGeneric": {
+              "type": "boolean"
             }
           },
           "required": [
@@ -4435,11 +4520,21 @@
         "default": 512,
         "description": "Max tokens for deterministic (non-LLM) summaries"
       },
+      "lcmTelemetryPrefilterEnabled": {
+        "type": "boolean",
+        "default": true,
+        "description": "Use deterministic LCM compression for mechanical action/state telemetry without durable-memory cues."
+      },
       "lcmArchiveRetentionDays": {
         "type": "number",
         "default": 90,
         "description": "Days to retain archived LCM summaries"
       },
+      "lcmObserveConcurrency": {
+        "type": "number",
+        "default": 1,
+        "description": "Maximum independent LCM observe jobs to process concurrently."
+      },
       "messagePartsEnabled": {
         "type": "boolean",
         "default": false,
@@ -5721,6 +5816,7 @@
     }
   ],
   "activation": {
+    "onStartup": false,
     "onCommands": [
       "remnic"
     ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joshuaswarren/openclaw-engram",
-  "version": "9.3.19",
+  "version": "9.3.21",
   "description": "Deprecated compatibility shim for Engram installs. Re-exports @remnic/plugin-openclaw and forwards engram-access to @remnic/core.",
   "type": "module",
   "main": "dist/index.js",
@@ -28,14 +28,30 @@
     "plugin": "./openclaw.plugin.json",
     "extensions": [
       "./dist/index.js"
-    ]
+    ],
+    "runtimeExtensions": [
+      "./dist/index.js"
+    ],
+    "compat": {
+      "pluginApi": ">=2026.5.16-beta.1"
+    },
+    "build": {
+      "openclawVersion": "2026.5.16-beta.2",
+      "pluginSdkVersion": "2026.5.16-beta.2"
+    },
+    "install": {
+      "clawhubSpec": "clawhub:@remnic/plugin-openclaw",
+      "npmSpec": "@joshuaswarren/openclaw-engram",
+      "defaultChoice": "clawhub",
+      "minHostVersion": ">=2026.5.16-beta.1"
+    }
   },
   "dependencies": {
-    "@remnic/plugin-openclaw": "^1.0.33",
-    "@remnic/core": "^1.1.10"
+    "@remnic/core": "^1.1.12",
+    "@remnic/plugin-openclaw": "^1.0.35"
   },
   "peerDependencies": {
-    "openclaw": ">=2026.4.8"
+    "openclaw": ">=2026.5.16-beta.1"
   },
   "devDependencies": {
     "tsup": "^8.5.1",