@hyperspell/openclaw-hyperspell 0.17.1 → 0.19.0

package/dist/tools/remember.js

@@ -1,5 +1,8 @@
 import { Type } from "@sinclair/typebox";
+import { channelIdFromCtx } from "../lib/exclude-channels.js";
 import { getDefaultWriteScope, resolveRole, resolveUser, routeWrite, } from "../lib/sender.js";
+import { resolveCurrentSessionId } from "../lib/session.js";
+import { isMultiSpeaker } from "../lib/speaker-tracker.js";
 import { log } from "../logger.js";
 export function createRememberToolFactory(client, cfg) {
     const scopingEnabled = !!cfg.multiUser?.scoping;
@@ -21,6 +24,22 @@ export function createRememberToolFactory(client, cfg) {
             scope: Type.Optional(Type.String({ description: scopeDescription })),
         }),
         async execute(_toolCallId, params) {
+            // Decline silently-wrong writes in multi-speaker sessions with no multiUser
+            // config. Without per-sender routing the memory would land under cfg.userId
+            // regardless of who asked — contaminating the primary user's store with
+            // another person's data (attribution gap 1, issue #59 follow-up).
+            const sessionId = resolveCurrentSessionId(undefined, ctx);
+            if (isMultiSpeaker(sessionId, ctx?.is_group_chat === true) && !cfg.multiUser) {
+                log.warn("remember tool: declining write — multi-speaker session with no multiUser config; cannot attribute memory to current speaker");
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "I can't store this memory right now — this is a multi-speaker session and without per-user memory configuration I have no way to attribute it to the right person. The memory would land in the primary user's store regardless of who asked. To fix this, add a `multiUser` config block to the plugin settings.",
+                        },
+                    ],
+                };
+            }
             const resolved = resolveUser(ctx, cfg);
             // Scope resolution: explicit param > role default > global default > "private"
             const scope = params.scope ??
@@ -67,12 +86,19 @@ export function createRememberToolFactory(client, cfg) {
                 userId = resolved?.userId;
             }
             log.debug(`remember tool: "${params.text.slice(0, 50)}..." date=${params.date ?? "now"} userId=${userId} scope=${scope}`);
