@remnic/plugin-openclaw 1.0.5 → 1.0.7

package/dist/resolution-YITUVUTH.js

@@ -0,0 +1,100 @@
+import {
+  readPair,
+  resolvePair
+} from "./chunk-DIZW6H5J.js";
+import {
+  log
+} from "./chunk-UFU5GGGA.js";
+import "./chunk-MLKGABMK.js";
+
+// ../remnic-core/src/contradiction/resolution.ts
+var VALID_VERBS = ["keep-a", "keep-b", "merge", "both-valid", "needs-more-context"];
+function isValidResolutionVerb(value) {
+  return VALID_VERBS.includes(value);
+}
+async function executeResolution(memoryDir, storage, pairId, verb) {
+  const pair = readPair(memoryDir, pairId);
+  if (!pair) {
+    return { pairId, verb, affectedIds: [], message: `Pair ${pairId} not found` };
+  }
+  if (pair.resolution) {
+    return { pairId, verb, affectedIds: [], message: `Pair already resolved with verb "${pair.resolution}"` };
+  }
+  const [idA, idB] = pair.memoryIds;
+  const affectedIds = [];
+  let message = "";
+  let supersedeFailed = false;
+  switch (verb) {
+    case "keep-a": {
+      const ok = await supersedeSafe(storage, idB, idA, "contradiction-resolution:keep-a");
+      if (ok) {
+        affectedIds.push(idB);
+        message = `Kept ${idA}, superseded ${idB}`;
+      } else {
+        supersedeFailed = true;
+        message = `Supersede failed for ${idB}; not resolving`;
+      }
+      break;
+    }
+    case "keep-b": {
+      const ok = await supersedeSafe(storage, idA, idB, "contradiction-resolution:keep-b");
+      if (ok) {
+        affectedIds.push(idA);
+        message = `Kept ${idB}, superseded ${idA}`;
+      } else {
+        supersedeFailed = true;
+        message = `Supersede failed for ${idA}; not resolving`;
+      }
+      break;
+    }
+    case "merge": {
+      const mergedId = `merged-${pairId}`;
+      const okA = await supersedeSafe(storage, idA, mergedId, "contradiction-resolution:merge");
+      const okB = await supersedeSafe(storage, idB, mergedId, "contradiction-resolution:merge");
+      if (okA) affectedIds.push(idA);
+      if (okB) affectedIds.push(idB);
+      if (!okA || !okB) {
+        supersedeFailed = true;
+        message = `Merge incomplete: ${affectedIds.length}/2 superseded; not resolving to allow retry`;
+      } else {
+        message = `Both memories superseded by merged ${mergedId}`;
+      }
+      break;
+    }
+    case "both-valid": {
+      message = "Pair marked as both-valid; cooldown applied";
+      break;
+    }
+    case "needs-more-context": {
+      message = "Deferred; no action taken, short cooldown applied";
+      break;
+    }
+  }
+  if (!supersedeFailed) {
+    resolvePair(memoryDir, pairId, verb);
+  }
+  log.info("[contradiction-resolution] pair=%s verb=%s affected=%d", pairId, verb, affectedIds.length);
+  return { pairId, verb, affectedIds, message };
+}
+async function supersedeSafe(storage, oldId, newId, reason) {
+  try {
+    const result = await storage.supersedeMemory(oldId, newId, reason);
+    if (result === false) {
+      log.warn("[contradiction-resolution] supersede returned false for %s \u2192 %s", oldId, newId);
+      return false;
+    }
+    return true;
+  } catch (err) {
+    log.warn(
+      "[contradiction-resolution] supersede failed %s \u2192 %s: %s",
+      oldId,
+      newId,
+      err instanceof Error ? err.message : err
+    );
+    return false;
+  }
+}
+export {
+  executeResolution,
+  isValidResolutionVerb
+};

package/dist/{storage-HW6SRQCK.js → storage-BA6OBLMK.js}

