agenr 0.9.18 → 0.9.19

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.9.19 (2026-02-28)
+
+### Features
+- OpenClaw plugin: store nudging - injects a system nudge when the
+  agent has not called agenr_store in 8+ turns (configurable via
+  storeNudge plugin config). Nudges are spaced by the threshold
+  interval, capped at 3 per session. (#290)
+
 ## 0.9.18 (2026-02-28)
 
 ### Features

package/dist/openclaw-plugin/index.js

@@ -659,7 +659,9 @@ function getMidSessionState(key) {
       recentMessages: new RecentMessagesBuffer(),
       lastRecallQuery: null,
       recalledIds: /* @__PURE__ */ new Set(),
-      turnCount: 0
+      turnCount: 0,
+      lastStoreTurn: 0,
+      nudgeCount: 0
     };
   }
   const existing = midSessionStates.get(normalizedKey);
@@ -670,11 +672,20 @@ function getMidSessionState(key) {
     recentMessages: new RecentMessagesBuffer(),
     lastRecallQuery: null,
     recalledIds: /* @__PURE__ */ new Set(),
-    turnCount: 0
+    turnCount: 0,
+    lastStoreTurn: 0,
+    nudgeCount: 0
   };
   midSessionStates.set(normalizedKey, nextState);
   return nextState;
 }
+function markStoreCall(key) {
+  if (typeof key !== "string" || key.trim().length === 0) {
+    return;
+  }
+  const state = getMidSessionState(key);
+  state.lastStoreTurn = state.turnCount;
+}
 function clearMidSessionStates() {
   midSessionStates.clear();
 }
@@ -1630,7 +1641,10 @@ var MAX_RECALLED_SESSIONS = 200;
 var DEFAULT_MID_SESSION_NORMAL_LIMIT = 5;
 var DEFAULT_MID_SESSION_COMPLEX_LIMIT = 8;
 var DEFAULT_MID_SESSION_QUERY_SIMILARITY_THRESHOLD = 0.85;
+var DEFAULT_STORE_NUDGE_THRESHOLD = 8;
+var DEFAULT_STORE_NUDGE_MAX_PER_SESSION = 3;
 var sessionRecalledEntries = /* @__PURE__ */ new Map();
+var sessionRef = { current: "" };
 function isDebugEnabled(config) {
   return process.env.AGENR_DEBUG === "1" || config?.debug === true;
 }
@@ -1711,6 +1725,19 @@ function resolveMidSessionSimilarityThreshold(raw) {
   }
   return raw;
 }
