@hyperspell/openclaw-hyperspell 0.21.1 → 0.23.0

package/dist/hooks/emotional-state.js

@@ -89,12 +89,19 @@ function contentToText(content) {
     }
     return "";
 }
-function messagesToTranscript(messages) {
+/**
+ * Only conversational turns carry relationship signal. `system` is scaffolding
+ * and `tool`/`toolResult` are machinery — a Discord send receipt says nothing
+ * about how a conversation felt, and letting one through means the extractor
+ * distills API JSON into an emotional register. Same rule as hot-buffer.ts.
+ */
+const CONVERSATIONAL_ROLES = new Set(["user", "assistant"]);
+export function messagesToTranscript(messages) {
     const lines = [];
     for (const m of messages) {
         if (!m.role || !m.content)
             continue;
-        if (m.role === "system")
+        if (!CONVERSATIONAL_ROLES.has(m.role))
             continue;
         const raw = contentToText(m.content);
         if (!raw)
@@ -112,9 +119,13 @@ function messagesToTranscript(messages) {
  * rather than a distilled emotional register. Real summaries are second-person
  * prose ("Your relationship with this user…"); the placeholder echoes the input
  * conversation, which has role-prefixed lines.
+ *
+ * Covers the full role vocabulary, not just what messagesToTranscript writes
+ * today: rows stored before tool roles were excluded above are still fetched
+ * until they age out, and they lead with `toolResult:`.
  */
 export function looksLikeRawTranscript(summary) {
-    return /(^|\n)\s*(user|assistant)\s*:/i.test(summary);
+    return /(^|\n)\s*(?:user|assistant|system|tool(?:result|use|call)?)\s*:/i.test(summary);
 }
 /** Compact relative time for the arc labels (e.g. "just now", "3h ago", "2d ago"). */
 function relativeWhen(iso) {

package/dist/hooks/hot-buffer.js

@@ -2,6 +2,7 @@ import fs from "node:fs";
 import path from "node:path";
 import { getWorkspaceDir } from "../config.js";
 import { channelIdFromCtx } from "../lib/exclude-channels.js";
+import { HOT_BUFFER_SOURCE } from "../lib/filters.js";
 import { resolveUser } from "../lib/sender.js";
 import { cleanupSpeakerSession, isMultiSpeaker, recordSender, senderIdFromCtx, } from "../lib/speaker-tracker.js";
 import { log } from "../logger.js";
@@ -237,7 +238,7 @@ export function buildHotBufferHandler(client, cfg, opts) {
             // would have blocked.
             const channelId = channelIdFromCtx(ctx);
             const metadata = {
-                openclaw_source: "hot_buffer",
+                openclaw_source: HOT_BUFFER_SOURCE,
                 openclaw_session_id: sessionId,
                 ...(channelId ? { openclaw_channel_id: channelId } : {}),
             };

package/dist/hooks/startup-orientation.js

@@ -1,4 +1,4 @@
-import { excludeFilterFor } from "../lib/filters.js";
+import { excludeFilterFor, HOT_BUFFER_SOURCE } from "../lib/filters.js";
 import { resolveUser } from "../lib/sender.js";
 import { resolveCurrentSessionId } from "../lib/session.js";
 import { isMultiSpeaker } from "../lib/speaker-tracker.js";
@@ -144,13 +144,16 @@ async function fetchRecentTraces(client, cutoff, limit, userId) {
  * modern source of "recent interactions" (the agent_end-trace path only works
  * when auto-trace is on, which it usually isn't). The hot buffer writes one
  * session-grouped Resource per conversation: `resource_id` = the session id (a
- * UUID), untagged (no `openclaw_source`), with a generated title. We rely on
- * `listMemories` returning resources newest-first (verified live) and take the
- * newest `limit` conversation resources — their metadata carries no date to
+ * UUID), tagged `openclaw_source: "hot_buffer"`, with a generated title. We rely
+ * on `listMemories` returning resources newest-first (verified live) and take
+ * the newest `limit` conversation resources — their metadata carries no date to
  * filter on, so order is our recency signal.
  *
- * Excludes: tagged rows (memory_sync_section / command / agent_end), non-UUID
- * resources (synced docs), automated cron sessions, and untitled rows.
+ * Selects ON the hot-buffer tag. This used to skip any row carrying an
+ * `openclaw_source` at all, which was correct only while hot rows were untagged;
+ * backend #1921 (2026-07-02) started tagging them, so that exclusion began
+ * dropping every row it was meant to keep and the block silently vanished.
+ * Sibling rows (memory_sync_section / command / agent_end) fail the same check.
  */
 async function fetchRecentConversations(client, limit, userId) {
     const out = [];
@@ -166,7 +169,7 @@ async function fetchRecentConversations(client, limit, userId) {
             break;
         if (!UUID_RE.test(memory.resourceId))
             continue;
-        if (memory.metadata?.openclaw_source)
+        if (memory.metadata?.openclaw_source !== HOT_BUFFER_SOURCE)
             continue;
         const title = memory.title ?? "";
         if (title.length === 0 || /^\[cron:/i.test(title))

package/dist/index.js

@@ -144,6 +144,14 @@ export default {
         // Register exactly ONE of the two: cores between 2026-04 and 2026-07
         // accept both and would double-inject. Both hooks share the same
         // { prependContext } result contract and provide event.prompt.
+        //
+        // Do NOT rename this a third time. We were originally on
+        // `before_prompt_build`, moved to `before_agent_start`, and that is the
+        // only reason 2026.7.2 took injection down: `before_prompt_build` is
+        // still live in core's PROMPT_INJECTION_HOOK_NAMES and would have
+        // survived untouched. Staying on `agent_turn_prepare` (proven in
+        // production) — but the lesson is that "newer-sounding hook name" is not
+        // evidence of anything. Check core's hook table before moving again.
         const injectionHook = typeof api
             .enqueueNextTurnInjection === "function"
             ? "agent_turn_prepare"

package/dist/lib/filters.js

@@ -10,6 +10,13 @@
 export const AGENT_END_SOURCE = "agent_end";
 /** Metadata tag on mood-weather roll records (see `recordMoodRoll` in hooks/mood-weather.ts). */
 export const MOOD_WEATHER_SOURCE = "mood_weather";
+/**
+ * Metadata tag on hot-buffer conversation rows (written by hooks/hot-buffer.ts).
+ * Readers must select ON this value, never "any tag means not mine" — hot rows
+ * were untagged before backend #1921 (2026-07-02) and consumers written against
+ * that shape silently match nothing now.
+ */
+export const HOT_BUFFER_SOURCE = "hot_buffer";
 /**
  * Memories produced by the auto-trace session-end hook are tagged in metadata
  * as `openclaw_source: "agent_end"` (see `sendTrace` in client.ts). Those should

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
 	"id": "openclaw-hyperspell",
 	"name": "Hyperspell",
 	"description": "Context and memory for your AI agents — search across Notion, Slack, Google Drive, and more",
-	"version": "0.21.0",
+	"version": "0.23.0",
 	"kind": "memory",
 	"contracts": {
 		"tools": [

package/package.json

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