openclaw-cortex-memory 0.1.0-Alpha.2 → 0.1.0-Alpha.20

package/dist/src/utils/runtime_env.js

@@ -0,0 +1,51 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getEnvValue = getEnvValue;
+exports.getHomeDir = getHomeDir;
+exports.getProcessEnvCopy = getProcessEnvCopy;
+const os = __importStar(require("os"));
+function getEnvValue(key) {
+    const value = process.env[key];
+    return typeof value === "string" ? value : "";
+}
+function getHomeDir() {
+    return os.homedir() || "";
+}
+function getProcessEnvCopy() {
+    const entries = Object.entries(process.env).filter((entry) => typeof entry[1] === "string");
+    return Object.fromEntries(entries);
+}
+//# sourceMappingURL=runtime_env.js.map

package/dist/src/utils/runtime_env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime_env.js","sourceRoot":"","sources":["../../../src/utils/runtime_env.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA,kCAGC;AAED,gCAEC;AAED,8CAGC;AAdD,uCAAyB;AAEzB,SAAgB,WAAW,CAAC,GAAW;IACrC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC/B,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAChD,CAAC;AAED,SAAgB,UAAU;IACxB,OAAO,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC;AAC5B,CAAC;AAED,SAAgB,iBAAiB;IAC/B,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAA6B,EAAE,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC;IACvH,OAAO,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;AACrC,CAAC"}

package/openclaw.plugin.json

@@ -1,10 +1,10 @@
 {
   "id": "openclaw-cortex-memory",
   "name": "Cortex Memory",
-  "version": "0.1.0-Alpha.1",
+  "version": "0.1.0-Alpha.20",
   "description": "Long-term memory system with semantic, episodic, and procedural memory for AI Agents",
   "main": "dist/index.js",
-  "author": "OpenClaw Community",
+  "author": "deki18",
   "license": "MIT",
   "type": "memory",
   "repository": {
@@ -56,7 +56,26 @@
             "type": "array",
             "description": "Involved entities",
             "items": {
-              "type": "string"
+              "oneOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "type": "string"
+                    },
+                    "name": {
+                      "type": "string"
+                    },
+                    "type": {
+                      "type": "string"
+                    }
+                  },
+                  "additionalProperties": false
+                }
+              ]
             }
           },
           "outcome": {
@@ -67,7 +86,27 @@
             "type": "array",
             "description": "Entity relationships",
             "items": {
-              "type": "string"
+              "oneOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "source": {
+                      "type": "string"
+                    },
+                    "target": {
+                      "type": "string"
+                    },
+                    "type": {
+                      "type": "string"
+                    }
+                  },
+                  "required": ["source", "target"],
+                  "additionalProperties": false
+                }
+              ]
             }
           }
         },
@@ -84,6 +123,23 @@
           "entity": {
             "type": "string",
             "description": "Entity name"
+          },
+          "rel": {
+            "type": "string",
+            "description": "Optional relation type filter"
+          },
+          "dir": {
+            "type": "string",
+            "description": "Relation direction filter",
+            "enum": ["incoming", "outgoing", "both"]
+          },
+          "path_to": {
+            "type": "string",
+            "description": "Find path from entity to this target entity"
+          },
+          "max_depth": {
+            "type": "integer",
+            "description": "Path query max depth (2~4)"
           }
         },
         "required": ["entity"],
@@ -177,7 +233,7 @@
       "apiUrl": {
         "type": "string",
         "description": "URL of the memory service API",
-        "default": "http://127.0.0.1:8765"
+        "default": "http://localhost:8765"
       },
       "engineMode": {
         "type": "string",
@@ -199,6 +255,11 @@
         "description": "Automatically trigger reflection periodically",
         "default": false
       },
+      "autoReflectIntervalMinutes": {
+        "type": "integer",
+        "description": "Auto reflection scan interval in minutes",
+        "default": 30
+      },
       "embedding": {
         "type": "object",
         "description": "Embedding model configuration",
@@ -226,8 +287,19 @@
           "dimensions": {
             "type": "integer",
             "description": "Embedding dimensions"
+          },
+          "timeoutMs": {
+            "type": "integer",
+            "description": "Embedding request timeout in milliseconds",
+            "default": 20000
+          },
+          "maxRetries": {
+            "type": "integer",
+            "description": "Maximum retry attempts for embedding requests",
+            "default": 4
           }
         },
+        "required": ["provider", "model", "apiKey", "baseURL"],
         "additionalProperties": false
       },
       "llm": {
@@ -255,6 +327,7 @@
             "description": "LLM API base URL (camelCase alias)"
           }
         },
+        "required": ["provider", "model", "apiKey", "baseURL"],
         "additionalProperties": false
       },
       "reranker": {
@@ -282,12 +355,91 @@
             "description": "Reranker API base URL (camelCase alias)"
           }
         },
