openclaw-engram 2.0.7 → 2.0.11

package/dist/tools/memory-forget.js

@@ -1,24 +1,30 @@
 "use strict";
 /**
- * memory_forget — delete observations from engram by ID.
+ * memory_forget — suppress or permanently delete observations from engram by ID.
  *
- * Maps to engram's bulk_delete_observations endpoint.
+ * Default: suppress (reversible soft-hide from search results).
+ * With permanent=true: archive (permanent removal).
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createMemoryForgetTool = createMemoryForgetTool;
 const zod_1 = require("zod");
 const typebox_1 = require("@sinclair/typebox");
 const ForgetParamsSchema = zod_1.z.object({
-    id: zod_1.z.string().min(1),
+    id: zod_1.z.string().regex(/^[1-9]\d*$/, 'Must be a positive integer'),
+    permanent: zod_1.z.boolean().optional().default(false),
 });
 const forgetParameters = typebox_1.Type.Object({
-    id: typebox_1.Type.String({ description: 'Observation UUID to delete' }),
+    id: typebox_1.Type.String({ description: 'Observation ID (positive integer)' }),
+    permanent: typebox_1.Type.Optional(typebox_1.Type.Boolean({
+        description: 'If true, permanently archives the observation. Default: false (reversible suppress).',
+    })),
 });
 function createMemoryForgetTool(_ctx, client, _config) {
     return {
         name: 'memory_forget',
         label: 'Forget Memory',
-        description: 'Delete a specific observation from engram memory by its ID.',
+        description: 'Suppress an observation from future search results (reversible). ' +
+            'Use permanent=true to permanently archive it instead.',
         parameters: forgetParameters,
         async execute(_toolCallId, params) {
             const parsed = ForgetParamsSchema.safeParse(params);
@@ -28,13 +34,23 @@ function createMemoryForgetTool(_ctx, client, _config) {
             if (!client.isAvailable()) {
                 return 'engram is currently unreachable — memory forget unavailable';
             }
-            const response = await client.bulkDelete([parsed.data.id]);
-            if (!response) {
-                return 'engram delete failed — server returned no response';
+            const numericId = parseInt(parsed.data.id, 10);
+            if (!Number.isSafeInteger(numericId) || numericId <= 0) {
+                return `Invalid observation ID: ${parsed.data.id}`;
             }
-            return response.deleted > 0
-                ? `Deleted observation: ${parsed.data.id}`
-                : `Observation not found or already deleted: ${parsed.data.id}`;
+            if (parsed.data.permanent) {
+                const response = await client.bulkDelete([String(numericId)]);
+                if (!response) {
+                    return 'engram archive failed — server returned no response';
+                }
+                return response.deleted > 0
+                    ? `Permanently archived observation: ${parsed.data.id}`
+                    : `Observation not found or already archived: ${parsed.data.id}`;
+            }
+            const suppressed = await client.suppressObservation(numericId);
+            return suppressed
+                ? `Suppressed observation: ${parsed.data.id} (reversible — will no longer appear in search)`
+                : `Failed to suppress observation: ${parsed.data.id}`;
         },
     };
 }

package/dist/tools/memory-forget.js.map

@@ -1 +1 @@
-{"version":3,"file":"memory-forget.js","sourceRoot":"","sources":["../../src/tools/memory-forget.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAgBH,wDA+BC;AA7CD,6BAAwB;AACxB,+CAAyC;AAKzC,MAAM,kBAAkB,GAAG,OAAC,CAAC,MAAM,CAAC;IAClC,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACtB,CAAC,CAAC;AAEH,MAAM,gBAAgB,GAAG,cAAI,CAAC,MAAM,CAAC;IACnC,EAAE,EAAE,cAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,4BAA4B,EAAE,CAAC;CAC/D,CAAC,CAAC;AAEH,SAAgB,sBAAsB,CACpC,IAA+B,EAC/B,MAAwB,EACxB,OAAqB;IAErB,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE,6DAA6D;QAC1E,UAAU,EAAE,gBAAgB;QAE5B,KAAK,CAAC,OAAO,CAAC,WAAmB,EAAE,MAA+B;YAChE,MAAM,MAAM,GAAG,kBAAkB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YACpD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,OAAO,uBAAuB,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YACvD,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;gBAC1B,OAAO,6DAA6D,CAAC;YACvE,CAAC;YAED,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YAC3D,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,OAAO,oDAAoD,CAAC;YAC9D,CAAC;YAED,OAAO,QAAQ,CAAC,OAAO,GAAG,CAAC;gBACzB,CAAC,CAAC,wBAAwB,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE;gBAC1C,CAAC,CAAC,6CAA6C,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QACpE,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"memory-forget.js","sourceRoot":"","sources":["../../src/tools/memory-forget.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAsBH,wDA4CC;AAhED,6BAAwB;AACxB,+CAAyC;AAKzC,MAAM,kBAAkB,GAAG,OAAC,CAAC,MAAM,CAAC;IAClC,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,YAAY,EAAE,4BAA4B,CAAC;IAChE,SAAS,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CACjD,CAAC,CAAC;AAEH,MAAM,gBAAgB,GAAG,cAAI,CAAC,MAAM,CAAC;IACnC,EAAE,EAAE,cAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,mCAAmC,EAAE,CAAC;IACrE,SAAS,EAAE,cAAI,CAAC,QAAQ,CACtB,cAAI,CAAC,OAAO,CAAC;QACX,WAAW,EAAE,sFAAsF;KACpG,CAAC,CACH;CACF,CAAC,CAAC;AAEH,SAAgB,sBAAsB,CACpC,IAA+B,EAC/B,MAAwB,EACxB,OAAqB;IAErB,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,eAAe;QACtB,WAAW,EACT,mEAAmE;YACnE,uDAAuD;QACzD,UAAU,EAAE,gBAAgB;QAE5B,KAAK,CAAC,OAAO,CAAC,WAAmB,EAAE,MAA+B;YAChE,MAAM,MAAM,GAAG,kBAAkB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YACpD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,OAAO,uBAAuB,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YACvD,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;gBAC1B,OAAO,6DAA6D,CAAC;YACvE,CAAC;YAED,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;YAC/C,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;gBACvD,OAAO,2BAA2B,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YACrD,CAAC;YAED,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;gBAC1B,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;gBAC9D,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACd,OAAO,qDAAqD,CAAC;gBAC/D,CAAC;gBACD,OAAO,QAAQ,CAAC,OAAO,GAAG,CAAC;oBACzB,CAAC,CAAC,qCAAqC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE;oBACvD,CAAC,CAAC,8CAA8C,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YACrE,CAAC;YAED,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC;YAC/D,OAAO,UAAU;gBACf,CAAC,CAAC,2BAA2B,MAAM,CAAC,IAAI,CAAC,EAAE,iDAAiD;gBAC5F,CAAC,CAAC,mCAAmC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QAC1D,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-engram",
-  "version": "2.0.7",
+  "version": "2.0.11",
   "description": "OpenClaw plugin that connects to engram persistent memory server",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",