+            // Tag with the originating conversation so purge-channel can find this
+            // memory if the channel is quarantined later (the tool is already
+            // suppressed in channels that are quarantined NOW).
+            const channelId = channelIdFromCtx(ctx);
             try {
                 await client.addMemory(params.text, {
                     title: params.title,
                     date: params.date,
                     collection,
-                    metadata: { source: "openclaw_tool" },
+                    metadata: {
+                        source: "openclaw_tool",
+                        ...(channelId ? { openclaw_channel_id: channelId } : {}),
+                    },
                     userId,
                     scope: scopingEnabled ? scope : undefined,
                 });

package/dist/tools/search.js

@@ -2,6 +2,8 @@ import { Type } from "@sinclair/typebox";
 import { mergeWithExclude } from "../lib/filters.js";
 import { classifySearchError, logSearchError, searchErrorToolText, } from "../lib/search-error.js";
 import { buildScopeFilter, getCanReadScopes, resolveUser } from "../lib/sender.js";
+import { resolveCurrentSessionId } from "../lib/session.js";
+import { isMultiSpeaker } from "../lib/speaker-tracker.js";
 import { log } from "../logger.js";
 export function createSearchToolFactory(client, cfg) {
     const scopingEnabled = !!cfg.multiUser?.scoping;
@@ -27,6 +29,15 @@ export function createSearchToolFactory(client, cfg) {
             const limit = params.limit ?? 5;
             const resolved = resolveUser(ctx, cfg);
             const userId = params.userId ?? resolved?.userId;
+            // Warn when searching in a multi-speaker session with no multiUser config:
+            // results reflect the primary user's full store, not the current speaker's
+            // personal space. The search proceeds but the result carries the caveat so
+            // the agent can qualify its answer (attribution gap 1, issue #59 follow-up).
+            const sessionId = resolveCurrentSessionId(undefined, ctx);
+            const multiSpeakerNoConfig = isMultiSpeaker(sessionId, ctx?.is_group_chat === true) && !cfg.multiUser;
+            if (multiSpeakerNoConfig) {
+                log.warn("search tool: multi-speaker session with no multiUser config — results reflect primary user's full store, not current speaker's personal space");
+            }
             // Build scope filter: intersect requested scope (if any) with caller's canRead
             let filter;
             if (scopingEnabled) {
@@ -70,7 +81,10 @@ export function createSearchToolFactory(client, cfg) {
                     return `${i + 1}. Source: ${doc.source}\n   Title: ${title}\n   Summary: ${summary}\n   Relevance: ${relevance}`;
                 })
                     .join("\n\n");
-                const text = `Found ${documents.length} memories:\n\n${formattedDocs}`;
+                const caveat = multiSpeakerNoConfig
+                    ? "\n\n⚠️ Note: This is a multi-speaker session without per-user memory config. These results reflect the primary user's store, not the current speaker's personal space. Use these results with that limitation in mind."
+                    : "";
+                const text = `Found ${documents.length} memories:\n\n${formattedDocs}${caveat}`;
                 return {
                     content: [{ type: "text", text }],
                     details: { count: documents.length, documents },

package/openclaw.plugin.json

@@ -2,12 +2,13 @@
 	"id": "openclaw-hyperspell",
 	"name": "Hyperspell",
 	"description": "Context and memory for your AI agents — search across Notion, Slack, Google Drive, and more",
-	"version": "0.13.0",
+	"version": "0.19.0",
 	"kind": "memory",
 	"contracts": {
 		"tools": [
 			"hyperspell_search",
 			"hyperspell_remember",
+			"hyperspell_emotional_arc",
 			"hyperspell_network_scan",
 			"hyperspell_network_write",
 			"hyperspell_network_complete"
@@ -46,6 +47,11 @@
 			"help": "Maintain emotional continuity across sessions — remembers not just what happened, but how it felt",
 			"advanced": true
 		},
+		"excludeChannels": {
+			"label": "Excluded Channels",
+			"help": "Conversation/channel ids fully quarantined from memory: no context injection, no memory writes, no memory tools in those sessions. Threads inside an excluded channel inherit the quarantine. Forward-only; already-synced content is not removed (see purge-channel CLI command).",
+			"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.",
@@ -133,6 +139,15 @@
 			"emotionalContext": {
 				"type": "boolean"
 			},
+			"moodWeatherChance": {
+				"type": "number",
+				"minimum": 0,
+				"maximum": 1
+			},
+			"excludeChannels": {
+				"type": "array",
+				"items": { "type": "string" }
+			},
 			"relationshipId": {
 				"type": "string"
 			},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperspell/openclaw-hyperspell",
-  "version": "0.17.1",
+  "version": "0.19.0",
   "type": "module",
   "description": "OpenClaw Hyperspell memory plugin",
   "license": "MIT",
@@ -38,7 +38,7 @@
     "check-types": "tsc --noEmit",
     "lint": "bunx @biomejs/biome ci .",
     "lint:fix": "bunx @biomejs/biome check --write .",
-    "test": "node --test --experimental-strip-types client.test.ts lib/sender.test.ts lib/filters.test.ts lib/search-error.test.ts lib/session.test.ts lib/ranking.test.ts tools/search.test.ts config.test.ts sync/markdown.test.ts hooks/auto-trace.test.ts hooks/auto-context.test.ts hooks/hot-buffer.test.ts hooks/emotional-state.test.ts hooks/startup-orientation.test.ts"
+    "test": "node --test --experimental-strip-types client.test.ts lib/sender.test.ts lib/filters.test.ts lib/search-error.test.ts lib/session.test.ts lib/exclude-channels.test.ts lib/ranking.test.ts lib/eval-matchers.test.ts tools/search.test.ts tools/emotional-arc.test.ts commands/preview.test.ts commands/purge-channel.test.ts config.test.ts sync/markdown.test.ts hooks/auto-trace.test.ts hooks/auto-context.test.ts hooks/hot-buffer.test.ts hooks/emotional-state.test.ts hooks/startup-orientation.test.ts hooks/mood-weather.test.ts eval/eval.test.ts"
   },
   "openclaw": {
     "extensions": [