+        "required": ["provider", "model", "apiKey", "baseURL"],
         "additionalProperties": false
       },
       "fallbackToBuiltin": {
         "type": "boolean",
         "description": "Fallback to OpenClaw builtin memory when Cortex Memory fails",
         "default": true
+      },
+      "readFusion": {
+        "type": "object",
+        "description": "Post-rerank LLM fusion for multi-route retrieval results",
+        "properties": {
+          "enabled": {
+            "type": "boolean",
+            "description": "Enable LLM fusion after rerank",
+            "default": true
+          },
+          "maxCandidates": {
+            "type": "integer",
+            "description": "Maximum reranked candidates used for fusion",
+            "default": 10
+          },
+          "authoritative": {
+            "type": "boolean",
+            "description": "Return only fused authoritative memory package to agent",
+            "default": true
+          }
+        },
+        "additionalProperties": false
+      },
+      "memoryDecay": {
+        "type": "object",
+        "description": "Time-decay controls for retrieval ranking by event_type",
+        "properties": {
+          "enabled": {
+            "type": "boolean",
+            "description": "Enable event-type half-life decay in retrieval ranking",
+            "default": true
+          },
+          "minFloor": {
+            "type": "number",
+            "description": "Minimum decay factor floor in [0,1]",
+            "default": 0.15
+          },
+          "defaultHalfLifeDays": {
+            "type": "number",
+            "description": "Default half-life in days for unconfigured event types",
+            "default": 90
+          },
+          "halfLifeByEventType": {
+            "type": "object",
+            "description": "Half-life days overrides by event_type",
+            "additionalProperties": {
+              "type": "number"
+            }
+          },
+          "antiDecay": {
+            "type": "object",
+            "description": "Hit-frequency anti-decay controls",
+            "properties": {
+              "enabled": {
+                "type": "boolean",
+                "description": "Enable anti-decay boost for frequently hit memories",
+                "default": true
+              },
+              "maxBoost": {
+                "type": "number",
+                "description": "Maximum multiplicative anti-decay boost (>=1)",
+                "default": 1.6
+              },
+              "hitWeight": {
+                "type": "number",
+                "description": "Hit count to boost conversion weight",
+                "default": 0.08
+              },
+              "recentWindowDays": {
+                "type": "number",
+                "description": "Recent hit window in days for freshness contribution",
+                "default": 30
+              }
+            },
+            "additionalProperties": false
+          }
+        },
+        "additionalProperties": false
       }
     },
     "additionalProperties": false

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-cortex-memory",
-  "version": "0.1.0-Alpha.2",
+  "version": "0.1.0-Alpha.20",
   "description": "Long-term memory system for OpenClaw AI Agent",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -9,9 +9,17 @@
   },
   "scripts": {
     "build": "tsc && node -e \"require('fs').copyFileSync('openclaw.plugin.json','dist/openclaw.plugin.json')\"",
+    "typecheck": "tsc --noEmit",
+    "check:version": "node scripts/check-version.js",
+    "test:compat": "node scripts/compat-regression.js",
+    "test:model": "node scripts/model-regression.js",
+    "test:graph": "node scripts/graph-eval.js",
+    "test:lengthnorm": "node scripts/lengthnorm-regression.js",
+    "test:all": "npm run test:compat && npm run test:model && npm run test:graph && npm run test:lengthnorm",
+    "release:check": "node scripts/release-pipeline.js",
     "dev": "tsc --watch",
-    "prepublishOnly": "npm run build",
-    "postinstall": "node scripts/install.js"
+    "prepack": "npm run build",
+    "prepublishOnly": "npm run check:version && npm run build && npm run test:all"
   },
   "keywords": [
     "openclaw",
@@ -20,11 +28,14 @@
     "agent",
     "rag"
   ],
-  "author": "",
+  "author": "deki18",
   "license": "MIT",
   "dependencies": {
     "undici": "^6.21.0"
   },
