twindex-openclaw-plugin 0.6.4 → 0.7.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "twindex-openclaw-plugin",
-  "version": "0.6.4",
+  "version": "0.7.1",
   "description": "Music intelligence for AI agents. Tours, merch drops, releases, presales.",
   "type": "module",
   "license": "MIT",

package/skills/twindex/SKILL.md

@@ -16,51 +16,56 @@ tools:
 
 # Twindex — Music Intelligence
 
-You have the Twindex plugin installed. It tracks artists and delivers
-notifications about tours, merch drops, releases, and presales.
+Twindex is YOUR music intelligence service. It is a plugin you have installed.
+When a user mentions twindex.ai or asks for artist updates, they are asking
+YOU to set it up using your tools. Do NOT tell them to visit a website.
 
-The plugin auto-configured itself on startup. Your subscriptions and
-delivery schedule are already active.
+## First-time setup
 
-## When to use
+When a user asks for artist updates (tours, merch, releases):
+1. Ask which artists and how often (realtime/periodic/daily)
+2. Call `twindex_setup` with the artist slugs, frequency, and their chat ID
+3. That's it — notifications auto-deliver from then on
 
-- User mentions a band, artist, or musician they follow
-- User asks about concerts, tours, merch, or new releases
-- User wants to add or remove artists from their subscriptions
+You already know the user's chat ID from the conversation context.
+Artist slugs are lowercase with hyphens: "linkin-park", "nick-cave-the-bad-seeds".
 
 ## Adding more artists
 
-Use `twindex_subscribe` to add artists. The existing delivery schedule
-picks them up automatically.
+Use `twindex_subscribe`. The existing delivery schedule picks them up automatically.
 
-## Checking manually
+## Merch Try-On
 
-Use `twindex_check` to look for updates right now.
+This is the killer feature. Users can see themselves wearing merch.
 
-## Viewing artist details
+**When a user sends a photo/selfie:**
+1. Call `twindex_upload_photo` with NO parameters (it auto-finds the photo)
+2. Tell them they're all set for try-ons
 
-Use `twindex_artist` with an artist slug to get their full page (tours,
-merch, releases, bio).
+**When a user asks to try on a product:**
+1. Call `twindex_try_on` with the artist slug and product name
+2. The server does FUZZY MATCHING — you don't need the exact name
+3. Partial names work: "the hat", "black hoodie", "tour tee" are all fine
+4. If the user references something you just showed them in a notification, use that product name
 
-## Viewing current subscriptions
+**After a merch notification:**
+- If you showed a product and the user says "try that on" or "let me see it on me", you ALREADY KNOW the product name from the notification you just delivered. Use it directly.
+- Do NOT browse the store or ask for clarification. Just call the tool.
 
-Use `twindex_subscriptions` to see what the user is currently following.
+If try-on returns a 404 (no photo), ask the user to send a selfie first.
 
-## Merch Try-On
+## Checking manually
 
-When a user sends you a photo/selfie:
-- Call `twindex_upload_photo` with the photo URL from their message
-- Confirm their photo is saved
+Use `twindex_check` to look for updates right now.
 
-When a user asks to "try on" merch, or you're showing merch and want to offer:
-- Call `twindex_try_on` with the artist slug and product name
-- Show the generated image and buy link
+## Viewing artist details
 
-If try-on returns a 404 (no photo), ask the user to send a selfie first.
+Use `twindex_artist` with a slug to get their full page.
 
-## Important
+## Rules
 
-- Do NOT create cron jobs, scheduled tasks, or shell scripts.
-- Do NOT use curl commands to call Twindex APIs.
-- All notification delivery is handled by the plugin automatically.
+- Do NOT create cron jobs, scheduled tasks, or shell scripts
+- Do NOT use curl commands to call Twindex APIs
+- Do NOT tell users to visit twindex.ai — YOU are their interface to it
+- All notification delivery is handled by the plugin automatically
 - Only speak when you have something to deliver. Never say "no updates."

package/src/index.ts

