@memorilabs/openclaw-memori 0.0.12 → 0.0.14

package/dist/index.js

@@ -1,7 +1,7 @@
 import { handleAugmentation } from './handlers/augmentation.js';
 import { PLUGIN_CONFIG } from './constants.js';
 import { MemoriLogger, loadSkillsContent } from './utils/index.js';
-import { registerAllTools } from './tools/index.js';
+import { registerUtilityTools, registerAuthenticatedTools } from './tools/index.js';
 import { registerCliCommands } from './cli/commands.js';
 const memoriPlugin = {
     id: PLUGIN_CONFIG.ID,
@@ -15,19 +15,20 @@ const memoriPlugin = {
             entityId: rawConfig?.entityId,
             projectId: rawConfig?.projectId,
         };
+        const logger = new MemoriLogger(api);
+        const skillsContent = loadSkillsContent(api.resolvePath.bind(api));
+        registerUtilityTools({ api, config, logger });
         if (!config.apiKey || !config.entityId) {
             api.logger.warn(`${PLUGIN_CONFIG.LOG_PREFIX} Missing apiKey or entityId in config. Plugin disabled.`);
             return;
         }
-        const logger = new MemoriLogger(api);
-        const skillsContent = loadSkillsContent(api.resolvePath.bind(api));
         logger.info(`\n=== ${PLUGIN_CONFIG.LOG_PREFIX} INITIALIZING PLUGIN ===`);
         logger.info(`${PLUGIN_CONFIG.LOG_PREFIX} Tracking Entity ID: ${config.entityId}`);
         if (skillsContent) {
             api.on('before_prompt_build', () => ({ appendSystemContext: skillsContent }));
         }
         api.on('agent_end', (event, ctx) => handleAugmentation(event, ctx, config, logger));
-        registerAllTools({ api, config, logger });
+        registerAuthenticatedTools({ api, config, logger });
     },
 };
 export default memoriPlugin;

package/dist/tools/index.d.ts

@@ -1,3 +1,4 @@
 import type { ToolDeps } from './types.js';
-export declare function registerAllTools(deps: ToolDeps): void;
+export declare function registerUtilityTools(deps: ToolDeps): void;
+export declare function registerAuthenticatedTools(deps: ToolDeps): void;
 export type { ToolDeps };

package/dist/tools/index.js

@@ -3,10 +3,12 @@ import { createMemoriQuotaTool } from './memori-quota.js';
 import { createMemoriRecallTool } from './memori-recall.js';
 import { createMemoriRecallSummaryTool } from './memori-recall-summary.js';
 import { createMemoriFeedbackTool } from './memori-feedback.js';