@@ -8,7 +8,7 @@ import {
   normalizeEntityName,
   parseEntityFile,
   serializeEntityFile
-} from "./chunk-5VTGFKKU.js";
+} from "./chunk-KPMXWORS.js";
 import "./chunk-UFU5GGGA.js";
 import "./chunk-MLKGABMK.js";
 export {

package/openclaw.plugin.json

@@ -318,6 +318,63 @@
           }
         }
       },
+      "procedural": {
+        "type": "object",
+        "additionalProperties": false,
+        "default": {},
+        "properties": {
+          "enabled": {
+            "type": "boolean",
+            "default": false,
+            "description": "Master gate for procedural memory: extraction, recall boost, and mining (issue #519)."
+          },
+          "minOccurrences": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 1000,
+            "default": 3,
+            "description": "Minimum clustered trajectory occurrences before emitting a candidate procedure (0 disables mining)."
+          },
+          "successFloor": {
+            "type": "number",
+            "minimum": 0,
+            "maximum": 1,
+            "default": 0.7,
+            "description": "Minimum success-rate floor (from trajectory outcomes) for miner promotion."
+          },
+          "autoPromoteOccurrences": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 10000,
+            "default": 8,
+            "description": "When auto-promotion is enabled, minimum occurrence count to move pending_review procedures to active (0 disables auto-promotion by count)."
+          },
+          "autoPromoteEnabled": {
+            "type": "boolean",
+            "default": false,
+            "description": "When true, miner may auto-promote trusted procedures to active after autoPromoteOccurrences."
+          },
+          "lookbackDays": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 3650,
+            "default": 30,
+            "description": "Trajectory lookback window for procedural mining."
+          },
+          "recallMaxProcedures": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 10,
+            "default": 3,
+            "description": "Maximum procedure memories to inject on task-initiation recall."
+          },
+          "proceduralMiningCronAutoRegister": {
+            "type": "boolean",
+            "default": false,
+            "description": "When true, installer may register the nightly procedural mining cron job."
+          }
+        }
+      },
       "slotBehavior": {
         "type": "object",
         "additionalProperties": false,
@@ -1295,7 +1352,8 @@
             "principle",
             "commitment",
             "moment",
-            "skill"
+            "skill",
+            "procedure"
           ]
         },
         "default": [
@@ -1860,6 +1918,18 @@
         "default": true,
         "description": "Automatically supersede contradicted memories"
       },
+      "contradictionScan": {
+        "type": "object",
+        "description": "Configuration for the nightly contradiction-scan cron (issue #520)",
+        "properties": {
+          "enabled": { "type": "boolean", "default": false, "description": "Enable the nightly contradiction scan cron (disabled by default per rule 48)" },
+          "similarityFloor": { "type": "number", "default": 0.82, "minimum": 0, "maximum": 1, "description": "Embedding cosine similarity floor for candidate pair generation" },
+          "topicOverlapFloor": { "type": "number", "default": 0.4, "minimum": 0, "maximum": 1, "description": "Minimum topic-token Jaccard overlap for unstructured pairs" },
+          "maxPairsPerRun": { "type": "integer", "default": 500, "minimum": 1, "description": "Cap on candidate pairs evaluated per cron run" },
+          "cooldownDays": { "type": "integer", "default": 14, "minimum": 0, "description": "Cooldown in days. 0 = always re-evaluate." },
+          "autoMergeDuplicates": { "type": "boolean", "default": false, "description": "Auto-flag pairs judged duplicates for dedup (still requires user approval)" }
+        }
+      },
       "temporalSupersessionEnabled": {
         "type": "boolean",
         "default": true,
@@ -1870,6 +1940,38 @@
         "default": false,
         "description": "If true, include temporally-superseded facts in recall results (for audit/history). Default: exclude."
       },
