@contextableai/openclaw-memory-rebac 0.3.5 → 0.3.6

package/README.md

@@ -163,6 +163,25 @@ When enabled (default: `true`), the plugin captures the last N messages from eac
 - Skips messages shorter than 5 characters and injected context blocks
 - Uses custom extraction instructions for entity/fact extraction
 
+### Session Filtering
+
+Both auto-recall and auto-capture can be filtered by session key pattern using the `sessionFilter` config option. This is useful for excluding cron jobs, monitoring sessions, or other automated processes that generate repetitive, low-value data.
+
+```json
+{
+  "sessionFilter": {
+    "excludePatterns": ["cron", "monitoring", "healthcheck"]
+  }
+}
+```
+
+- **`excludePatterns`**: Array of strings. If the session key contains any of these substrings, auto-recall and auto-capture are skipped for that session.
+- **`includePatterns`**: Array of strings. If set, only sessions whose key contains at least one of these substrings will trigger auto-recall/capture.
+- If both are set, `excludePatterns` takes priority (exclude first, then check include).
+- If neither is set, all sessions are captured (default behavior).
+
+Filtered sessions still have full access to explicit memory tools (`memory_recall`, `memory_store`, `memory_forget`, `memory_status`). This means a cron job that consolidates memories can still use `memory_recall` and `memory_store` directly — only the automatic hooks are suppressed.
+
 ## Authorization Model
 
 The SpiceDB schema defines four object types:
@@ -270,6 +289,8 @@ Agents without an `identities` entry (like service agents) are not linked to any
 | `identities` | object | `{}` | Maps agent IDs to owner person IDs for cross-agent recall (see [Identity Linking](#identity-linking)) |
 | `autoCapture` | boolean | `true` | Auto-capture conversations |
 | `autoRecall` | boolean | `true` | Auto-inject relevant memories |
+| `sessionFilter.excludePatterns` | string[] | `[]` | Skip auto-capture/recall for sessions matching any pattern |
+| `sessionFilter.includePatterns` | string[] | `[]` | Only auto-capture/recall sessions matching at least one pattern |
 | `customInstructions` | string | *(see below)* | Custom extraction instructions |
 | `maxCaptureMessages` | integer | `10` | Max messages per auto-capture batch (1-50) |
 
@@ -389,7 +410,10 @@ OpenClaw has an exclusive `memory` slot — only one memory plugin is active at
             "my-agent": "U0123ABC"
           },
           "autoCapture": true,
-          "autoRecall": true
+          "autoRecall": true,
+          "sessionFilter": {
+            "excludePatterns": ["cron"]
+          }
         }
       }
     }

package/dist/config.d.ts

@@ -21,6 +21,10 @@ export type RebacMemoryConfig = {
     autoCapture: boolean;
     autoRecall: boolean;
     maxCaptureMessages: number;
+    sessionFilter?: {
+        excludePatterns?: string[];
+        includePatterns?: string[];
+    };
 };
 export declare const rebacMemoryConfigSchema: {
     parse(value: unknown): RebacMemoryConfig;

package/dist/config.js

@@ -25,6 +25,21 @@ function assertAllowedKeys(value, allowed, label) {
         throw new Error(`${label} has unknown keys: ${unknown.join(", ")}`);
     }
 }
+function parseSessionFilter(raw) {
+    if (!raw || typeof raw !== "object" || Array.isArray(raw))
+        return undefined;
+    const obj = raw;
+    assertAllowedKeys(obj, ["excludePatterns", "includePatterns"], "sessionFilter config");
+    const excludePatterns = Array.isArray(obj.excludePatterns)
+        ? obj.excludePatterns.filter((p) => typeof p === "string")
+        : undefined;
+    const includePatterns = Array.isArray(obj.includePatterns)
+        ? obj.includePatterns.filter((p) => typeof p === "string")
+        : undefined;
+    if (!excludePatterns?.length && !includePatterns?.length)
+        return undefined;
+    return { excludePatterns, includePatterns };
+}
 // ============================================================================
 // Config schema
 // ============================================================================
@@ -42,7 +57,7 @@ export const rebacMemoryConfigSchema = {
         assertAllowedKeys(cfg, [
             "backend", "spicedb",
             "subjectType", "subjectId", "identities",
-            "autoCapture", "autoRecall", "maxCaptureMessages",
+            "autoCapture", "autoRecall", "maxCaptureMessages", "sessionFilter",
             backendName,
         ], "openclaw-memory-rebac config");
         // SpiceDB config (shared)
@@ -84,6 +99,7 @@ export const rebacMemoryConfigSchema = {
             maxCaptureMessages: typeof cfg.maxCaptureMessages === "number" && cfg.maxCaptureMessages > 0
                 ? cfg.maxCaptureMessages
                 : pluginDefaults.maxCaptureMessages,
+            sessionFilter: parseSessionFilter(cfg.sessionFilter),
         };
     },
 };

package/dist/index.js

@@ -34,6 +34,26 @@ function sessionGroupId(sessionId) {
 function isSessionGroup(groupId) {
     return groupId.startsWith("session-");
 }
+function isSessionAllowed(sessionKey, filter) {
+    if (!filter)
+        return true;
+    if (!sessionKey)
+        return true;
+    if (filter.excludePatterns?.length) {
+        for (const pattern of filter.excludePatterns) {
+            if (sessionKey.includes(pattern))
+                return false;
+        }
+    }
+    if (filter.includePatterns?.length) {
+        for (const pattern of filter.includePatterns) {
+            if (sessionKey.includes(pattern))
+                return true;
+        }
+        return false;
+    }
+    return true;
+}
 // ============================================================================
 // Plugin Definition
 // ============================================================================
@@ -460,6 +480,8 @@ const rebacMemoryPlugin = {
                 const state = getState(ctx?.agentId);
                 if (ctx?.sessionKey)
                     state.sessionId = ctx.sessionKey;
+                if (!isSessionAllowed(ctx?.sessionKey, cfg.sessionFilter))
+                    return;
                 if (!event.prompt || event.prompt.length < 5)
                     return;
                 try {
@@ -509,6 +531,8 @@ const rebacMemoryPlugin = {
                 const state = getState(ctx?.agentId);
                 if (ctx?.sessionKey)
                     state.sessionId = ctx.sessionKey;
+                if (!isSessionAllowed(ctx?.sessionKey, cfg.sessionFilter))
+                    return;
                 if (!event.success || !event.messages || event.messages.length === 0)
                     return;
                 try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contextableai/openclaw-memory-rebac",
-  "version": "0.3.5",
+  "version": "0.3.6",
   "description": "OpenClaw two-layer memory plugin: SpiceDB ReBAC authorization + Graphiti knowledge graph",
   "type": "module",
   "license": "MIT",