@hyperspell/openclaw-hyperspell 0.7.2 → 0.8.1

package/README.md

@@ -7,9 +7,11 @@ OpenClaw plugin for [Hyperspell](https://hyperspell.com) - Context and memory fo
 ## Installation
 
 ```bash
-openclaw plugins install @hyperspell/openclaw-hyperspell
+openclaw plugins install --dangerously-force-unsafe-install @hyperspell/openclaw-hyperspell
 ```
 
+> **Note:** The `--dangerously-force-unsafe-install` flag is required because OpenClaw's automated install scanner detects standard operations that are essential to how the plugin works — opening your browser during setup, scheduling background jobs, and securely communicating with the Hyperspell API. These are normal, expected behaviors and the plugin does not execute arbitrary code or access data beyond what is needed to function. The source is fully open and auditable in this repository.
+
 ## Quick Start
 
 Run the interactive setup wizard:
@@ -193,70 +195,6 @@ Enable the graph tools by using `hyperspell_network_scan`, `hyperspell_network_w
 
 ---
 
-## SommeliAgent 🍷
-
-> *"Your playlist says more about your palate than you'd like to admit, darling."*
-> — A Linea, Hyperspell's hidden sommelier
-
-An opinionated AI sommelier living inside your memory plugin. She reads your Spotify listening habits, judges them (affectionately), and recommends wines that match the person your music says you are — not the person you think you are.
-
-215 wines. 26 countries. Zero tolerance for boring recommendations.
-
-**Requires:** `uv` ([install](https://docs.astral.sh/uv/))
-
-### Setup
-
-1. Create a Spotify app at https://developer.spotify.com/dashboard (redirect URI: `http://localhost:8888/callback`)
-2. Set environment variables: `SPOTIFY_CLIENT_ID` and `SPOTIFY_CLIENT_SECRET`
-3. Authenticate: `/wine-auth`
-
-Or skip all that and try demo mode: `/wine demo`
-
-### Slash Commands
-
-#### `/wine [options]`
-
-Get wine recommendations. Options can be combined:
-
-```
-/wine                    — recommendations from your Spotify
-/wine demo               — use demo profile (no Spotify needed)
-/wine red premium        — only red wines, premium price range
-/wine white 5            — 5 white wine recommendations
-/wine demo profile       — show full music-to-wine mapping
-```
-
-#### `/wine-auth`
-
-Connect your Spotify account.
-
-#### `/wine-rate <wine-id> <1-5> [notes]`
-
-Rate a recommendation to improve future suggestions.
-
-```
-/wine-rate red-it-001 5 "Incredible tannins, paired perfectly with my Radiohead phase"
-```
-
-#### `/wine-history`
-
-View your rating history and derived taste preferences.
-
-### AI Tools
-
-The plugin also registers tools the AI can use autonomously:
-
-- **hyperspell_sommelier** - Get wine recommendations (with full personality instructions)
-- **hyperspell_sommelier_rate** - Rate wines
-
-### How It Works
-
-Your Spotify audio features (energy, valence, complexity, acousticness, tempo) are mapped to wine dimensions (body, sweetness, tannin, acidity, complexity, fruitiness, earthiness, spiciness). The cross-domain mapping is entertainment-first — the comedy comes from a sharp, opinionated sommelier voice diagnosing your personality through your questionable music taste.
-
-The sommelier is A Linea — she lives inside Hyperspell and has strong opinions about both your playlist and your palate. She chose Alexander McQueen as her fashion house, so expect the wine recommendations to have a similar aesthetic: beautiful, a little dark, and never boring.
-
-See `sommeliagent/references/cross-domain-mappings.md` for the full methodology. 🖤
-
 ## Troubleshooting
 
 ### "No relevant memories found"

package/client.ts

@@ -27,7 +27,7 @@ export type Integration = {
 	id: string;
 	name: string;
 	provider: HyperspellSource;
-	icon: string;
+	icon: string | null;
 };
 
 export type Connection = {
@@ -149,6 +149,7 @@ export class HyperspellClient {
 			score: doc.score ?? null,
 			url: (doc.metadata?.url as string | null) ?? null,
 			createdAt: (doc.metadata?.created_at as string | null) ?? null,
+			highlights: [],
 		}));
 
 		log.debugResponse("memories.search (with answer)", {
@@ -290,7 +291,12 @@ export class HyperspellClient {
 			session_id: options?.sessionId,
 			title: options?.title,
 			format: "openclaw",
-			extract: options?.extract ?? ["procedure"],
+			// Cast: SDK 0.35 typing accepts only ["procedure" | "memory"], but the
+			// backend's mood extractor (hyperspell/hyperspell#581) accepts "mood".
+			// Remove this cast once the OpenAPI spec is updated.
+			extract: (options?.extract ?? ["procedure"]) as Array<
+				"procedure" | "memory"
+			>,
 			metadata: {
 				...options?.metadata,
 				openclaw_source: "agent_end",

package/commands/setup.ts

@@ -332,6 +332,7 @@ async function runSetup(): Promise<void> {
         apiKey,
         userId,
         autoContext: true,
+        autoTrace: { enabled: false, extract: ["procedure"] },
         syncMemories: true,
         sources: [],
         maxResults: 10,

package/config.ts

@@ -1,5 +1,4 @@
 export type HyperspellSource =
-	| "collections"
 	| "reddit"
 	| "notion"
 	| "slack"
@@ -8,7 +7,11 @@ export type HyperspellSource =
 	| "box"
 	| "google_drive"
 	| "vault"
-	| "web_crawler";
+	| "web_crawler"
+	| "dropbox"
+	| "github"
+	| "trace"
+	| "microsoft_teams";
 
 export type KnowledgeGraphConfig = {
 	enabled: boolean;
@@ -49,7 +52,6 @@ const ALLOWED_KEYS = [
 ];
 
 const VALID_SOURCES: HyperspellSource[] = [
-	"collections",
 	"reddit",
 	"notion",
 	"slack",
@@ -59,6 +61,10 @@ const VALID_SOURCES: HyperspellSource[] = [
 	"google_drive",
 	"vault",
 	"web_crawler",
+	"dropbox",
+	"github",
+	"trace",
+	"microsoft_teams",
 ];
 
 function assertAllowedKeys(

package/index.ts

@@ -1,7 +1,6 @@
 import type { OpenClawPluginApi } from "openclaw/plugin-sdk"
 import { HyperspellClient } from "./client.ts"
 import { registerCommands } from "./commands/slash.ts"
-import { registerWineCommands } from "./commands/wine.ts"
 import { registerCliCommands } from "./commands/setup.ts"
 import { parseConfig, hyperspellConfigSchema, getWorkspaceDir } from "./config.ts"
 import { buildAutoContextHandler } from "./hooks/auto-context.ts"
@@ -10,7 +9,6 @@ import { buildFileSyncHandler, syncMemoriesOnStartup } from "./hooks/memory-sync
 import { initLogger } from "./logger.ts"
 import { registerRememberTool } from "./tools/remember.ts"
 import { registerSearchTool } from "./tools/search.ts"
-import { registerSommelierTool, registerSommelierRateTool } from "./tools/sommelier.ts"
 import { registerNetworkTools } from "./graph/index.ts"
 
 export default {
@@ -34,11 +32,6 @@ export default {
 		const rawConfig = api.pluginConfig as Record<string, unknown> | undefined;
 		const hasConfig = rawConfig?.apiKey || process.env.HYPERSPELL_API_KEY;
 
-		// SommeliAgent works independently of Hyperspell config — it just needs uv + Spotify
-		registerSommelierTool(api)
-		registerSommelierRateTool(api)
-		registerWineCommands(api)
-
 		if (!hasConfig) {
 			api.logger.info(
 				"hyperspell: not configured - run 'openclaw openclaw-hyperspell setup'",

package/openclaw.plugin.json

@@ -1,5 +1,8 @@
 {
 	"id": "openclaw-hyperspell",
+	"name": "Hyperspell",
+	"description": "Context and memory for your AI agents — search across Notion, Slack, Google Drive, and more",
+	"version": "0.7.2",
 	"kind": "memory",
 	"uiHints": {
 		"apiKey": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperspell/openclaw-hyperspell",
-  "version": "0.7.2",
+  "version": "0.8.1",
   "type": "module",
   "description": "OpenClaw Hyperspell memory plugin",
   "license": "MIT",
@@ -14,10 +14,11 @@
     "graph/",
     "lib/",
     "types/",
-    "sommeliagent/",
     "openclaw.plugin.json",
     "README.md"
   ],
+  "author": "Hyperspell <hello@hyperspell.com> (https://hyperspell.com)",
+  "homepage": "https://hyperspell.com",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/hyperspell/hyperspell-openclaw.git"
@@ -28,14 +29,12 @@
     "memory",
     "rag",
     "ai",
-    "plugin",
-    "sommelier",
-    "wine"
+    "plugin"
   ],
   "dependencies": {
     "@clack/prompts": "^1.0.0",
     "@sinclair/typebox": "^0.34.0",
-    "hyperspell": "^0.30.0"
+    "hyperspell": "^0.35.1"
   },
   "peerDependencies": {
     "openclaw": ">=2026.1.29"
@@ -49,7 +48,15 @@
     "extensions": [
       "./index.ts"
     ],
-    "hooks": []
+    "hooks": [],
+    "compat": {
+      "pluginApi": ">=2026.1.29",
+      "minGatewayVersion": "2026.1.29"
+    },
+    "build": {
+      "openclawVersion": "2026.3.24-beta.2",
+      "pluginSdkVersion": "2026.3.24-beta.2"
+    }
   },
   "devDependencies": {
     "typescript": "^5.9.3"

package/commands/wine.ts

@@ -1,164 +0,0 @@
-import { execFile } from "node:child_process"
-import { access, constants } from "node:fs/promises"
-import { join } from "node:path"
-import type { OpenClawPluginApi } from "openclaw/plugin-sdk"
-import { log } from "../logger.ts"
-import { runScript, SCRIPTS_DIR } from "../lib/run-script.ts"
-
-function parseWineArgs(argsStr: string): string[] {
-  const args: string[] = []
-  const parts = argsStr.trim().split(/\s+/)
-
-  for (let i = 0; i < parts.length; i++) {
-    const part = parts[i].toLowerCase()
-    if (["red", "white", "rose", "orange", "sparkling", "dessert"].includes(part)) {
-      args.push("--color", part)
-    } else if (["budget", "mid", "premium", "luxury"].includes(part)) {
-      args.push("--price", part)
-    } else if (part === "demo") {
-      args.push("--demo")
-    } else if (part === "profile") {
-      args.push("--profile")
-    } else if (/^\d+$/.test(part)) {
-      args.push("--count", String(Math.min(Number.parseInt(part), 10)))
-    }
-  }
-
-  return args
-}
-
-export function registerWineCommands(api: OpenClawPluginApi): void {
-  // /wine [color] [price] [count] [demo] [profile]
-  api.registerCommand({
-    name: "wine",
-    description: "Get wine recommendations based on your Spotify listening habits",
-    acceptsArgs: true,
-    requireAuth: false,
-    handler: async (ctx: { args?: string }) => {
-      log.debug(`/wine command: "${ctx.args || ""}"`)
-
-      // Check uv
-      try {
-        await new Promise<void>((resolve, reject) => {
-          execFile("uv", ["--version"], { timeout: 5_000 }, (err) => {
-            if (err) reject(err)
-            else resolve()
-          })
-        })
-      } catch {
-        return { text: "SommeliAgent needs `uv` installed. Run: brew install uv" }
-      }
-
-      const userArgs = ctx.args?.trim() || ""
-      const scriptArgs = parseWineArgs(userArgs)
-      const isDemo = scriptArgs.includes("--demo")
-
-      // Check Spotify auth (unless demo mode)
-      if (!isDemo) {
-        const tokenPath = join(
-          process.env.HOME || process.env.USERPROFILE || "",
-          ".sommeliagent",
-          "token.json",
-        )
-        try {
-          await access(tokenPath, constants.R_OK)
-        } catch {
-          return {
-            text: `Spotify not connected. Set up:\n1. Create app at https://developer.spotify.com/dashboard\n2. Set SPOTIFY_CLIENT_ID and SPOTIFY_CLIENT_SECRET\n3. Run: uv run ${join(SCRIPTS_DIR, "auth.py")}\n\nOr try: /wine demo`,
-          }
-        }
-      }
-
-      try {
-        const { stdout, stderr } = await runScript("recommend.py", scriptArgs)
-
-        if (stderr) {
-          log.debug(`/wine stderr: ${stderr}`)
-        }
-
-        return { text: stdout }
-      } catch (err) {
-        log.error("/wine failed", err)
-        return {
-          text: `SommeliAgent failed: ${err instanceof Error ? err.message : String(err)}\n\nTry: /wine demo`,
-        }
-      }
-    },
-  })
-
-  // /wine-auth - Run Spotify OAuth
-  api.registerCommand({
-    name: "wine-auth",
-    description: "Connect your Spotify account for wine recommendations",
-    acceptsArgs: false,
-    requireAuth: false,
-    handler: async () => {
-      log.debug("/wine-auth command")
-
-      try {
-        const { stdout } = await runScript("auth.py", [], 180_000)
-        return { text: stdout }
-      } catch (err) {
-        log.error("/wine-auth failed", err)
-        return {
-          text: `Spotify auth failed: ${err instanceof Error ? err.message : String(err)}\n\nMake sure SPOTIFY_CLIENT_ID and SPOTIFY_CLIENT_SECRET are set.`,
-        }
-      }
-    },
-  })
-
-  // /wine-rate <wine-id> <1-5> [notes]
-  api.registerCommand({
-    name: "wine-rate",
-    description: "Rate a wine recommendation (improves future suggestions)",
-    acceptsArgs: true,
-    requireAuth: false,
-    handler: async (ctx: { args?: string }) => {
-      const parts = ctx.args?.trim().split(/\s+/) || []
-      if (parts.length < 2) {
-        return { text: 'Usage: /wine-rate <wine-id> <1-5> [notes]\nExample: /wine-rate red-it-001 5 "Incredible tannins"' }
-      }
-
-      const wineId = parts[0]
-      const rating = Number.parseInt(parts[1])
-      if (Number.isNaN(rating) || rating < 1 || rating > 5) {
-        return { text: "Rating must be 1-5." }
-      }
-
-      const notes = parts.slice(2).join(" ")
-      const args = ["--wine-id", wineId, "--rating", String(rating)]
-      if (notes) args.push("--notes", notes)
-
-      try {
-        const { stdout } = await runScript("rate.py", args)
-        return { text: stdout }
-      } catch (err) {
-        log.error("/wine-rate failed", err)
-        return {
-          text: `Failed to rate: ${err instanceof Error ? err.message : String(err)}`,
-        }
-      }
-    },
-  })
-
-  // /wine-history - Show past ratings
-  api.registerCommand({
-    name: "wine-history",
-    description: "View your wine rating history and taste profile",
-    acceptsArgs: false,
-    requireAuth: false,
-    handler: async () => {
-      log.debug("/wine-history command")
-
-      try {
-        const { stdout } = await runScript("history.py", [])
-        return { text: stdout }
-      } catch (err) {
-        log.error("/wine-history failed", err)
-        return {
-          text: `Failed to load history: ${err instanceof Error ? err.message : String(err)}`,
-        }
-      }
-    },
-  })
-}

package/lib/run-script.ts

@@ -1,32 +0,0 @@
-import { execFile } from "node:child_process"
-import { dirname, join } from "node:path"
-import { fileURLToPath } from "node:url"
-
-const __dirname = dirname(fileURLToPath(import.meta.url))
-export const SCRIPTS_DIR = join(__dirname, "..", "sommeliagent", "scripts")
-
-const ALLOWED_SCRIPTS = new Set(["recommend.py", "rate.py", "auth.py", "history.py"])
-
-export function runScript(
-  scriptName: string,
-  args: string[],
-  timeout: number = 30_000,
-): Promise<{ stdout: string; stderr: string }> {
-  if (!ALLOWED_SCRIPTS.has(scriptName)) {
-    return Promise.reject(new Error(`Unknown script: ${scriptName}`))
-  }
-  return new Promise((resolve, reject) => {
-    execFile(
-      "uv",
-      ["run", join(SCRIPTS_DIR, scriptName), ...args],
-      { timeout, maxBuffer: 1024 * 512 },
-      (error, stdout, stderr) => {
-        if (error) {
-          reject(new Error(`${scriptName} failed: ${stderr || error.message}`))
-        } else {
-          resolve({ stdout, stderr })
-        }
-      },
-    )
-  })
-}

package/sommeliagent/references/cross-domain-mappings.md

@@ -1,63 +0,0 @@
-# Cross-Domain Mapping: Music → Wine
-
-The core thesis: sensory and aesthetic preferences transfer across domains. Someone who seeks complexity in music seeks complexity in wine. Someone drawn to dark, brooding sounds wants wines with tension and structure, not crowd-pleasers.
-
-## Music → Wine Dimension Map
-
-| Music Signal | Wine Dimension | Logic |
-|---|---|---|
-| Tempo / energy | Body / weight | High energy → bold, full-bodied; ambient → light, delicate |
-| Complexity (jazz, prog, classical) | Complexity (terroir-driven, natural wines) | Listeners who tolerate/seek complexity want wines that challenge |
-| Valence (happy vs dark) | Sweetness / dryness spectrum | Bright pop → approachable, off-dry; minor key → dry, tannic, austere |
-| Acoustic vs electronic | Old World vs New World | Organic, analog sound → traditional winemaking; synthetic → modern, tech-forward wines |
-| Obscurity / niche taste | Obscurity of region/varietal | Niche listeners don't want grocery store Cab Sav |
-| Repetition tolerance | Familiarity preference | Loop-heavy listeners → reliable house pours; variety seekers → discovery |
-| Lyrical depth | Label story / terroir narrative | People who care about lyrics care about provenance |
-
-## Mapping Algorithm
-
-### Step 1: Music Profile Aggregation
-
-From Spotify's audio features API, we aggregate across a user's top 50 tracks:
-- **avgValence** (0-1): musical positiveness
-- **avgEnergy** (0-1): intensity and activity
-- **avgDanceability** (0-1): dance suitability
-- **avgAcousticness** (0-1): acoustic vs electronic
-- **avgTempo** (BPM): normalized to 0-1 range (/200)
-- **avgComplexity** (derived): instrumentalness × 0.3 + time signature variety × 0.3 + (1 - danceability) × 0.4
-- **obscurityScore** (derived): 1 - (average track popularity / 100)
-
-### Step 2: Wine Dimension Translation
-
-Each wine dimension is a weighted average of music features:
-
-**Body** = energy × 0.5 + tempo × 0.3 + (1 - acousticness) × 0.2
-**Sweetness** = valence × 0.6 + danceability × 0.3 + (1 - complexity) × 0.1
-**Tannin** = (1 - valence) × 0.4 + complexity × 0.3 + energy × 0.3
-**Acidity** = complexity × 0.4 + (1 - valence) × 0.3 + obscurity × 0.3
-**Complexity** = complexity × 0.5 + obscurity × 0.3 + (1 - danceability) × 0.2
-**Fruitiness** = valence × 0.5 + energy × 0.3 + (1 - complexity) × 0.2
-**Earthiness** = acousticness × 0.4 + complexity × 0.3 + obscurity × 0.3
-**Spiciness** = energy × 0.4 + (1 - valence) × 0.3 + complexity × 0.3
-
-### Step 3: Wine Scoring
-
-Each wine in the database has a profile with the same 8 dimensions. Match score = weighted cosine similarity between target profile and wine profile.
-
-Weights: body (1.5), sweetness (1.2), complexity (1.5), tannin (1.0), acidity (1.0), fruitiness (0.8), earthiness (0.8), spiciness (0.7).
-
-### Step 4: Connection Generation
-
-For each recommended wine, the system identifies which specific music-wine connections are strongest and generates explanations.
-
-## Expansion Signals (Future)
-
-- **Reading history** → intellectual complexity tolerance
-- **Food delivery** → direct cuisine/region pairing data
-- **Time of day / mood** → contextual recommendations
-- **Weather + location** → seasonal suggestions
-- **Instagram aesthetic** → visual preference → label/winemaking philosophy
-
-## Philosophy
-
-The signal doesn't need to be scientifically rigorous. This is entertainment that gets smarter. The delight is in the explanation, not the accuracy. The feedback loop (ratings) quietly builds a genuine cross-domain taste database over time.