teleton 0.1.0

package/dist/chunk-XBGUNXF2.js

@@ -0,0 +1,176 @@
+// src/agent/tools/telegram/gifts/get-my-gifts.ts
+import { Type } from "@sinclair/typebox";
+import { Api } from "telegram";
+function extractEmoji(sticker) {
+  if (!sticker?.attributes) return null;
+  const attr = sticker.attributes.find(
+    (a) => a.className === "DocumentAttributeSticker" || a.className === "DocumentAttributeCustomEmoji"
+  );
+  return attr?.alt || null;
+}
+var telegramGetMyGiftsTool = {
+  name: "telegram_get_my_gifts",
+  description: `Get Star Gifts you or another user has received.
+
+USAGE:
+- To view YOUR OWN gifts: omit both userId and viewSender
+- To view the SENDER's gifts (when user says "show me MY gifts"): set viewSender=true
+- To view a specific user's gifts: pass their userId
+
+PRESENTATION GUIDE:
+- For collectibles: Use "title + model" as display name (e.g., "Hypno Lollipop Telegram")
+- NFT link: t.me/nft/{slug} (e.g., t.me/nft/HypnoLollipop-63414)
+- Respond concisely: "You have a Hypno Lollipop Telegram \u{1F36D}"
+- Only give details (rarity, backdrop, pattern) when specifically asked
+- attributes.model.name = model, attributes.pattern.name = pattern, attributes.backdrop.name = backdrop
+- rarityPermille: divide by 10 to get percentage (7 = 0.7%)
+
+TRANSFER: Use msgId (for your own gifts) to transfer collectibles via telegram_transfer_collectible.
+
+NEVER dump all raw data. Keep responses natural and concise.`,
+  parameters: Type.Object({
+    userId: Type.Optional(
+      Type.String({
+        description: "User ID to get gifts for. Use viewSender=true instead if looking at the message sender's gifts."
+      })
+    ),
+    viewSender: Type.Optional(
+      Type.Boolean({
+        description: "Set to true to view the message sender's gifts (when user says 'show me MY gifts'). Takes precedence over userId."
+      })
+    ),
+    limit: Type.Optional(
+      Type.Number({
+        description: "Maximum number of gifts to return (default: 50)",
+        minimum: 1,
+        maximum: 200
+      })
+    ),
+    excludeUnsaved: Type.Optional(
+      Type.Boolean({
+        description: "Only show gifts saved/displayed on profile"
+      })
+    ),
+    excludeSaved: Type.Optional(
+      Type.Boolean({
+        description: "Only show gifts NOT displayed on profile"
+      })
+    ),
+    sortByValue: Type.Optional(
+      Type.Boolean({
+        description: "Sort by value instead of date. Default: false (sorted by date)"
+      })
+    )
+  })
+};
+var telegramGetMyGiftsExecutor = async (params, context) => {
+  try {
+    const { userId, viewSender, limit = 50, excludeUnsaved, excludeSaved, sortByValue = false } = params;
+    const gramJsClient = context.bridge.getClient().getClient();
+    const targetUserId = viewSender ? context.senderId.toString() : userId;
+    const peer = targetUserId ? await gramJsClient.getEntity(targetUserId) : new Api.InputPeerSelf();
+    const catalog = await gramJsClient.invoke(
+      new Api.payments.GetStarGifts({ hash: 0 })
+    );
+    const catalogMap = /* @__PURE__ */ new Map();
+    for (const catalogGift of catalog.gifts || []) {
+      const id = catalogGift.id?.toString();
+      if (id) {
+        catalogMap.set(id, {
+          limited: catalogGift.limited || false,
+          soldOut: catalogGift.soldOut || false,
+          emoji: extractEmoji(catalogGift.sticker),
+          availabilityTotal: catalogGift.availabilityTotal,
+          availabilityRemains: catalogGift.availabilityRemains
+        });
+      }
+    }
+    const result = await gramJsClient.invoke(
+      new Api.payments.GetSavedStarGifts({
+        peer,
+        offset: "",
+        limit,
+        excludeUnsaved,
+        excludeSaved,
+        sortByValue
+      })
+    );
+    const gifts = (result.gifts || []).map((savedGift) => {
+      const gift = savedGift.gift;
+      const isCollectible = gift?.className === "StarGiftUnique";
+      const lookupId = isCollectible ? gift.giftId?.toString() : gift.id?.toString();
+      const catalogInfo = catalogMap.get(lookupId);
+      const isLimited = isCollectible || catalogInfo?.limited === true;
+      const extractAttrSummary = (attr) => attr ? {
+        name: attr.name,
+        rarityPercent: attr.rarityPermille ? (attr.rarityPermille / 10).toFixed(1) + "%" : null
+      } : null;
+      const compactGift = {
+        date: savedGift.date,
+        isLimited,
+        isCollectible,
+        stars: gift?.stars?.toString(),
+        emoji: catalogInfo?.emoji || null,
+        // IDs needed for transfer/actions (msgId for user gifts, savedId for chat gifts)
+        msgId: savedGift.msgId,
+        savedId: savedGift.savedId?.toString(),
+        // Transfer cost in Stars (if set, transfer requires payment; if null, transfer is free)
+        transferStars: savedGift.transferStars?.toString() || null
+      };
+      if (isCollectible) {
+        compactGift.collectibleId = gift.id?.toString();
+        compactGift.title = gift.title;
+        compactGift.num = gift.num;
+        compactGift.slug = gift.slug;
+        compactGift.nftLink = `t.me/nft/${gift.slug}`;
+        const modelAttr = gift.attributes?.find((a) => a.className === "StarGiftAttributeModel");
+        const patternAttr = gift.attributes?.find((a) => a.className === "StarGiftAttributePattern");
+        const backdropAttr = gift.attributes?.find((a) => a.className === "StarGiftAttributeBackdrop");
+        compactGift.model = extractAttrSummary(modelAttr);
+        compactGift.pattern = extractAttrSummary(patternAttr);
+        compactGift.backdrop = extractAttrSummary(backdropAttr);
+      } else {
+        compactGift.canUpgrade = savedGift.canUpgrade || false;
+        if (savedGift.canUpgrade) {
+          compactGift.upgradeStars = gift?.upgradeStars?.toString();
+        }
+      }
+      if (isLimited && !isCollectible) {
+        compactGift.availabilityRemains = catalogInfo?.availabilityRemains || gift?.availabilityRemains;
+        compactGift.availabilityTotal = catalogInfo?.availabilityTotal || gift?.availabilityTotal;
+      }
+      return compactGift;
+    });
+    const limited = gifts.filter((g) => g.isLimited);
+    const unlimited = gifts.filter((g) => !g.isLimited);
+    const collectibles = gifts.filter((g) => g.isCollectible);
+    const viewingLabel = viewSender ? `sender (${context.senderId})` : userId || "self";
+    console.log(`\u{1F4E6} get_my_gifts: viewing ${viewingLabel}, found ${gifts.length} gifts (${collectibles.length} collectibles)`);
+    return {
+      success: true,
+      data: {
+        viewingUser: targetUserId || "self",
+        gifts,
+        summary: {
+          total: gifts.length,
+          limited: limited.length,
+          unlimited: unlimited.length,
+          collectibles: collectibles.length,
+          canUpgrade: gifts.filter((g) => g.canUpgrade).length
+        },
+        totalCount: result.count
+      }
+    };
+  } catch (error) {
+    console.error("Error getting gifts:", error);
+    return {
+      success: false,
+      error: error instanceof Error ? error.message : String(error)
+    };
+  }
+};
+
+export {
+  telegramGetMyGiftsTool,
+  telegramGetMyGiftsExecutor
+};