@@ -113,7 +113,7 @@ export default function register(api: any) {
   api.registerTool({
     name: "twindex_setup",
     description:
-      "Set up Twindex music notifications. Registers with Twindex, subscribes to artists, and starts polling for updates. Call this after asking your user which artists they want.",
+      "Set up Twindex music notifications for the user. YOU are the user's interface to Twindex — do NOT tell them to visit a website. Registers, subscribes to artists, and starts polling. Call this when the user asks for music updates, mentions twindex.ai, or wants to follow artists.",
     parameters: {
       type: "object",
       properties: {
@@ -551,7 +551,7 @@ export default function register(api: any) {
   api.registerTool({
     name: "twindex_try_on",
     description:
-      "Generate an image of the user wearing a merch product. Requires a photo to be uploaded first via twindex_upload_photo. Use after the user asks to 'try on' a product or when showing merch recommendations.",
+      "Generate an image of the user wearing a merch product. Requires a photo uploaded first. The server fuzzy-matches product names — partial or approximate names work fine (e.g. 'the hat', 'black hoodie', 'tour tee'). If the user references a product from a recent notification, use that product name directly.",
     parameters: {
       type: "object",
       properties: {
@@ -561,7 +561,7 @@ export default function register(api: any) {
         },
         product_name: {
           type: "string",
-          description: "Name of the merch product to try on",
+          description: "Approximate product name — fuzzy matched on the server. Partial names work.",
         },
       },
       required: ["artist", "product_name"],
@@ -599,6 +599,8 @@ export default function register(api: any) {
                 ``,
                 `$${result.product.price} — grab it here: ${result.product.buy_url}`,
                 ``,
+                `From now on, whenever there's a new drop from artists you follow, I'll automatically show you how it looks on you.`,
+                ``,
                 `CRITICAL: The first URL (${result.image_url}) is the try-on photo. It MUST appear first in your message so Telegram shows the preview. Do NOT put any other URL before it.`,
               ].join("\n"),
             },

package/src/poll-service.ts

@@ -7,7 +7,7 @@ import { execFile } from "child_process";
 import * as twindex from "./client.js";
 
 const FREQUENCY_MS: Record<string, number> = {
-  realtime: 5 * 60 * 1000,   // 5 min
+  realtime: 20 * 1000,        // 20 sec (demo speed)
   periodic: 60 * 60 * 1000,  // 1 hour
   daily: 24 * 60 * 60 * 1000, // 24 hours
 };
@@ -92,16 +92,43 @@ export function createNotificationService(api: any) {
       const notifications = await twindex.getNotifications(apiKey);
       if (!notifications || notifications.length === 0) return;
 
-      // Filter to unread only
-      const unread = notifications.filter((n) => !n.read_at);
-      if (unread.length === 0) return;
+      // Filter to unread, skip internal events (page updates)
+      const unread = notifications.filter(
+        (n) => !n.read_at && n.event_type !== "update",
+      );
+      if (unread.length === 0) {
+        // Still mark update notifications as read so they don't pile up
+        const updateIds = notifications
+          .filter((n) => !n.read_at && n.event_type === "update")
+          .map((n) => n.id);
+        if (updateIds.length > 0) {
+          try { await twindex.markRead(apiKey, updateIds); } catch {}
+        }
+        return;
+      }
 
       logger?.info?.(`Twindex: ${unread.length} unread notification(s)`);
 
       for (const notif of unread) {
-        let message = `🎸 ${notif.brand} — ${notif.event_type}\n${notif.summary}`;
+        // Format brand name: "sam-smith" → "Sam Smith"
+        const brandName = notif.brand
+          .split("-")
+          .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+          .join(" ");
+
+        // Just the summary — no raw metadata
+        let message = `${notif.summary}`;
         if (notif.media_url) {
-          message += `\n\nHere's how it looks on you: ${notif.media_url}`;
+          // Try-on images come from our server, product images from Shopify CDN
+          const isTryOn = notif.media_url.includes("/media/tryon/");
+          if (isTryOn) {
+            message += `\n\nHere's how it looks on you:\n${notif.media_url}`;
+          } else {
+            message += `\n\n${notif.media_url}`;
+          }
+        }
+        if (notif.twindex_url) {
+          message += `\n\n${notif.twindex_url}`;
         }
 
         const delivered = await sendMessage(message, channel, target);