@dimcool/dimclaw 0.1.11 → 0.1.13

package/dist/index.js

@@ -57468,6 +57468,11 @@ function register(api) {
               "No referrer yet \u2014 call dim_apply_referral_code for 10% fee discount"
             );
           }
+          if (result.username) {
+            nextSteps.push(
+              `Share your referral code "${result.username}" with other users/agents \u2014 you earn 30% of their game fees (https://dim.cool/?ref=${result.username})`
+            );
+          }
         } catch {
         }
         const response = {
@@ -57618,11 +57623,11 @@ function register(api) {
     },
     {
       name: "dim_create_lobby",
-      description: "Create a game lobby; bet in USDC minor units."
+      description: "Create a game lobby; bet in USDC dollars."
     },
     {
       name: "dim_join_queue",
-      description: "Join matchmaking queue for a game type."
+      description: "Join matchmaking queue. If not matched immediately, poll dim_get_lobby until gameId appears."
     },
     { name: "dim_get_lobby", description: "Get lobby details by ID." },
     {
@@ -58164,17 +58169,17 @@ function register(api) {
   });
   api.registerTool({
     name: "dim_create_lobby",
-    description: "Create a new game lobby. The agent becomes the lobby creator. Other players can join, or you can join the matchmaking queue to find an opponent. Bet amount is in USDC minor units (1 USDC = 1,000,000). A 1% fee (min 1 cent) is charged per player.",
+    description: "Create a new game lobby. The agent becomes the lobby creator. Other players can join, or you can join the matchmaking queue to find an opponent. Bet amount is in USDC dollars (e.g., 1.00 for $1.00). A 1% fee (min 1 cent) is charged per player.",
     parameters: {
       type: "object",
       properties: {
         gameType: {
           type: "string",
-          description: 'Game type ID (e.g., "rock-paper-scissors", "chess", "tic-tac-toe", "connect-four", "nim", "dots-and-boxes")'
+          description: 'Game type ID (e.g., "rock-paper-scissors", "chess", "tic-tac-toe", "connect-four")'
         },
         betAmount: {
           type: "number",
-          description: "Bet amount in USDC minor units (e.g., 1000000 = $1.00). Common amounts: 1000000 ($1), 5000000 ($5), 10000000 ($10)"
+          description: "Bet amount in USDC dollars (e.g., 1.00 for $1.00, 5.00 for $5.00, 10.00 for $10.00)"
         }
       },
       required: ["gameType"],
@@ -58184,7 +58189,7 @@ function register(api) {
       const c = await requireClient();
       if ("error" in c) return c.error;
       const gameType = String(params.gameType ?? "");
-      const betAmount = typeof params.betAmount === "number" ? params.betAmount : void 0;
+      const betAmount = typeof params.betAmount === "number" ? Math.round(params.betAmount * 1e6) : void 0;
       try {
         const lobby = await c.sdk.lobbies.createLobby(gameType, betAmount);
         return textResult(
@@ -58213,7 +58218,7 @@ function register(api) {
   });
   api.registerTool({
     name: "dim_join_queue",
-    description: "Join the matchmaking queue for a lobby. If the lobby is full, the game starts immediately. Otherwise, waits for an opponent. Returns the lobby (and gameId if matched).",
+    description: 'Join the matchmaking queue for a lobby. If matched immediately, returns gameId \u2014 start playing. If not matched, you MUST poll dim_get_lobby every 2-3 seconds until status becomes "active" and gameId appears.',
     parameters: {
       type: "object",
       properties: {
@@ -58311,7 +58316,7 @@ function register(api) {
   });
   api.registerTool({
     name: "dim_submit_action",
-    description: 'Submit a game action. The action format depends on the game type.\n\nRock-Paper-Scissors: gameType="rock-paper-scissors", action="play", payload={ action: "rock"|"paper"|"scissors" }\nChess: gameType="chess", action="move", payload={ from: "e2", to: "e4" }\nTic-Tac-Toe: gameType="tic-tac-toe", action="place", payload={ position: 0-8 }\nConnect Four: gameType="connect-four", action="drop", payload={ column: 0-6 }\nNim: gameType="nim", action="take", payload={ heap: 0-2, count: 1-N }\nDots and Boxes: gameType="dots-and-boxes", action="draw", payload={ row, col, direction: "h"|"v" }',
+    description: 'Submit a game action. The action format depends on the game type.\n\nRock-Paper-Scissors: gameType="rock-paper-scissors", action="play", payload={ action: "rock"|"paper"|"scissors" }\nChess: gameType="chess", action="move", payload={ from: "e2", to: "e4" }\nTic-Tac-Toe: gameType="tic-tac-toe", action="place_mark", payload={ row: 0-2, col: 0-2 }\nConnect Four: gameType="connect-four", action="drop_disc", payload={ column: 0-6 }',
     parameters: {
       type: "object",
       properties: {
@@ -58321,11 +58326,11 @@ function register(api) {
         },
         gameType: {
           type: "string",
-          description: 'Game type (e.g., "rock-paper-scissors", "chess", "tic-tac-toe")'
+          description: 'Game type (e.g., "rock-paper-scissors", "chess", "tic-tac-toe", "connect-four")'
         },
         action: {
           type: "string",
-          description: 'Action type (e.g., "play", "move", "place", "drop")'
+          description: 'Action type (e.g., "play", "move", "place_mark", "drop_disc")'
         },
         payload: {
           type: "object",
@@ -58339,11 +58344,12 @@ function register(api) {
       const c = await requireClient();
       if ("error" in c) return c.error;
       try {
-        await c.sdk.games.submitAction(String(params.gameId ?? ""), {
+        const gameAction = {
           gameType: String(params.gameType ?? ""),
           action: String(params.action ?? ""),
           payload: params.payload ?? {}
-        });
+        };
+        await c.sdk.games.submitAction(String(params.gameId ?? ""), gameAction);
         return textResult(
           JSON.stringify(
             {

package/index.ts

@@ -7,6 +7,7 @@ import { mkdir, readFile, rename, writeFile } from 'node:fs/promises';
 import path from 'node:path';
 import { Keypair, Transaction } from '@solana/web3.js';
 import bs58 from 'bs58';
+import type { ValidAction } from '@dimcool/sdk';
 import { DimClient } from './dim-client';
 
 type PluginConfig = {
@@ -171,6 +172,11 @@ export default function register(api: {
               'No referrer yet — call dim_apply_referral_code for 10% fee discount',
             );
           }
+          if (result.username) {
+            nextSteps.push(
+              `Share your referral code "${result.username}" with other users/agents — you earn 30% of their game fees (https://dim.cool/?ref=${result.username})`,
+            );
+          }
         } catch {
           /* non-critical */
         }
@@ -335,11 +341,11 @@ export default function register(api: {
     },
     {
       name: 'dim_create_lobby',
-      description: 'Create a game lobby; bet in USDC minor units.',
+      description: 'Create a game lobby; bet in USDC dollars.',
     },
     {
       name: 'dim_join_queue',
-      description: 'Join matchmaking queue for a game type.',
+      description: 'Join matchmaking queue. If not matched immediately, poll dim_get_lobby until gameId appears.',
     },
     { name: 'dim_get_lobby', description: 'Get lobby details by ID.' },
     {
@@ -916,19 +922,19 @@ export default function register(api: {
   api.registerTool({
     name: 'dim_create_lobby',
     description:
-      'Create a new game lobby. The agent becomes the lobby creator. Other players can join, or you can join the matchmaking queue to find an opponent. Bet amount is in USDC minor units (1 USDC = 1,000,000). A 1% fee (min 1 cent) is charged per player.',
+      'Create a new game lobby. The agent becomes the lobby creator. Other players can join, or you can join the matchmaking queue to find an opponent. Bet amount is in USDC dollars (e.g., 1.00 for $1.00). A 1% fee (min 1 cent) is charged per player.',
     parameters: {
       type: 'object',
       properties: {
         gameType: {
           type: 'string',
           description:
-            'Game type ID (e.g., "rock-paper-scissors", "chess", "tic-tac-toe", "connect-four", "nim", "dots-and-boxes")',
+            'Game type ID (e.g., "rock-paper-scissors", "chess", "tic-tac-toe", "connect-four")',
         },
         betAmount: {
           type: 'number',
           description:
-            'Bet amount in USDC minor units (e.g., 1000000 = $1.00). Common amounts: 1000000 ($1), 5000000 ($5), 10000000 ($10)',
+            'Bet amount in USDC dollars (e.g., 1.00 for $1.00, 5.00 for $5.00, 10.00 for $10.00)',
         },
       },
       required: ['gameType'],
@@ -939,7 +945,9 @@ export default function register(api: {
       if ('error' in c) return c.error;
       const gameType = String(params.gameType ?? '');
       const betAmount =
-        typeof params.betAmount === 'number' ? params.betAmount : undefined;
+        typeof params.betAmount === 'number'
+          ? Math.round(params.betAmount * 1_000_000)
+          : undefined;
       try {
         const lobby = await c.sdk.lobbies.createLobby(gameType, betAmount);
         return textResult(
@@ -972,7 +980,7 @@ export default function register(api: {
   api.registerTool({
     name: 'dim_join_queue',
     description:
-      'Join the matchmaking queue for a lobby. If the lobby is full, the game starts immediately. Otherwise, waits for an opponent. Returns the lobby (and gameId if matched).',
+      'Join the matchmaking queue for a lobby. If matched immediately, returns gameId — start playing. If not matched, you MUST poll dim_get_lobby every 2-3 seconds until status becomes "active" and gameId appears.',
     parameters: {
       type: 'object',
       properties: {
@@ -1081,10 +1089,8 @@ export default function register(api: {
       'Submit a game action. The action format depends on the game type.\n\n' +
       'Rock-Paper-Scissors: gameType="rock-paper-scissors", action="play", payload={ action: "rock"|"paper"|"scissors" }\n' +
       'Chess: gameType="chess", action="move", payload={ from: "e2", to: "e4" }\n' +
-      'Tic-Tac-Toe: gameType="tic-tac-toe", action="place", payload={ position: 0-8 }\n' +
-      'Connect Four: gameType="connect-four", action="drop", payload={ column: 0-6 }\n' +
-      'Nim: gameType="nim", action="take", payload={ heap: 0-2, count: 1-N }\n' +
-      'Dots and Boxes: gameType="dots-and-boxes", action="draw", payload={ row, col, direction: "h"|"v" }',
+      'Tic-Tac-Toe: gameType="tic-tac-toe", action="place_mark", payload={ row: 0-2, col: 0-2 }\n' +
+      'Connect Four: gameType="connect-four", action="drop_disc", payload={ column: 0-6 }',
     parameters: {
       type: 'object',
       properties: {
@@ -1095,11 +1101,12 @@ export default function register(api: {
         gameType: {
           type: 'string',
           description:
-            'Game type (e.g., "rock-paper-scissors", "chess", "tic-tac-toe")',
+            'Game type (e.g., "rock-paper-scissors", "chess", "tic-tac-toe", "connect-four")',
         },
         action: {
           type: 'string',
-          description: 'Action type (e.g., "play", "move", "place", "drop")',
+          description:
+            'Action type (e.g., "play", "move", "place_mark", "drop_disc")',
         },
         payload: {
           type: 'object',
@@ -1114,11 +1121,12 @@ export default function register(api: {
       const c = await requireClient();
       if ('error' in c) return c.error;
       try {
-        await c.sdk.games.submitAction(String(params.gameId ?? ''), {
+        const gameAction = {
           gameType: String(params.gameType ?? ''),
           action: String(params.action ?? ''),
           payload: (params.payload as Record<string, unknown>) ?? {},
-        } as never);
+        } as ValidAction;
+        await c.sdk.games.submitAction(String(params.gameId ?? ''), gameAction);
         return textResult(
           JSON.stringify(
             {

package/openclaw.plugin.json

@@ -31,5 +31,6 @@
       "placeholder": "https://api.dim.cool"
     }
   },
-  "setupHint": "After install, add your Solana wallet private key to plugins.entries.dimclaw.config.walletPrivateKey, then call dim_login to get started."
+  "setupHint": "After install, add your Solana wallet private key to plugins.entries.dimclaw.config.walletPrivateKey, then call dim_login to get started.",
+  "skill": "./SKILL.md"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dimcool/dimclaw",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "description": "OpenClaw plugin for DIM — play games, chat, send USDC, and earn on DIM using the SDK directly (no MCP subprocess).",
   "type": "module",
   "openclaw": {