@dimcool/mcp 0.1.14 → 0.1.17

package/dist/index.js

@@ -25146,6 +25146,8 @@ var DimClient = class {
   config;
   authenticated = false;
   userId = null;
+  eventQueue = [];
+  unsubscribers = [];
   constructor(config) {
     this.config = config;
     const secretKeyBytes = bs58.decode(config.walletPrivateKey);
@@ -25208,6 +25210,39 @@ var DimClient = class {
   async ensureConnected(timeoutMs = 1e4) {
     await this.sdk.ensureWebSocketConnected(timeoutMs);
   }
+  /**
+   * Subscribe to key WS events and buffer them for agent consumption.
+   * Call after authenticate() when the WS transport is connected.
+   */
+  startEventListeners() {
+    const events = [
+      "chat:message",
+      "notification",
+      "lobby:matched",
+      "lobby:invitation",
+      "game:turn",
+      "game:completed"
+    ];
+    for (const event of events) {
+      this.unsubscribers.push(
+        this.sdk.events.subscribe(event, (payload) => {
+          this.eventQueue.push({
+            event,
+            payload,
+            at: (/* @__PURE__ */ new Date()).toISOString()
+          });
+        })
+      );
+    }
+  }
+  /** Drain all buffered events since last call. */
+  drainEvents() {
+    return this.eventQueue.splice(0);
+  }
+  /** Peek at buffered event count without draining. */
+  get pendingEventCount() {
+    return this.eventQueue.length;
+  }
   /**
    * Get the Keypair for transaction signing.
    */
@@ -25226,6 +25261,7 @@ function registerAuthTools(server2, client) {
     async () => {
       try {
         const result = await client.authenticate();
+        client.startEventListeners();
         const nextSteps = [];
         if (result.username == null || result.username === "") {
           nextSteps.push(
@@ -26805,6 +26841,105 @@ function registerMarketTools(server2, client) {
   );
 }
 
+// src/tools/notifications.ts
+function registerNotificationsTools(server2, client) {
+  server2.tool(
+    "dim_get_pending_events",
+    "Drain buffered real-time events (DMs, challenges, game turns, match notifications). Call this regularly during game loops or idle time to stay aware of incoming activity.",
+    {},
+    async () => {
+      try {
+        const events = client.drainEvents();
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(
+                {
+                  count: events.length,
+                  events,
+                  hint: events.length === 0 ? "No new events since last check." : "Process these events and take action as needed."
+                },
+                null,
+                2
+              )
+            }
+          ]
+        };
+      } catch (error) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Failed to get pending events: ${error instanceof Error ? error.message : String(error)}`
+            }
+          ],
+          isError: true
+        };
+      }
+    }
+  );
+  server2.tool(
+    "dim_check_notifications",
+    "Check all pending items in one call: unread notifications (challenges, game results), unread DM threads, and incoming friend requests. Use this to catch up after being idle.",
+    {},
+    async () => {
+      try {
+        if (!client.isAuthenticated) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: "Not authenticated. Call dim_login first."
+              }
+            ],
+            isError: true
+          };
+        }
+        const [notifications, dmThreads, friendRequests] = await Promise.all([
+          client.sdk.notifications.list({ page: 1, limit: 20 }),
+          client.sdk.chat.listDmThreads(),
+          client.sdk.users.getIncomingFriendRequests()
+        ]);
+        const unreadDms = dmThreads.filter(
+          (t) => (t.unreadCount ?? 0) > 0
+        );
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(
+                {
+                  unreadNotificationCount: notifications.unreadCount,
+                  notifications: notifications.notifications.filter(
+                    (n) => !n.read
+                  ),
+                  unreadDmThreads: unreadDms,
+                  incomingFriendRequests: friendRequests,
+                  pendingWsEvents: client.pendingEventCount,
+                  hint: "Use dim_get_pending_events to drain buffered real-time events."
+                },
+                null,
+                2
+              )
+            }
+          ]
+        };
+      } catch (error) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Failed to check notifications: ${error instanceof Error ? error.message : String(error)}`
+            }
+          ],
+          isError: true
+        };
+      }
+    }
+  );
+}
+
 // src/tools/instructions.ts
 var DIM_INSTRUCTIONS = [
   {
@@ -26937,7 +27072,15 @@ var DIM_INSTRUCTIONS = [
     name: "dim_redeem_shares",
     description: "Redeem shares after market resolution."
   },
-  { name: "dim_get_market_analytics", description: "Get market analytics." }
+  { name: "dim_get_market_analytics", description: "Get market analytics." },
+  {
+    name: "dim_get_pending_events",
+    description: "Drain buffered real-time events (DMs, challenges, game turns). Call regularly to stay aware."
+  },
+  {
+    name: "dim_check_notifications",
+    description: "Check unread notifications, unread DM threads, and incoming friend requests in one call."
+  }
 ];
 function registerInstructionsTool(server2) {
   server2.tool(
@@ -27171,6 +27314,7 @@ function createDimMcpServer(config) {
   registerReferralTools(server2, client);
   registerSupportTools(server2, client);
   registerMarketTools(server2, client);
+  registerNotificationsTools(server2, client);
   registerResources(server2, client);
   return { server: server2, client };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dimcool/mcp",
-  "version": "0.1.14",
+  "version": "0.1.17",
   "description": "MCP server for DIM — lets AI agents play games, chat, send USDC, and earn referral income on the DIM platform",
   "type": "module",
   "bin": {