@memorilabs/openclaw-memori 0.0.13 → 0.0.14

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.13";
+export declare const SDK_VERSION = "0.0.14";

package/dist/version.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memorilabs/openclaw-memori",
-  "version": "0.0.13",
+  "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