npm - @hyperspell/openclaw-hyperspell - Versions diffs - 0.5.0 → 0.7.2 - Mend

@hyperspell/openclaw-hyperspell 0.5.0 → 0.7.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (22) hide show

package/README.md +127 -3
package/client.ts +311 -241
package/commands/setup.ts +8 -54
package/commands/wine.ts +164 -0
package/config.ts +242 -175
package/hooks/auto-context.ts +17 -11
package/hooks/auto-trace.ts +127 -0
package/index.ts +122 -100
package/lib/browser.ts +10 -6
package/lib/run-script.ts +32 -0
package/openclaw.plugin.json +110 -87
package/package.json +8 -4
package/sommeliagent/references/cross-domain-mappings.md +63 -0
package/sommeliagent/scripts/auth.py +222 -0
package/sommeliagent/scripts/history.py +72 -0
package/sommeliagent/scripts/rate.py +76 -0
package/sommeliagent/scripts/recommend.py +777 -0
package/sommeliagent/scripts/test_recommend.py +459 -0
package/sommeliagent/scripts/wine_db.py +3224 -0
package/tools/remember.ts +6 -2
package/tools/search.ts +9 -3
package/tools/sommelier.ts +254 -0

package/sommeliagent/scripts/auth.py ADDED Viewed