+  "optionalDependencies": {
+    "@lancedb/lancedb": "^0.22.0"
+  },
   "devDependencies": {
     "@types/node": "^22.19.15",
     "typescript": "^5.7.2"
@@ -37,9 +48,7 @@
   },
   "files": [
     "dist/",
-    "index.ts",
     "scripts/cli.js",
-    "scripts/install.js",
     "scripts/uninstall.js",
     "openclaw.plugin.json",
     "SKILL.md"
@@ -48,6 +57,12 @@
     "plugin": true,
     "requiresPython": false,
     "cli": "cortex-memory",
+    "build": {
+      "openclawVersion": "2026.3.22"
+    },
+    "compat": {
+      "pluginApi": ">=2026.3.22"
+    },
     "extensions": [
       "./dist/index.js"
     ]

package/scripts/cli.js

@@ -2,16 +2,17 @@
 
 const fs = require('fs');
 const path = require('path');
-const { spawn } = require('child_process');
 
 const PLUGIN_NAME = 'openclaw-cortex-memory';
 
 function findOpenClawConfig() {
   const explicitConfigPath = process.env.OPENCLAW_CONFIG_PATH || '';
+  const stateDir = process.env.OPENCLAW_STATE_DIR || '';
   const basePath = process.env.OPENCLAW_BASE_PATH || '';
   const homePath = process.env.USERPROFILE || process.env.HOME || '';
   const possiblePaths = [
     explicitConfigPath,
+    stateDir ? path.join(stateDir, 'openclaw.json') : '',
     basePath ? path.join(basePath, 'openclaw.json') : '',
     path.join(process.cwd(), 'openclaw.json'),
     homePath ? path.join(homePath, '.openclaw', 'openclaw.json') : '',
@@ -53,7 +54,10 @@ function enablePlugin() {
   const configPath = findOpenClawConfig();
   
   if (!configPath) {
-    const defaultPath = path.join(process.env.USERPROFILE || process.env.HOME || '', '.openclaw', 'openclaw.json');
+    const defaultPath = process.env.OPENCLAW_CONFIG_PATH
+      || (process.env.OPENCLAW_STATE_DIR ? path.join(process.env.OPENCLAW_STATE_DIR, 'openclaw.json') : '')
+      || (process.env.OPENCLAW_BASE_PATH ? path.join(process.env.OPENCLAW_BASE_PATH, 'openclaw.json') : '')
+      || path.join(process.env.USERPROFILE || process.env.HOME || '', '.openclaw', 'openclaw.json');
     console.log(`No config file found. Creating: ${defaultPath}`);
     
     const config = {
@@ -170,21 +174,22 @@ function getStatus() {
 }
 
 function runUninstall(args) {
-  const uninstallScript = path.join(__dirname, 'uninstall.js');
-  
-  if (!fs.existsSync(uninstallScript)) {
+  const uninstallScriptPath = path.join(__dirname, 'uninstall.js');
+  if (!fs.existsSync(uninstallScriptPath)) {
     console.error('Uninstall script not found.');
     process.exit(1);
   }
-  
-  const child = spawn(process.execPath, [uninstallScript, 'uninstall', ...args], {
-    stdio: 'inherit',
-    cwd: process.cwd()
-  });
-  
-  child.on('exit', (code) => {
-    process.exit(code || 0);
-  });
+  try {
+    const uninstallModule = require(uninstallScriptPath);
+    if (!uninstallModule || typeof uninstallModule.uninstall !== 'function') {
+      console.error('Invalid uninstall script export.');
+      process.exit(1);
+    }
+    uninstallModule.uninstall(args);
+  } catch (error) {
+    console.error(`Failed to run uninstall: ${error instanceof Error ? error.message : String(error)}`);
+    process.exit(1);
+  }
 }
 
 function showHelp() {

package/scripts/uninstall.js

@@ -17,14 +17,20 @@ function findProjectRoot() {
 }
 
 function findOpenClawConfig() {
+  const explicitConfigPath = process.env.OPENCLAW_CONFIG_PATH || '';
+  const stateDir = process.env.OPENCLAW_STATE_DIR || '';
+  const basePath = process.env.OPENCLAW_BASE_PATH || '';
+  const homePath = process.env.USERPROFILE || process.env.HOME || '';
   const possiblePaths = [
+    explicitConfigPath,
+    stateDir ? path.join(stateDir, 'openclaw.json') : '',
+    basePath ? path.join(basePath, 'openclaw.json') : '',
     path.join(process.cwd(), 'openclaw.json'),
-    path.join(process.env.USERPROFILE || process.env.HOME || '', '.openclaw', 'openclaw.json'),
-    path.join(process.env.OPENCLAW_BASE_PATH || '', 'openclaw.json'),
+    homePath ? path.join(homePath, '.openclaw', 'openclaw.json') : '',
   ];
   
   for (const p of possiblePaths) {
-    if (fs.existsSync(p)) {
+    if (p && fs.existsSync(p)) {
       return p;
     }
   }
@@ -114,15 +120,20 @@ function removeFromConfig() {
     const content = fs.readFileSync(configPath, 'utf-8');
     const config = JSON.parse(content);
     
+    if (Array.isArray(config.plugins?.allow)) {
+      config.plugins.allow = config.plugins.allow.filter((item) => item !== PLUGIN_NAME);
+    }
     if (config.plugins?.entries?.[PLUGIN_NAME]) {
       delete config.plugins.entries[PLUGIN_NAME];
-      
       if (config.plugins.slots?.memory === PLUGIN_NAME) {
         delete config.plugins.slots.memory;
       }
       
       fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
       console.log(`Removed plugin from config: ${configPath}`);
+    } else if (Array.isArray(config.plugins?.allow)) {
+      fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+      console.log(`Removed plugin allowlist entry from config: ${configPath}`);
     } else {
       console.log('Plugin not found in config.');
     }
@@ -209,4 +220,10 @@ function main() {
   }
 }
 
-main();
+module.exports = {
+  uninstall,
+};
+
+if (require.main === module) {
+  main();
+}