twindex-openclaw-plugin 0.5.6 → 0.6.0

package/package.json

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

package/skills/twindex/SKILL.md

@@ -10,6 +10,8 @@ tools:
   - twindex_artist
   - twindex_search
   - twindex_artists
+  - twindex_upload_photo
+  - twindex_try_on
 ---
 
 # Twindex — Music Intelligence
@@ -44,6 +46,18 @@ merch, releases, bio).
 
 Use `twindex_subscriptions` to see what the user is currently following.
 
+## Merch Try-On
+
+When a user sends you a photo/selfie:
+- Call `twindex_upload_photo` with the photo URL from their message
+- Confirm their photo is saved
+
+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
+
+If try-on returns a 404 (no photo), ask the user to send a selfie first.
+
 ## Important
 
 - Do NOT create cron jobs, scheduled tasks, or shell scripts.

package/src/client.ts

@@ -21,6 +21,7 @@ interface Notification {
   summary: string;
   twindex_url?: string;
   detail_url?: string;
+  media_url?: string;
   created_at: string;
   read_at?: string | null;
 }
@@ -166,3 +167,33 @@ export async function getArtist(slug: string): Promise<string> {
   }
   return res.text();
 }
+
+interface TryOnResult {
+  image_url: string;
+  product: { title: string; price: string; buy_url: string };
+}
+
+/** Upload a selfie for personalized merch try-on. */
+export async function uploadPhoto(
+  apiKey: string,
+  photoUrl: string,
+): Promise<void> {
+  await request("/api/v1/me/photo", {
+    method: "POST",
+    headers: authHeader(apiKey),
+    body: JSON.stringify({ photo_url: photoUrl }),
+  });
+}
+
+/** Generate an image of the user wearing merch. */
+export async function tryOn(
+  apiKey: string,
+  artist: string,
+  productName: string,
+): Promise<TryOnResult> {
+  return request("/api/v1/try-on", {
+    method: "POST",
+    headers: authHeader(apiKey),
+    body: JSON.stringify({ artist, product_name: productName }),
+  });
+}

package/src/index.ts

@@ -419,6 +419,113 @@ export default function register(api: any) {
     },
   });
 
+  api.registerTool({
+    name: "twindex_upload_photo",
+    description:
+      "Upload the user's photo for personalized merch try-on. The user sends a selfie in chat, and you pass the photo URL here. One photo per user — uploading replaces the previous one.",
+    parameters: {
+      type: "object",
+      properties: {
+        photo_url: {
+          type: "string",
+          description:
+            "URL of the user's photo (from the media attachment in their message)",
+        },
+      },
+      required: ["photo_url"],
+    },
+    async execute(_id: string, params: { photo_url: string }) {
+      const apiKey = cfg().apiKey;
+      if (!apiKey) {
+        return {
+          content: [
+            { type: "text", text: "Not set up yet. Use twindex_setup first." },
+          ],
+        };
+      }
+
+      try {
+        await twindex.uploadPhoto(apiKey, params.photo_url);
+        return {
+          content: [
+            {
+              type: "text",
+              text: "Photo saved! I can now show you how merch looks on you.",
+            },
+          ],
+        };
+      } catch (err: any) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Failed to upload photo: ${err.message}`,
+            },
+          ],
+        };
+      }
+    },
+  });
+
+  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.",
+    parameters: {
+      type: "object",
+      properties: {
+        artist: {
+          type: "string",
+          description: "Artist slug (lowercase, hyphens). Example: metallica",
+        },
+        product_name: {
+          type: "string",
+          description: "Name of the merch product to try on",
+        },
+      },
+      required: ["artist", "product_name"],
+    },
+    async execute(
+      _id: string,
+      params: { artist: string; product_name: string },
+    ) {
+      const apiKey = cfg().apiKey;
+      if (!apiKey) {
+        return {
+          content: [
+            { type: "text", text: "Not set up yet. Use twindex_setup first." },
+          ],
+        };
+      }
+
+      try {
+        const result = await twindex.tryOn(
+          apiKey,
+          params.artist,
+          params.product_name,
+        );
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Here's you in the ${result.product.title} ($${result.product.price})!\nBuy it: ${result.product.buy_url}`,
+            },
+            { type: "image", url: result.image_url },
+          ],
+        };
+      } catch (err: any) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Failed to generate try-on: ${err.message}`,
+            },
+          ],
+        };
+      }
+    },
+  });
+
   api.registerTool({
     name: "twindex_artists",
     description: "List all artists currently indexed on Twindex.",

package/src/poll-service.ts

@@ -83,8 +83,10 @@ export function createNotificationService(api: any) {
       logger?.info?.(`Twindex: ${unread.length} unread notification(s)`);
 
       for (const notif of unread) {
-        const message =
-          `🎸 ${notif.brand} — ${notif.event_type}\n${notif.summary}`;
+        let message = `🎸 ${notif.brand} — ${notif.event_type}\n${notif.summary}`;
+        if (notif.media_url) {
+          message += `\n\nHere's how it looks on you: ${notif.media_url}`;
+        }
 
         const delivered = await sendMessage(message, channel, target);
         if (delivered) {