@dimcool/dimclaw 0.1.26 → 0.1.27

package/dist/index.js

@@ -33236,19 +33236,18 @@ var Lobbies = class {
     return this.http.delete(`/lobbies/admin/${lobbyId}`);
   }
   /**
-   * Play again: Create a new lobby, start deposits, and prepare deposit transaction
-   * Returns the lobby and unsigned transaction that needs to be signed
+   * Play again: Create a new lobby and prepare deposit in one flow.
+   * Returns the lobby and unsigned transaction that needs to be signed.
    * @param gameType - The game type to play again
    * @param betAmount - The bet amount (same as previous game)
    * @param escrow - The escrow service instance (from sdk.escrow)
    */
   async playAgain(gameType, betAmount, escrow) {
     const lobby = await this.createLobby(gameType, betAmount);
-    await escrow.startDeposits(lobby.id);
-    const prepareResponse = await escrow.prepareDepositTransaction(lobby.id);
+    const { transaction } = await escrow.prepareAndStartDeposit(lobby.id);
     return {
       lobby,
-      unsignedTransaction: prepareResponse.transaction
+      unsignedTransaction: transaction
     };
   }
 };
@@ -34112,6 +34111,17 @@ var Escrow = class {
       `/escrow/lobby/${lobbyId}/deposit/prepare`
     );
   }
+  /**
+   * Combined prepare-and-start: validates lobby, transitions waiting→preparing,
+   * initializes depositStatus, and prepares the unsigned transaction in one call.
+   * Eliminates one HTTP round-trip vs startDeposits() + prepareDepositTransaction().
+   */
+  async prepareAndStartDeposit(lobbyId) {
+    return this.http.post(
+      `/escrow/lobby/${lobbyId}/deposit/prepare-and-start`,
+      {}
+    );
+  }
   /**
    * Submit a signed deposit transaction
    * The transaction will be submitted to the Solana network and confirmed
@@ -34142,7 +34152,7 @@ var Escrow = class {
     );
   }
   /**
-   * One-call lobby deposit: start deposits, prepare, sign, submit, and poll until
+   * One-call lobby deposit: prepare-and-start, sign, submit, and poll until
    * the current user's deposit is confirmed. Requires sdk.wallet.setSigner() to be set.
    * Returns when all required deposits are confirmed and the lobby can proceed to queue.
    *
@@ -34154,8 +34164,7 @@ var Escrow = class {
         "No signer configured. Use sdk.wallet.setSigner(...) first."
       );
     }
-    await this.startDeposits(lobbyId);
-    const { transaction } = await this.prepareDepositTransaction(lobbyId);
+    const { transaction } = await this.prepareAndStartDeposit(lobbyId);
     const unsignedTx = Transaction.from(base64ToBytes(transaction));
     let signature;
     if (this.wallet.isSignAndSendMode()) {
@@ -34177,7 +34186,7 @@ var Escrow = class {
       if (status.allConfirmed && status.canProceedToQueue) {
         return {
           signature,
-          status: "pending",
+          status: "confirmed",
           canProceedToQueue: true
         };
       }
@@ -34189,6 +34198,39 @@ var Escrow = class {
       canProceedToQueue: false
     };
   }
+  /**
+   * Zero-polling deposit variant using server-side awaitConfirmation.
+   * 2 HTTP calls total, 0 client-side polling. Ideal for agents.
+   *
+   * Automatically uses signAndSendTransaction or signTransaction based on signer capability.
+   */
+  async depositForLobbySync(lobbyId) {
+    if (!this.wallet.hasSigner()) {
+      throw new Error(
+        "No signer configured. Use sdk.wallet.setSigner(...) first."
+      );
+    }
+    const { transaction } = await this.prepareAndStartDeposit(lobbyId);
+    const unsignedTx = Transaction.from(base64ToBytes(transaction));
+    let signature;
+    if (this.wallet.isSignAndSendMode()) {
+      signature = await this.wallet.signAndSendTransaction(unsignedTx);
+      await this.http.post(
+        `/escrow/lobby/${lobbyId}/deposit/confirm-signature?awaitConfirmation=true`,
+        { signature }
+      );
+    } else {
+      const signedTx = await this.wallet.signTransaction(unsignedTx);
+      const signedBase64 = bytesToBase64(
+        signedTx.serialize({ requireAllSignatures: false })
+      );
+      const result = await this.http.post(`/escrow/lobby/${lobbyId}/deposit/submit?awaitConfirmation=true`, {
+        signedTransaction: signedBase64
+      });
+      signature = result.signature;
+    }
+    return { signature, status: "confirmed", canProceedToQueue: true };
+  }
   async claimLobbyDepositRefund(lobbyId, depositSignature) {
     return this.http.post(
       `/escrow/lobby/${lobbyId}/deposit/${depositSignature}/claim-refund`,
@@ -34201,33 +34243,6 @@ var Escrow = class {
       {}
     );
   }
-  /**
-   * Submit a signed deposit transaction and wait until the lobby is queued/active.
-   *
-   * Note: the backend may auto-transition the lobby to the queue once deposits are confirmed.
-   * In that case, calling /join-queue from the client would be redundant and can fail with
-   * "Current status: queued".
-   * @param lobbyId - The lobby ID
-   * @param signedTransaction - The signed transaction (base64 encoded)
-   * @param lobbies - The lobbies service instance (from sdk.lobbies) to read lobby status
-   */
-  async submitDepositAndJoinQueue(lobbyId, signedTransaction, lobbies) {
-    await this.submitDeposit(lobbyId, signedTransaction);
-    const MAX_WAIT_TIME = 3e4;
-    const POLL_INTERVAL = 1e3;
-    const startTime = Date.now();
-    while (Date.now() - startTime < MAX_WAIT_TIME) {
-      const status = await this.getDepositStatus(lobbyId);
-      if (status.allConfirmed && status.canProceedToQueue) {
-        const lobby = await lobbies.getLobby(lobbyId);
-        if (lobby.status === "queued" || lobby.status === "active") {
-          return lobby;
-        }
-      }
-      await new Promise((resolve) => setTimeout(resolve, POLL_INTERVAL));
-    }
-    throw new Error("Deposit confirmation timeout");
-  }
 };
 var Daily = class {
   constructor(http2, logger2 = logger) {
@@ -34854,8 +34869,14 @@ var _StandaloneWsTransport = class _StandaloneWsTransport2 extends BaseWsTranspo
         connecting: false,
         error: null
       });
