@hyperspell/openclaw-hyperspell 0.13.0 → 0.13.1

package/dist/commands/setup.js

@@ -281,7 +281,6 @@ async function runSetup() {
                     recentDays: 7,
                     recentLimit: 5,
                     loopsLimit: 3,
-                    recentQuery: "conversation session interaction",
                     loopsQuery: "open tasks pending questions unfinished promised need to follow up",
                 },
             });

package/dist/config.js

@@ -25,6 +25,7 @@ const ALLOWED_KEYS = [
     "debug",
     "knowledgeGraph",
     "multiUser",
+    "dreaming",
 ];
 const VALID_SOURCES = [
     "reddit",
@@ -252,7 +253,6 @@ export function parseConfig(raw) {
             recentDays: soRaw.recentDays ?? 7,
             recentLimit: soRaw.recentLimit ?? 5,
             loopsLimit: soRaw.loopsLimit ?? 3,
-            recentQuery: soRaw.recentQuery ?? "conversation session interaction",
             loopsQuery: soRaw.loopsQuery ??
                 "open tasks pending questions unfinished promised need to follow up",
         },

package/dist/hooks/auto-trace.js

@@ -13,6 +13,8 @@ export function sanitizeTraceText(input) {
     let out = input;
     out = out.replace(/<hyperspell-context>[\s\S]*?<\/hyperspell-context>\n?/g, "");
     out = out.replace(/<hyperspell-emotional-context>[\s\S]*?<\/hyperspell-emotional-context>\n?/g, "");
+    out = out.replace(/<hyperspell-recent-interactions>[\s\S]*?<\/hyperspell-recent-interactions>\n?/g, "");
+    out = out.replace(/<hyperspell-unfinished-loops>[\s\S]*?<\/hyperspell-unfinished-loops>\n?/g, "");
     out = out.replace(/Sender \(untrusted metadata\):\s*```json[\s\S]*?```\n?/g, "");
     out = out.replace(/\[Bootstrap pending\][\s\S]*?(?=\n{2,}|\nSystem:|\nSender|$)/g, "");
     out = out.replace(/\[Startup context loaded by runtime\][\s\S]*?(?:\n\n|$)/g, "");

package/dist/hooks/startup-orientation.js

@@ -1,15 +1,23 @@
 import { resolveUser } from "../lib/sender.js";
 import { log } from "../logger.js";
-const RECENT_FILTER = { openclaw_source: "agent_end" };
+const MAX_ATTEMPTS = 2;
+const RECENT_BUFFER_LIMIT = 100;
 /**
- * Track which sessions already received the orientation injection. The block is
- * expensive (two search calls + a few hundred tokens of wrapper) and its
- * contents don't change within a session, so inject-once is the right shape.
- * Lifecycle mirrors the emotional-context hook: first turn injects, later turns
- * skip, `after_compaction` clears (injection may have been trimmed), and
- * `session_end` deletes to keep the Set bounded.
+ * Sessions where the orientation block was already injected (or where we
+ * deliberately decided not to inject — unknown sender, exhausted retries).
+ * Re-checked at the top of every turn; on hit, we skip.
+ *
+ * Lifecycle mirrors the emotional-context hook: `after_compaction` clears
+ * (the original injection may have been trimmed out of history) and
+ * `session_end` cleans up to keep both structures bounded.
  */
 const injectedSessions = new Set();
+/**
+ * Counts attempts for sessions where every call has failed so far. We only
+ * count failures here, so a session that succeeds on retry will never appear.
+ * Capped at MAX_ATTEMPTS — past that we give up and add to injectedSessions.
+ */
+const failedAttempts = new Map();
 function formatRelativeTime(iso) {
     if (!iso)
         return "";
@@ -36,7 +44,7 @@ function formatRecentInteractions(results) {
         return null;
     const lines = results.map((r) => {
         const when = formatRelativeTime(r.createdAt);
-        const title = r.title ?? `[${r.source}]`;
+        const title = r.title || `[${r.source}]`;
         const prefix = when ? `[${when}] ` : "";
         const top = r.highlights[0]?.text?.replace(/\n/g, " ").slice(0, 140);
         const tail = top ? ` — ${top}` : "";
@@ -50,7 +58,7 @@ function formatUnfinishedLoops(results) {
         const top = r.highlights[0];
         if (!top)
             continue;
-        const title = r.title ?? `[${r.source}]`;
+        const title = r.title || `[${r.source}]`;
         bullets.push(`- ${title}: ${top.text.replace(/\n/g, " ")}`);
     }
     return bullets.length > 0 ? bullets.join("\n") : null;
@@ -58,7 +66,7 @@ function formatUnfinishedLoops(results) {
 function isoDaysAgo(days) {
     const d = new Date();
     d.setUTCDate(d.getUTCDate() - days);
-    return d.toISOString();
+    return d;
 }
 /**
  * Resolve the userId to use for personal searches. In multi-user mode, skip
@@ -74,12 +82,73 @@ function personalUserId(cfg, ctx) {
         return { skip: true };
     return { skip: false, userId: resolved.userId };
 }
+/**
+ * Pull recent agent_end traces via listMemories, sorted chronologically.
+ *
+ * Why list, not search: a date-window + relevance search ranks results by
+ * lexical similarity to a generic query, which is approximately random
+ * within a 7-day slice and can easily exclude yesterday in favor of a
+ * 5-day-old session. listMemories gives us true chronological recall.
+ *
+ * The SDK's list endpoint doesn't expose date or metadata filters in our
+ * wrapper, so we filter client-side. Buffer is capped at
+ * RECENT_BUFFER_LIMIT to bound wire cost; if a user has more than that
+ * many traces in the cutoff window we'll still get the newest ones,
+ * since the underlying API returns recency-ordered pages.
+ */
+async function fetchRecentTraces(client, cutoff, limit, userId) {
+    const buffer = [];
+    let scanned = 0;
+    const cutoffMs = cutoff.getTime();
+    for await (const memory of client.listMemories({
+        source: "trace",
+        userId,
+        pageSize: 50,
+    })) {
+        scanned++;
+        if (scanned > RECENT_BUFFER_LIMIT)
+            break;
+        const meta = memory.metadata;
+        if (meta.openclaw_source !== "agent_end")
+            continue;
+        const createdRaw = meta.created_at;
+        if (typeof createdRaw !== "string")
+            continue;
+        const createdMs = new Date(createdRaw).getTime();
+        if (Number.isNaN(createdMs) || createdMs < cutoffMs)
+            continue;
+        buffer.push({
+            resourceId: memory.resourceId,
+            title: memory.title,
+            source: memory.source,
+            score: null,
+            url: null,
+            createdAt: createdRaw,
+            highlights: [],
+        });
+    }
+    buffer.sort((a, b) => {
+        const at = a.createdAt ? new Date(a.createdAt).getTime() : 0;
+        const bt = b.createdAt ? new Date(b.createdAt).getTime() : 0;
+        return bt - at;
+    });
+    return buffer.slice(0, limit);
+}
 export function buildStartupOrientationHandler(client, cfg) {
     const so = cfg.startupOrientation;
     return async (_event, ctx) => {
         const sessionKey = ctx?.sessionKey;
         if (sessionKey && injectedSessions.has(sessionKey))
             return;
+        const tries = (sessionKey && failedAttempts.get(sessionKey)) || 0;
+        if (tries >= MAX_ATTEMPTS) {
+            log.debug(`startup-orientation: giving up after ${tries} failed attempt(s)`);
+            if (sessionKey) {
+                injectedSessions.add(sessionKey);
+                failedAttempts.delete(sessionKey);
+            }
+            return;
+        }
         const { skip, userId } = personalUserId(cfg, ctx);
         if (skip) {
             log.debug("startup-orientation: skipping — unknown sender in multi-user mode");
@@ -87,31 +156,36 @@ export function buildStartupOrientationHandler(client, cfg) {
                 injectedSessions.add(sessionKey);
             return;
         }
-        const after = isoDaysAgo(so.recentDays);
+        const cutoff = isoDaysAgo(so.recentDays);
         const [recentSettled, loopsSettled] = await Promise.allSettled([
-            client.search(so.recentQuery, {
-                limit: so.recentLimit,
-                after,
-                filter: RECENT_FILTER,
-                userId,
-            }),
+            fetchRecentTraces(client, cutoff, so.recentLimit, userId),
             client.search(so.loopsQuery, {
                 limit: so.loopsLimit,
                 userId,
             }),
         ]);
-        const recent = recentSettled.status === "fulfilled" ? recentSettled.value : [];
-        if (recentSettled.status === "rejected") {
-            log.error("startup-orientation: recent search failed", recentSettled.reason);
+        const recentOk = recentSettled.status === "fulfilled";
+        const loopsOk = loopsSettled.status === "fulfilled";
+        const recent = recentOk ? recentSettled.value : [];
+        const loops = loopsOk ? loopsSettled.value : [];
+        if (!recentOk) {
+            log.error("startup-orientation: recent listMemories failed", recentSettled.reason);
         }
-        const loops = loopsSettled.status === "fulfilled" ? loopsSettled.value : [];
-        if (loopsSettled.status === "rejected") {
+        if (!loopsOk) {
             log.error("startup-orientation: loops search failed", loopsSettled.reason);
         }
+        if (!recentOk && !loopsOk) {
+            if (sessionKey)
+                failedAttempts.set(sessionKey, tries + 1);
+            log.debug(`startup-orientation: both calls failed (attempt ${tries + 1}/${MAX_ATTEMPTS}); will retry next turn`);
+            return;
+        }
+        if (sessionKey) {
+            injectedSessions.add(sessionKey);
+            failedAttempts.delete(sessionKey);
+        }
         const recentBody = formatRecentInteractions(recent);
         const loopsBody = formatUnfinishedLoops(loops);
-        if (sessionKey)
-            injectedSessions.add(sessionKey);
         if (!recentBody && !loopsBody) {
             log.debug("startup-orientation: nothing to inject");
             return;
@@ -120,7 +194,7 @@ export function buildStartupOrientationHandler(client, cfg) {
         if (recentBody) {
             blocks.push([
                 "<hyperspell-recent-interactions>",
-                `Your last ${so.recentDays} days of conversations with this user, most-relevant-first. Use for situational continuity — don't quote verbatim.`,
+                `Your last ${so.recentDays} days of conversations with this user, most-recent-first. Use for situational continuity — don't quote verbatim.`,
                 "",
                 recentBody,
                 "</hyperspell-recent-interactions>",
@@ -142,7 +216,11 @@ export function buildStartupOrientationHandler(client, cfg) {
 export function buildStartupOrientationCompactionHandler() {
     return async (_event, ctx) => {
         const sessionKey = ctx?.sessionKey;
-        if (sessionKey && injectedSessions.delete(sessionKey)) {
+        if (!sessionKey)
+            return;
+        const dropped = injectedSessions.delete(sessionKey);
+        failedAttempts.delete(sessionKey);
+        if (dropped) {
             log.debug(`startup-orientation: cache cleared after compaction (session=${sessionKey})`);
         }
     };
@@ -150,7 +228,9 @@ export function buildStartupOrientationCompactionHandler() {
 export function buildStartupOrientationSessionCleanupHandler() {
     return async (_event, ctx) => {
         const sessionKey = ctx?.sessionKey;
-        if (sessionKey)
-            injectedSessions.delete(sessionKey);
+        if (!sessionKey)
+            return;
+        injectedSessions.delete(sessionKey);
+        failedAttempts.delete(sessionKey);
     };
 }

package/openclaw.plugin.json

@@ -41,6 +41,11 @@
 			"help": "Maintain emotional continuity across sessions — remembers not just what happened, but how it felt",
 			"advanced": true
 		},
+		"startupOrientation": {
+			"label": "Startup Orientation",
+			"help": "Inject recent-interactions and unfinished-loops blocks once per session at startup. Costs two extra calls + ~500–800 tokens of injection per session; off by default.",
+			"advanced": true
+		},
 		"relationshipId": {
 			"label": "Relationship ID",
 			"placeholder": "partner-anna",
@@ -117,6 +122,16 @@
 			"relationshipId": {
 				"type": "string"
 			},
+			"startupOrientation": {
+				"type": "object",
+				"properties": {
+					"enabled": { "type": "boolean" },
+					"recentDays": { "type": "number", "minimum": 1, "maximum": 90 },
+					"recentLimit": { "type": "number", "minimum": 1, "maximum": 20 },
+					"loopsLimit": { "type": "number", "minimum": 1, "maximum": 20 },
+					"loopsQuery": { "type": "string" }
+				}
+			},
 			"sources": {
 				"type": "string"
 			},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperspell/openclaw-hyperspell",
-  "version": "0.13.0",
+  "version": "0.13.1",
   "type": "module",
   "description": "OpenClaw Hyperspell memory plugin",
   "license": "MIT",