@joshuaswarren/openclaw-engram 9.3.21 → 9.3.23

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,7 +1,7 @@
 {
   "id": "openclaw-engram",
   "name": "Remnic OpenClaw Plugin",
-  "version": "9.3.21",
+  "version": "9.3.23",
   "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": {
@@ -115,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": {
@@ -124,7 +131,7 @@
       },
       "model": {
         "type": "string",
-        "default": "gpt-5.2",
+        "default": "gpt-5.5",
         "description": "OpenAI model for extraction/consolidation"
       },
       "reasoningEffort": {
@@ -281,6 +288,83 @@
         "default": false,
         "description": "Allow automated cold-tier backfill jobs to repair parity gaps"
       },
+      "qmdSupportedVersion": {
+        "type": "string",
+        "default": "2.5.1",
+        "description": "Highest QMD version this Remnic build will auto-install"
+      },
+      "qmdAutoUpgradeEnabled": {
+        "type": "boolean",
+        "default": false,
+        "description": "Opt-in auto-upgrade for PATH/fallback QMD installs"
+      },
+      "qmdAutoUpgradeCheckIntervalMs": {
+        "type": "number",
+        "minimum": 60000,
+        "default": 86400000,
+        "description": "Minimum interval between QMD auto-upgrade checks"
+      },
+      "qmdChunkStrategy": {
+        "type": "string",
+        "enum": [
+          "auto",
+          "regex"
+        ],
+        "default": "auto",
+        "description": "QMD chunk strategy forwarded when the installed QMD supports it"
+      },
+      "qmdCandidateLimit": {
+        "type": "number",
+        "minimum": 1,
+        "description": "Optional candidate limit forwarded to supported QMD query paths"
+      },
+      "qmdQueryRerankEnabled": {
+        "type": "boolean",
+        "default": true,
+        "description": "When false, ask supported QMD versions to skip the built-in rerank step"
+      },
+      "qmdIndexName": {
+        "type": "string",
+        "description": "Optional QMD named index forwarded as qmd --index <name> when supported"
+      },
+      "qmdForceCpu": {
+        "type": "boolean",
+        "default": false,
+        "description": "Set QMD_FORCE_CPU=1 for QMD child processes to bypass GPU probing and run predictably on CPU"
+      },
+      "qmdGpuBackend": {
+        "type": [
+          "string",
+          "boolean"
+        ],
+        "enum": [
+          "auto",
+          "metal",
+          "cuda",
+          "vulkan",
+          "false",
+          false
+        ],
+        "description": "Optional QMD_LLAMA_GPU override for QMD child processes"
+      },
+      "qmdEmbedParallelism": {
+        "type": "number",
+        "minimum": 1,
+        "maximum": 8,
+        "description": "Optional QMD_EMBED_PARALLELISM override, clamped to 1-8"
+      },
+      "qmdEmbedModel": {
+        "type": "string",
+        "description": "Optional QMD_EMBED_MODEL override"
+      },
+      "qmdRerankModel": {
+        "type": "string",
+        "description": "Optional QMD_RERANK_MODEL override"
+      },
+      "qmdGenerateModel": {
+        "type": "string",
+        "description": "Optional QMD_GENERATE_MODEL override"
+      },
       "embeddingFallbackEnabled": {
         "type": "boolean",
         "default": true,
@@ -296,6 +380,10 @@
         "default": "auto",
         "description": "Embedding provider selection for semantic fallback"
       },
+      "embeddingFallbackModel": {
+        "type": "string",
+        "description": "Optional model identifier for embedding fallback requests. Defaults to localLlmModel for legacy installs."
+      },
       "qmdPath": {
         "type": "string",
         "description": "Optional absolute path to qmd binary (bypasses PATH/fallback discovery)"
@@ -1346,7 +1434,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"
       },
@@ -1767,7 +1856,7 @@
       },
       "recallPlannerModel": {
         "type": "string",
-        "default": "gpt-5.2-mini",
+        "default": "gpt-5.5",
         "description": "Model to use for the recall planner."
       },
       "recallPlannerTimeoutMs": {
@@ -3379,7 +3468,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",
@@ -4764,7 +4853,7 @@
     "model": {
       "label": "Extraction Model",
       "advanced": true,
-      "placeholder": "gpt-5.2"
+      "placeholder": "gpt-5.5"
     },
     "reasoningEffort": {
       "label": "Reasoning Effort",
@@ -4861,6 +4950,66 @@
       "advanced": true,
       "help": "Enable automated cold-tier backfill runs for parity repair"
     },
+    "qmdSupportedVersion": {
+      "label": "QMD Supported Version",
+      "advanced": true,
+      "placeholder": "2.5.1"
+    },
+    "qmdAutoUpgradeEnabled": {
+      "label": "QMD Auto Upgrade",
+      "advanced": true,
+      "help": "Upgrade PATH/fallback QMD installs to the supported version; explicit qmdPath installs are skipped"
+    },
+    "qmdAutoUpgradeCheckIntervalMs": {
+      "label": "QMD Auto Upgrade Interval",
+      "advanced": true,
+      "placeholder": "86400000"
+    },
+    "qmdChunkStrategy": {
+      "label": "QMD Chunk Strategy",
+      "advanced": true,
+      "placeholder": "auto"
+    },
+    "qmdCandidateLimit": {
+      "label": "QMD Candidate Limit",
+      "advanced": true
+    },
+    "qmdQueryRerankEnabled": {
+      "label": "QMD Query Rerank",
+      "advanced": true
+    },
+    "qmdIndexName": {
+      "label": "QMD Index Name",
+      "advanced": true,
+      "help": "Use a named QMD index when QMD 2.5+ supports --index"
+    },
+    "qmdForceCpu": {
+      "label": "QMD Force CPU",
+      "advanced": true,
+      "help": "Set QMD_FORCE_CPU=1 for QMD child processes"
+    },
+    "qmdGpuBackend": {
+      "label": "QMD GPU Backend",
+      "advanced": true,
+      "placeholder": "metal"
+    },
+    "qmdEmbedParallelism": {
+      "label": "QMD Embed Parallelism",
+      "advanced": true,
+      "placeholder": "4"
+    },
+    "qmdEmbedModel": {
+      "label": "QMD Embed Model",
+      "advanced": true
+    },
+    "qmdRerankModel": {
+      "label": "QMD Rerank Model",
+      "advanced": true
+    },
+    "qmdGenerateModel": {
+      "label": "QMD Generate Model",
+      "advanced": true
+    },
     "embeddingFallbackEnabled": {
       "label": "Embedding Fallback",
       "help": "Use semantic embeddings when QMD is unavailable or no results are found"
@@ -4870,6 +5019,12 @@
       "advanced": true,
       "placeholder": "auto"
     },
+    "embeddingFallbackModel": {
+      "label": "Embedding Model",
+      "advanced": true,
+      "placeholder": "(defaults to local LLM model)",
+      "help": "Optional embedding model for semantic fallback. Use this when the local chat model and embedding model are different."
+    },
     "qmdPath": {
       "label": "QMD Path",
       "advanced": true,
@@ -4936,7 +5091,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",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joshuaswarren/openclaw-engram",
-  "version": "9.3.21",
+  "version": "9.3.23",
   "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",
@@ -36,8 +37,8 @@
       "pluginApi": ">=2026.5.16-beta.1"
     },
     "build": {
-      "openclawVersion": "2026.5.16-beta.2",
-      "pluginSdkVersion": "2026.5.16-beta.2"
+      "openclawVersion": "2026.5.19-beta.1",
+      "pluginSdkVersion": "2026.5.19-beta.1"
     },
     "install": {
       "clawhubSpec": "clawhub:@remnic/plugin-openclaw",
@@ -47,8 +48,8 @@
     }
   },
   "dependencies": {
-    "@remnic/core": "^1.1.12",
-    "@remnic/plugin-openclaw": "^1.0.35"
+    "@remnic/plugin-openclaw": "^1.0.37",
+    "@remnic/core": "^1.1.13"
   },
   "peerDependencies": {
     "openclaw": ">=2026.5.16-beta.1"
@@ -73,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`);