@memoryrelay/plugin-memoryrelay-ai 0.17.0 → 0.17.1

package/README.md

@@ -34,6 +34,18 @@ MemoryRelay is designed for engineering teams managing complex, long-running pro
 openclaw plugins install @memoryrelay/plugin-memoryrelay-ai
 ```
 
+**1b. Install native dependencies (for local SQLite cache)**
+
+The local cache requires `better-sqlite3`, which includes native bindings. After plugin installation, run:
+
+```bash
+cd ~/.openclaw/extensions/plugin-memoryrelay-ai && npm install --omit=dev
+```
+
+Or install globally: `npm install -g better-sqlite3`
+
+> **Note:** If you skip this step, the plugin still works — it falls back to API-only mode (no local cache).
+
 **2. Set your API key**
 
 ```bash

package/index.ts

@@ -1,6 +1,6 @@
 /**
  * OpenClaw Memory Plugin - MemoryRelay
- * Version: 0.16.3
+ * Version: 0.17.1
  *
  * Long-term memory with vector search using MemoryRelay API.
  * Provides auto-recall and auto-capture via lifecycle hooks.
@@ -358,7 +358,7 @@ export default async function plugin(api: OpenClawPluginApi): Promise<void> {
     api.logger.error(`memory-memoryrelay: health check failed: ${String(err)}`);
   }
 
-  // --- Local Cache + SyncDaemon (v0.17.0) ---
+  // --- Local Cache + SyncDaemon (v0.17.0+) ---
   // Replaces the stub file hack from v0.16.x. LocalCache creates a real SQLite
   // database at the expected path, satisfying OpenClaw's existsSync scanner and
   // enabling local-first recall/capture pipelines.
@@ -472,7 +472,7 @@ export default async function plugin(api: OpenClawPluginApi): Promise<void> {
   // ========================================================================
 
   api.logger.info?.(
-    `memory-memoryrelay: plugin v0.17.0 loaded (${Object.values(TOOL_GROUPS).flat().length} tools, autoRecall: ${pluginConfig.autoRecall}, autoCapture: ${autoCaptureConfig.enabled ? autoCaptureConfig.tier : "off"}, debug: ${debugEnabled})`,
+    `memory-memoryrelay: plugin v0.17.1 loaded (${Object.values(TOOL_GROUPS).flat().length} tools, autoRecall: ${pluginConfig.autoRecall}, autoCapture: ${autoCaptureConfig.enabled ? autoCaptureConfig.tier : "off"}, debug: ${debugEnabled})`,
   );
 
   // ========================================================================

package/openclaw.plugin.json

@@ -2,8 +2,8 @@
   "id": "plugin-memoryrelay-ai",
   "kind": "memory",
   "name": "MemoryRelay AI",
-  "description": "MemoryRelay v0.17.0 - Long-term memory with pipeline architecture, 42 tools, 17 commands, V2 async, sessions, decisions, patterns & projects (api.memoryrelay.net)",
-  "version": "0.17.0",
+  "description": "MemoryRelay v0.17.1 - Long-term memory with pipeline architecture, 42 tools, 17 commands, V2 async, sessions, decisions, patterns & projects (api.memoryrelay.net)",
+  "version": "0.17.1",
   "uiHints": {
     "apiKey": {
       "label": "MemoryRelay API Key",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memoryrelay/plugin-memoryrelay-ai",
-  "version": "0.17.0",
+  "version": "0.17.1",
   "description": "OpenClaw memory plugin for MemoryRelay API - 42 tools, 17 commands, V2 async, sessions, decisions, patterns, projects & semantic search",
   "type": "module",
   "main": "index.ts",
@@ -52,6 +52,9 @@
     "src/",
     "skills/"
   ],
+  "bundledDependencies": [
+    "better-sqlite3"
+  ],
   "engines": {
     "node": ">=20.0.0"
   },

package/src/cache/local-cache.ts

@@ -1,4 +1,4 @@
-import Database from "better-sqlite3";
+import type BetterSqlite3 from "better-sqlite3";
 import { statSync } from "node:fs";
 import { migrateIfNeeded } from "./schema.js";
 import type {
@@ -62,21 +62,30 @@ function rowToBuffer(row: BufferRow): BufferEntry {
 }
 
 export class LocalCache {
-  private db: Database.Database;
+  private db: BetterSqlite3.Database;
   private readonly _dbPath: string;
   private readonly config: LocalCacheConfig;
 
   constructor(dbPath: string, config: LocalCacheConfig) {
+    let Database: typeof BetterSqlite3;
+    try {
+      Database = require("better-sqlite3");
+    } catch {
+      throw new Error(
+        "better-sqlite3 not available — run: cd ~/.openclaw/extensions/plugin-memoryrelay-ai && npm install --omit=dev",
+      );
+    }
+
     this._dbPath = dbPath;
     this.config = config;
-    this.db = this.initDb(dbPath);
+    this.db = this.initDb(dbPath, Database);
   }
 
   get dbPath(): string {
     return this._dbPath;
   }
 
-  private initDb(dbPath: string): Database.Database {
+  private initDb(dbPath: string, Database: typeof BetterSqlite3): BetterSqlite3.Database {
     const db = new Database(dbPath);
     db.pragma("journal_mode = WAL");
     db.pragma("foreign_keys = ON");

package/src/client/memoryrelay-client.ts

@@ -153,7 +153,7 @@ export class MemoryRelayClient implements IMemoryRelayClient {
           headers: {
             "Content-Type": "application/json",
             Authorization: `Bearer ${this.apiKey}`,
-            "User-Agent": "openclaw-memory-memoryrelay/0.17.0",
+            "User-Agent": "openclaw-memory-memoryrelay/0.17.1",
           },
           body: body ? JSON.stringify(body) : undefined,
         },