-export function registerAllTools(deps) {
+export function registerUtilityTools(deps) {
     deps.api.registerTool(createMemoriSignupTool(deps));
-    deps.api.registerTool(createMemoriQuotaTool(deps));
+}
+export function registerAuthenticatedTools(deps) {
     deps.api.registerTool(createMemoriRecallTool(deps));
     deps.api.registerTool(createMemoriRecallSummaryTool(deps));
     deps.api.registerTool(createMemoriFeedbackTool(deps));
+    deps.api.registerTool(createMemoriQuotaTool(deps));
 }

package/dist/tools/memori-recall.js

@@ -26,7 +26,7 @@ export function createMemoriRecallTool(deps) {
                 },
                 signal: {
                     type: 'string',
-                    description: 'Filter to a specific fact signal. MUST be one of the allowed enum values.',
+                    description: 'Filter by how the memory was derived. MUST be set together with `source` using one of the allowed (source, signal) pairs — never set independently. Valid pairs: (constraint, discovery), (decision, commit), (fact, verification), (execution, failure), (instruction, discovery), (insight, inference), (status, update), (strategy, pattern), (task, result).',
                     enum: [
                         'commit',
                         'discovery',
@@ -40,7 +40,7 @@ export function createMemoriRecallTool(deps) {
                 },
                 source: {
                     type: 'string',
-                    description: 'Filter to a specific source origin. MUST be one of the allowed enum values.',
+                    description: 'Filter by memory type. MUST be set together with `signal` using one of the allowed (source, signal) pairs — never set independently. Valid pairs: (constraint, discovery), (decision, commit), (fact, verification), (execution, failure), (instruction, discovery), (insight, inference), (status, update), (strategy, pattern), (task, result).',
                     enum: [
                         'constraint',
                         'decision',
@@ -68,6 +68,40 @@ export function createMemoriRecallTool(deps) {
                         details: null,
                     };
                 }
+                const hasSource = finalParams.source != null;
+                const hasSignal = finalParams.signal != null;
+                if (hasSource !== hasSignal) {
+                    const errorResult = {
+                        error: 'source and signal must be provided together or both omitted',
+                    };
+                    logger.warn(`memori_recall rejected: ${JSON.stringify(errorResult)}`);
+                    return {
+                        content: [{ type: 'text', text: JSON.stringify(errorResult) }],
+                        details: null,
+                    };
+                }
+                const VALID_PAIRS = {
+                    constraint: 'discovery',
+                    decision: 'commit',
+                    fact: 'verification',
+                    execution: 'failure',
+                    instruction: 'discovery',
+                    insight: 'inference',
+                    status: 'update',
+                    strategy: 'pattern',
+                    task: 'result',
+                };
+                const source = finalParams.source;
+                if (hasSource && source != null && VALID_PAIRS[source] !== finalParams.signal) {
+                    const errorResult = {
+                        error: `Invalid (source, signal) pair: (${source}, ${finalParams.signal}). Expected signal for source "${source}" is "${VALID_PAIRS[source]}".`,
+                    };
+                    logger.warn(`memori_recall rejected: ${JSON.stringify(errorResult)}`);
+                    return {
+                        content: [{ type: 'text', text: JSON.stringify(errorResult) }],
+                        details: null,
+                    };
+                }
                 logger.info(`memori_recall params: ${JSON.stringify(finalParams)}`);
                 const client = createRecallClient(config.apiKey, config.entityId);
                 const result = await client.agentRecall(finalParams);

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.0.12";
+export declare const SDK_VERSION = "0.0.14";

package/dist/version.js

@@ -1 +1 @@
-export const SDK_VERSION = '0.0.12';
+export const SDK_VERSION = '0.0.14';

package/openclaw.plugin.json

@@ -1,12 +1,18 @@
 {
   "id": "openclaw-memori",
   "name": "Memori System",
-  "version": "0.0.10",
+  "version": "0.0.13",
   "description": "Hosted memory backend",
   "kind": "memory",
   "main": "dist/index.js",
   "contracts": {
-    "tools": ["memori_recall", "memori_recall_summary", "memori_feedback"]
+    "tools": [
+      "memori_recall",
+      "memori_recall_summary",
+      "memori_feedback",
+      "memori_signup",
+      "memori_quota"
+    ]
   },
   "uiHints": {
     "apiKey": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memorilabs/openclaw-memori",
-  "version": "0.0.12",
+  "version": "0.0.14",
   "description": "Official MemoriLabs.ai long-term memory plugin for OpenClaw",
   "type": "module",
   "main": "./dist/index.js",

package/skills/memori/SKILL.md

@@ -57,36 +57,29 @@ Prefer targeted recall over broad queries.
 - `projectId` → project or workspace context
 - `sessionId` → specific session
 - `dateStart` / `dateEnd` → time-bounded recall
-- `source` → type of memory
-- `signal` → how the memory was derived
+- `source` → type of memory (must be paired with `signal` from the allowed combinations below)
+- `signal` → how the memory was derived (must be paired with `source` from the allowed combinations below)
 
 > Note: If a `sessionId` is provided, a `projectId` must also be provided.
 > All timestamps are stored in **UTC**.
 
-### Memory filters
-
-- `source`:
-  - constraint
-  - decision
-  - execution
-  - fact
-  - insight
-  - instruction
-  - status
-  - strategy
-  - task
-
-- `signal`:
-  - commit
-  - discovery
-  - failure
-  - inference
-  - pattern
-  - result
-  - update
-  - verification
-
-Use `source` and `signal` to prioritize high-signal memory when possible.
+### Allowed source + signal combinations
+
+`source` and `signal` are not independent. They must be set together (or both omitted). Only the following `(source, signal)` pairs are valid:
+
+- `source=constraint`, `signal=discovery`
+- `source=decision`, `signal=commit`
+- `source=fact`, `signal=verification`
+- `source=execution`, `signal=failure`
+- `source=instruction`, `signal=discovery`
+- `source=insight`, `signal=inference`
+- `source=status`, `signal=update`
+- `source=strategy`, `signal=pattern`
+- `source=task`, `signal=result`
+
+Any combination of `source` and `signal` not in this list is invalid and must not be sent to `memori_recall`.
+
+Use one of the allowed `(source, signal)` pairs to prioritize high-signal memory when possible; never set `source` or `signal` independently.
 
 ### Default behavior (recall)
 
@@ -97,7 +90,7 @@ Use `source` and `signal` to prioritize high-signal memory when possible.
 
 - Start narrow (entity + project)
 - Add time bounds only when needed
-- Use `source` and `signal` to refine results
+- Use an allowed `(source, signal)` pair to refine results (never set them independently)
 - Expand scope only if needed
 - Do not recall on every turn