agenr 0.8.19 → 0.8.21

package/dist/openclaw-plugin/index.js

@@ -7,8 +7,6 @@ import {
 } from "../chunk-L7VVZDWF.js";
 
 // src/openclaw-plugin/index.ts
-import os from "os";
-import path3 from "path";
 import { Type } from "@sinclair/typebox";
 
 // src/openclaw-plugin/recall.ts
@@ -33,7 +31,7 @@ function buildSpawnArgs(agenrPath) {
   }
   return { cmd: agenrPath, args: [] };
 }
-async function runRecall(agenrPath, budget, project, query) {
+async function runRecall(agenrPath, budget, project, query, options) {
   return await new Promise((resolve) => {
     let stdout = "";
     let settled = false;
@@ -45,14 +43,17 @@ async function runRecall(agenrPath, budget, project, query) {
       settled = true;
       resolve(value);
     }
-    const args = ["recall", "--context", "session-start", "--budget", String(budget), "--json"];
+    const isBrowse = options?.context === "browse";
+    const args = isBrowse ? ["recall", "--browse", "--since", options?.since ?? "1d", "--json"] : ["recall", "--context", "session-start", "--budget", String(budget), "--json"];
     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);
+    if (!isBrowse) {
+      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"]
@@ -148,6 +149,8 @@ var SESSION_TOPIC_TTL_MS = 60 * 60 * 1e3;
 var SESSION_TOPIC_MIN_LENGTH = 40;
 var ARCHIVED_SESSION_MAX_AGE_MS = 24 * 60 * 60 * 1e3;
 var SESSION_QUERY_LOOKBACK = 3;
+var EXCHANGE_TEXT_MAX_CHARS = 200;
+var EXCHANGE_USER_TURN_LIMIT = 5;
 var sessionTopicStash = /* @__PURE__ */ new Map();
 function isRecord(value) {
   return typeof value === "object" && value !== null;
@@ -179,9 +182,40 @@ function extractTextFromUserMessage(message) {
   }
   return textParts.join(" ").trim();
 }
+function extractTextFromAssistantMessage(message) {
+  if (!isRecord(message) || message["role"] !== "assistant") {
+    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 truncateMessageText(text) {
+  return text.length > EXCHANGE_TEXT_MAX_CHARS ? text.slice(0, EXCHANGE_TEXT_MAX_CHARS) : text;
+}
+var OPENCLAW_BARE_RESET_PREFIX = "a new session was started via /new";
 function isThinPrompt(prompt) {
   const trimmed = prompt.trim().toLowerCase();
-  return trimmed === "" || trimmed === "/new" || trimmed === "/reset";
+  return trimmed === "" || trimmed === "/new" || trimmed === "/reset" || trimmed.startsWith(OPENCLAW_BARE_RESET_PREFIX);
 }
 function stripPromptMetadata(raw) {
   if (!raw) {
@@ -221,56 +255,41 @@ function extractLastUserText(messages) {
     return "";
   }
 }
-async function readLatestArchivedUserMessages(sessionsDir, maxAgeMs = ARCHIVED_SESSION_MAX_AGE_MS) {
+function extractLastExchangeText(messages, maxTurns = EXCHANGE_USER_TURN_LIMIT) {
   try {
-    const now = Date.now();
-    const archivedFiles = [];
-    const entries = await readdir(sessionsDir, { withFileTypes: true });
-    for (const entry of entries) {
-      if (!entry.isFile() || !entry.name.includes(".reset.")) {
-        continue;
-      }
-      const filePath = path2.join(sessionsDir, entry.name);
-      const fileStats = await stat(filePath);
-      if (now - fileStats.mtimeMs > maxAgeMs) {
-        continue;
-      }
-      archivedFiles.push({ filePath, mtimeMs: fileStats.mtimeMs });
+    if (!Array.isArray(messages) || messages.length === 0) {
+      return "";
     }
-    if (archivedFiles.length === 0) {
-      return [];
+    if (maxTurns <= 0) {
+      return "";
     }
-    archivedFiles.sort((a, b) => b.mtimeMs - a.mtimeMs);
-    for (const candidate of archivedFiles) {
-      const raw = await readFile(candidate.filePath, "utf8");
-      const userMessages = [];
-      for (const line of raw.split(/\r?\n/)) {
-        const trimmed = line.trim();
-        if (!trimmed) {
-          continue;
-        }
-        let parsed;
-        try {
-          parsed = JSON.parse(trimmed);
-        } catch {
-          continue;
-        }
-        if (!isRecord(parsed) || parsed["type"] !== "message") {
-          continue;
-        }
-        const text = extractTextFromUserMessage(parsed["message"]);
-        if (!text) {
-          continue;
+    const collected = [];
+    let collectedUserTurns = 0;
+    for (let index = messages.length - 1; index >= 0; index -= 1) {
+      const message = messages[index];
+      const userText = extractTextFromUserMessage(message);
+      if (userText) {
+        collected.push({ role: "user", text: truncateMessageText(userText) });
+        collectedUserTurns += 1;
+        if (collectedUserTurns >= maxTurns) {
+          break;
         }
-        userMessages.push(text);
+        continue;
       }
-      if (userMessages.length > 0) {
-        return userMessages.slice(-SESSION_QUERY_LOOKBACK);
+      const assistantText = extractTextFromAssistantMessage(message);
+      if (assistantText) {
+        collected.push({
+          role: "assistant",
+          text: truncateMessageText(assistantText)
+        });
       }
     }
-    return [];
+    if (collected.length === 0) {
+      return "";
+    }
+    return collected.reverse().map((turn) => `${turn.role === "user" ? "U" : "A"}: ${turn.text}`).join(" | ");
   } catch {
-    return [];
+    return "";
   }
 }
 function shouldStashTopic(text) {
@@ -923,6 +942,7 @@ var plugin = {
   name: "agenr memory context",
   description: "Injects agenr long-term memory into every agent session via before_prompt_build",
   register(api) {
+    const config = api.pluginConfig;
     api.on(
       "before_prompt_build",
       async (event, ctx) => {
@@ -934,7 +954,6 @@ var plugin = {
           if (shouldSkipSession(sessionKey)) {
             return;
           }
-          const config = api.pluginConfig;
           if (config?.enabled === false) {
             return;
           }
@@ -950,33 +969,48 @@ var plugin = {
             const project = config?.project?.trim() || void 0;
             const userPrompt = stripPromptMetadata(event.prompt ?? "");
             const queryText = resolveSessionQuery(userPrompt, ctx.sessionKey);
-            let recallQueryText = queryText;
-            if (isFirstInSession && queryText === userPrompt && userPrompt.length < SESSION_TOPIC_MIN_LENGTH) {
-              const agentId = ctx.agentId?.trim() || "main";
+            let recallResult;
+            const isColdStart = isFirstInSession && queryText === void 0;
+            if (isColdStart) {
               if (!ctx.agentId?.trim()) {
-                api.logger.debug?.("[agenr] session-start: agentId not provided, defaulting to 'main'");
-              }
-              const sessionsDir = path3.join(
-                os.homedir(),
-                ".openclaw",
-                "agents",
-                agentId,
-                "sessions"
-              );
-              const archivedMessages = await readLatestArchivedUserMessages(sessionsDir);
-              if (archivedMessages.length > 0) {
-                recallQueryText = `${archivedMessages.join(" ")} ${userPrompt}`;
-                api.logger.info?.(
-                  `[agenr] session-start: archived session fallback applied, ${archivedMessages.length} messages`
-                );
+                api.logger.debug?.("[agenr] cold-start: agentId not in ctx, defaulting to 'main'");
               }
+              recallResult = await runRecall(agenrPath, budget, project, void 0, {
+                context: "browse",
+                since: "1d"
+              });
+            } else {
+              recallResult = await runRecall(agenrPath, budget, project, queryText);
             }
-            const recallResult = await runRecall(agenrPath, budget, project, recallQueryText);
             if (recallResult) {
               const formatted = formatRecallAsMarkdown(recallResult);
               if (formatted.trim()) {
                 markdown = formatted;
               }
+              if (isColdStart) {
+                for (const item of recallResult.results) {
+                  const entry = item.entry;
+                  const subject = typeof entry.subject === "string" ? entry.subject : "";
+                  if (!subject.toLowerCase().startsWith("session handoff")) {
+                    continue;
+                  }
+                  const entryId = typeof entry.id === "string" && entry.id.trim() ? entry.id.trim() : null;
+                  if (entryId) {
+                    await runRetireTool(agenrPath, {
+                      entry_id: entryId,
+                      reason: "consumed at session start"
+                    }).catch((err) => {
+                      api.logger.debug?.(
+                        `[agenr] session-start: retire handoff ${entryId} failed: ${err instanceof Error ? err.message : String(err)}`
+                      );
+                    });
+                  } else {
+                    api.logger.debug?.(
+                      "[agenr] session-start: handoff entry missing id, skipping retire"
+                    );
+                  }
+                }
+              }
             }
           }
           let signal;
@@ -1021,10 +1055,35 @@ var plugin = {
           return;
         }
         const lastUserText = extractLastUserText(messages);
-        if (!shouldStashTopic(lastUserText)) {
-          return;
+        if (shouldStashTopic(lastUserText)) {
+          stashSessionTopic(sessionKey, lastUserText);
+        }
+        const handoffText = extractLastExchangeText(messages);
+        if (handoffText) {
+          const agenrPath = resolveAgenrPath(config);
+          const defaultProject = config?.project?.trim() || void 0;
+          const timestamp = (/* @__PURE__ */ new Date()).toISOString().slice(0, 16).replace("T", " ");
+          const handoffEntry = {
+            entries: [
+              {
+                type: "event",
+                importance: 10,
+                subject: `session handoff ${timestamp}`,
+                content: handoffText,
+                tags: ["handoff", "session"]
+              }
+            ]
+          };
+          const storeConfig = {
+            ...config,
+            logger: api.logger
+          };
+          runStoreTool(agenrPath, handoffEntry, storeConfig, defaultProject).catch((err) => {
+            api.logger.debug?.(
+              `[agenr] before_reset: handoff store failed: ${err instanceof Error ? err.message : String(err)}`
+            );
+          });
         }
-        stashSessionTopic(sessionKey, lastUserText);
       } catch (err) {
         api.logger.warn(
           `agenr plugin before_reset stash failed: ${err instanceof Error ? err.message : String(err)}`
@@ -1032,7 +1091,6 @@ var plugin = {
       }
     });
     if (api.registerTool) {
-      const config = api.pluginConfig;
       if (config?.enabled === false) {
         return;
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agenr",
-  "version": "0.8.19",
+  "version": "0.8.21",
   "openclaw": {
     "extensions": [
       "dist/openclaw-plugin/index.js"
@@ -11,6 +11,13 @@
   "bin": {
     "agenr": "dist/cli.js"
   },
+  "scripts": {
+    "build": "tsup src/cli.ts src/cli-main.ts src/openclaw-plugin/index.ts --format esm --dts",
+    "dev": "tsup src/cli.ts src/cli-main.ts --format esm --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  },
   "dependencies": {
     "@clack/prompts": "^1.0.1",
     "@libsql/client": "^0.17.0",
@@ -54,11 +61,9 @@
     "README.md"
   ],
   "author": "agenr-ai",
-  "scripts": {
-    "build": "tsup src/cli.ts src/cli-main.ts src/openclaw-plugin/index.ts --format esm --dts",
-    "dev": "tsup src/cli.ts src/cli-main.ts --format esm --watch",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "typecheck": "tsc --noEmit"
+  "pnpm": {
+    "overrides": {
+      "fast-xml-parser": "^5.3.6"
+    }
   }
-}
+}