+function resolveStoreNudgeConfig(config) {
+  return {
+    enabled: config?.storeNudge?.enabled !== false,
+    threshold: resolveMidSessionLimit(
+      config?.storeNudge?.threshold,
+      DEFAULT_STORE_NUDGE_THRESHOLD
+    ),
+    maxPerSession: resolveMidSessionLimit(
+      config?.storeNudge?.maxPerSession,
+      DEFAULT_STORE_NUDGE_MAX_PER_SESSION
+    )
+  };
+}
 function getRecallEntryId(item) {
   if (typeof item !== "object" || item === null) {
     return null;
@@ -2499,6 +2526,7 @@ var testingApi = {
     clearMidSessionStates();
     handoffSeenSessionIds.clear();
     sessionRecalledEntries.clear();
+    sessionRef.current = "";
   },
   readSessionsJson,
   readAndParseSessionJsonl,
@@ -2530,6 +2558,7 @@ var plugin = {
       "before_prompt_build",
       async (event, ctx) => {
         try {
+          sessionRef.current = "";
           const sessionKey = ctx.sessionKey ?? "";
           if (!sessionKey) {
             return;
@@ -2541,12 +2570,18 @@ var plugin = {
             return;
           }
           const dedupeKey = ctx.sessionId ?? sessionKey;
+          sessionRef.current = dedupeKey || sessionKey;
           const agenrPath = resolveAgenrPath(config);
           const budget = resolveBudget(config);
           const project = config?.project?.trim() || void 0;
           let markdown;
           let midSessionMarkdown;
           const isFirstInSession = dedupeKey ? !hasSeenSession(dedupeKey) : true;
+          const stateKey = dedupeKey || sessionKey;
+          const state = isFirstInSession ? void 0 : getMidSessionState(stateKey);
+          if (state) {
+            state.turnCount += 1;
+          }
           if (isFirstInSession) {
             debugLog(debug, "session-start", `sessionKey=${sessionKey} dedupeKey=${dedupeKey} isFirst=true`);
             if (dedupeKey) {
@@ -2702,10 +2737,7 @@ ${formatted.trim()}`);
           } else {
             debugLog(debug, "prompt-build", `sessionKey=${sessionKey} isFirst=false`);
           }
-          if (!isFirstInSession && config?.midSessionRecall?.enabled !== false) {
-            const stateKey = dedupeKey || sessionKey;
-            const state = getMidSessionState(stateKey);
-            state.turnCount += 1;
+          if (state && config?.midSessionRecall?.enabled !== false) {
             const rawPrompt = typeof event.prompt === "string" ? stripPromptMetadata(event.prompt) : "";
             const userMessage = rawPrompt.trim();
             if (userMessage) {
@@ -2783,23 +2815,46 @@ ${formatted.trim()}`);
             const db = await ensurePluginDb(config);
             const candidateSignal = await checkSignals(db, sessionKey, signalConfig);
             debugLog(debug, "signals", `check result=${candidateSignal ? "found" : "none"}`);
-            const state = sessionSignalState.get(sessionKey) ?? { lastSignalAt: 0, signalCount: 0 };
-            const isCooldown = signalConfig.cooldownMs > 0 && Date.now() - state.lastSignalAt < signalConfig.cooldownMs;
-            const isMaxReached = signalConfig.maxPerSession > 0 && state.signalCount >= signalConfig.maxPerSession;
+            const state2 = sessionSignalState.get(sessionKey) ?? { lastSignalAt: 0, signalCount: 0 };
+            const isCooldown = signalConfig.cooldownMs > 0 && Date.now() - state2.lastSignalAt < signalConfig.cooldownMs;
+            const isMaxReached = signalConfig.maxPerSession > 0 && state2.signalCount >= signalConfig.maxPerSession;
             if (candidateSignal && !isCooldown && !isMaxReached) {
               sessionSignalState.set(sessionKey, {
                 lastSignalAt: Date.now(),
-                signalCount: state.signalCount + 1
+                signalCount: state2.signalCount + 1
               });
               signal = candidateSignal;
             }
             debugLog(debug, "signals", `cooldown=${isCooldown} maxReached=${isMaxReached} injected=${!!signal}`);
           }
-          const prependContext = [markdown, midSessionMarkdown, signal].filter(Boolean).join("\n\n");
+          let storeNudge;
+          if (!isFirstInSession && state) {
+            const nudgeConfig = resolveStoreNudgeConfig(config);
+            if (nudgeConfig.enabled) {
+              const gap = state.turnCount - state.lastStoreTurn;
+              debugLog(
+                debug,
+                "store-nudge",
+                `check gap=${gap} threshold=${nudgeConfig.threshold} nudgeCount=${state.nudgeCount} maxPerSession=${nudgeConfig.maxPerSession}`
+              );
+              if (gap >= nudgeConfig.threshold && state.nudgeCount < nudgeConfig.maxPerSession) {
+                storeNudge = "[MEMORY CHECK] You have not stored any knowledge recently. Review the conversation for decisions, preferences, lessons, or facts worth remembering.";
+                state.nudgeCount += 1;
+                state.lastStoreTurn = state.turnCount;
+                debugLog(debug, "store-nudge", `injecting nudge #${state.nudgeCount}`);
+              } else {
+                const reason = gap < nudgeConfig.threshold ? "gap_below_threshold" : "max_reached";
+                debugLog(debug, "store-nudge", `skipped reason=${reason}`);
+              }
+            } else {
+              debugLog(debug, "store-nudge", "skipped reason=disabled");
+            }
+          }
+          const prependContext = [markdown, midSessionMarkdown, signal, storeNudge].filter(Boolean).join("\n\n");
           debugLog(
             debug,
             "prompt-build",
-            `prependContext total chars=${prependContext.length} (recall=${markdown?.length ?? 0} midSession=${midSessionMarkdown?.length ?? 0} signal=${signal?.length ?? 0})`
+            `prependContext total chars=${prependContext.length} (recall=${markdown?.length ?? 0} midSession=${midSessionMarkdown?.length ?? 0} signal=${signal?.length ?? 0} nudge=${storeNudge?.length ?? 0})`
           );
           if (!prependContext) {
             return;
@@ -2914,6 +2969,10 @@ ${formatted.trim()}`);
             if (resetKey) {
               clearMidSessionState(resetKey);
             }
+            const resetSessionId = event.context?.sessionEntry?.sessionId?.trim() ?? "";
+            if (resetSessionId && resetSessionId !== resetKey) {
+              clearMidSessionState(resetSessionId);
+            }
           }
           const sessionKey = event.sessionKey;
           if (!sessionKey) {
@@ -3069,6 +3128,11 @@ ${formatted.trim()}`);
             if (runtimeConfig?.enabled === false) {
               return makeDisabledToolResult();
             }
+            const key = sessionRef.current;
+            if (key) {
+              markStoreCall(key);
+              debugLog(debug, "store-nudge", `store detected session=${key}`);
+            }
             const agenrPath = resolveAgenrPath(runtimeConfig);
             const defaultProject = runtimeConfig?.project?.trim() || void 0;
             const toolConfig = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agenr",
-  "version": "0.9.18",
+  "version": "0.9.19",
   "openclaw": {
     "extensions": [
       "dist/openclaw-plugin/index.js"