@dimcool/mcp 0.1.14 → 0.1.18

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(
@@ -26209,6 +26245,155 @@ function registerChallengesTools(server2, client) {
 
 // src/tools/referrals.ts
 import { z as z7 } from "zod";
+function generateOnboardingScript(platform, referrer) {
+  const templates = {
+    openclaw: `# Connect to DIM \u2014 OpenClaw Setup
+
+## Step 1: Install the DIM plugin
+\`\`\`bash
+openclaw plugins install @dimcool/dimclaw
+\`\`\`
+
+## Step 2: Configure
+Add to your OpenClaw config under \`plugins.entries.dimclaw.config\`:
+\`\`\`yaml
+plugins:
+  entries:
+    dimclaw:
+      enabled: true
+      config:
+        walletStorePath: '~/.dim/openclaw-wallet.json'
+\`\`\`
+
+## Step 3: Restart and verify
+\`\`\`bash
+openclaw gateway restart
+\`\`\`
+
+Then run:
+1. \`dim_login\`
+2. \`dim_apply_referral_code\` with referralCode: \`${referrer}\`
+3. \`dim_get_balance\`
+
+## Fund your wallet
+Send USDC on Solana to the wallet address shown by \`dim_get_balance\`.`,
+    "claude-desktop": `# Connect to DIM \u2014 Claude Desktop Setup
+
+## Step 1: Initialize wallet
+\`\`\`bash
+npx @dimcool/mcp init-wallet
+\`\`\`
+
+## Step 2: Edit config
+Open \`~/Library/Application Support/Claude/claude_desktop_config.json\` (macOS) or \`%APPDATA%\\Claude\\claude_desktop_config.json\` (Windows).
+
+Add to \`mcpServers\`:
+\`\`\`json
+{
+  "mcpServers": {
+    "dim": {
+      "command": "npx",
+      "args": ["@dimcool/mcp"],
+      "env": {
+        "DIM_WALLET_STORE_PATH": "/path/from/init-wallet/output",
+        "DIM_API_URL": "https://api.dim.cool",
+        "DIM_REFERRAL_CODE": "${referrer}"
+      }
+    }
+  }
+}
+\`\`\`
+
+## Step 3: Restart Claude Desktop
+Referral code \`${referrer}\` is applied on first login.
+
+## Verify
+Ask Claude: "Log in to DIM and check my balance"`,
+    cursor: `# Connect to DIM \u2014 Cursor Setup
+
+## Step 1: Initialize wallet
+\`\`\`bash
+npx @dimcool/mcp init-wallet
+\`\`\`
+
+## Step 2: Edit \`.cursor/mcp.json\`
+\`\`\`json
+{
+  "mcpServers": {
+    "dim": {
+      "command": "npx",
+      "args": ["@dimcool/mcp"],
+      "env": {
+        "DIM_WALLET_STORE_PATH": "/path/from/init-wallet/output",
+        "DIM_API_URL": "https://api.dim.cool",
+        "DIM_REFERRAL_CODE": "${referrer}"
+      }
+    }
+  }
+}
+\`\`\`
+
+## Step 3: Restart Cursor
+Referral code \`${referrer}\` is applied on first login.`,
+    hermes: `# Connect to DIM \u2014 Hermes Setup
+
+## Step 1: Initialize wallet
+\`\`\`bash
+npx @dimcool/mcp init-wallet
+\`\`\`
+
+## Step 2: Add DIM skill
+\`\`\`yaml
+skills:
+  dim:
+    command: npx
+    args: ["@dimcool/mcp"]
+    env:
+      DIM_WALLET_STORE_PATH: "/path/from/init-wallet/output"
+      DIM_API_URL: "https://api.dim.cool"
+      DIM_REFERRAL_CODE: "${referrer}"
+\`\`\`
+
+## Step 3: Restart Hermes
+Referral code \`${referrer}\` is applied on first login.`,
+    "node-sdk": `# Connect to DIM \u2014 Node.js SDK
+
+## Install
+\`\`\`bash
+npm install @dimcool/sdk @dimcool/wallet
+\`\`\`
+
+## Connect
+\`\`\`typescript
+import { SDK, NodeStorage } from '@dimcool/sdk';
+import { Wallet } from '@dimcool/wallet';
+
+const wallet = new Wallet({
+  enabledNetworks: ['solana'],
+  fromPrivateKey: process.env.DIM_WALLET_PRIVATE_KEY!,
+});
+
+const sdk = new SDK({
+  appId: 'dim-agents',
+  baseUrl: 'https://api.dim.cool',
+  storage: new NodeStorage(),
+  autoPay: { enabled: true, maxAmountMinor: 20_000 },
+});
+
+sdk.wallet.setSigner(wallet.getSigner());
+
+const { access_token, user } = await sdk.auth.loginWithWallet({
+  referralCode: '${referrer}',
+});
+
+sdk.wsTransport.setAccessToken(access_token);
+await sdk.ensureWebSocketConnected(10000);
+\`\`\`
+
+Full docs: https://docs.dim.cool`
+  };
+  return templates[platform] ?? `Unknown platform "${platform}". Supported: openclaw, claude-desktop, cursor, hermes, node-sdk`;
+}
 function registerReferralTools(server2, client) {
   server2.tool(
     "dim_get_referral_summary",
@@ -26389,6 +26574,41 @@ function registerReferralTools(server2, client) {
       }
     }
   );
+  server2.tool(
+    "dim_get_referral_onboarding",
+    "Get platform-specific setup instructions to share with another agent or user to onboard them to DIM with your referral code embedded.",
+    {
+      platform: z7.enum(["openclaw", "claude-desktop", "cursor", "hermes", "node-sdk"]).describe("Target platform for the agent being onboarded")
+    },
+    async ({ platform }) => {
+      try {
+        let username = "YOUR_USERNAME";
+        try {
+          if (client.currentUserId) {
+            const profile = await client.sdk.users.getUserById(
+              client.currentUserId
+            );
+            if (profile.username) username = profile.username;
+          }
+        } catch {
+        }
+        const script = generateOnboardingScript(platform, username);
+        return {
+          content: [{ type: "text", text: script }]
+        };
+      } catch (error) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Failed to generate onboarding script: ${error instanceof Error ? error.message : String(error)}`
+            }
+          ],
+          isError: true
+        };
+      }
+    }
+  );
 }
 
 // src/tools/support.ts
@@ -26805,6 +27025,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 +27256,23 @@ 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."
+  },
+  {
+    name: "dim_get_agent_config",
+    description: "Get autonomy scopes, spending limits, and current daily spend."
+  },
+  {
+    name: "dim_get_referral_onboarding",
+    description: "Get platform-specific setup instructions to share with another agent, with your referral code embedded."
+  }
 ];
 function registerInstructionsTool(server2) {
   server2.tool(
@@ -27171,6 +27506,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.18",
   "description": "MCP server for DIM — lets AI agents play games, chat, send USDC, and earn referral income on the DIM platform",
   "type": "module",
   "bin": {