@memoryrelay/plugin-memoryrelay-ai 0.15.5 → 0.15.7

package/README.md

@@ -5,7 +5,7 @@
 Persistent memory, architectural decisions, reusable patterns, and project orchestration for AI agents.
 
 [![npm version](https://img.shields.io/npm/v/@memoryrelay/plugin-memoryrelay-ai.svg)](https://www.npmjs.com/package/@memoryrelay/plugin-memoryrelay-ai)
-[![OpenClaw Compatible](https://img.shields.io/badge/OpenClaw-2026.2.26+-blue.svg)](https://openclaw.ai)
+[![OpenClaw Compatible](https://img.shields.io/badge/OpenClaw-2026.2.0+-blue.svg)](https://openclaw.ai)
 
 ## Why MemoryRelay?
 
@@ -23,7 +23,7 @@ MemoryRelay is designed for engineering teams managing complex, long-running pro
 | Auto-capture with privacy tiers | Yes (off/conservative/smart/aggressive) | Basic | No |
 | V2 Async Storage | Yes | No | No |
 | Direct commands | 17 | ~5 | 0 |
-| Lifecycle hooks | 13 | 0 | 0 |
+| Lifecycle hooks | 14 | 0 | 0 |
 | Tools | 42 | ~10 | 0 |
 
 ## Quick Start
@@ -382,7 +382,6 @@ Then inspect with `/memory-logs` or `/memory-metrics` to identify slow or failin
 ### Known Limitations
 
 - `memory_batch_store`: May return 500 errors on large batches (use individual `memory_store` as workaround)
-- `memory_context`: Returns 405 Method Not Allowed on some API versions (use `memory_recall` instead)
 
 ## Development
 

package/index.ts

@@ -1,6 +1,6 @@
 /**
  * OpenClaw Memory Plugin - MemoryRelay
- * Version: 0.15.5
+ * Version: 0.15.6
  *
  * Long-term memory with vector search using MemoryRelay API.
  * Provides auto-recall and auto-capture via lifecycle hooks.
@@ -711,7 +711,7 @@ class MemoryRelayClient {
           headers: {
             "Content-Type": "application/json",
             Authorization: `Bearer ${this.apiKey}`,
-            "User-Agent": "openclaw-memory-memoryrelay/0.15.5",
+            "User-Agent": "openclaw-memory-memoryrelay/0.15.6",
           },
           body: body ? JSON.stringify(body) : undefined,
         },
@@ -883,9 +883,10 @@ class MemoryRelayClient {
   }
 
   async list(limit: number = 20, offset: number = 0): Promise<Memory[]> {
+    const cappedLimit = Math.min(limit, 100);
     const response = await this.request<{ data: Memory[] }>(
       "GET",
-      `/v1/memories?limit=${limit}&offset=${offset}&agent_id=${encodeURIComponent(this.agentId)}`,
+      `/v1/memories?limit=${cappedLimit}&offset=${offset}&agent_id=${encodeURIComponent(this.agentId)}`,
     );
     return response.data || [];
   }
@@ -1624,7 +1625,7 @@ export default async function plugin(api: OpenClawPluginApi): Promise<void> {
   // Helper to check if a tool is enabled (by group)
   // ========================================================================
 
-  // Tool group mapping — matches MCP server's TOOL_GROUPS
+  // Plugin tool group mapping
   const TOOL_GROUPS: Record<string, string[]> = {
     memory: [
       "memory_store", "memory_recall", "memory_forget", "memory_list",
@@ -1700,7 +1701,7 @@ export default async function plugin(api: OpenClawPluginApi): Promise<void> {
             },
             dedup_threshold: {
               type: "number",
-              description: "Similarity threshold for deduplication (0-1). Default 0.9.",
+              description: "Similarity threshold for deduplication (0-1). Default 0.95.",
             },
             project: {
               type: "string",
@@ -2996,6 +2997,11 @@ export default async function plugin(api: OpenClawPluginApi): Promise<void> {
               description: "Tags for the new decision.",
               items: { type: "string" },
             },
+            metadata: {
+              type: "object",
+              description: "Optional key-value metadata to attach to the new decision.",
+              additionalProperties: { type: "string" },
+            },
           },
           required: ["id", "title", "rationale"],
         },
@@ -3007,6 +3013,7 @@ export default async function plugin(api: OpenClawPluginApi): Promise<void> {
             rationale: string;
             alternatives?: string;
             tags?: string[];
+            metadata?: Record<string, string>;
           },
         ) => {
           try {
@@ -3016,6 +3023,7 @@ export default async function plugin(api: OpenClawPluginApi): Promise<void> {
               args.rationale,
               args.alternatives,
               args.tags,
+              args.metadata,
             );
             return {
               content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
@@ -3842,6 +3850,10 @@ export default async function plugin(api: OpenClawPluginApi): Promise<void> {
             description: "Memory tier: hot, warm, or cold.",
             enum: ["hot", "warm", "cold"],
           },
+          webhook_url: {
+            type: "string",
+            description: "Optional webhook URL to notify when async storage completes.",
+          },
         },
         required: ["content"],
       },
@@ -3853,13 +3865,14 @@ export default async function plugin(api: OpenClawPluginApi): Promise<void> {
           project?: string;
           importance?: number;
           tier?: string;
+          webhook_url?: string;
         },
       ) => {
         try {
-          const { content, metadata, importance, tier } = args;
+          const { content, metadata, importance, tier, webhook_url } = args;
           let project = args.project;
           if (!project && defaultProject) project = defaultProject;
-          const result = await client.storeAsync(content, metadata, project, importance, tier);
+          const result = await client.storeAsync(content, metadata, project, importance, tier, webhook_url);
           return {
             content: [
               {
@@ -3961,6 +3974,14 @@ export default async function plugin(api: OpenClawPluginApi): Promise<void> {
             description: "Memory IDs to exclude from results.",
             items: { type: "string" },
           },
+          llm_api_url: {
+            type: "string",
+            description: "Optional custom LLM API URL for AI summarization.",
+          },
+          llm_model: {
+            type: "string",
+            description: "Optional LLM model name for AI summarization.",
+          },
         },
         required: ["query"],
       },
@@ -3973,6 +3994,8 @@ export default async function plugin(api: OpenClawPluginApi): Promise<void> {
           ai_enhanced?: boolean;
           search_mode?: "semantic" | "hybrid" | "keyword";
           exclude_memory_ids?: string[];
+          llm_api_url?: string;
+          llm_model?: string;
         },
       ) => {
         try {
@@ -3982,6 +4005,8 @@ export default async function plugin(api: OpenClawPluginApi): Promise<void> {
             aiEnhanced: args.ai_enhanced,
             searchMode: args.search_mode,
             excludeMemoryIds: args.exclude_memory_ids,
+            llmApiUrl: args.llm_api_url,
+            llmModel: args.llm_model,
           });
           return {
             content: [
@@ -4508,7 +4533,7 @@ export default async function plugin(api: OpenClawPluginApi): Promise<void> {
   });
 
   api.logger.info?.(
-    `memory-memoryrelay: plugin v0.15.5 loaded (${Object.values(TOOL_GROUPS).flat().length} tools, autoRecall: ${cfg?.autoRecall}, autoCapture: ${autoCaptureConfig.enabled ? autoCaptureConfig.tier : 'off'}, debug: ${debugEnabled})`,
+    `memory-memoryrelay: plugin v0.15.6 loaded (${Object.values(TOOL_GROUPS).flat().length} tools, autoRecall: ${cfg?.autoRecall}, autoCapture: ${autoCaptureConfig.enabled ? autoCaptureConfig.tier : 'off'}, debug: ${debugEnabled})`,
   );
 
   // ========================================================================
@@ -5604,7 +5629,7 @@ export default async function plugin(api: OpenClawPluginApi): Promise<void> {
     description: "Show how to update the MemoryRelay plugin to the latest version",
     requireAuth: true,
     handler: async (_ctx) => {
-      const currentVersion = "0.15.5";
+      const currentVersion = "0.15.6";
       const lines: string[] = [
         "MemoryRelay Plugin Update",
         "━".repeat(50),

package/openclaw.plugin.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memoryrelay/plugin-memoryrelay-ai",
-  "version": "0.15.5",
+  "version": "0.15.7",
   "description": "OpenClaw memory plugin for MemoryRelay API - 42 tools, 17 commands, V2 async, sessions, decisions, patterns, projects & semantic search",
   "type": "module",
   "main": "index.ts",

package/skills/decision-tracking/SKILL.md

@@ -13,7 +13,7 @@ Decisions are **choices with rationale and alternatives considered**. Plain fact
 |------|-----------|---------|
 | `decision_record` | `decision_record(title, rationale, alternatives?, project?, tags?, status?)` | Record a new decision with reasoning |
 | `decision_list` | `decision_list(project?, status?, tags?, limit?)` | List decisions, optionally filtered |
-| `decision_supersede` | `decision_supersede(old_id, new_title, new_rationale, tags?)` | Replace an outdated decision |
+| `decision_supersede` | `decision_supersede(id, new_title, new_rationale, tags?)` | Replace an outdated decision |
 | `decision_check` | `decision_check(query, project?, limit?, threshold?)` | Semantic search for conflicting decisions |
 
 ## Workflow

package/skills/entity-and-context/SKILL.md

@@ -15,7 +15,7 @@ Entities turn flat memory storage into a connected knowledge graph. Create entit
 | `entity_link` | `entity_link(entity_id, memory_id, relationship?)` | Connect an entity to a memory |
 | `entity_list` | `entity_list(limit?, offset?)` | List entities with pagination |
 | `entity_graph` | `entity_graph(entity_id, depth?, max_neighbors?)` | Explore an entity's neighborhood |
-| `memory_context` | `memory_context(query, token_budget?)` | Enriched recall with entity connections (see `memory-workflow` skill) |
+| `memory_context` | `memory_context(query, max_tokens?)` | Enriched recall with entity connections (see `memory-workflow` skill) |
 
 ## Entity Types
 

package/skills/memory-workflow/SKILL.md

@@ -40,7 +40,7 @@ Call `session_end(session_id, summary)` with a meaningful summary. This becomes
 
 ## Deduplication
 
-Always pass `deduplicate=true` on `memory_store` and `memory_batch_store`. The default threshold is 0.9 similarity. Skipping this clutters search results with near-duplicates.
+Always pass `deduplicate=true` on `memory_store` and `memory_batch_store`. The default threshold is 0.95 similarity. Skipping this clutters search results with near-duplicates.
 
 ## Metadata Best Practices