@dimcool/dimclaw 0.1.10 → 0.1.12

package/dist/index.js

@@ -55022,10 +55022,12 @@ var Wallet = class {
    */
   async getBalances() {
     try {
-      const response = await this.http.get(
-        "/wallets/me/balance"
-      );
-      return response;
+      const raw = await this.http.get("/wallets/me/balance");
+      const usdcDollars = raw.usdc / 1e6;
+      return {
+        ...raw,
+        usdcFormatted: `$${usdcDollars.toFixed(2)}`
+      };
     } catch (error) {
       this.logger.error("Failed to get balances", {
         error: error instanceof Error ? error.message : String(error)
@@ -57444,26 +57446,37 @@ function register(api) {
   }
   api.registerTool({
     name: "dim_login",
-    description: "Authenticate with DIM using the configured wallet. Must be called before using any other tools. Returns user profile info.",
+    description: "Authenticate with DIM using the configured wallet. After login: set a username with dim_set_username, check balance with dim_get_balance, list games with dim_list_games, or apply a referral code with dim_apply_referral_code for a 10% fee discount.",
     parameters: { type: "object", properties: {}, additionalProperties: false },
     async execute() {
       const c = await requireClient();
       if ("error" in c) return c.error;
       try {
         const result = await c.authenticate();
-        const response = {
-          success: true,
-          userId: result.userId,
-          username: result.username,
-          walletAddress: c.walletAddress
-        };
+        const nextSteps = [];
+        if (result.username == null || result.username === "") {
+          nextSteps.push(
+            "No username set \u2014 call dim_set_username to claim one"
+          );
+        }
+        nextSteps.push("Check your balance with dim_get_balance");
+        nextSteps.push("Explore available games with dim_list_games");
         try {
           const summary = await c.sdk.referrals.getSummary();
           if (!summary.hasReferrer) {
-            response.referralHint = "You have no referrer yet. Use dim_apply_referral_code to apply one and get a 10% fee discount.";
+            nextSteps.push(
+              "No referrer yet \u2014 call dim_apply_referral_code for 10% fee discount"
+            );
           }
         } catch {
         }
+        const response = {
+          success: true,
+          userId: result.userId,
+          username: result.username ?? null,
+          walletAddress: c.walletAddress,
+          nextSteps
+        };
         return textResult(JSON.stringify(response, null, 2));
       } catch (err) {
         return textResult(
@@ -57529,9 +57542,165 @@ function register(api) {
       }
     }
   });
+  const DIM_INSTRUCTIONS = [
+    {
+      name: "dim_login",
+      description: "Authenticate with DIM. Call first; then set username, check balance, list games, or apply referral code."
+    },
+    {
+      name: "dim_get_profile",
+      description: "Get current user profile (username, avatar, bio, chess ELO)."
+    },
+    {
+      name: "dim_set_username",
+      description: "Set or update your username (alphanumeric, 3\u201320 chars)."
+    },
+    {
+      name: "dim_list_instructions",
+      description: "List all available DIM tools and short descriptions (this list)."
+    },
+    {
+      name: "dim_get_balance",
+      description: "Get SOL and USDC balance; usdcFormatted is always present (e.g. $0.00)."
+    },
+    {
+      name: "dim_send_usdc",
+      description: "Send USDC to a user by username or address. 1\xA2 fee; amount in dollars."
+    },
+    {
+      name: "dim_tip_user",
+      description: "Tip a user with USDC; broadcast to global chat. 1\xA2 fee."
+    },
+    {
+      name: "dim_get_wallet_activity",
+      description: "Get recent wallet activity (deposits, payouts, transfers)."
+    },
+    { name: "dim_search_users", description: "Search users by username." },
+    {
+      name: "dim_send_friend_request",
+      description: "Send friend request by user ID."
+    },
+    {
+      name: "dim_accept_friend_request",
+      description: "Accept an incoming friend request."
+    },
+    {
+      name: "dim_list_friends",
+      description: "List your friends with pagination."
+    },
+    {
+      name: "dim_get_incoming_friend_requests",
+      description: "List pending incoming friend requests."
+    },
+    {
+      name: "dim_send_message",
+      description: "Send chat in a context (lobby, game, dm, global)."
+    },
+    {
+      name: "dim_get_chat_history",
+      description: "Get chat history for a context."
+    },
+    {
+      name: "dim_send_dm",
+      description: "Send a direct message to a user by ID."
+    },
+    {
+      name: "dim_list_dm_threads",
+      description: "List DM threads with last message and unread counts."
+    },
+    {
+      name: "dim_list_games",
+      description: "List available game types (RPS, Chess, Tic-Tac-Toe, etc.)."
+    },
+    {
+      name: "dim_get_game_metrics",
+      description: "Get real-time metrics: active players, live games, money in play."
+    },
+    {
+      name: "dim_create_lobby",
+      description: "Create a game lobby; bet in USDC dollars."
+    },
+    {
+      name: "dim_join_queue",
+      description: "Join matchmaking queue for a game type."
+    },
+    { name: "dim_get_lobby", description: "Get lobby details by ID." },
+    {
+      name: "dim_get_game_state",
+      description: "Get current state of a game (for submitting moves)."
+    },
+    {
+      name: "dim_submit_action",
+      description: "Submit a move/action in a game."
+    },
+    { name: "dim_donate_to_pot", description: "Add to the pot in a lobby." },
+    { name: "dim_get_game", description: "Get game summary by ID." },
+    {
+      name: "dim_challenge_user",
+      description: "Challenge another user to a game."
+    },
+    { name: "dim_accept_challenge", description: "Accept a game challenge." },
+    {
+      name: "dim_get_referral_summary",
+      description: "Get your referral stats and rewards."
+    },
+    { name: "dim_get_referral_tree", description: "Get your referral tree." },
+    {
+      name: "dim_get_referral_rewards",
+      description: "Get claimable referral rewards."
+    },
+    {
+      name: "dim_claim_referral_rewards",
+      description: "Claim referral rewards to your wallet."
+    },
+    {
+      name: "dim_apply_referral_code",
+      description: "Apply a referral code for 10% fee discount."
+    },
+    {
+      name: "dim_create_support_ticket",
+      description: "Create a support ticket."
+    },
+    { name: "dim_get_my_tickets", description: "List your support tickets." },
+    { name: "dim_get_ticket", description: "Get a ticket by ID." },
+    {
+      name: "dim_add_ticket_message",
+      description: "Add a message to a ticket."
+    },
+    { name: "dim_close_ticket", description: "Close a support ticket." },
+    {
+      name: "dim_get_market",
+      description: "Get prediction market for a game."
+    },
+    { name: "dim_buy_shares", description: "Buy prediction market shares." },
+    { name: "dim_sell_shares", description: "Sell prediction market shares." },
+    { name: "dim_get_positions", description: "Get your market positions." },
+    {
+      name: "dim_redeem_shares",
+      description: "Redeem shares after market resolution."
+    },
+    { name: "dim_get_market_analytics", description: "Get market analytics." }
+  ];
+  api.registerTool({
+    name: "dim_list_instructions",
+    description: "List all available DIM tools (instructions) with short descriptions. Use this to discover what you can do after dim_login.",
+    parameters: { type: "object", properties: {}, additionalProperties: false },
+    async execute() {
+      return textResult(
+        JSON.stringify(
+          {
+            instructions: DIM_INSTRUCTIONS,
+            hint: "Call dim_login first if you have not authenticated. Then use any tool above by name."
+          },
+          null,
+          2
+        )
+      );
+    }
+  });
   api.registerTool({
     name: "dim_get_balance",
-    description: "Get the wallet balance for the authenticated user. Returns SOL and USDC amounts. USDC amounts are in minor units (1 USDC = 1,000,000 minor units).",
+    description: "Get the wallet balance for the authenticated user. Returns SOL and USDC (usdc in minor units; usdcFormatted is always present, e.g. $0.00 or $1.50, so you do not need to convert).",
     parameters: { type: "object", properties: {}, additionalProperties: false },
     async execute() {
       const c = await requireClient();
@@ -57539,13 +57708,11 @@ function register(api) {
       try {
         const balance = await c.sdk.wallet.getBalances();
         const usdcDollars = balance.usdc / 1e6;
-        return textResult(
-          JSON.stringify(
-            { ...balance, usdcFormatted: `$${usdcDollars.toFixed(2)}` },
-            null,
-            2
-          )
-        );
+        const payload = {
+          ...balance,
+          usdcFormatted: `$${usdcDollars.toFixed(2)}`
+        };
+        return textResult(JSON.stringify(payload, null, 2));
       } catch (err) {
         return textResult(
           `Failed to get balance: ${err instanceof Error ? err.message : String(err)}`,
@@ -57997,17 +58164,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"],
@@ -58017,7 +58184,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(
@@ -58144,7 +58311,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: {
@@ -58154,11 +58321,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",
@@ -58172,11 +58339,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 = {
@@ -149,28 +150,38 @@ export default function register(api: {
   api.registerTool({
     name: 'dim_login',
     description:
-      'Authenticate with DIM using the configured wallet. Must be called before using any other tools. Returns user profile info.',
+      'Authenticate with DIM using the configured wallet. After login: set a username with dim_set_username, check balance with dim_get_balance, list games with dim_list_games, or apply a referral code with dim_apply_referral_code for a 10% fee discount.',
     parameters: { type: 'object', properties: {}, additionalProperties: false },
     async execute() {
       const c = await requireClient();
       if ('error' in c) return c.error;
       try {
         const result = await c.authenticate();
-        const response: Record<string, unknown> = {
-          success: true,
-          userId: result.userId,
-          username: result.username,
-          walletAddress: c.walletAddress,
-        };
+        const nextSteps: string[] = [];
+        if (result.username == null || result.username === '') {
+          nextSteps.push(
+            'No username set — call dim_set_username to claim one',
+          );
+        }
+        nextSteps.push('Check your balance with dim_get_balance');
+        nextSteps.push('Explore available games with dim_list_games');
         try {
           const summary = await c.sdk.referrals.getSummary();
           if (!summary.hasReferrer) {
-            response.referralHint =
-              'You have no referrer yet. Use dim_apply_referral_code to apply one and get a 10% fee discount.';
+            nextSteps.push(
+              'No referrer yet — call dim_apply_referral_code for 10% fee discount',
+            );
           }
         } catch {
           /* non-critical */
         }
+        const response: Record<string, unknown> = {
+          success: true,
+          userId: result.userId,
+          username: result.username ?? null,
+          walletAddress: c.walletAddress,
+          nextSteps,
+        };
         return textResult(JSON.stringify(response, null, 2));
       } catch (err) {
         return textResult(
@@ -242,11 +253,176 @@ export default function register(api: {
     },
   });
 
+  // --- Instructions (discovery) ---
+  const DIM_INSTRUCTIONS = [
+    {
+      name: 'dim_login',
+      description:
+        'Authenticate with DIM. Call first; then set username, check balance, list games, or apply referral code.',
+    },
+    {
+      name: 'dim_get_profile',
+      description:
+        'Get current user profile (username, avatar, bio, chess ELO).',
+    },
+    {
+      name: 'dim_set_username',
+      description: 'Set or update your username (alphanumeric, 3–20 chars).',
+    },
+    {
+      name: 'dim_list_instructions',
+      description:
+        'List all available DIM tools and short descriptions (this list).',
+    },
+    {
+      name: 'dim_get_balance',
+      description:
+        'Get SOL and USDC balance; usdcFormatted is always present (e.g. $0.00).',
+    },
+    {
+      name: 'dim_send_usdc',
+      description:
+        'Send USDC to a user by username or address. 1¢ fee; amount in dollars.',
+    },
+    {
+      name: 'dim_tip_user',
+      description: 'Tip a user with USDC; broadcast to global chat. 1¢ fee.',
+    },
+    {
+      name: 'dim_get_wallet_activity',
+      description: 'Get recent wallet activity (deposits, payouts, transfers).',
+    },
+    { name: 'dim_search_users', description: 'Search users by username.' },
+    {
+      name: 'dim_send_friend_request',
+      description: 'Send friend request by user ID.',
+    },
+    {
+      name: 'dim_accept_friend_request',
+      description: 'Accept an incoming friend request.',
+    },
+    {
+      name: 'dim_list_friends',
+      description: 'List your friends with pagination.',
+    },
+    {
+      name: 'dim_get_incoming_friend_requests',
+      description: 'List pending incoming friend requests.',
+    },
+    {
+      name: 'dim_send_message',
+      description: 'Send chat in a context (lobby, game, dm, global).',
+    },
+    {
+      name: 'dim_get_chat_history',
+      description: 'Get chat history for a context.',
+    },
+    {
+      name: 'dim_send_dm',
+      description: 'Send a direct message to a user by ID.',
+    },
+    {
+      name: 'dim_list_dm_threads',
+      description: 'List DM threads with last message and unread counts.',
+    },
+    {
+      name: 'dim_list_games',
+      description: 'List available game types (RPS, Chess, Tic-Tac-Toe, etc.).',
+    },
+    {
+      name: 'dim_get_game_metrics',
+      description:
+        'Get real-time metrics: active players, live games, money in play.',
+    },
+    {
+      name: 'dim_create_lobby',
+      description: 'Create a game lobby; bet in USDC dollars.',
+    },
+    {
+      name: 'dim_join_queue',
+      description: 'Join matchmaking queue for a game type.',
+    },
+    { name: 'dim_get_lobby', description: 'Get lobby details by ID.' },
+    {
+      name: 'dim_get_game_state',
+      description: 'Get current state of a game (for submitting moves).',
+    },
+    {
+      name: 'dim_submit_action',
+      description: 'Submit a move/action in a game.',
+    },
+    { name: 'dim_donate_to_pot', description: 'Add to the pot in a lobby.' },
+    { name: 'dim_get_game', description: 'Get game summary by ID.' },
+    {
+      name: 'dim_challenge_user',
+      description: 'Challenge another user to a game.',
+    },
+    { name: 'dim_accept_challenge', description: 'Accept a game challenge.' },
+    {
+      name: 'dim_get_referral_summary',
+      description: 'Get your referral stats and rewards.',
+    },
+    { name: 'dim_get_referral_tree', description: 'Get your referral tree.' },
+    {
+      name: 'dim_get_referral_rewards',
+      description: 'Get claimable referral rewards.',
+    },
+    {
+      name: 'dim_claim_referral_rewards',
+      description: 'Claim referral rewards to your wallet.',
+    },
+    {
+      name: 'dim_apply_referral_code',
+      description: 'Apply a referral code for 10% fee discount.',
+    },
+    {
+      name: 'dim_create_support_ticket',
+      description: 'Create a support ticket.',
+    },
+    { name: 'dim_get_my_tickets', description: 'List your support tickets.' },
+    { name: 'dim_get_ticket', description: 'Get a ticket by ID.' },
+    {
+      name: 'dim_add_ticket_message',
+      description: 'Add a message to a ticket.',
+    },
+    { name: 'dim_close_ticket', description: 'Close a support ticket.' },
+    {
+      name: 'dim_get_market',
+      description: 'Get prediction market for a game.',
+    },
+    { name: 'dim_buy_shares', description: 'Buy prediction market shares.' },
+    { name: 'dim_sell_shares', description: 'Sell prediction market shares.' },
+    { name: 'dim_get_positions', description: 'Get your market positions.' },
+    {
+      name: 'dim_redeem_shares',
+      description: 'Redeem shares after market resolution.',
+    },
+    { name: 'dim_get_market_analytics', description: 'Get market analytics.' },
+  ];
+  api.registerTool({
+    name: 'dim_list_instructions',
+    description:
+      'List all available DIM tools (instructions) with short descriptions. Use this to discover what you can do after dim_login.',
+    parameters: { type: 'object', properties: {}, additionalProperties: false },
+    async execute() {
+      return textResult(
+        JSON.stringify(
+          {
+            instructions: DIM_INSTRUCTIONS,
+            hint: 'Call dim_login first if you have not authenticated. Then use any tool above by name.',
+          },
+          null,
+          2,
+        ),
+      );
+    },
+  });
+
   // --- Wallet ---
   api.registerTool({
     name: 'dim_get_balance',
     description:
-      'Get the wallet balance for the authenticated user. Returns SOL and USDC amounts. USDC amounts are in minor units (1 USDC = 1,000,000 minor units).',
+      'Get the wallet balance for the authenticated user. Returns SOL and USDC (usdc in minor units; usdcFormatted is always present, e.g. $0.00 or $1.50, so you do not need to convert).',
     parameters: { type: 'object', properties: {}, additionalProperties: false },
     async execute() {
       const c = await requireClient();
@@ -254,13 +430,11 @@ export default function register(api: {
       try {
         const balance = await c.sdk.wallet.getBalances();
         const usdcDollars = balance.usdc / 1_000_000;
-        return textResult(
-          JSON.stringify(
-            { ...balance, usdcFormatted: `$${usdcDollars.toFixed(2)}` },
-            null,
-            2,
-          ),
-        );
+        const payload = {
+          ...balance,
+          usdcFormatted: `$${usdcDollars.toFixed(2)}`,
+        };
+        return textResult(JSON.stringify(payload, null, 2));
       } catch (err) {
         return textResult(
           `Failed to get balance: ${err instanceof Error ? err.message : String(err)}`,
@@ -743,19 +917,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'],
@@ -766,7 +940,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(
@@ -908,10 +1084,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: {
@@ -922,11 +1096,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',
@@ -941,11 +1116,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

@@ -30,5 +30,7 @@
       "label": "API URL",
       "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.",
+  "skill": "./SKILL.md"
 }

package/package.json

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