@joshuaswarren/openclaw-engram 9.3.20 → 9.3.22

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/bin/engram-access.js

@@ -7,12 +7,19 @@
 // store during migration when both blocks exist with no plugins.slots.memory
 // override (#403).  The id is hardcoded (not imported from @remnic/core)
 // because the shim *is* the legacy alias — the string is its identity.
-import("../dist/access-cli.js")
-  .then(({ runCli }) =>
-    runCli(process.argv.slice(2), { preferredId: "openclaw-engram" }),
-  )
-  .catch((error) => {
-    const message = error instanceof Error ? error.message : "unknown load error";
-    console.error(`access-cli failed to load dist/access-cli.js: ${message}`);
-    process.exit(1);
-  });
+let accessCli;
+try {
+  accessCli = await import("../dist/access-cli.js");
+} catch (error) {
+  const message = error instanceof Error ? error.message : "unknown load error";
+  console.error(`access-cli failed to load dist/access-cli.js: ${message}`);
+  process.exit(1);
+}
+
+try {
+  await accessCli.runCli(process.argv.slice(2), { preferredId: "openclaw-engram" });
+} catch (error) {
+  const message = error instanceof Error ? error.message : "unknown error";
+  console.error(`engram-access failed: ${message}`);
+  process.exit(1);
+}

package/openclaw.plugin.json

@@ -1,21 +1,10 @@
 {
   "id": "openclaw-engram",
   "name": "Remnic OpenClaw Plugin",
-  "version": "9.3.20",
+  "version": "9.3.22",
   "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": {
@@ -126,7 +115,14 @@
     "additionalProperties": false,
     "properties": {
       "openaiApiKey": {
-        "type": "string",
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "const": false
+          }
+        ],
         "description": "Optional OpenAI API key for plugin mode (or set OPENAI_API_KEY env var). Ignored by default gateway-mode installs; in plugin mode, Remnic may send conversation and memory content to OpenAI or the configured OpenAI-compatible endpoint for extraction, consolidation, summarization, and embeddings."
       },
       "openaiBaseUrl": {
@@ -135,7 +131,7 @@
       },
       "model": {
         "type": "string",
-        "default": "gpt-5.2",
+        "default": "gpt-5.5",
         "description": "OpenAI model for extraction/consolidation"
       },
       "reasoningEffort": {
@@ -719,7 +715,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",
@@ -1357,7 +1353,8 @@
         "description": "Include the most relevant open question in generated memory context"
       },
       "commitmentDecayDays": {
-        "type": "number",
+        "type": "integer",
+        "minimum": 1,
         "default": 90,
         "description": "Days before fulfilled/expired commitments are removed"
       },
@@ -1778,7 +1775,7 @@
       },
       "recallPlannerModel": {
         "type": "string",
-        "default": "gpt-5.2-mini",
+        "default": "gpt-5.5",
         "description": "Model to use for the recall planner."
       },
       "recallPlannerTimeoutMs": {
@@ -2338,6 +2335,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,
@@ -3017,6 +3130,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,
@@ -3269,7 +3387,7 @@
       "conversationIndexFaissModelId": {
         "type": "string",
         "default": "text-embedding-3-small",
-        "description": "Embedding model identifier passed to the FAISS sidecar. By default the sidecar aliases OpenAI embedding ids to a local sentence-transformers model when ENGRAM_FAISS_ENABLE_ST=1, and otherwise falls back to deterministic hash embeddings."
+        "description": "Embedding model identifier passed to the FAISS sidecar. By default the sidecar aliases OpenAI embedding ids to a local sentence-transformers model when REMNIC_FAISS_ENABLE_ST=1 (or legacy ENGRAM_FAISS_ENABLE_ST=1), and otherwise falls back to deterministic hash embeddings."
       },
       "conversationIndexFaissIndexDir": {
         "type": "string",
@@ -4350,6 +4468,9 @@
             },
             "maxPatterns": {
               "type": "number"
+            },
+            "forceGeneric": {
+              "type": "boolean"
             }
           },
           "required": [
@@ -4407,11 +4528,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,
@@ -4641,7 +4772,7 @@
     "model": {
       "label": "Extraction Model",
       "advanced": true,
-      "placeholder": "gpt-5.2"
+      "placeholder": "gpt-5.5"
     },
     "reasoningEffort": {
       "label": "Reasoning Effort",
@@ -4813,7 +4944,8 @@
     "commitmentDecayDays": {
       "label": "Commitment Decay (days)",
       "advanced": true,
-      "placeholder": "90"
+      "placeholder": "90",
+      "help": "Positive integer days before fulfilled/expired commitments are removed."
     },
     "workspaceDir": {
       "label": "Workspace Directory",
@@ -5693,6 +5825,7 @@
     }
   ],
   "activation": {
+    "onStartup": false,
     "onCommands": [
       "remnic"
     ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joshuaswarren/openclaw-engram",
-  "version": "9.3.20",
+  "version": "9.3.22",
   "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",
@@ -18,7 +18,8 @@
   "files": [
     "dist",
     "bin/engram-access.js",
-    "openclaw.plugin.json"
+    "openclaw.plugin.json",
+    "scripts/postinstall-banner.mjs"
   ],
   "publishConfig": {
     "access": "public",
@@ -28,14 +29,30 @@
     "plugin": "./openclaw.plugin.json",
     "extensions": [
       "./dist/index.js"
-    ]
+    ],
+    "runtimeExtensions": [
+      "./dist/index.js"
+    ],
+    "compat": {
+      "pluginApi": ">=2026.5.16-beta.1"
+    },
+    "build": {
+      "openclawVersion": "2026.5.19-beta.1",
+      "pluginSdkVersion": "2026.5.19-beta.1"
+    },
+    "install": {
+      "clawhubSpec": "clawhub:@remnic/plugin-openclaw",
+      "npmSpec": "@joshuaswarren/openclaw-engram",
+      "defaultChoice": "clawhub",
+      "minHostVersion": ">=2026.5.16-beta.1"
+    }
   },
   "dependencies": {
-    "@remnic/core": "^1.1.11",
-    "@remnic/plugin-openclaw": "^1.0.34"
+    "@remnic/plugin-openclaw": "^1.0.36",
+    "@remnic/core": "^1.1.12"
   },
   "peerDependencies": {
-    "openclaw": ">=2026.4.8"
+    "openclaw": ">=2026.5.16-beta.1"
   },
   "devDependencies": {
     "tsup": "^8.5.1",
@@ -57,6 +74,7 @@
   ],
   "scripts": {
     "build": "node ./scripts/sync-openclaw-plugin.mjs && tsup --config tsup.config.ts",
+    "precheck-types": "node ../../scripts/ensure-bench-build-deps.mjs",
     "check-types": "tsc --noEmit",
     "postinstall": "node ./scripts/postinstall-banner.mjs"
   }

package/scripts/postinstall-banner.mjs

@@ -0,0 +1,19 @@
+const lines = [
+  "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━",
+  "  Engram is now Remnic",
+  "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━",
+  "  Same product. New name. One-time auto-migration runs",
+  "  on first use. Your memories, config, and tokens carry over.",
+  "",
+  "  Why: namespace conflicts and a clearer identity for what",
+  "  the product actually is — a Recall Engine for Memory",
+  "  Networks powering Intelligent Collaboration across your",
+  "  entire agent fleet.",
+  "",
+  "  Next step: nothing. The plugin auto-migrates on first run.",
+  "",
+  "  Learn more: https://remnic.ai/rename",
+  "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━",
+];
+
+process.stderr.write(`\n${lines.join("\n")}\n\n`);