@@ -0,0 +1,222 @@
+# /// script
+# requires-python = ">=3.11"
+# dependencies = ["httpx"]
+# ///
+"""
+Spotify OAuth flow for SommeliAgent.
+Opens browser, runs local callback server, saves token.
+"""
+import html
+import http.server
+import json
+import os
+import secrets
+import stat
+import sys
+import threading
+import urllib.parse
+import webbrowser
+from pathlib import Path
+import httpx
+CONFIG_DIR = Path.home() / ".sommeliagent"
+TOKEN_FILE = CONFIG_DIR / "token.json"
+REDIRECT_URI = "http://localhost:8888/callback"
+SCOPES = "user-top-read user-read-recently-played"
+def get_credentials() -> tuple[str, str]:
+    client_id = os.environ.get("SPOTIFY_CLIENT_ID", "")
+    client_secret = os.environ.get("SPOTIFY_CLIENT_SECRET", "")
+    if not client_id or not client_secret:
+        print("Error: SPOTIFY_CLIENT_ID and SPOTIFY_CLIENT_SECRET must be set.", file=sys.stderr)
+        print("Get them from https://developer.spotify.com/dashboard", file=sys.stderr)
+        sys.exit(1)
+    return client_id, client_secret
+def save_token(token_data: dict) -> None:
+    CONFIG_DIR.mkdir(parents=True, exist_ok=True)
+    tmp = TOKEN_FILE.with_suffix(".tmp")
+    tmp.write_text(json.dumps(token_data, indent=2))
+    tmp.chmod(stat.S_IRUSR | stat.S_IWUSR)  # 600 — owner only
+    tmp.replace(TOKEN_FILE)
+    print(f"Token saved to {TOKEN_FILE}")
+def load_token() -> dict | None:
+    if TOKEN_FILE.exists():
+        return json.loads(TOKEN_FILE.read_text())
+    return None
+def refresh_access_token(refresh_token: str, client_id: str, client_secret: str) -> dict:
+    resp = httpx.post(
+        "https://accounts.spotify.com/api/token",
+        data={
+            "grant_type": "refresh_token",
+            "refresh_token": refresh_token,
+            "client_id": client_id,
+            "client_secret": client_secret,
+        },
+    )
+    resp.raise_for_status()
+    data = resp.json()
+    if "refresh_token" not in data:
+        data["refresh_token"] = refresh_token
+    return data
+def get_access_token() -> str | None:
+    """Get a valid access token, refreshing if needed. Returns None if unavailable."""
+    import time as _time
+    token_data = load_token()
+    if token_data and "refresh_token" in token_data:
+        # Return existing token if it hasn't expired yet
+        expires_at = token_data.get("expires_at", 0)
+        if expires_at and _time.time() < expires_at and token_data.get("access_token"):
+            return token_data["access_token"]
+        # Need to refresh — now we need credentials
+        client_id, client_secret = get_credentials()
+        try:
+            refreshed = refresh_access_token(
+                token_data["refresh_token"], client_id, client_secret
+            )
+            expires_in = refreshed.get("expires_in", 3600)
+            refreshed["expires_at"] = _time.time() + expires_in
+            save_token(refreshed)
+            return refreshed["access_token"]
+        except Exception as e:
+            print(f"Token refresh failed: {e}", file=sys.stderr)
+    return None
+def _make_callback_handler(expected_state: str):
+    """Create a callback handler that validates the OAuth state parameter."""
+    class CallbackHandler(http.server.BaseHTTPRequestHandler):
+        auth_code: str | None = None
+        error: str | None = None
+        def do_GET(self):
+            query = urllib.parse.urlparse(self.path).query
+            params = urllib.parse.parse_qs(query)
+            # Validate state to prevent CSRF
+            received_state = params.get("state", [None])[0]
+            if received_state != expected_state:
+                self.send_response(400)
+                self.send_header("Content-Type", "text/html")
+                self.end_headers()
+                self.wfile.write(b"<html><body><h1>Invalid state parameter</h1></body></html>")
+                return
+            if "code" in params:
+                CallbackHandler.auth_code = params["code"][0]
+                self.send_response(200)
+                self.send_header("Content-Type", "text/html")
+                self.end_headers()
+                self.wfile.write(
+                    b"<html><body><h1>SommeliAgent connected!</h1>"
+                    b"<p>You can close this tab and return to your terminal.</p></body></html>"
+                )
+            elif "error" in params:
+                CallbackHandler.error = params["error"][0]
+                self.send_response(400)
+                self.send_header("Content-Type", "text/html")
+                self.end_headers()
+                safe_error = html.escape(params["error"][0])
+                self.wfile.write(f"<html><body><h1>Error: {safe_error}</h1></body></html>".encode())
+            else:
+                self.send_response(400)
+                self.end_headers()
+        def log_message(self, format, *args):
+            pass
+    return CallbackHandler
+def run_oauth_flow() -> None:
+    client_id, client_secret = get_credentials()
+    state = secrets.token_urlsafe(16)
+    auth_url = (
+        "https://accounts.spotify.com/authorize?"
+        + urllib.parse.urlencode(
+            {
+                "response_type": "code",
+                "client_id": client_id,
+                "scope": SCOPES,
+                "redirect_uri": REDIRECT_URI,
+                "state": state,
+            }
+        )
+    )
+    handler_class = _make_callback_handler(state)
+    try:
+        server = http.server.HTTPServer(("localhost", 8888), handler_class)
+    except OSError as e:
+        print(f"Error: Could not start callback server on port 8888: {e}", file=sys.stderr)
+        print("Make sure nothing else is using that port.", file=sys.stderr)
+        sys.exit(1)
+    # Handle up to 3 requests (in case of preflight/favicon/etc hitting first)
+    def serve():
+        for _ in range(3):
+            server.handle_request()
+            if handler_class.auth_code or handler_class.error:
+                break
+    server_thread = threading.Thread(target=serve, daemon=True)
+    server_thread.start()
+    print("Opening Spotify authorization in your browser...")
+    print(f"If it doesn't open, visit: {auth_url}")
+    webbrowser.open(auth_url)
+    server_thread.join(timeout=120)
+    server.server_close()
+    if handler_class.error:
+        print(f"Error: Spotify returned: {handler_class.error}", file=sys.stderr)
+        sys.exit(1)
+    if not handler_class.auth_code:
+        print("Error: No authorization code received (timed out after 120s).", file=sys.stderr)
+        sys.exit(1)
+    # Exchange code for token
+    resp = httpx.post(
+        "https://accounts.spotify.com/api/token",
+        data={
+            "grant_type": "authorization_code",
+            "code": handler_class.auth_code,
+            "redirect_uri": REDIRECT_URI,
+            "client_id": client_id,
+            "client_secret": client_secret,
+        },
+    )
+    resp.raise_for_status()
+    token_data = resp.json()
+    import time as _time
+    token_data["expires_at"] = _time.time() + token_data.get("expires_in", 3600)
+    save_token(token_data)
+    print("Spotify connected successfully!")
+if __name__ == "__main__":
+    token = get_access_token()
+    if token:
+        print("Already authenticated. Token refreshed successfully.")
+        print(f"Token file: {TOKEN_FILE}")
+    else:
+        run_oauth_flow()

package/sommeliagent/scripts/history.py ADDED Viewed