+      const wasReconnect = this.reconnectAttempts > 0;
       this.reconnectAttempts = 0;
       this.onReconnect();
+      if (wasReconnect) {
+        this.dispatchEvent("connection:reconnected", {
+          timestamp: Date.now()
+        });
+      }
     });
     socket.on("disconnect", (reason) => {
       this.updateConnectionState({ connected: false, connecting: false });
@@ -34997,7 +35018,8 @@ function createLobbyStore(transport) {
   const store = createSdkStore({
     lobbiesById: {},
     matchedEvent: null,
-    typingByLobbyId: {}
+    typingByLobbyId: {},
+    depositStatusByLobbyId: {}
   });
   const setBaseState = (lobbies) => {
     const lobbiesById = {};
@@ -35077,6 +35099,15 @@ function createLobbyStore(transport) {
           };
         });
         break;
+      case "lobby:deposit:updated":
+        store.updateState((state) => ({
+          ...state,
+          depositStatusByLobbyId: {
+            ...state.depositStatusByLobbyId,
+            [event.payload.lobbyId]: event.payload
+          }
+        }));
+        break;
       case "lobby:typing:start":
       case "lobby:typing:stop":
         store.updateState((state) => {
@@ -35105,12 +35136,22 @@ function createLobbyStore(transport) {
       }
     }
   );
+  const subscribeDepositUpdate = (lobbyId, callback) => store.subscribeSelector(
+    (state) => state.depositStatusByLobbyId[lobbyId],
+    () => {
+      const data = store.getState().depositStatusByLobbyId[lobbyId];
+      if (data) {
+        callback(data);
+      }
+    }
+  );
   return {
     store,
     setBaseState,
     applyWsEvent,
     joinLobby,
-    subscribeMatched
+    subscribeMatched,
+    subscribeDepositUpdate
   };
 }
 function createGameStore(transport) {
@@ -35392,7 +35433,6 @@ function createGameActionsStore(transport) {
           ...current,
           roundState: {
             ...current.roundState,
-            phase: "completed",
             timeRemaining: 0,
             actions: timedOutUser ? {
               ...current.roundState.actions,
@@ -35904,6 +35944,7 @@ var WS_EVENT_NAMES = [
   "lobby:queue:joined",
   "lobby:queue:cancelled",
   "lobby:matched",
+  "lobby:deposit:updated",
   "lobby:typing:start",
   "lobby:typing:stop",
   "game:updated",
@@ -35980,6 +36021,11 @@ function decodeWsEvent(eventName, payload) {
         event: "lobby:matched",
         payload
       };
+    case "lobby:deposit:updated":
+      return {
+        event: "lobby:deposit:updated",
+        payload
+      };
     case "lobby:typing:start":
     case "lobby:typing:stop":
       return {
@@ -36569,6 +36615,17 @@ var SAFETY_RULES = [
 ];
 
 // ../dim-agent-core/src/tools/auth.ts
+var WALLET_LINKAGE_NOTE = "DIM is noncustodial. Your DIM wallet is the Solana address shown here; it was configured with a base58 private key at setup. Signing is done locally where this instance runs, using that private key and DIM's wallet package.";
+async function getSpectateUrl(client) {
+  if (!client.currentUserId) return null;
+  try {
+    const user = await client.sdk.users.getUserById(client.currentUserId);
+    const u = user;
+    return u?.username ? `https://dim.cool/spectate/${u.username}` : null;
+  } catch {
+    return null;
+  }
+}
 async function login(client) {
   try {
     const result = await client.authenticate();
@@ -36598,6 +36655,7 @@ async function login(client) {
       userId: result.userId,
       username: result.username ?? null,
       walletAddress: client.walletAddress,
+      walletNote: WALLET_LINKAGE_NOTE,
       safetyRules: SAFETY_RULES,
       nextSteps
     };
@@ -36631,7 +36689,11 @@ async function getProfile(client) {
       };
     }
     const user = await client.sdk.users.getUserById(client.currentUserId);
-    return { data: user };
+    const profile = {
+      ...typeof user === "object" && user !== null ? user : {},
+      walletAddress: client.walletAddress
+    };
+    return { data: profile };
   } catch (error) {
     return {
       error: `Failed to get profile: ${error instanceof Error ? error.message : String(error)}`,
@@ -36832,12 +36894,31 @@ async function listDmThreads(client) {
 }
 
 // ../dim-agent-core/src/tools/wallet.ts
+async function getWalletAddress(client) {
+  try {
+    return {
+      data: {
+        walletAddress: client.walletAddress,
+        walletNote: WALLET_LINKAGE_NOTE
+      }
+    };
+  } catch (error) {
+    return {
+      error: `Failed to get wallet address: ${error instanceof Error ? error.message : String(error)}`,
+      isError: true
+    };
+  }
+}
 async function getBalance(client) {
   try {
     const balance = await client.sdk.wallet.getBalances();
     const usdcDollars = balance.usdc / 1e6;
     return {
-      data: { ...balance, usdcFormatted: `$${usdcDollars.toFixed(2)}` }
+      data: {
+        ...balance,
+        usdcFormatted: `$${usdcDollars.toFixed(2)}`,
+        walletAddress: client.walletAddress
+      }
     };
   } catch (error) {
     return {
@@ -36904,7 +36985,10 @@ async function getWalletActivity(client, args) {
       limit: args.limit || 20
     });
     const claimable = activity.items.filter((i) => i.claimable === true);
-    const data = { ...activity };
+    const data = {
+      ...activity,
+      walletAddress: client.walletAddress
+    };
     if (claimable.length > 0) {
       data.hint = `You have ${claimable.length} claimable item(s). Call dim_claim_funds with the activityId to claim each one.`;
       data.claimableItems = claimable.map((i) => ({
@@ -37113,9 +37197,8 @@ function buildGameOverHint(state) {
   const winnerId = state.winnerId;
   const wonAmount = state.wonAmount;
   const isDraw = state.draw === true || winnerId == null;
-  if (isDraw) return "Game over \u2014 it was a draw.";
-  const amountStr = wonAmount != null ? ` Won $${(wonAmount / 1e6).toFixed(2)}.` : "";
-  return `Game over. Winner: ${winnerId}.${amountStr}`;
+  const result = isDraw ? "Game over \u2014 it was a draw." : `Game over. Winner: ${winnerId}.${wonAmount != null ? ` Won $${(wonAmount / 1e6).toFixed(2)}.` : ""}`;
+  return `${result} You can request a rematch with dim_request_rematch, or check dim_check_notifications for new activity.`;
 }
 async function fetchNewGameChat(client, gameId) {
   try {
@@ -37223,13 +37306,13 @@ async function createLobby(client, args) {
 }
 async function depositForLobby(client, args) {
   try {
-    const result = await client.sdk.escrow.depositForLobby(args.lobbyId);
+    const result = await client.sdk.escrow.depositForLobbySync(args.lobbyId);
     return {
       data: {
         signature: result.signature,
         status: result.status,
         canProceedToQueue: result.canProceedToQueue,
-        hint: result.canProceedToQueue ? "Deposit confirmed. Call dim_join_queue when ready (and when all players have deposited if 2-player)." : "Deposit submitted. Poll dim_get_deposit_status or try dim_join_queue once all players have deposited."
+        hint: "Deposit confirmed. The server auto-joins the queue when all players have deposited."
       }
     };
   } catch (error) {
@@ -37260,13 +37343,15 @@ async function joinQueue(client, args) {
     await client.ensureConnected();
     const lobby = await client.sdk.lobbies.joinQueue(args.lobbyId);
     const matched = lobby.status === "active" && lobby.gameId;
+    const spectateUrl = matched ? await getSpectateUrl(client) : null;
     return {
       data: {
         lobbyId: lobby.id,
         status: lobby.status,
         gameId: lobby.gameId || null,
         matched: !!matched,
-        hint: matched ? `Game started! Call dim_game_loop with gameId "${lobby.gameId}" to play.` : "Waiting for an opponent. Poll dim_get_lobby to check for a match."
+        ...spectateUrl && { spectateUrl },
+        hint: matched ? `Game started! Call dim_game_loop with gameId "${lobby.gameId}" to play.${spectateUrl ? ` Tell the user they can spectate at ${spectateUrl}` : ""}` : "Waiting for an opponent. Poll dim_get_lobby to check for a match."
       }
     };
   } catch (error) {
@@ -37448,6 +37533,38 @@ async function inviteToLobby(client, args) {
     };
   }
 }
+async function requestRematch(client, args) {
+  try {
+    const result = await client.sdk.games.requestRematch(args.gameId);
+    return {
+      data: {
+        ...result,
+        hint: result.bothReady ? `Both players want a rematch! A lobby is being created.${result.newLobbyId ? ` Lobby ID: ${result.newLobbyId}.` : ""} Check dim_check_notifications or call dim_game_loop with the new gameId once the game starts.` : "Rematch requested. Waiting for opponent to accept. Call dim_check_notifications to see if they respond."
+      }
+    };
+  } catch (error) {
+    return {
+      error: `Failed to request rematch: ${error instanceof Error ? error.message : String(error)}`,
+      isError: true
+    };
+  }
+}
+async function acceptRematch(client, args) {
+  try {
+    const result = await client.sdk.games.requestRematch(args.gameId);
+    return {
+      data: {
+        ...result,
+        hint: result.bothReady ? `Rematch accepted! A lobby has been created.${result.newLobbyId ? ` Lobby ID: ${result.newLobbyId}.` : ""} Proceed with deposit and game flow.` : "Your rematch acceptance was recorded. Waiting for the other player."
+      }
+    };
+  } catch (error) {
+    return {
+      error: `Failed to accept rematch: ${error instanceof Error ? error.message : String(error)}`,
+      isError: true
+    };
+  }
+}
 function raceTimeout(promise, ms) {
   return new Promise((resolve) => {
     const timer = setTimeout(resolve, ms);
@@ -37494,10 +37611,12 @@ async function challengeUser(client, args) {
 async function acceptChallenge(client, args) {
   try {
     const result = await client.sdk.challenges.accept(args.challengeId);
+    const spectateUrl = result.gameId ? await getSpectateUrl(client) : null;
     return {
       data: {
         ...result,
-        hint: result.gameId ? `Game started! Call dim_game_loop with gameId "${result.gameId}".` : `Lobby created: ${result.lobbyId}. Use dim_join_queue to start matchmaking.`
+        ...spectateUrl && { spectateUrl },
+        hint: result.gameId ? `Game started! Call dim_game_loop with gameId "${result.gameId}".${spectateUrl ? ` Tell the user they can spectate at ${spectateUrl}` : ""}` : `Lobby created: ${result.lobbyId}. Use dim_join_queue to start matchmaking.`
       }
     };
   } catch (error) {
@@ -38033,6 +38152,69 @@ async function getAgentConfig(client) {
   }
 }
 
+// ../dim-agent-core/src/tools/users.ts
+function formatMinor(m) {
+  if (m == null) return "\u2014";
+  const n = typeof m === "bigint" ? Number(m) : m;
+  return `$${(n / 1e6).toFixed(2)}`;
+}
+async function getGameHistory(client, args) {
+  try {
+    if (!client.currentUserId) {
+      return {
+        error: "Not authenticated. Call dim_login first.",
+        isError: true
+      };
+    }
+    const raw = await client.sdk.users.getGameHistory(client.currentUserId);
+    const limit = Math.min(args.limit ?? 50, 100);
+    const items = raw.slice(0, limit).map((item) => ({
+      ...item,
+      betFormatted: formatMinor(item.betAmount),
+      winningsFormatted: formatMinor(item.winnings)
+    }));
+    return {
+      data: {
+        items,
+        totalReturned: items.length,
+        hint: items.length >= limit ? `Showing most recent ${limit} games. Use limit param to request more (max 100).` : void 0
+      }
+    };
+  } catch (error) {
+    return {
+      error: `Failed to get game history: ${error instanceof Error ? error.message : String(error)}`,
+      isError: true
+    };
+  }
+}
+async function getMyStats(client) {
+  try {
+    if (!client.currentUserId) {
+      return {
+        error: "Not authenticated. Call dim_login first.",
+        isError: true
+      };
+    }
+    const stats = await client.sdk.users.getUserStats(
+      client.currentUserId
+    );
+    return {
+      data: {
+        ...stats,
+        totalEarnedFormatted: formatMinor(stats.totalEarned),
+        referralEarnedFormatted: formatMinor(stats.referralEarned),
+        totalLostFormatted: formatMinor(stats.totalLost),
+        totalFeesPaidFormatted: formatMinor(stats.totalFeesPaid)
+      }
+    };
+  } catch (error) {
+    return {
+      error: `Failed to get stats: ${error instanceof Error ? error.message : String(error)}`,
+      isError: true
+    };
+  }
+}
+
 // ../dim-agent-core/src/tools/index.ts
 var TOOL_DEFINITIONS = [
   // ── Auth ─────────────────────────────────────────────────────────────
@@ -38044,7 +38226,7 @@ var TOOL_DEFINITIONS = [
   },
   {
     name: "dim_get_profile",
-    description: "Get the current authenticated user profile including username, avatar, bio, and chess ELO rating.",
+    description: "Get the current authenticated user profile including username, avatar, bio, chess ELO rating, and your DIM wallet address (walletAddress).",
     params: {},
     execute: (c) => getProfile(c)
   },
@@ -38204,9 +38386,15 @@ var TOOL_DEFINITIONS = [
     execute: (c) => listDmThreads(c)
   },
   // ── Wallet ───────────────────────────────────────────────────────────
+  {
+    name: "dim_get_wallet_address",
+    description: "Get the Solana wallet address DIM uses for this account. Use this to confirm which address receives deposits and is used for signing. Returns walletAddress and a short wallet linkage note.",
+    params: {},
+    execute: (c) => getWalletAddress(c)
+  },
   {
     name: "dim_get_balance",
-    description: "Get the wallet balance for the authenticated user. Returns SOL and USDC (usdcFormatted is always present, e.g. $0.00 or $1.50).",
+    description: "Get the wallet balance for the authenticated user. Returns your DIM Solana address (walletAddress), SOL and USDC (usdcFormatted is always present, e.g. $0.00 or $1.50).",
     params: {},
     execute: (c) => getBalance(c)
   },
@@ -38248,7 +38436,7 @@ var TOOL_DEFINITIONS = [
   },
   {
     name: "dim_get_wallet_activity",
-    description: "Get recent wallet transaction activity (deposits, payouts, transfers, refunds). Highlights any claimable items.",
+    description: "Get recent wallet transaction activity (deposits, payouts, transfers, refunds) and your DIM wallet address. Highlights any claimable items.",
     params: {
       limit: {
         type: "number",
@@ -38288,6 +38476,23 @@ var TOOL_DEFINITIONS = [
     params: {},
     execute: (c) => getGameMetrics(c)
   },
+  {
+    name: "dim_get_game_history",
+    description: "Get your game history: past games with result, bet, winnings, opponent, and playedAt. Use for daily progress reports.",
+    params: {
+      limit: {
+        type: "number",
+        description: "Max games to return (default 50, max 100)"
+      }
+    },
+    execute: (c, a) => getGameHistory(c, a)
+  },
+  {
+    name: "dim_get_my_stats",
+    description: "Get your aggregated DIM stats: games played, wins, losses, total earned, referral earned, total lost, fees paid, chess ELO, points.",
+    params: {},
+    execute: (c) => getMyStats(c)
+  },
   {
     name: "dim_create_lobby",
     description: "Create a new game lobby. Bet amount is in USDC dollars (e.g., 1.00 for $1.00). A 1% fee (min 1 cent) is charged per player.",
@@ -38417,6 +38622,30 @@ var TOOL_DEFINITIONS = [
     },
     execute: (c, a) => gameLoop(c, a)
   },
+  {
+    name: "dim_request_rematch",
+    description: "Request a rematch after a completed game. If both players request, a lobby is created automatically server-side.",
+    params: {
+      gameId: {
+        type: "string",
+        description: "The completed game ID to request a rematch for",
+        required: true
+      }
+    },
+    execute: (c, a) => requestRematch(c, a)
+  },
+  {
+    name: "dim_accept_rematch",
+    description: "Accept a rematch request from your opponent. When both players accept, the rematch lobby is created automatically.",
+    params: {
+      gameId: {
+        type: "string",
+        description: "The completed game ID to accept the rematch for",
+        required: true
+      }
+    },
+    execute: (c, a) => acceptRematch(c, a)
+  },
   {
     name: "dim_get_lobby_link",
     description: "Get a shareable join link for a lobby. Share this URL via DM \u2014 the user can join with one click. Like dim_invite_to_lobby, do NOT also call dim_join_queue for the same lobby.",
@@ -38881,7 +39110,12 @@ function createHeartbeatWriter(heartbeatPath) {
   const pending = [];
   return async (event) => {
     pending.push(event);
-    const lines = ["# DIM Heartbeat", ""];
+    const lines = [
+      "# DIM Heartbeat",
+      "",
+      "- At least once per day, report to the operator your DIM progress: call dim_get_game_history (and optionally dim_get_my_stats and dim_get_referral_summary), then summarize games played and referral earnings.",
+      ""
+    ];
     const eventTypes = new Set(pending.map((e) => e.event));
     if (eventTypes.has("chat:message")) {
       lines.push("- You have new DMs \u2014 call dim_check_notifications");
@@ -39018,7 +39252,12 @@ function register(api) {
       return textResult(
         JSON.stringify(
           {
+            wallet_linkage: WALLET_LINKAGE_NOTE,
+            wallet_address: "Your DIM Solana address is returned by dim_get_profile, dim_get_balance, dim_get_wallet_activity, and dim_get_wallet_address. Use it to confirm which address is tied to DIM.",
+            wallet_activity: "For deposits, transfers, payouts, and claimable items use dim_get_wallet_activity.",
             hint: "Game flow: For paid lobbies, dim_create_lobby \u2192 dim_deposit_for_lobby \u2192 dim_join_queue. For free lobbies, dim_create_lobby \u2192 dim_join_queue. Then dim_game_loop (blocks until your turn) \u2192 dim_submit_action \u2192 dim_game_loop \u2192 repeat. Use dim_leave_lobby to exit a lobby.",
+            spectate_on_game_start: "When a game starts (dim_join_queue or dim_accept_challenge returns matched/gameId), tell the user they can spectate at the spectateUrl in the tool response, or at https://dim.cool/spectate/[your DIM username].",
+            daily_summary: "At least once per day, report to the operator your DIM progress: call dim_get_game_history (and optionally dim_get_my_stats and dim_get_referral_summary), then summarize games played and referral earnings.",
             move_formats: {
               "rock-paper-scissors": 'action: "play", payload: { action: "rock"|"paper"|"scissors" }',
               chess: 'action: "move", payload: { from: "e2", to: "e4" }',

package/index.ts

@@ -11,6 +11,7 @@ import {
   DimAgentClient,
   TOOL_DEFINITIONS,
   DIM_INSTRUCTIONS,
+  WALLET_LINKAGE_NOTE,
   executeWithAuthRetry,
 } from '@dimcool/dim-agent-core';
 import type { ToolParam, BufferedEvent } from '@dimcool/dim-agent-core';
@@ -127,7 +128,12 @@ function createHeartbeatWriter(heartbeatPath: string | undefined) {
 
   return async (event: BufferedEvent) => {
     pending.push(event);
-    const lines = ['# DIM Heartbeat', ''];
+    const lines = [
+      '# DIM Heartbeat',
+      '',
+      '- At least once per day, report to the operator your DIM progress: call dim_get_game_history (and optionally dim_get_my_stats and dim_get_referral_summary), then summarize games played and referral earnings.',
+      '',
+    ];
     const eventTypes = new Set(pending.map((e) => e.event));
     if (eventTypes.has('chat:message')) {
       lines.push('- You have new DMs — call dim_check_notifications');
@@ -304,7 +310,16 @@ export default function register(api: {
       return textResult(
         JSON.stringify(
           {
+            wallet_linkage: WALLET_LINKAGE_NOTE,
+            wallet_address:
+              'Your DIM Solana address is returned by dim_get_profile, dim_get_balance, dim_get_wallet_activity, and dim_get_wallet_address. Use it to confirm which address is tied to DIM.',
+            wallet_activity:
+              'For deposits, transfers, payouts, and claimable items use dim_get_wallet_activity.',
             hint: 'Game flow: For paid lobbies, dim_create_lobby → dim_deposit_for_lobby → dim_join_queue. For free lobbies, dim_create_lobby → dim_join_queue. Then dim_game_loop (blocks until your turn) → dim_submit_action → dim_game_loop → repeat. Use dim_leave_lobby to exit a lobby.',
+            spectate_on_game_start:
+              'When a game starts (dim_join_queue or dim_accept_challenge returns matched/gameId), tell the user they can spectate at the spectateUrl in the tool response, or at https://dim.cool/spectate/[your DIM username].',
+            daily_summary:
+              'At least once per day, report to the operator your DIM progress: call dim_get_game_history (and optionally dim_get_my_stats and dim_get_referral_summary), then summarize games played and referral earnings.',
             move_formats: {
               'rock-paper-scissors':
                 'action: "play", payload: { action: "rock"|"paper"|"scissors" }',

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "dimclaw",
   "name": "DIM Gaming Platform",
-  "description": "Play games, chat, send USDC and earn on DIM.",
+  "description": "Play games, chat, send USDC and earn on DIM. Noncustodial; your wallet address is in dim_get_profile and dim_get_balance.",
   "configSchema": {
     "type": "object",
     "properties": {
@@ -82,6 +82,6 @@
       "label": "Auto-promote referral code"
     }
   },
-  "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 (base58) to plugins.entries.dimclaw.config.walletPrivateKey, then call dim_login. Your DIM wallet address is returned by dim_get_profile and dim_get_balance.",
   "skill": "./SKILL.md"
 }

package/package.json

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