@troykelly/openclaw-projects 0.0.59 → 0.0.60

package/dist/register-openclaw.d.ts

@@ -82,6 +82,9 @@ export declare const schemas: {
     memoryForget: JSONSchema;
     memoryList: JSONSchema;
     memoryUpdate: JSONSchema;
+    memoryDigest: JSONSchema;
+    memoryReap: JSONSchema;
+    memoryPromote: JSONSchema;
     projectList: JSONSchema;
     projectGet: JSONSchema;
     projectCreate: JSONSchema;

package/dist/register-openclaw.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"register-openclaw.d.ts","sourceRoot":"","sources":["../src/register-openclaw.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAY,MAAM,KAAK,CAAC;AAClC,OAAO,EAAE,KAAK,SAAS,EAAmB,MAAM,iBAAiB,CAAC;AAClE,OAAO,EAAE,KAAK,YAAY,EAA2G,MAAM,aAAa,CAAC;AAQzJ,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAyExD,OAAO,KAAK,EACV,eAAe,EAEf,UAAU,EAcV,iBAAiB,EAGjB,UAAU,EACX,MAAM,yBAAyB,CAAC;AAajC,8CAA8C;AAC9C,UAAU,WAAW;IACnB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,SAAS,CAAC;IACrB,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC;IAChB,uGAAuG;IACvG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4GAA4G;IAC5G,iBAAiB,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACzD,oEAAoE;IACpE,eAAe,EAAE,OAAO,CAAC;IACzB,mEAAmE;IACnE,sBAAsB,EAAE,MAAM,CAAC;IAC/B,2DAA2D;IAC3D,eAAe,EAAE,OAAO,CAAC;IACzB,gEAAgE;IAChE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sFAAsF;IACtF,mBAAmB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAClC;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;;iBAUhC,CAAC;AAEH;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,eAAe,CA6CrE;AA4pDD;;;;GAIG;AACH,wBAAsB,sBAAsB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA6C9E;AA+7ED;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,iBAmsD9B,CAAC;AAEF,yDAAyD;AACzD,eAAe,gBAAgB,CAAC;AAEhC,2CAA2C;AAC3C,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0CnB,CAAC"}
+{"version":3,"file":"register-openclaw.d.ts","sourceRoot":"","sources":["../src/register-openclaw.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAY,MAAM,KAAK,CAAC;AAClC,OAAO,EAAE,KAAK,SAAS,EAAmB,MAAM,iBAAiB,CAAC;AAClE,OAAO,EAAE,KAAK,YAAY,EAA2G,MAAM,aAAa,CAAC;AAQzJ,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAkFxD,OAAO,KAAK,EACV,eAAe,EAEf,UAAU,EAcV,iBAAiB,EAGjB,UAAU,EACX,MAAM,yBAAyB,CAAC;AAcjC,8CAA8C;AAC9C,UAAU,WAAW;IACnB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,SAAS,CAAC;IACrB,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC;IAChB,uGAAuG;IACvG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4GAA4G;IAC5G,iBAAiB,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACzD,oEAAoE;IACpE,eAAe,EAAE,OAAO,CAAC;IACzB,mEAAmE;IACnE,sBAAsB,EAAE,MAAM,CAAC;IAC/B,2DAA2D;IAC3D,eAAe,EAAE,OAAO,CAAC;IACzB,gEAAgE;IAChE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sFAAsF;IACtF,mBAAmB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAClC;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;;iBAUhC,CAAC;AAEH;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,eAAe,CA6CrE;AA2qDD;;;;GAIG;AACH,wBAAsB,sBAAsB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA6C9E;AAk/ED;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,iBA8tD9B,CAAC;AAEF,yDAAyD;AACzD,eAAe,gBAAgB,CAAC;AAEhC,2CAA2C;AAC3C,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8CnB,CAAC"}

package/dist/register-openclaw.js

@@ -32,13 +32,18 @@ createNotebookListTool, createNotebookCreateTool, createNotebookGetTool, createN
 // Tool guide meta-tool (Issue #1923)
 createToolGuideTool, 
 // Dev prompt tools (Epic #2011, Issue #2015)
-createDevPromptListTool, createDevPromptGetTool, createDevPromptCreateTool, createDevPromptUpdateTool, createDevPromptResetTool, } from './tools/index.js';
+createDevPromptListTool, createDevPromptGetTool, createDevPromptCreateTool, createDevPromptUpdateTool, createDevPromptResetTool, 
+// Memory lifecycle tools (Epic #2426, Issues #2430, #2431)
+createMemoryDigestTool, MemoryDigestParamsSchema, createMemoryReapTool, MemoryReapParamsSchema, createMemoryPromoteTool, MemoryPromoteParamsSchema, 
+// Credential check for gateway memory_store handler (Issue #2438)
+mayContainCredentials, } from './tools/index.js';
 import { zodToJsonSchema } from './utils/zod-to-json-schema.js';
 import { autoLinkInboundMessage } from './utils/auto-linker.js';
 import { blendScores, computeGeoScore, haversineDistanceKm } from './utils/geo.js';
 import { createBoundaryMarkers, detectInjectionPatternsAsync, sanitizeMessageForContext, sanitizeMetadataField, wrapExternalMessage, } from './utils/injection-protection.js';
 import { injectionLogLimiter } from './utils/injection-log-rate-limiter.js';
 import { reverseGeocode } from './utils/nominatim.js';