@@ -0,0 +1,72 @@
+# /// script
+# requires-python = ">=3.11"
+# dependencies = []
+# ///
+"""
+View SommeliAgent recommendation history and ratings.
+"""
+import json
+import sys
+from pathlib import Path
+CONFIG_DIR = Path.home() / ".sommeliagent"
+RATINGS_FILE = CONFIG_DIR / "ratings.json"
+def main():
+    if not RATINGS_FILE.exists():
+        print("No ratings yet. Try some wines and rate them!")
+        sys.exit(0)
+    try:
+        ratings = json.loads(RATINGS_FILE.read_text())
+    except (json.JSONDecodeError, OSError) as e:
+        print(f"Error reading ratings file: {e}", file=sys.stderr)
+        print(f"You can delete {RATINGS_FILE} to reset.", file=sys.stderr)
+        sys.exit(1)
+    if not ratings:
+        print("No ratings yet. Try some wines and rate them!")
+        sys.exit(0)
+    print(f"SommeliAgent — Rating History ({len(ratings)} wines rated)")
+    print("=" * 50)
+    print()
+    label = {1: "hated it", 2: "not great", 3: "okay", 4: "liked it", 5: "loved it"}
+    for i, entry in enumerate(ratings, 1):
+        wine_id = entry.get("wine_id", "unknown")
+        rating = max(1, min(5, entry.get("rating", 3)))
+        stars = "★" * rating + "☆" * (5 - rating)
+        print(f"{i}. {wine_id}")
+        print(f"   {stars} ({label.get(rating, 'unknown')})")
+        if entry.get("notes"):
+            print(f"   \"{entry['notes']}\"")
+        if entry.get("timestamp"):
+            print(f"   Rated: {entry['timestamp'][:10]}")
+        print()
+    # Summary stats
+    avg = sum(r.get("rating", 3) for r in ratings) / len(ratings)
+    loved = sum(1 for r in ratings if r.get("rating", 3) >= 4)
+    print(f"Average rating: {avg:.1f}/5")
+    print(f"Wines you loved: {loved}/{len(ratings)}")
+    # Tag preferences
+    tag_scores: dict[str, list[int]] = {}
+    for r in ratings:
+        for tag in r.get("tags", []):
+            tag_scores.setdefault(tag, []).append(r.get("rating", 3))
+    if tag_scores:
+        print("\nYour taste profile (from ratings):")
+        sorted_tags = sorted(tag_scores.items(), key=lambda x: -sum(x[1]) / len(x[1]))
+        for tag, scores in sorted_tags[:8]:
+            avg_tag = sum(scores) / len(scores)
+            bar = "★" * round(avg_tag) + "☆" * (5 - round(avg_tag))
+            print(f"  {tag:<20} {bar} ({avg_tag:.1f} avg, {len(scores)} wines)")
+if __name__ == "__main__":
+    main()

package/sommeliagent/scripts/rate.py ADDED Viewed

@@ -0,0 +1,76 @@
+# /// script
+# requires-python = ">=3.11"
+# dependencies = []
+# ///
+"""
+Rate a wine recommendation to improve future suggestions.
+"""
+import argparse
+import json
+import sys
+from datetime import datetime, timezone
+from pathlib import Path
+from wine_db import WINE_DB
+CONFIG_DIR = Path.home() / ".sommeliagent"
+RATINGS_FILE = CONFIG_DIR / "ratings.json"
+# Wine ID → tags mapping (derived from wine_db)
+WINE_TAGS = {w.id: w.tags for w in WINE_DB}
+def load_ratings() -> list[dict]:
+    if RATINGS_FILE.exists():
+        try:
+            return json.loads(RATINGS_FILE.read_text())
+        except (OSError, json.JSONDecodeError) as e:
+            print(f"Warning: could not read {RATINGS_FILE}: {e}", file=sys.stderr)
+            return []
+    return []
+def save_ratings(ratings: list[dict]) -> None:
+    import stat
+    CONFIG_DIR.mkdir(parents=True, exist_ok=True)
+    tmp = RATINGS_FILE.with_suffix(".tmp")
+    tmp.write_text(json.dumps(ratings, indent=2))
+    tmp.chmod(stat.S_IRUSR | stat.S_IWUSR)
+    tmp.replace(RATINGS_FILE)
+def main():
+    parser = argparse.ArgumentParser(description="Rate a wine recommendation")
+    parser.add_argument("--wine-id", required=True, help="Wine ID from recommendation")
+    parser.add_argument("--rating", type=int, required=True, choices=[1, 2, 3, 4, 5], help="Rating 1-5")
+    parser.add_argument("--notes", default="", help="Optional tasting notes")
+    args = parser.parse_args()
+    tags = WINE_TAGS.get(args.wine_id)
+    if tags is None:
+        valid_ids = ", ".join(sorted(WINE_TAGS.keys()))
+        print(f"Error: Unknown wine ID '{args.wine_id}'.", file=sys.stderr)
+        print(f"Valid IDs: {valid_ids}", file=sys.stderr)
+        sys.exit(1)
+    ratings = load_ratings()
+    ratings.append({
+        "wine_id": args.wine_id,
+        "rating": args.rating,
+        "notes": args.notes,
+        "tags": tags,
+        "timestamp": datetime.now(timezone.utc).isoformat(),
+    })
+    save_ratings(ratings)
+    label = {1: "hated it", 2: "not great", 3: "okay", 4: "liked it", 5: "loved it"}
+    print(f"Rated {args.wine_id}: {args.rating}/5 ({label[args.rating]})")
+    if args.notes:
+        print(f"Notes: \"{args.notes}\"")
+    print(f"Total ratings: {len(ratings)}")
+    print("Future recommendations will factor this in.")
+if __name__ == "__main__":
+    main()