@hyperspell/openclaw-hyperspell 0.5.0 → 0.7.2

package/README.md

@@ -149,11 +149,135 @@ This ensures the AI always has access to relevant information from your connecte
 
 ## Available Sources
 
+### Documents & Storage
 - `vault` - User-created or synced memories
 - `notion` - Notion pages and databases
-- `slack` - Slack messages
-- `google_calendar` - Google Calendar events
-- `google_mail` - Gmail messages
 - `google_drive` - Google Drive files
 - `box` - Box files
+- `dropbox` - Dropbox files
+- `onedrive` - Microsoft OneDrive files
+
+### Communication
+- `slack` - Slack messages
+- `google_mail` - Gmail messages
+
+### Calendars & Meetings
+- `google_calendar` - Google Calendar events
+- `zoom` - Zoom meeting recordings and transcripts
+- `fathom` - Fathom meeting recordings
+- `fireflies` - Fireflies.ai meeting transcripts
+
+### Project Management
+- `linear` - Linear issues and comments
+
+### CRM
+- `hubspot` - HubSpot contacts, companies, and deals
+- `attio` - Attio CRM contacts, companies, and deals
+
+### Developer Tools
+- `github` - GitHub repositories and commits
+
+### Other
 - `web_crawler` - Crawled web pages
+
+## Knowledge Graph
+
+The plugin can automatically build a local knowledge graph from your memories:
+
+1. **Scan** memories for entities (people, organizations, projects, topics)
+2. **Extract** structured information and relationships
+3. **Write** entity files to `memory/people/`, `memory/organizations/`, etc.
+4. **Link** entities via markdown relationship references
+
+Enable the graph tools by using `hyperspell_network_scan`, `hyperspell_network_write`, and `hyperspell_network_complete` in your agent workflows.
+
+---
+
+## 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"
+- Check that your sources are connected: `openclaw openclaw-hyperspell status`
+- Verify your API key is set: `echo $HYPERSPELL_API_KEY`
+- Make sure content has been indexed (initial sync can take a few minutes)
+
+### Memory sync not working
+- Ensure `syncMemories: true` in your config
+- Check that markdown files are in `~/.openclaw/workspace/memory/`
+- Run `/sync` manually to trigger a sync and see any errors
+
+### Auto-context not injecting
+- Verify `autoContext: true` in your config
+- Enable `debug: true` to see what queries are being made
+- Check that you have memories matching your conversation topics
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and guidelines.
+
+## License
+
+MIT