+      "recallDirectAnswerEnabled": {
+        "type": "boolean",
+        "default": true,
+        "description": "When true, recall runs the direct-answer tier in observation mode: annotates LastRecallSnapshot.tierExplain with which tier would have served the query (issue #518). Does not short-circuit the QMD path in the current release."
+      },
+      "recallDirectAnswerTokenOverlapFloor": {
+        "type": "number",
+        "minimum": 0,
+        "maximum": 1,
+        "default": 0.55,
+        "description": "Minimum query↔memory token-overlap ratio for direct-answer eligibility. Set to 0 to disable the gate."
+      },
+      "recallDirectAnswerImportanceFloor": {
+        "type": "number",
+        "minimum": 0,
+        "maximum": 1,
+        "default": 0.7,
+        "description": "Minimum calibrated importance score for direct-answer eligibility. Set to 0 to disable the gate."
+      },
+      "recallDirectAnswerAmbiguityMargin": {
+        "type": "number",
+        "minimum": 0,
+        "maximum": 1,
+        "default": 0.15,
+        "description": "If the second-best candidate scores within this ratio of the top, direct-answer defers to hybrid."
+      },
+      "recallDirectAnswerEligibleTaxonomyBuckets": {
+        "type": "array",
+        "items": { "type": "string" },
+        "default": ["decisions", "principles", "conventions", "runbooks", "entities"],
+        "description": "Taxonomy category IDs eligible for direct-answer routing."
+      },
       "memoryLinkingEnabled": {
         "type": "boolean",
         "default": false,
@@ -2285,6 +2387,11 @@
         "default": 15000,
         "description": "Timeout for fast-tier local LLM requests (ms). Lower than primary since fast ops should complete quickly."
       },
+      "localLlmDisableThinking": {
+        "type": "boolean",
+        "default": true,
+        "description": "When true (default), request chain-of-thought / thinking-mode suppression on the main local LLM (issue #548). The `chat_template_kwargs: { enable_thinking: false }` field is only injected when the detected backend is known to support it (LM Studio, vLLM); strict OpenAI-compat backends fail open to avoid the 400-cooldown path. Structured-output tasks like extraction and consolidation gain nothing from reasoning tokens and thinking-capable models (Qwen 3.5, Gemma 4, DeepSeek) often blow the 60s timeout before emitting content. Set to false to restore thinking for narrative tasks. The fast-tier client always disables thinking and is not affected by this flag."
+      },
       "hourlySummaryCronAutoRegister": {
         "type": "boolean",
         "default": false,
@@ -2556,7 +2663,8 @@
         },
         "default": [
           "correction",
-          "commitment"
+          "commitment",
+          "procedure"
         ],
         "description": "Memory categories excluded from semantic consolidation."
       },
@@ -2969,7 +3077,8 @@
           "commitment",
           "preference",
           "decision",
-          "principle"
+          "principle",
+          "procedure"
         ],
         "description": "Categories that protect a fact from archival regardless of other criteria."
       },
@@ -3007,7 +3116,8 @@
           "decision",
           "principle",
           "commitment",
-          "preference"
+          "preference",
+          "procedure"
         ],
         "description": "Categories that lifecycle policy will not auto-archive."
       },
@@ -3585,6 +3695,7 @@
       },
       "briefing": {
         "type": "object",
+        "additionalProperties": false,
         "default": {
           "enabled": true,
           "defaultWindow": "yesterday",
@@ -3595,6 +3706,52 @@
           "saveDir": null,
           "llmFollowups": true
         },
+        "properties": {
+          "enabled": {
+            "type": "boolean",
+            "default": true
+          },
+          "defaultWindow": {
+            "type": "string",
+            "default": "yesterday"
+          },
+          "defaultFormat": {
+            "type": "string",
+            "enum": [
+              "markdown",
+              "json"
+            ],
+            "default": "markdown"
+          },
+          "maxFollowups": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 10,
+            "default": 5
+          },
+          "calendarSource": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "default": null
+          },
+          "saveByDefault": {
+            "type": "boolean",
+            "default": false
+          },
+          "saveDir": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "default": null
+          },
+          "llmFollowups": {
+            "type": "boolean",
+            "default": true
+          }
+        },
         "description": "Daily Context Briefing (#370). Knobs: enabled, defaultWindow ('yesterday', '3d', '1w', '24h', ...), defaultFormat (markdown|json), maxFollowups (0-10), calendarSource (path to ICS/JSON file, null = off), saveByDefault, saveDir (null = $REMNIC_HOME/briefings/), llmFollowups (disable to skip Responses API calls)."
       },
       "enrichmentEnabled": {
@@ -3897,6 +4054,10 @@
       "label": "Auto-Resolve Contradictions",
       "help": "Automatically supersede old memories when contradiction is confirmed"
     },
