agenr 0.8.9 → 0.8.10

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## [0.8.10]
+
+### Added
+- feat(plugin): session-start recall now uses the inbound user message as the recall query seed, enabling vector similarity scoring instead of pure recency ranking; entries relevant to the actual conversation topic now surface at session start (issues #177, #178)
+- feat(plugin): before_reset hook captures the last 3 substantive user messages before a /new reset and stashes them in memory; the next session-start recall uses the stash as its query seed when the opening prompt is low-signal (issues #177, #178)
+- feat(plugin): session topic stash eviction sweep runs every 5 minutes; TTL is 1 hour
+
+### Changed
+- chore(plugin): session-start recall timeout increased from 5s to 10s to accommodate the embedding API call now required when a query is present
+- chore(plugin): session topic stash requires a minimum of 40 characters and 5 words to filter out low-signal conversational closers
+- refactor(plugin): session query helpers extracted from index.ts into session-query.ts
+
+### Fixed
+- fix(plugin): session-start recall no longer skips vector similarity scoring when a query is available; previously RecallQuery.text was always undefined at session start (issue #177)
+
 ## [0.8.9]
 
 ### Added

package/dist/openclaw-plugin/index.d.ts

@@ -23,6 +23,12 @@ type BeforePromptBuildResult = {
     systemPrompt?: string;
     prependContext?: string;
 };
+type BeforeResetEvent = {
+    sessionFile?: string;
+    messages?: unknown[];
+    reason?: string;
+    [key: string]: unknown;
+};
 type PluginLogger = {
     debug?: (message: string) => void;
     info?: (message: string) => void;
@@ -58,6 +64,7 @@ type PluginApi = {
     on: {
         (hook: "before_agent_start", handler: (event: BeforeAgentStartEvent, ctx: PluginHookAgentContext) => Promise<BeforeAgentStartResult | undefined> | BeforeAgentStartResult | undefined): void;
         (hook: "before_prompt_build", handler: (event: BeforePromptBuildEvent, ctx: PluginHookAgentContext) => Promise<BeforePromptBuildResult | undefined> | BeforePromptBuildResult | undefined): void;
+        (hook: "before_reset", handler: (event: BeforeResetEvent, ctx: PluginHookAgentContext) => Promise<void> | void): void;
     };
 };
 
@@ -67,5 +74,9 @@ declare const plugin: {
     description: string;
     register(api: PluginApi): void;
 };
+declare const __testing: {
+    SESSION_TOPIC_TTL_MS: number;
+    clearState(): void;
+};
 
-export { plugin as default };
+export { __testing, plugin as default };

package/dist/openclaw-plugin/index.js

@@ -13,7 +13,8 @@ import { Type } from "@sinclair/typebox";
 import { spawn } from "child_process";
 import path from "path";
 import { fileURLToPath } from "url";
-var RECALL_TIMEOUT_MS = 5e3;
+var RECALL_TIMEOUT_MS = 1e4;
+var RECALL_QUERY_MAX_CHARS = 500;
 var DEFAULT_BUDGET = 2e3;
 var MODULE_DIR = path.dirname(fileURLToPath(import.meta.url));
 var PACKAGE_ROOT = path.resolve(MODULE_DIR, "..", "..");
@@ -30,7 +31,7 @@ function buildSpawnArgs(agenrPath) {
   }
   return { cmd: agenrPath, args: [] };
 }
-async function runRecall(agenrPath, budget, project) {
+async function runRecall(agenrPath, budget, project, query) {
   return await new Promise((resolve) => {
     let stdout = "";
     let settled = false;
@@ -46,6 +47,11 @@ async function runRecall(agenrPath, budget, project) {
     if (project) {
       args.push("--project", project);
     }
+    const trimmedQuery = query?.trim() ?? "";
+    const truncatedQuery = trimmedQuery.length > RECALL_QUERY_MAX_CHARS ? trimmedQuery.slice(0, RECALL_QUERY_MAX_CHARS) : trimmedQuery;
+    if (truncatedQuery) {
+      args.push(truncatedQuery);
+    }
     const child = spawn(spawnArgs.cmd, [...spawnArgs.args, ...args], {
       stdio: ["ignore", "pipe", "ignore"]
     });
@@ -133,6 +139,127 @@ function formatRecallAsMarkdown(result) {
   return lines.join("\n").trimEnd();
 }
 
+// src/openclaw-plugin/session-query.ts
+var SESSION_TOPIC_TTL_MS = 60 * 60 * 1e3;
+var SESSION_TOPIC_MIN_LENGTH = 40;
+var SESSION_QUERY_LOOKBACK = 3;
+var sessionTopicStash = /* @__PURE__ */ new Map();
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+function extractTextFromUserMessage(message) {
+  if (!isRecord(message) || message["role"] !== "user") {
+    return "";
+  }
+  const content = message["content"];
+  if (typeof content === "string") {
+    return content.trim();
+  }
+  if (!Array.isArray(content)) {
+    return "";
+  }
+  const textParts = [];
+  for (const part of content) {
+    if (!isRecord(part) || part["type"] !== "text") {
+      continue;
+    }
+    const partText = part["text"];
+    if (typeof partText !== "string") {
+      continue;
+    }
+    const trimmed = partText.trim();
+    if (trimmed) {
+      textParts.push(trimmed);
+    }
+  }
+  return textParts.join(" ").trim();
+}
+function isThinPrompt(prompt) {
+  const trimmed = prompt.trim().toLowerCase();
+  return trimmed === "" || trimmed === "/new" || trimmed === "/reset";
+}
+function extractLastUserText(messages) {
+  try {
+    const collected = [];
+    for (let index = messages.length - 1; index >= 0; index -= 1) {
+      const extracted = extractTextFromUserMessage(messages[index]);
+      if (!extracted) {
+        continue;
+      }
+      collected.push(extracted);
+      if (collected.length >= SESSION_QUERY_LOOKBACK) {
+        break;
+      }
+    }
+    const joined = collected.reverse().join(" ").trim();
+    return joined || "";
+  } catch {
+    return "";
+  }
+}
+function shouldStashTopic(text) {
+  if (text.length < SESSION_TOPIC_MIN_LENGTH) {
+    return false;
+  }
+  const wordCount = text.split(/\s+/).filter(Boolean).length;
+  return wordCount >= 5;
+}
+function sweepExpiredStash() {
+  const now = Date.now();
+  for (const [key, entry] of sessionTopicStash) {
+    if (now - entry.storedAt > SESSION_TOPIC_TTL_MS) {
+      sessionTopicStash.delete(key);
+    }
+  }
+}
+var sweepInterval = setInterval(sweepExpiredStash, 5 * 60 * 1e3);
+if (sweepInterval !== void 0 && typeof sweepInterval.unref === "function") {
+  sweepInterval.unref();
+}
+function stripResetPrefix(prompt) {
+  const lower = prompt.toLowerCase();
+  for (const cmd of ["/new", "/reset"]) {
+    if (lower.startsWith(cmd + " ")) {
+      return prompt.slice(cmd.length).trim();
+    }
+  }
+  return prompt;
+}
+function resolveSessionQuery(prompt, sessionKey) {
+  let stashedText;
+  if (sessionKey) {
+    const entry = sessionTopicStash.get(sessionKey);
+    if (entry) {
+      sessionTopicStash.delete(sessionKey);
+      const expired = Date.now() - entry.storedAt > SESSION_TOPIC_TTL_MS;
+      if (!expired && entry.text.length > 0) {
+        stashedText = entry.text;
+      }
+    }
+  }
+  const normalized = (prompt ?? "").trim();
+  if (!isThinPrompt(normalized)) {
+    return stripResetPrefix(normalized);
+  }
+  return stashedText;
+}
+function stashSessionTopic(sessionKey, text) {
+  if (!shouldStashTopic(text)) {
+    return;
+  }
+  sessionTopicStash.set(sessionKey, {
+    text,
+    storedAt: Date.now()
+  });
+}
+function clearStash() {
+  sessionTopicStash.clear();
+  if (sweepInterval !== void 0) {
+    clearInterval(sweepInterval);
+    sweepInterval = void 0;
+  }
+}
+
 // src/db/signals.ts
 async function fetchNewSignalEntries(db, sinceSeq, minImportance, limit, maxAgeSec = 0) {
   const ageArgs = maxAgeSec > 0 ? [minImportance, sinceSeq, new Date(Date.now() - maxAgeSec * 1e3).toISOString(), limit] : [minImportance, sinceSeq, limit];
@@ -712,7 +839,7 @@ var plugin = {
   register(api) {
     api.on(
       "before_prompt_build",
-      async (_event, ctx) => {
+      async (event, ctx) => {
         try {
           const sessionKey = ctx.sessionKey ?? "";
           if (!sessionKey) {
@@ -735,7 +862,8 @@ var plugin = {
             const agenrPath = resolveAgenrPath(config);
             const budget = resolveBudget(config);
             const project = config?.project?.trim() || void 0;
-            const recallResult = await runRecall(agenrPath, budget, project);
+            const queryText = resolveSessionQuery(event.prompt, ctx.sessionKey);
+            const recallResult = await runRecall(agenrPath, budget, project, queryText);
             if (recallResult) {
               const formatted = formatRecallAsMarkdown(recallResult);
               if (formatted.trim()) {
@@ -774,6 +902,27 @@ var plugin = {
         }
       }
     );
+    api.on("before_reset", (event, ctx) => {
+      try {
+        const sessionKey = ctx.sessionKey;
+        if (!sessionKey) {
+          return;
+        }
+        const messages = event.messages;
+        if (!Array.isArray(messages) || messages.length === 0) {
+          return;
+        }
+        const lastUserText = extractLastUserText(messages);
+        if (!shouldStashTopic(lastUserText)) {
+          return;
+        }
+        stashSessionTopic(sessionKey, lastUserText);
+      } catch (err) {
+        api.logger.warn(
+          `agenr plugin before_reset stash failed: ${err instanceof Error ? err.message : String(err)}`
+        );
+      }
+    });
     if (api.registerTool) {
       const config = api.pluginConfig;
       if (config?.enabled === false) {
@@ -924,7 +1073,16 @@ var plugin = {
     }
   }
 };
+var __testing = {
+  SESSION_TOPIC_TTL_MS,
+  clearState() {
+    clearStash();
+    seenSessions.clear();
+    sessionSignalState.clear();
+  }
+};
 var openclaw_plugin_default = plugin;
 export {
+  __testing,
   openclaw_plugin_default as default
 };

package/package.json

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