+import { resolveTtl } from './utils/temporal.js';
 /**
  * Zod schema enforcing the gateway contract: every content block
  * must have type "text" and a non-empty text string (#2230).
@@ -294,8 +299,23 @@ const memoryStoreSchema = {
             },
             required: ['lat', 'lng'],
         },
+        // Ephemeral TTL shorthand (Issue #2434): relative duration e.g. "24h", "7d", "2w", "1m".
+        // Mutually exclusive with expires_at. Auto-adds "ephemeral" tag.
+        ttl: {
+            type: 'string',
+            description: 'Relative TTL for ephemeral memories (e.g. "24h", "7d", "2w", "1m"). Mutually exclusive with expires_at. Auto-adds "ephemeral" tag.',
+        },
+        // Absolute expiry timestamp (ISO 8601 with timezone).
+        expires_at: {
+            type: 'string',
+            description: 'Absolute expiry timestamp (ISO 8601 with timezone, e.g. "2026-04-01T00:00:00Z"). Mutually exclusive with ttl.',
+        },
+        // Credential bypass opt-in (Issue #2438).
+        allow_sensitive: {
+            type: 'boolean',
+            description: 'When true, bypasses credential/secret detection and stores the content as-is. Use only when deliberately storing sensitive reference material.',
+        },
     },
-    required: ['text'],
 };
 /**
  * Memory forget tool JSON Schema
@@ -1887,10 +1907,51 @@ function createToolHandlers(state) {
         },
         async memory_store(params) {
             // Accept 'text' (OpenClaw native) or 'content' (backwards compat)
-            const { text, content: contentAlias, category = 'other', importance = 0.7, tags, relationship_id, location, pinned, } = params;
+            const { text, content: contentAlias, category = 'other', importance = 0.7, tags, relationship_id, location, pinned, ttl, expires_at, allow_sensitive, } = params;
             const memoryText = text || contentAlias;
             if (!memoryText) {
-                return { success: false, error: 'text is required' };
+                return { success: false, error: 'text or content is required' };
+            }
+            // Credential blocking (Issue #2438): block by default, opt-in via allow_sensitive
+            if (!allow_sensitive && mayContainCredentials(memoryText)) {
+                logger.warn('memory_store blocked: possible credential detected', {
+                    user_id: state.agentId,
+                    namespace: getStoreNamespace(params),
+                });
+                return {
+                    success: false,
+                    error: 'Content appears to contain credentials or secrets (API keys, passwords, tokens). ' +
+                        'Use allow_sensitive=true to explicitly store sensitive content.',
+                };
+            }
+            if (allow_sensitive) {
+                logger.info('memory_store: allow_sensitive=true — storing without credential check', {
+                    user_id: state.agentId,
+                    namespace: getStoreNamespace(params),
+                });
+            }
+            // Validate TTL/expires_at mutual exclusivity (Issue #2434)
+            if (ttl && expires_at) {
+                return { success: false, error: 'ttl and expires_at are mutually exclusive' };
+            }
+            // Resolve TTL to expires_at (Issue #2434)
+            let resolvedExpiresAt;
+            const resolvedTags = tags ? [...tags] : [];
+            if (ttl) {
+                const ttlDate = resolveTtl(ttl);
+                if (!ttlDate) {
+                    return {
+                        success: false,
+                        error: `Invalid ttl "${ttl}". Use a positive relative duration like "24h", "7d", "2w", or "1m" (max 365d).`,
+                    };
+                }
+                resolvedExpiresAt = ttlDate.toISOString();
+                if (!resolvedTags.includes('ephemeral')) {
+                    resolvedTags.push('ephemeral');
+                }
+            }
+            else if (expires_at) {
+                resolvedExpiresAt = expires_at;
             }
             try {
                 // Map to backend's /api/memories/unified which expects 'content'
@@ -1901,8 +1962,10 @@ function createToolHandlers(state) {
                     importance,
                     namespace: getStoreNamespace(params), // Issue #1428
                 };
-                if (tags && tags.length > 0)
-                    payload.tags = tags;
+                if (resolvedTags.length > 0)
+                    payload.tags = resolvedTags;
+                if (resolvedExpiresAt)
+                    payload.expires_at = resolvedExpiresAt;
                 if (relationship_id)
                     payload.relationship_id = relationship_id;
                 if (pinned !== undefined)
@@ -4356,6 +4419,28 @@ export const registerOpenClaw = (api) => {
             },
         },
     ];
+    // ── Memory lifecycle tools (Epic #2426, Issues #2430 #2431) ────────────────
+    // memory_digest, memory_reap, memory_promote — use factory pattern with
+    // dynamic user_id and namespace getters (Issue #2437).
+    {
+        const memLifecycleToolOpts = Object.defineProperties({ client: apiClient, logger, config, user_id: '', namespace: '' }, {
+            user_id: { get: () => state.agentId, enumerable: true },
+            namespace: { get: () => state.resolvedNamespace.default, enumerable: true },
+        });
+        for (const factory of [createMemoryDigestTool, createMemoryReapTool, createMemoryPromoteTool]) {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any -- factory functions have heterogeneous option types
+            const tool = factory(memLifecycleToolOpts);
+            tools.push({
+                name: tool.name,
+                description: tool.description,
+                parameters: zodToJsonSchema(tool.parameters),
+                execute: async (_toolCallId, params, _signal, _onUpdate) => {
+                    const result = await tool.execute(params);
+                    return toAgentToolResult(result);
+                },
+            });
+        }
+    }
     // ── Terminal tools (Issue #1858) ──────────────────────────────
     // Register all 20 terminal plugin tools using factory pattern.
     // Use getter for user_id so terminal tools always read the current
@@ -5310,6 +5395,10 @@ export const schemas = {
     memoryForget: withNamespaces(memoryForgetSchema),
     memoryList: withNamespaces(memoryListSchema),
     memoryUpdate: withNamespace(memoryUpdateSchema),
+    // Memory lifecycle schemas (Epic #2426 — Issues #2430, #2431)
+    memoryDigest: zodToJsonSchema(MemoryDigestParamsSchema),
+    memoryReap: zodToJsonSchema(MemoryReapParamsSchema),
+    memoryPromote: zodToJsonSchema(MemoryPromoteParamsSchema),
     projectList: withNamespaces(projectListSchema),
     projectGet: withNamespaces(projectGetSchema),
     projectCreate: withNamespace(projectCreateSchema),