+    "contradictionScan": {
+      "label": "Contradiction Scan",
+      "help": "Nightly cron that pairs similar memories and flags contradictions for review (issue #520)"
+    },
     "temporalSupersessionEnabled": {
       "label": "Temporal Supersession",
       "help": "Mark older facts superseded when a newer fact writes a conflicting value for the same entityRef + structured attribute (issue #375)"
@@ -3906,6 +4067,30 @@
       "advanced": true,
       "help": "If enabled, superseded facts still surface in recall (audit/history mode)."
     },
+    "recallDirectAnswerEnabled": {
+      "label": "Direct-Answer Retrieval Tier",
+      "help": "Route validated high-trust queries to a fast direct-answer path before QMD (issue #518)."
+    },
+    "recallDirectAnswerTokenOverlapFloor": {
+      "label": "Direct-Answer Token Overlap Floor",
+      "advanced": true,
+      "placeholder": "0.55"
+    },
+    "recallDirectAnswerImportanceFloor": {
+      "label": "Direct-Answer Importance Floor",
+      "advanced": true,
+      "placeholder": "0.7"
+    },
+    "recallDirectAnswerAmbiguityMargin": {
+      "label": "Direct-Answer Ambiguity Margin",
+      "advanced": true,
+      "placeholder": "0.15"
+    },
+    "recallDirectAnswerEligibleTaxonomyBuckets": {
+      "label": "Direct-Answer Eligible Taxonomy Buckets",
+      "advanced": true,
+      "help": "Taxonomy category IDs eligible for direct-answer routing."
+    },
     "memoryLinkingEnabled": {
       "label": "Memory Linking",
       "help": "Build knowledge graph by linking related memories"
@@ -4107,6 +4292,11 @@
       "advanced": true,
       "help": "Timeout for fast-tier requests. Lower than primary since fast ops should complete quickly."
     },
+    "localLlmDisableThinking": {
+      "label": "Disable Local LLM Thinking Mode",
+      "advanced": true,
+      "help": "Suppress chain-of-thought reasoning on the main local LLM. Default on — extraction / consolidation are structured-output tasks where thinking is pure latency tax and a common cause of 60s timeouts on Qwen 3.5 / Gemma 4 / DeepSeek. The suppression field (chat_template_kwargs) is only sent when the backend is known to support it (LM Studio, vLLM); strict OpenAI-compat backends fail open. Turn off if you want thinking on narrative tasks. Fast-tier client always disables thinking regardless."
+    },
     "evalHarnessEnabled": {
       "label": "Evaluation Harness",
       "help": "Enable Engram's benchmark/evaluation harness foundation and benchmark-status diagnostics."

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remnic/plugin-openclaw",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "OpenClaw adapter for Remnic memory — thin wrapper delegating to @remnic/core",
   "type": "module",
   "main": "dist/index.js",
@@ -24,7 +24,8 @@
     ]
   },
   "dependencies": {
-    "openai": "^6.0.0"
+    "openai": "^6.0.0",
+    "@remnic/core": "^1.1.0"
   },
   "peerDependencies": {
     "openclaw": ">=2026.4.8"