openclaw-plugin-memory-engine 4.0.0 → 4.1.0

package/README.md

@@ -1,48 +1,42 @@
-# Memory Engine TS — OpenClaw Plugin
+# Memory Engine — OpenClaw Plugin
 
-Native memory engine for OpenClaw: 19 agent tools, event-driven session ingest,
-and a conservative night curator — all in one plugin, no external MCP server.
+Native memory engine for OpenClaw: **45 agent tools**, event-driven session ingest,
+semantic search, backup/import/export, learning, a conservative curator, and a
+native Control UI page — all in one plugin, no external MCP server.
+
+Successor of the Python `memory-engine` MCP server (same versioning lineage).
 
 ## Features
 
-- **17 memory tools**: recall (FTS + ranking), working_set (token-budgeted context pack),
-  remember, get_atom, list_atoms, link/search_graph (knowledge graph), contradict,
-  impact, preference_search, error_check/error_log (error memory), stats,
-  session_summary/generate_session_digest
-- **Curator (v3.1)**: `memory_curator_run` — conservative maintenance pass
-  (extractive body_compact, auto-bonds by domain/keyword/pattern, isolated atom
-  classification, promotion and merge candidates). Dry-run by default.
-- **Cognitive status**: `memory_cognitive_status` — graph health metrics + recommendations
-- **Event hooks**: buffers chat messages and periodically (60s, only when changed)
-  ingests `session_msg` atoms and generates/refreshes `session_digest` atoms (7-day TTL)
+**45 memory tools:**
+- **Core**: recall (FTS + ranking, optional semantic merge), working_set (token-budgeted context pack), remember, get_atom, list_atoms, stats, memory_summary
+- **Knowledge graph**: link, search_graph, contradict, impact, suggest_bonds(+all), find_similar
+- **Curator**: memory_curator_run — conservative maintenance (extractive body_compact, auto-bonds by domain/keyword/pattern, isolated atom classification, promotion and merge candidates). Dry-run by default. memory_cognitive_status for graph health metrics
+- **Semantic** (Ollama): semantic_search with FTS fallback, reindex_embeddings, optional `semantic:true` on recall
+- **Maintenance**: decay_run, cleanup_sessions, cleanup_duplicates, merge_atoms, delete_atom (soft by default), unlink, update_domain, classify_memory_tier
+- **Backup**: backup_database, restore_database (confirm required), list_backups, export_all, export_atom, import_data, import_markdown
+- **Learning**: learning_run, ask_pending, answer_human (human_questions flow)
+- **Errors**: error_check, error_log, error_list, list_contradictions, preference_search
 
-## Install
+**Native Control UI page** (5 tabs): live cognitive stats, FTS atom search with type/domain filters, atom detail with bonds, curator dry-run/apply, backup management, pending human questions with inline answers.
 
-```bash
-openclaw plugins install memory-engine-ts
-```
+**Event hooks**: buffers chat messages and periodically (60s, only when changed) ingests `session_msg` atoms and refreshes `session_digest` atoms (7-day TTL).
 
-Or from a local package:
+## Install
 
 ```bash
-openclaw plugins install ./openclaw-plugin-memory-engine-ts-3.1.0.tgz
+openclaw plugins install clawhub:openclaw-plugin-memory-engine
+# or from npm
+openclaw plugins install npm:openclaw-plugin-memory-engine
 ```
 
 ## Configuration
 
-The database path is read from the `MEMORY_DB_PATH` environment variable
-(default `/data/memory.db`). The SQLite database is created with the expected
-schema on first use.
-
-Curator tuning (optional) via plugin config `curator`: max_atoms_per_run,
-compact_min_body_chars, bond_limit_per_atom, stale_after_days and more —
-sensible defaults apply.
-
-## Session hooks
+- `MEMORY_DB_PATH` — SQLite database path (default `/data/memory.db`, schema created on first use)
+- `OLLAMA_HOST` — Ollama base URL for embeddings (default `http://ollama:11434`)
+- `ME_EMBED_MODEL` — embedding model (default `nomic-embed-text`)
 
-- `message_received` / `agent_end`: buffer chat content per session
-- every 60s: ingest new messages as episodic `session_msg` atoms (7-day TTL)
-  and refresh the session digest atom
+Enable the plugin UI page once via **Control UI → Settings → Labs → Custom plugin UI**.
 
 ## License
 

package/dist/tools.d.ts

@@ -4,7 +4,7 @@
  * Python server and are exposed as explicit pointers.
  */
 import { DatabaseSync } from "node:sqlite";
-export declare const VERSION = "4.0.0";
+export declare const VERSION = "4.1.0";
 export declare function createTools(dbPath: string): {
     __db: DatabaseSync;
     version: () => {

package/dist/tools.js

@@ -6,7 +6,7 @@
 import { DatabaseSync } from "node:sqlite";
 import { Engine } from "./engine.js";
 import { buildSessionDigest } from "./digest.js";
-export const VERSION = "4.0.0";
+export const VERSION = "4.1.0";
 export function createTools(dbPath) {
     const db = new DatabaseSync(dbPath);
     const engine = new Engine(db, {});

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "memory-engine",
   "name": "Memory Engine",
   "description": "Native Memory Engine: 45 memory tools, session ingest/digest, curator and Control UI.",
-  "version": "4.0.0",
+  "version": "4.1.0",
   "configSchema": {
     "type": "object",
     "additionalProperties": false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-plugin-memory-engine",
-  "version": "4.0.0",
+  "version": "4.1.0",
   "type": "module",
   "scripts": {
     "build": "tsc -p tsconfig.json && openclaw plugins build",
@@ -9,10 +9,13 @@
     "test": "vitest run --config ./vitest.config.ts"
   },
   "files": [
-    "README.md",
-    "assets",
     "dist",
-    "openclaw.plugin.json"
+    "!dist/index.test.js",
+    "!dist/index.test.d.ts",
+    "openclaw.plugin.json",
+    "README.md",
+    "LICENSE",
+    "assets"
   ],
   "peerDependencies": {
     "openclaw": ">=2026.5.17"
@@ -37,7 +40,7 @@
     },
     "controlUi": "./src/control-ui.ts"
   },
-  "description": "Native Memory Engine for OpenClaw: 19 memory tools + session ingest/digest + curator",
+  "description": "Native Memory Engine for OpenClaw: 45 memory tools (recall, working set, curator, semantic, backup, learning) + session ingest/digest + Control UI",
   "license": "MIT",
   "keywords": [
     "openclaw",

package/dist/index.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/index.test.js

@@ -1,8 +0,0 @@
-import { describe, expect, it } from "vitest";
-import entry from "./index.js";
-import { getToolPluginMetadata } from "openclaw/plugin-sdk/tool-plugin";
-describe("memory-engine-ts", () => {
-    it("declares tool metadata", () => {
-        expect(getToolPluginMetadata(entry)?.tools.map((tool) => tool.name)).toEqual(["echo"]);
-    });
-});