twindex-openclaw-plugin 0.5.6 → 0.6.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "twindex-openclaw-plugin",
-  "version": "0.5.6",
+  "version": "0.6.1",
   "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

@@ -36,6 +36,32 @@ export default function register(api: any) {
   const pollService = createNotificationService(api);
   api.registerService?.(pollService);
 
+  // ── Auto-detect chatTarget from Telegram channel config ─────────
+  function inferChatTarget(): string | undefined {
+    const config = cfg();
+    if (config.chatTarget) return config.chatTarget;
+
+    // Infer from Telegram allowFrom list (first allowed chat ID)
+    const telegramAllow = api.config?.channels?.telegram?.allowFrom;
+    if (Array.isArray(telegramAllow) && telegramAllow.length > 0) {
+      return String(telegramAllow[0]);
+    }
+
+    // Infer from Slack channel config
+    const slackChannel = api.config?.channels?.slack?.channel;
+    if (slackChannel) return slackChannel;
+
+    return undefined;
+  }
+
+  function inferChatChannel(): string {
+    const config = cfg();
+    if (config.chatChannel) return config.chatChannel;
+    if (api.config?.channels?.telegram?.allowFrom?.length > 0) return "telegram";
+    if (api.config?.channels?.slack?.channel) return "slack";
+    return "telegram";
+  }
+
   // ── Auto-bootstrap: register + subscribe ────────────────────────
 
   (async () => {
@@ -60,7 +86,16 @@ export default function register(api: any) {
           }
         }
 
-        persistConfig({ apiKey });
+        // Auto-detect chatTarget from channel config if not explicitly set
+        const updates: Record<string, any> = { apiKey };
+        const chatTarget = inferChatTarget();
+        if (chatTarget) {
+          updates.chatTarget = chatTarget;
+          updates.chatChannel = inferChatChannel();
+          api.logger?.info?.(`Twindex: auto-detected chatTarget=${chatTarget}`);
+        }
+
+        persistConfig(updates);
         pollService.start();
         api.logger?.info?.(
           "Twindex: auto-bootstrap complete. Delivery via polling.",
@@ -419,6 +454,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

@@ -42,10 +42,19 @@ export function createNotificationService(api: any) {
 
   function getChatTarget(): string | undefined {
     const raw = api.config?.plugins?.entries?.twindex?.config?.chatTarget;
-    if (!raw) return undefined;
-    // Strip channel prefix if agent included it (e.g. "telegram:123" → "123")
-    const colonIdx = raw.indexOf(":");
-    return colonIdx >= 0 ? raw.slice(colonIdx + 1) : raw;
+    if (raw) {
+      // Strip channel prefix if agent included it (e.g. "telegram:123" → "123")
+      const colonIdx = raw.indexOf(":");
+      return colonIdx >= 0 ? raw.slice(colonIdx + 1) : raw;
+    }
+
+    // Fallback: infer from Telegram allowFrom
+    const telegramAllow = api.config?.channels?.telegram?.allowFrom;
+    if (Array.isArray(telegramAllow) && telegramAllow.length > 0) {
+      return String(telegramAllow[0]);
+    }
+
+    return undefined;
   }
 
   function getChatChannel(): string {
@@ -53,7 +62,14 @@ export function createNotificationService(api: any) {
     // Infer channel from prefix if present (e.g. "telegram:123" → "telegram")
     const colonIdx = raw.indexOf(":");
     if (colonIdx > 0) return raw.slice(0, colonIdx);
-    return api.config?.plugins?.entries?.twindex?.config?.chatChannel ?? "telegram";
+
+    const explicit = api.config?.plugins?.entries?.twindex?.config?.chatChannel;
+    if (explicit) return explicit;
+
+    // Fallback: infer from which channel is configured
+    if (api.config?.channels?.telegram?.allowFrom?.length > 0) return "telegram";
+    if (api.config?.channels?.slack?.channel) return "slack";
+    return "telegram";
   }
 
   const logger = api.logger;
@@ -83,8 +99,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) {