@hyperspell/openclaw-hyperspell 0.12.0 → 0.13.1

package/dist/tools/search.js

@@ -0,0 +1,87 @@
+import { Type } from "@sinclair/typebox";
+import { buildScopeFilter, getCanReadScopes, resolveUser } from "../lib/sender.js";
+import { log } from "../logger.js";
+export function createSearchToolFactory(client, cfg) {
+    const scopingEnabled = !!cfg.multiUser?.scoping;
+    const availableScopes = cfg.multiUser?.scoping?.scopes ?? [];
+    const scopeDescription = scopingEnabled
+        ? `Narrow search to a single privacy scope. Available: ${availableScopes.join(", ")}. Omit to search all scopes visible to the caller's role.`
+        : "Privacy scope (only used when scoping is enabled in config).";
+    return (ctx) => ({
+        name: "hyperspell_search",
+        label: "Memory Search",
+        description: "Search through the user's connected sources (Notion, Slack, Gmail, Google Drive, etc.) for relevant information.",
+        parameters: Type.Object({
+            query: Type.String({ description: "Search query" }),
+            limit: Type.Optional(Type.Number({ description: "Max results (default: 5)" })),
+            after: Type.Optional(Type.String({ description: "Only return memories created on or after this date (ISO 8601 or YYYY-MM-DD)" })),
+            before: Type.Optional(Type.String({ description: "Only return memories created before this date (ISO 8601 or YYYY-MM-DD)" })),
+            userId: Type.Optional(Type.String({
+                description: "Search as a specific user (e.g. 'ben', 'shared'). Omit to search as current sender.",
+            })),
+            scope: Type.Optional(Type.String({ description: scopeDescription })),
+        }),
+        async execute(_toolCallId, params) {
+            const limit = params.limit ?? 5;
+            const resolved = resolveUser(ctx, cfg);
+            const userId = params.userId ?? resolved?.userId;
+            // Build scope filter: intersect requested scope (if any) with caller's canRead
+            let filter;
+            if (scopingEnabled) {
+                const canRead = getCanReadScopes(resolved, cfg);
+                const allowed = params.scope
+                    ? canRead.includes("*")
+                        ? [params.scope]
+                        : canRead.includes(params.scope)
+                            ? [params.scope]
+                            : [] // requested scope not allowed → match nothing
+                    : canRead;
+                filter = buildScopeFilter(allowed, resolved?.userId ?? "");
+            }
+            log.debug(`search tool: query="${params.query}" limit=${limit} after=${params.after ?? "none"} before=${params.before ?? "none"} userId=${userId} scope=${params.scope ?? "any"}`);
+            try {
+                const response = await client.searchRaw(params.query, {
+                    limit,
+                    after: params.after,
+                    before: params.before,
+                    userId,
+                    filter,
+                });
+                const documents = (response.documents ?? []);
+                if (documents.length === 0) {
+                    return {
+                        content: [
+                            { type: "text", text: "No relevant memories found." },
+                        ],
+                    };
+                }
+                const formattedDocs = documents
+                    .map((doc, i) => {
+                    const relevance = doc.score
+                        ? `${Math.round(doc.score * 100)}%`
+                        : "N/A";
+                    const title = doc.title || "(untitled)";
+                    const summary = doc.summary || "(no summary)";
+                    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}`;
+                return {
+                    content: [{ type: "text", text }],
+                    details: { count: documents.length, documents },
+                };
+            }
+            catch (err) {
+                log.error("search tool failed", err);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Search failed: ${err instanceof Error ? err.message : String(err)}`,
+                        },
+                    ],
+                };
+            }
+        },
+    });
+}

package/openclaw.plugin.json

@@ -2,8 +2,17 @@
 	"id": "openclaw-hyperspell",
 	"name": "Hyperspell",
 	"description": "Context and memory for your AI agents — search across Notion, Slack, Google Drive, and more",
-	"version": "0.12.0",
+	"version": "0.13.0",
 	"kind": "memory",
+	"contracts": {
+		"tools": [
+			"hyperspell_search",
+			"hyperspell_remember",
+			"hyperspell_network_scan",
+			"hyperspell_network_write",
+			"hyperspell_network_complete"
+		]
+	},
 	"uiHints": {
 		"apiKey": {
 			"label": "Hyperspell API Key",
@@ -32,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",
@@ -108,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,19 +1,12 @@
 {
   "name": "@hyperspell/openclaw-hyperspell",
-  "version": "0.12.0",
+  "version": "0.13.1",
   "type": "module",
   "description": "OpenClaw Hyperspell memory plugin",
   "license": "MIT",
-  "main": "./index.ts",
+  "main": "./dist/index.js",
   "files": [
-    "*.ts",
-    "commands/",
-    "hooks/",
-    "tools/",
-    "sync/",
-    "graph/",
-    "lib/",
-    "types/",
+    "dist/",
     "openclaw.plugin.json",
     "README.md"
   ],
@@ -40,14 +33,16 @@
     "openclaw": ">=2026.1.29"
   },
   "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "prepublishOnly": "npm run build",
     "check-types": "tsc --noEmit",
     "lint": "bunx @biomejs/biome ci .",
     "lint:fix": "bunx @biomejs/biome check --write .",
-    "test": "node --test --experimental-strip-types lib/sender.test.ts config.test.ts hooks/auto-trace.test.ts hooks/emotional-state.test.ts"
+    "test": "node --test --experimental-strip-types lib/sender.test.ts config.test.ts hooks/auto-trace.test.ts hooks/emotional-state.test.ts hooks/startup-orientation.test.ts"
   },
   "openclaw": {
     "extensions": [
-      "./index.ts"
+      "./dist/index.js"
     ],
     "hooks": [],
     "compat": {