@dimcool/mcp 0.1.29 → 0.1.31

package/dist/index.js

@@ -7328,8 +7328,6 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { Transaction } from "@solana/web3.js";
 import { Transaction as Transaction2 } from "@solana/web3.js";
 import { Transaction as Transaction3 } from "@solana/web3.js";
-import { Transaction as Transaction4 } from "@solana/web3.js";
-import { Transaction as Transaction5 } from "@solana/web3.js";
 
 // ../../node_modules/engine.io-client/build/esm-debug/transports/polling-xhr.node.js
 var XMLHttpRequestModule = __toESM(require_XMLHttpRequest(), 1);
@@ -11587,6 +11585,16 @@ var Auth = class {
     this.logger.debug("Token stored in storage", { tokenKey: TOKEN_KEY });
     return response;
   }
+  async loginWithExternalSignature(address, signedMessage, options) {
+    const response = await this.http.post("/auth/login-wallet", {
+      signedMessage,
+      address,
+      referralCode: options?.referralCode,
+      walletMeta: options?.walletMeta
+    });
+    this.storage.set(TOKEN_KEY, response.access_token);
+    return response;
+  }
   logout() {
     this.logger.debug("Auth.logout called");
     const hadToken = this.storage.get(TOKEN_KEY) !== null;
@@ -11600,6 +11608,10 @@ var Auth = class {
     });
     return isAuth;
   }
+  async getSessionStats() {
+    this.logger.debug("Auth.getSessionStats called");
+    return this.http.get("/auth/sessions/stats");
+  }
   async getLatestSessions(limit) {
     this.logger.debug("Auth.getLatestSessions called", { limit });
     const params = new URLSearchParams();
@@ -11618,6 +11630,9 @@ var Admin = class {
     this.http = http;
     this.logger = logger2;
   }
+  async getInternalBots() {
+    return this.http.get("/admin/internal-bots");
+  }
   async getUserById(id) {
     return this.http.get(`/admin/users/${id}`);
   }
@@ -11823,11 +11838,25 @@ var Users = class {
   async removeFriend(userId) {
     return this.http.delete(`/friends/${userId}`);
   }
-  async getIncomingFriendRequests() {
-    return this.http.get("/friends/requests/incoming");
+  async getIncomingFriendRequests(opts) {
+    const params = new URLSearchParams();
+    if (opts?.limit !== void 0)
+      params.append("limit", opts.limit.toString());
+    if (opts?.cursor !== void 0) params.append("cursor", opts.cursor);
+    const qs = params.toString();
+    return this.http.get(
+      qs ? `/friends/requests/incoming?${qs}` : "/friends/requests/incoming"
+    );
   }
-  async getOutgoingFriendRequests() {
-    return this.http.get("/friends/requests/outgoing");
+  async getOutgoingFriendRequests(opts) {
+    const params = new URLSearchParams();
+    if (opts?.limit !== void 0)
+      params.append("limit", opts.limit.toString());
+    if (opts?.cursor !== void 0) params.append("cursor", opts.cursor);
+    const qs = params.toString();
+    return this.http.get(
+      qs ? `/friends/requests/outgoing?${qs}` : "/friends/requests/outgoing"
+    );
   }
   async acceptFriendRequest(userId) {
     return this.http.post(
@@ -11914,6 +11943,9 @@ var FeatureFlags = class {
     this.loaded = true;
     return this.flags;
   }
+  async getAdminFeatureFlags() {
+    return this.http.get("/feature-flags/admin");
+  }
   isEnabledFlag(name) {
     const flag = this.flags.find((f) => f.name === name);
     return flag?.enabled ?? false;
@@ -11933,10 +11965,11 @@ var FeatureFlags = class {
     }
     return flag;
   }
-  async createFeatureFlag(name, enabled) {
+  async createFeatureFlag(name, enabled, description) {
     const flag = await this.http.post("/feature-flags", {
       name,
-      enabled
+      enabled,
+      ...description !== void 0 && { description }
     });
     this.flags.push(flag);
     return flag;
@@ -11947,11 +11980,17 @@ var Lobbies = class {
     this.http = http;
     this.logger = logger2;
   }
+  /** Called by SDK after the store is created so mutations can update state directly. */
+  setLobbyStore(store) {
+    this.lobbyStore = store;
+  }
   async createLobby(gameType, betAmount) {
     return this.http.post("/lobbies", { gameType, betAmount });
   }
   async getLobby(lobbyId) {
-    return this.http.get(`/lobbies/${lobbyId}`);
+    const lobby = await this.http.get(`/lobbies/${lobbyId}`);
+    this.lobbyStore?.setBaseState([lobby]);
+    return lobby;
   }
   async inviteFriend(lobbyId, friendId) {
     return this.http.post(`/lobbies/${lobbyId}/invite`, {
@@ -11962,7 +12001,9 @@ var Lobbies = class {
     return this.http.post(`/lobbies/${lobbyId}/accept-invite`, {});
   }
   async joinLobby(lobbyId) {
-    return this.http.post(`/lobbies/${lobbyId}/join`, {});
+    const lobby = await this.http.post(`/lobbies/${lobbyId}/join`, {});
+    this.lobbyStore?.setBaseState([lobby]);
+    return lobby;
   }
   async removePlayer(lobbyId, userId) {
     return this.http.delete(
@@ -11979,12 +12020,17 @@ var Lobbies = class {
     return this.http.post(`/lobbies/${lobbyId}/join-queue`, {});
   }
   async cancelQueue(lobbyId) {
-    return this.http.delete(`/lobbies/${lobbyId}/queue`);
+    const lobby = await this.http.delete(`/lobbies/${lobbyId}/queue`);
+    this.lobbyStore?.setBaseState([lobby]);
+    return lobby;
   }
   async updateBetAmount(lobbyId, betAmount) {
-    return this.http.patch(`/lobbies/${lobbyId}/bet-amount`, {
-      betAmount
-    });
+    const lobby = await this.http.patch(
+      `/lobbies/${lobbyId}/bet-amount`,
+      { betAmount }
+    );
+    this.lobbyStore?.setBaseState([lobby]);
+    return lobby;
   }
   async playSound(lobbyId, sound) {
     return this.http.post(`/lobbies/${lobbyId}/sound`, {
@@ -12023,6 +12069,12 @@ var Games = class {
     this.wallet = wallet;
     this.logger = logger2;
   }
+  setGameStore(store) {
+    this.gameStore = store;
+  }
+  setGameActionsStore(store) {
+    this.gameActionsStore = store;
+  }
   async getAvailableGames() {
     return this.http.get("/games/available");
   }
@@ -12035,7 +12087,11 @@ var Games = class {
     return this.http.get("/games/metrics");
   }
   async getGame(gameId) {
-    return this.http.get(`/games/${gameId}`);
+    const existing = this.gameStore?.store.getState().gamesById[gameId];
+    if (existing?.status === "completed") return existing;
+    const game = await this.http.get(`/games/${gameId}`);
+    this.gameStore?.setBaseState([game]);
+    return game;
   }
   /**
    * Get list of currently active (live) games. Public endpoint for spectating.
@@ -12062,7 +12118,13 @@ var Games = class {
    * Get current game state with timer information
    */
   async getGameState(gameId) {
-    return this.http.get(`/games/${gameId}/state`);
+    const existing = this.gameActionsStore?.store.getState().statesByGameId[gameId];
+    if (existing?.status === "completed") return existing;
+    const state = await this.http.get(
+      `/games/${gameId}/state`
+    );
+    this.gameActionsStore?.setBaseState(gameId, state);
+    return state;
   }
   /**
    * Request a rematch for a completed game
@@ -12098,8 +12160,18 @@ var Games = class {
       { amountMinor, signedTransaction }
     );
   }
+  /**
+   * Confirm a donation that was already sent by the client (signAndSendTransaction path).
+   */
+  async confirmGameDonationSignature(gameId, amountMinor, signature) {
+    return this.http.post(
+      `/games/${gameId}/donate/confirm-signature`,
+      { amountMinor, signature }
+    );
+  }
   /**
    * One-call donation flow: prepare -> sign -> submit.
+   * Automatically uses the right signing path (embedded vs injected wallet).
    */
   async sendDonation(gameId, amountMinor) {
     if (!this.wallet.hasSigner()) {
@@ -12108,16 +12180,10 @@ var Games = class {
       );
     }
     const prepared = await this.prepareGameDonation(gameId, amountMinor);
-    const unsignedTx = Transaction2.from(base64ToBytes(prepared.transaction));
-    const signedTx = await this.wallet.signTransaction(unsignedTx);
-    const signedTransaction = bytesToBase64(
-      signedTx.serialize({ requireAllSignatures: false })
-    );
-    const result = await this.donateToGame(
-      gameId,
-      amountMinor,
-      signedTransaction
-    );
+    const result = await this.wallet.signAndDispatch(prepared.transaction, {
+      onSigned: (signedTxBase64) => this.donateToGame(gameId, amountMinor, signedTxBase64),
+      onSignedAndSent: (sig) => this.confirmGameDonationSignature(gameId, amountMinor, sig)
+    });
     return {
       ...result,
       escrowAddress: prepared.escrowAddress,
@@ -12210,6 +12276,9 @@ var Chat = class {
     this.logger = logger2;
     this.retryOptions = { ...DEFAULT_RETRY_OPTIONS, ...retryOptions };
   }
+  setDmThreadsStore(store) {
+    this.dmThreadsStore = store;
+  }
   encodeContextId(id) {
     return encodeURIComponent(id);
   }
@@ -12291,7 +12360,9 @@ var Chat = class {
     return response;
   }
   async listDmThreads() {
-    return this.http.get("/chat/dm/threads");
+    const threads = await this.http.get("/chat/dm/threads");
+    this.dmThreadsStore?.setBaseState(threads);
+    return threads;
   }
   async getDmThread(dmKey) {
     return this.http.get(
@@ -12379,21 +12450,32 @@ var Tips = class {
       );
     }
     const { publicKey: senderAddress } = await this.wallet.loadWallet();
-    const prepared = await this.prepare({ recipientUsername, amount });
-    const unsignedTx = Transaction3.from(base64ToBytes(prepared.transaction));
-    const signedTx = await this.wallet.signTransaction(unsignedTx);
-    const signedTxBase64 = bytesToBase64(
-      signedTx.serialize({ requireAllSignatures: false })
-    );
-    const transfer = await this.wallet.submitTransfer(
-      signedTxBase64,
-      senderAddress,
-      prepared.recipientAddress,
-      prepared.amount,
-      "USDC",
-      false,
-      prepared.recipientUsername
-    );
+    const supportsPresign = !this.wallet.isSignAndSendMode();
+    const prepared = await this.prepare({
+      recipientUsername,
+      amount,
+      supportsPresign
+    });
+    const transfer = await this.wallet.signAndDispatch(prepared.transaction, {
+      onSigned: (signedTxBase64) => this.wallet.submitTransfer(
+        signedTxBase64,
+        senderAddress,
+        prepared.recipientAddress,
+        prepared.amount,
+        "USDC",
+        false,
+        prepared.recipientUsername
+      ),
+      onSignedAndSent: (sig) => this.wallet.confirmTransferSignature(
+        sig,
+        senderAddress,
+        prepared.recipientAddress,
+        prepared.amount,
+        "USDC",
+        false,
+        prepared.recipientUsername
+      )
+    });
     const message = await this.chat.broadcastGlobalTip(
       prepared.recipientUserId,
       prepared.amount
@@ -12711,13 +12793,15 @@ var Wallet = class {
       );
     }
     try {
+      const supportsPresign = !this.isSignAndSendMode();
       const response = await this.http.post(
         "/wallets/transfer/prepare",
         {
           senderAddress,
           recipient,
           amount: amountMinor,
-          token
+          token,
+          supportsPresign
         }
       );
       this.logger.debug("Transfer prepared", {
@@ -12801,6 +12885,29 @@ var Wallet = class {
       throw error;
     }
   }
+  /**
+   * Sign a prepared transaction and invoke the appropriate backend callback
+   * based on the configured signer — without exposing the mode decision to callers.
+   *   - Embedded wallet (signAndSend): signs+sends, calls onSignedAndSent(signature)
+   *   - Injected wallet (signTransaction): signs locally, calls onSigned(signedTxBase64)
+   */
+  async signAndDispatch(unsignedTxBase64, handlers) {
+    if (!this.signer) {
+      throw new Error(
+        "No signer configured. Call setSigner() with a WalletSigner implementation first."
+      );
+    }
+    const unsignedTx = Transaction2.from(base64ToBytes(unsignedTxBase64));
+    if (this.isSignAndSendMode()) {
+      const sig = await this.signAndSendTransaction(unsignedTx);
+      return handlers.onSignedAndSent(sig);
+    }
+    const signedTx = await this.signTransaction(unsignedTx);
+    const signedBase64 = bytesToBase64(
+      signedTx.serialize({ requireAllSignatures: false })
+    );
+    return handlers.onSigned(signedBase64);
+  }
   /**
    * Full transfer flow in one call: prepare -> sign -> submit
    * Recipient can be username, .sol domain, or Solana address (resolved by backend).
@@ -12817,7 +12924,7 @@ var Wallet = class {
       amount,
       token
     );
-    const unsignedTx = Transaction4.from(base64ToBytes(prepared.transaction));
+    const unsignedTx = Transaction2.from(base64ToBytes(prepared.transaction));
     let submitted;
     if (this.isSignAndSendMode()) {
       const signature = await this.signAndSendTransaction(unsignedTx);
@@ -12882,12 +12989,32 @@ var Escrow = class {
    * initializes depositStatus, and prepares the unsigned transaction in one call.
    * Eliminates one HTTP round-trip vs startDeposits() + prepareDepositTransaction().
    */
-  async prepareAndStartDeposit(lobbyId) {
+  async prepareAndStartDeposit(lobbyId, supportsPresign) {
+    const presign = supportsPresign ?? !this.wallet.isSignAndSendMode();
     return this.http.post(
       `/escrow/lobby/${lobbyId}/deposit/prepare-and-start`,
-      {}
+      { supportsPresign: presign }
     );
   }
+  /**
+   * Sign and submit a prepared (unsigned) deposit transaction using the
+   * configured signer. Automatically picks the right path:
+   *   - Embedded wallet: signAndSendTransaction → confirmDepositSignature
+   *   - Injected wallet: signTransaction → submitDeposit
+   * Returns the on-chain signature.
+   */
+  async signAndSubmitPreparedDeposit(lobbyId, unsignedTxBase64) {
+    return this.wallet.signAndDispatch(unsignedTxBase64, {
+      onSigned: async (signedTxBase64) => {
+        const result = await this.submitDeposit(lobbyId, signedTxBase64);
+        return result.signature;
+      },
+      onSignedAndSent: async (signature) => {
+        await this.confirmDepositSignature(lobbyId, signature);
+        return signature;
+      }
+    });
+  }
   /**
    * Submit a signed deposit transaction
    * The transaction will be submitted to the Solana network and confirmed
@@ -12930,8 +13057,12 @@ var Escrow = class {
         "No signer configured. Use sdk.wallet.setSigner(...) first."
       );
     }
-    const { transaction } = await this.prepareAndStartDeposit(lobbyId);
-    const unsignedTx = Transaction5.from(base64ToBytes(transaction));
+    const supportsPresign = !this.wallet.isSignAndSendMode();
+    const { transaction } = await this.prepareAndStartDeposit(
+      lobbyId,
+      supportsPresign
+    );
+    const unsignedTx = Transaction3.from(base64ToBytes(transaction));
     let signature;
     if (this.wallet.isSignAndSendMode()) {
       signature = await this.wallet.signAndSendTransaction(unsignedTx);
@@ -12965,8 +13096,13 @@ var Escrow = class {
     };
   }
   /**
-   * Zero-polling deposit variant using server-side awaitConfirmation.
-   * 2 HTTP calls total, 0 client-side polling. Ideal for agents.
+   * Deposit for a lobby and wait until the calling user's own deposit is confirmed.
+   * Ideal for agents: returns as soon as your deposit is on-chain without waiting
+   * for the other player. The server auto-joins the queue when all players deposit.
+   *
+   * Confirmation is handled asynchronously by the transaction queue processor.
+   * This method polls the deposit status endpoint until the signature appears as
+   * confirmed (up to 60 seconds).
    *
    * Automatically uses signAndSendTransaction or signTransaction based on signer capability.
    */
@@ -12976,26 +13112,45 @@ var Escrow = class {
         "No signer configured. Use sdk.wallet.setSigner(...) first."
       );
     }
-    const { transaction } = await this.prepareAndStartDeposit(lobbyId);
-    const unsignedTx = Transaction5.from(base64ToBytes(transaction));
+    const supportsPresign2 = !this.wallet.isSignAndSendMode();
+    const { transaction } = await this.prepareAndStartDeposit(
+      lobbyId,
+      supportsPresign2
+    );
+    const unsignedTx = Transaction3.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 }
-      );
+      await this.confirmDepositSignature(lobbyId, 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;
+      const submitResult = await this.submitDeposit(lobbyId, signedBase64);
+      signature = submitResult.signature;
+    }
+    const MAX_WAIT_MS = 6e4;
+    const POLL_INTERVAL_MS = 1e3;
+    const startTime = Date.now();
+    while (Date.now() - startTime < MAX_WAIT_MS) {
+      const status = await this.getDepositStatus(lobbyId);
+      const myDeposit = status.deposits.find(
+        (d) => d.transactionHash === signature
+      );
+      if (myDeposit?.status === "confirmed") {
+        return {
+          signature,
+          status: "confirmed",
+          canProceedToQueue: status.canProceedToQueue
+        };
+      }
+      if (status.allConfirmed && status.canProceedToQueue) {
+        return { signature, status: "confirmed", canProceedToQueue: true };
+      }
+      await new Promise((r) => setTimeout(r, POLL_INTERVAL_MS));
     }
-    return { signature, status: "confirmed", canProceedToQueue: true };
+    return { signature, status: "pending", canProceedToQueue: false };
   }
   async claimLobbyDepositRefund(lobbyId, depositSignature) {
     return this.http.post(
@@ -13337,9 +13492,10 @@ var Support = class {
   }
 };
 var Markets = class {
-  constructor(http, logger2) {
+  constructor(http, logger2, wallet) {
     this.http = http;
     this.logger = logger2;
+    this.wallet = wallet;
   }
   /**
    * Get the prediction market state for a game.
@@ -13381,6 +13537,35 @@ var Markets = class {
       { signedTransaction, outcomeId, amountMinor }
     );
   }
+  /**
+   * Confirm a buy order that was already broadcast by the client (signAndSendTransaction path).
+   */
+  async confirmBuyOrderSignature(gameId, depositSignature, outcomeId, amountMinor) {
+    return this.http.post(
+      `/games/${gameId}/market/orders/buy/confirm-signature`,
+      { depositSignature, outcomeId, amountMinor }
+    );
+  }
+  /**
+   * One-call buy order: prepare → sign → submit, automatically choosing
+   * the right signing path (embedded vs injected wallet).
+   */
+  async buy(gameId, outcomeId, amountMinor) {
+    if (!this.wallet?.hasSigner()) {
+      throw new Error(
+        "No signer configured. Use sdk.wallet.setSigner(...) first."
+      );
+    }
+    const { transaction } = await this.prepareBuyOrder(
+      gameId,
+      outcomeId,
+      amountMinor
+    );
+    return this.wallet.signAndDispatch(transaction, {
+      onSigned: (signedTxBase64) => this.submitBuyOrder(gameId, signedTxBase64, outcomeId, amountMinor),
+      onSignedAndSent: (sig) => this.confirmBuyOrderSignature(gameId, sig, outcomeId, amountMinor)
+    });
+  }
   /**
    * Sell shares back to the AMM pool.
    * @param gameId - The game ID
@@ -13429,6 +13614,20 @@ var Markets = class {
     return this.http.get(`/games/admin/markets${qs ? `?${qs}` : ""}`);
   }
 };
+var NoopAnalyticsClient = class {
+  userLoggedIn(_user, _meta) {
+  }
+  userLoggedOut() {
+  }
+  sessionRestored(_user) {
+  }
+  track(_event, _properties) {
+  }
+  setUserProperties(_properties) {
+  }
+  group(_groupType, _groupKey, _properties) {
+  }
+};
 var BaseWsTransport = class {
   constructor() {
     this.roomRefs = /* @__PURE__ */ new Map();
@@ -13516,21 +13715,35 @@ var _StandaloneWsTransport = class _StandaloneWsTransport2 extends BaseWsTranspo
     this.accessToken = null;
     this.reconnectAttempts = 0;
     this.reconnectTimer = null;
-    this.periodicReconnectInterval = null;
-    this.maxReconnectAttempts = 5;
-    this.reconnectDelay = 1e3;
-    this.reconnectDelayMax = 3e4;
+    this.needsReconnect = false;
+    this.visibilityHandler = null;
     this.wildcardHandlers = /* @__PURE__ */ new Set();
     this.eventHandlers = /* @__PURE__ */ new Map();
     this.registeredEvents = /* @__PURE__ */ new Set();
     this.wildcardRegistered = false;
     this.url = url2;
+    if (typeof document !== "undefined") {
+      this.visibilityHandler = () => {
+        if (document.visibilityState === "visible" && !this.connectionState.connected) {
+          this.reconnectImmediately();
+        }
+      };
+      document.addEventListener("visibilitychange", this.visibilityHandler);
+    }
   }
   connect() {
+    if (this.reconnectTimer !== null) {
+      clearTimeout(this.reconnectTimer);
+      this.reconnectTimer = null;
+    }
+    this.reconnectAttempts = 0;
     this.ensureSocket();
   }
   disconnect() {
-    this.clearPeriodicReconnect();
+    if (this.visibilityHandler && typeof document !== "undefined") {
+      document.removeEventListener("visibilitychange", this.visibilityHandler);
+      this.visibilityHandler = null;
+    }
     if (!this.socket) return;
     this.socket.disconnect();
     this.socket = null;
@@ -13629,13 +13842,13 @@ var _StandaloneWsTransport = class _StandaloneWsTransport2 extends BaseWsTranspo
       reconnection: false
     });
     socket.on("connect", () => {
-      this.clearPeriodicReconnect();
       this.updateConnectionState({
         connected: true,
         connecting: false,
         error: null
       });
-      const wasReconnect = this.reconnectAttempts > 0;
+      const wasReconnect = this.needsReconnect;
+      this.needsReconnect = false;
       this.reconnectAttempts = 0;
       this.onReconnect();
       if (wasReconnect) {
@@ -13646,6 +13859,7 @@ var _StandaloneWsTransport = class _StandaloneWsTransport2 extends BaseWsTranspo
     });
     socket.on("disconnect", (reason) => {
       this.updateConnectionState({ connected: false, connecting: false });
+      this.needsReconnect = true;
       this.clearSocketForReconnect();
       if (reason === "io server disconnect") {
         this.handleAuthFailure("io server disconnect");
@@ -13655,6 +13869,7 @@ var _StandaloneWsTransport = class _StandaloneWsTransport2 extends BaseWsTranspo
     });
     socket.on("connect_error", (error) => {
       const message = error?.message || "connect_error";
+      this.needsReconnect = true;
       this.clearSocketForReconnect();
       if (message.includes("unauthorized") || message.includes("401")) {
         this.handleAuthFailure(message);
@@ -13682,31 +13897,31 @@ var _StandaloneWsTransport = class _StandaloneWsTransport2 extends BaseWsTranspo
     this.socket.removeAllListeners();
     this.socket = null;
   }
-  clearPeriodicReconnect() {
-    if (this.periodicReconnectInterval !== null) {
-      clearInterval(this.periodicReconnectInterval);
-      this.periodicReconnectInterval = null;
+  reconnectImmediately() {
+    if (this.reconnectTimer !== null) {
+      clearTimeout(this.reconnectTimer);
+      this.reconnectTimer = null;
     }
-  }
-  startPeriodicReconnect() {
-    if (this.periodicReconnectInterval !== null) return;
-    this.periodicReconnectInterval = setInterval(() => {
-      if (this.connectionState.connected) return;
-      this.reconnectAttempts = 0;
-      this.ensureSocket();
-    }, _StandaloneWsTransport2.PERIODIC_RECONNECT_MS);
+    this.reconnectAttempts = 0;
+    this.ensureSocket();
   }
   scheduleReconnect() {
     if (this.reconnectTimer !== null) return;
-    if (this.reconnectAttempts >= this.maxReconnectAttempts) {
-      this.startPeriodicReconnect();
-      return;
-    }
-    const delay = Math.min(
-      this.reconnectDelay * Math.pow(2, this.reconnectAttempts),
-      this.reconnectDelayMax
-    );
+    const attempt = this.reconnectAttempts;
     this.reconnectAttempts += 1;
+    let delay;
+    if (attempt < _StandaloneWsTransport2.FAST_RETRY_LIMIT) {
+      delay = _StandaloneWsTransport2.FAST_RETRY_DELAY_MS;
+    } else {
+      const backoffAttempt = attempt - _StandaloneWsTransport2.FAST_RETRY_LIMIT;
+      delay = Math.min(
+        _StandaloneWsTransport2.FAST_RETRY_DELAY_MS * Math.pow(2, backoffAttempt),
+        _StandaloneWsTransport2.MAX_BACKOFF_MS
+      );
+      if (attempt === _StandaloneWsTransport2.FAST_RETRY_LIMIT) {
+        this.dispatchEvent("connection:slow-retry", { timestamp: Date.now() });
+      }
+    }
     this.reconnectTimer = setTimeout(() => {
       this.reconnectTimer = null;
       this.ensureSocket();
@@ -13767,7 +13982,9 @@ var _StandaloneWsTransport = class _StandaloneWsTransport2 extends BaseWsTranspo
     this.wildcardRegistered = true;
   }
 };
-_StandaloneWsTransport.PERIODIC_RECONNECT_MS = 5 * 60 * 1e3;
+_StandaloneWsTransport.FAST_RETRY_LIMIT = 60;
+_StandaloneWsTransport.FAST_RETRY_DELAY_MS = 1e3;
+_StandaloneWsTransport.MAX_BACKOFF_MS = 3e4;
 var StandaloneWsTransport = _StandaloneWsTransport;
 function createSdkStore(initial) {
   const store = createStore()(subscribeWithSelector(() => initial));
@@ -13788,14 +14005,16 @@ function createLobbyStore(transport2) {
     depositStatusByLobbyId: {}
   });
   const setBaseState = (lobbies) => {
-    const lobbiesById = {};
-    for (const lobby of lobbies) {
-      lobbiesById[lobby.id] = lobby;
-    }
-    store.updateState((state) => ({
-      ...state,
-      lobbiesById
-    }));
+    store.updateState((state) => {
+      const lobbiesById = { ...state.lobbiesById };
+      for (const lobby of lobbies) {
+        const existing = lobbiesById[lobby.id];
+        if (!existing || lobby.updatedAt >= existing.updatedAt) {
+          lobbiesById[lobby.id] = lobby;
+        }
+      }
+      return { ...state, lobbiesById };
+    });
   };
   const applyWsEvent = (event) => {
     switch (event.event) {
@@ -13925,12 +14144,23 @@ function createGameStore(transport2) {
     gamesById: {},
     spectatorCounts: {}
   });
+  const STATUS_RANK = {
+    active: 0,
+    completed: 1,
+    abandoned: 1
+  };
   const setBaseState = (games) => {
-    const gamesById = {};
-    for (const game of games) {
-      gamesById[game.gameId] = game;
-    }
-    store.updateState((state) => ({ ...state, gamesById }));
+    store.updateState((state) => {
+      const gamesById = { ...state.gamesById };
+      for (const game of games) {
+        const existing = gamesById[game.gameId];
+        if (existing && STATUS_RANK[existing.status] > STATUS_RANK[game.status]) {
+          continue;
+        }
+        gamesById[game.gameId] = game;
+      }
+      return { ...state, gamesById };
+    });
   };
   const applyWsEvent = (event) => {
     switch (event.event) {
@@ -14026,8 +14256,21 @@ function createGameActionsStore(transport2) {
     });
   };
   const isNonRpsState = (state) => Boolean(state && !isRpsState(state));
+  const pendingEvents = /* @__PURE__ */ new Map();
+  function enqueue(gameId, event) {
+    const q = pendingEvents.get(gameId) ?? [];
+    q.push(event);
+    pendingEvents.set(gameId, q);
+  }
+  function drainQueue(gameId) {
+    const q = pendingEvents.get(gameId);
+    if (!q?.length) return;
+    pendingEvents.delete(gameId);
+    for (const ev of q) applyWsEvent(ev);
+  }
   const setBaseState = (gameId, state) => {
     updateState(gameId, state);
+    drainQueue(gameId);
   };
   const clearState = (gameId) => {
     store.updateState((state) => {
@@ -14037,6 +14280,7 @@ function createGameActionsStore(transport2) {
       const { [gameId]: _, ...rest } = state.statesByGameId;
       return { ...state, statesByGameId: rest };
     });
+    pendingEvents.delete(gameId);
   };
   const applyWsEvent = (event) => {
     switch (event.event) {
@@ -14055,7 +14299,10 @@ function createGameActionsStore(transport2) {
       }
       case "game:rps:starting": {
         const current = store.getState().statesByGameId[event.payload.gameId];
-        if (!current || !isRpsState(current)) return;
+        if (!current || !isRpsState(current)) {
+          enqueue(event.payload.gameId, event);
+          return;
+        }
         const betAmount = typeof event.payload.betAmount === "number" ? event.payload.betAmount : void 0;
         const startedAt = typeof event.payload.startedAt === "string" ? event.payload.startedAt : current.roundState.startedAt;
         const bufferEndsAt = typeof event.payload.bufferEndsAt === "string" ? event.payload.bufferEndsAt : current.roundState.selectionEndsAt;
@@ -14076,7 +14323,10 @@ function createGameActionsStore(transport2) {
       }
       case "game:rps:round:started": {
         const current = store.getState().statesByGameId[event.payload.gameId];
-        if (!current || !isRpsState(current)) return;
+        if (!current || !isRpsState(current)) {
+          enqueue(event.payload.gameId, event);
+          return;
+        }
         const actions = {};
         const baseUsers = /* @__PURE__ */ new Set();
         Object.keys(current.roundState.actions).forEach(
@@ -14110,7 +14360,10 @@ function createGameActionsStore(transport2) {
       }
       case "game:rps:action:received": {
         const current = store.getState().statesByGameId[event.payload.gameId];
-        if (!current || !isRpsState(current)) return;
+        if (!current || !isRpsState(current)) {
+          enqueue(event.payload.gameId, event);
+          return;
+        }
         const updated = {
           ...current,
           roundState: {
@@ -14129,7 +14382,10 @@ function createGameActionsStore(transport2) {
       }
       case "game:rps:timer:cutoff": {
         const current = store.getState().statesByGameId[event.payload.gameId];
-        if (!current || !isRpsState(current)) return;
+        if (!current || !isRpsState(current)) {
+          enqueue(event.payload.gameId, event);
+          return;
+        }
         const updated = {
           ...current,
           roundState: {
@@ -14143,7 +14399,10 @@ function createGameActionsStore(transport2) {
       }
       case "game:rps:round:reveal": {
         const current = store.getState().statesByGameId[event.payload.gameId];
-        if (!current || !isRpsState(current)) return;
+        if (!current || !isRpsState(current)) {
+          enqueue(event.payload.gameId, event);
+          return;
+        }
         const actions = {};
         const payloadActions = event.payload.actions;
         Object.keys(payloadActions || {}).forEach((userId) => {
@@ -14167,7 +14426,10 @@ function createGameActionsStore(transport2) {
       }
       case "game:rps:round:completed": {
         const current = store.getState().statesByGameId[event.payload.gameId];
-        if (!current || !isRpsState(current)) return;
+        if (!current || !isRpsState(current)) {
+          enqueue(event.payload.gameId, event);
+          return;
+        }
         const roundHistory = [
           ...current.roundHistory || [],
           {
@@ -14192,7 +14454,10 @@ function createGameActionsStore(transport2) {
       }
       case "game:rps:timeout": {
         const current = store.getState().statesByGameId[event.payload.gameId];
-        if (!current || !isRpsState(current)) return;
+        if (!current || !isRpsState(current)) {
+          enqueue(event.payload.gameId, event);
+          return;
+        }
         const timedOutUser = event.payload.playerId;
         const action = event.payload.action;
         const updated = {
@@ -14217,7 +14482,10 @@ function createGameActionsStore(transport2) {
         const payload = event.payload;
         const { gameId } = payload;
         const current = store.getState().statesByGameId[gameId];
-        if (!current) return;
+        if (!current) {
+          enqueue(gameId, event);
+          return;
+        }
         const updated = isRpsCompletionPayload(payload) && isRpsState(current) ? {
           ...current,
           status: "completed",
@@ -14266,11 +14534,15 @@ function createGameActionsStore(transport2) {
         const current = store.getState().statesByGameId[gameId];
         const updated = current ? { ...current, ...incoming } : incoming;
         updateState(gameId, updated);
+        drainQueue(gameId);
         break;
       }
       case "game:rematch:requested": {
         const current = store.getState().statesByGameId[event.payload.gameId];
-        if (!current) return;
+        if (!current) {
+          enqueue(event.payload.gameId, event);
+          return;
+        }
         const requestedBy = event.payload.requestedBy;
         const userId = event.payload.userId;
         const requested = new Set(
@@ -14286,7 +14558,10 @@ function createGameActionsStore(transport2) {
       }
       case "game:rematch:cancelled": {
         const current = store.getState().statesByGameId[event.payload.gameId];
-        if (!current) return;
+        if (!current) {
+          enqueue(event.payload.gameId, event);
+          return;
+        }
         const requestedBy = event.payload.requestedBy ?? [];
         const updated = {
           ...current,
@@ -14297,7 +14572,10 @@ function createGameActionsStore(transport2) {
       }
       case "game:rematch:started": {
         const current = store.getState().statesByGameId[event.payload.gameId];
-        if (!current) return;
+        if (!current) {
+          enqueue(event.payload.gameId, event);
+          return;
+        }
         const updated = {
           ...current,
           rematchRequestedBy: event.payload.playerIds ?? []
@@ -14308,7 +14586,10 @@ function createGameActionsStore(transport2) {
       case "game:pot:updated": {
         const { gameId, totalPotMinor } = event.payload;
         const current = store.getState().statesByGameId[gameId];
-        if (!current) return;
+        if (!current) {
+          enqueue(gameId, event);
+          return;
+        }
         const updated = {
           ...current,
           totalPotMinor
@@ -14321,12 +14602,123 @@ function createGameActionsStore(transport2) {
     }
   };
   const joinGame = (gameId) => transport2.joinRoom(`game:${gameId}`);
+  const getCountdownDigit = (gameId, nowMs) => {
+    const state = store.getState().statesByGameId[gameId];
+    if (!state) return null;
+    if (isRpsState(state)) {
+      if (state.roundState.phase !== "starting") return null;
+      const remaining = new Date(state.roundState.selectionEndsAt).getTime() - nowMs;
+      if (remaining <= 0) return null;
+      return Math.ceil(remaining / 1e3);
+    }
+    const bufferEndsAt = state.bufferEndsAt;
+    if (bufferEndsAt) {
+      const remaining = new Date(bufferEndsAt).getTime() - nowMs;
+      if (remaining <= 0) return null;
+      return Math.ceil(remaining / 1e3);
+    }
+    return null;
+  };
+  const getChessClockTimes = (gameId, nowMs) => {
+    const state = store.getState().statesByGameId[gameId];
+    if (!state || state.gameType !== "chess") return null;
+    const s = state;
+    let whiteMs = s.whiteTimeMs ?? 0;
+    let blackMs = s.blackTimeMs ?? 0;
+    if (s.status === "active" && s.currentPlayerId) {
+      const startedAt = Date.parse(s.turnStartedAt);
+      if (!Number.isNaN(startedAt)) {
+        const elapsed = Math.max(0, nowMs - startedAt);
+        if (s.currentPlayerId === s.whitePlayerId) {
+          whiteMs = Math.max(0, whiteMs - elapsed);
+        } else if (s.currentPlayerId === s.blackPlayerId) {
+          blackMs = Math.max(0, blackMs - elapsed);
+        }
+      }
+    }
+    return { whiteTimeMs: whiteMs, blackTimeMs: blackMs };
+  };
+  const getChessCapturedPieces = (gameId) => {
+    const state = store.getState().statesByGameId[gameId];
+    if (!state || state.gameType !== "chess") return null;
+    const fen = state.fen;
+    if (!fen) return { capturedByWhite: [], capturedByBlack: [] };
+    const placement = fen.split(" ")[0];
+    const white = {};
+    const black = {};
+    for (const char of placement) {
+      if (char === "/" || char >= "1" && char <= "8") continue;
+      const lower = char.toLowerCase();
+      if (char === lower) {
+        black[lower] = (black[lower] ?? 0) + 1;
+      } else {
+        white[lower] = (white[lower] ?? 0) + 1;
+      }
+    }
+    const INITIAL = {
+      p: 8,
+      r: 2,
+      n: 2,
+      b: 2,
+      q: 1,
+      k: 1
+    };
+    const capturedByWhite = [];
+    const capturedByBlack = [];
+    for (const [type, initial] of Object.entries(INITIAL)) {
+      const missingBlack = initial - (black[type] ?? 0);
+      for (let i = 0; i < missingBlack; i++) capturedByWhite.push(`b${type}`);
+      const missingWhite = initial - (white[type] ?? 0);
+      for (let i = 0; i < missingWhite; i++) capturedByBlack.push(`w${type}`);
+    }
+    return { capturedByWhite, capturedByBlack };
+  };
+  const getTicTacToeClockTimes = (gameId, nowMs) => {
+    const state = store.getState().statesByGameId[gameId];
+    if (!state || state.gameType !== "tic-tac-toe") return null;
+    const s = state;
+    let xMs = s.xTimeMs ?? 0;
+    let oMs = s.oTimeMs ?? 0;
+    if (s.status === "active" && s.currentPlayerId) {
+      const currentMark = s.playerMarks[s.currentPlayerId];
+      const startedAt = Date.parse(s.turnStartedAt);
+      if (!Number.isNaN(startedAt)) {
+        const elapsed = Math.max(0, nowMs - startedAt);
+        if (currentMark === "X") xMs = Math.max(0, xMs - elapsed);
+        else if (currentMark === "O") oMs = Math.max(0, oMs - elapsed);
+      }
+    }
+    return { xTimeMs: xMs, oTimeMs: oMs };
+  };
+  const getConnect4ClockTimes = (gameId, nowMs) => {
+    const state = store.getState().statesByGameId[gameId];
+    if (!state || state.gameType !== "connect-four") return null;
+    const s = state;
+    let redMs = s.redTimeMs ?? 0;
+    let yellowMs = s.yellowTimeMs ?? 0;
+    if (s.status === "active" && s.currentPlayerId) {
+      const currentColor = s.playerColors[s.currentPlayerId];
+      const startedAt = Date.parse(s.turnStartedAt);
+      if (!Number.isNaN(startedAt)) {
+        const elapsed = Math.max(0, nowMs - startedAt);
+        if (currentColor === "RED") redMs = Math.max(0, redMs - elapsed);
+        else if (currentColor === "YELLOW")
+          yellowMs = Math.max(0, yellowMs - elapsed);
+      }
+    }
+    return { redTimeMs: redMs, yellowTimeMs: yellowMs };
+  };
   return {
     store,
     setBaseState,
     clearState,
     applyWsEvent,
-    joinGame
+    joinGame,
+    getCountdownDigit,
+    getChessClockTimes,
+    getChessCapturedPieces,
+    getTicTacToeClockTimes,
+    getConnect4ClockTimes
   };
 }
 function isRpsState(state) {
@@ -14668,7 +15060,38 @@ function createNotificationsStore() {
       appNotifications: []
     }));
   };
-  return { store, applyWsEvent, setListFromApi, clear };
+  const markAsRead = (id) => {
+    store.updateState((state) => ({
+      ...state,
+      appNotifications: state.appNotifications.map(
+        (n) => n.id === id ? { ...n, read: true } : n
+      )
+    }));
+  };
+  const markAllAsRead = () => {
+    store.updateState((state) => ({
+      ...state,
+      appNotifications: state.appNotifications.map((n) => ({
+        ...n,
+        read: true
+      }))
+    }));
+  };
+  const dismiss = (id) => {
+    store.updateState((state) => ({
+      ...state,
+      appNotifications: state.appNotifications.filter((n) => n.id !== id)
+    }));
+  };
+  return {
+    store,
+    applyWsEvent,
+    setListFromApi,
+    clear,
+    markAsRead,
+    markAllAsRead,
+    dismiss
+  };
 }
 function createFriendsStore() {
   const store = createSdkStore({
@@ -14953,12 +15376,14 @@ var WsRouter = class {
       }
       const decoded = decodeWsEvent(eventName, payload);
       if (!decoded) return;
-      this.deps.lobbyStore.applyWsEvent(decoded);
-      this.deps.gameStore.applyWsEvent(decoded);
-      this.deps.gameActionsStore.applyWsEvent(decoded);
-      this.deps.chatStore.applyWsEvent(decoded);
-      this.deps.dmThreadsStore.applyWsEvent(decoded);
-      this.deps.notificationsStore.applyWsEvent(decoded);
+      const serverTs = payload !== null && typeof payload === "object" ? payload._serverTs : void 0;
+      const event = serverTs !== void 0 ? { ...decoded, _serverTs: serverTs } : decoded;
+      this.deps.lobbyStore.applyWsEvent(event);
+      this.deps.gameStore.applyWsEvent(event);
+      this.deps.gameActionsStore.applyWsEvent(event);
+      this.deps.chatStore.applyWsEvent(event);
+      this.deps.dmThreadsStore.applyWsEvent(event);
+      this.deps.notificationsStore.applyWsEvent(event);
     });
   }
   stop() {
@@ -14970,12 +15395,14 @@ var WsRouter = class {
       this.transport.subscribeEvent(eventName, (payload) => {
         const decoded = decodeWsEvent(eventName, payload);
         if (!decoded) return;
-        this.deps.lobbyStore.applyWsEvent(decoded);
-        this.deps.gameStore.applyWsEvent(decoded);
-        this.deps.gameActionsStore.applyWsEvent(decoded);
-        this.deps.chatStore.applyWsEvent(decoded);
-        this.deps.dmThreadsStore.applyWsEvent(decoded);
-        this.deps.notificationsStore.applyWsEvent(decoded);
+        const serverTs = payload !== null && typeof payload === "object" ? payload._serverTs : void 0;
+        const event = serverTs !== void 0 ? { ...decoded, _serverTs: serverTs } : decoded;
+        this.deps.lobbyStore.applyWsEvent(event);
+        this.deps.gameStore.applyWsEvent(event);
+        this.deps.gameActionsStore.applyWsEvent(event);
+        this.deps.chatStore.applyWsEvent(event);
+        this.deps.dmThreadsStore.applyWsEvent(event);
+        this.deps.notificationsStore.applyWsEvent(event);
       });
     }
   }
@@ -15015,6 +15442,7 @@ var SDK = class {
   constructor(config) {
     const baseUrl = config.baseUrl || "http://localhost:3000";
     const logger2 = config.logger || logger;
+    this.analytics = config.analytics ?? new NoopAnalyticsClient();
     this.http = config.httpClient || new HttpClient(
       baseUrl,
       config.storage,
@@ -15047,14 +15475,18 @@ var SDK = class {
     this.referrals = new Referrals(this.http, logger2);
     this.reports = new Reports(this.http, logger2);
     this.support = new Support(this.http, logger2);
-    this.markets = new Markets(this.http, logger2);
+    this.markets = new Markets(this.http, logger2, this.wallet);
     this.wsTransport = config.wsTransport || new StandaloneWsTransport(baseUrl);
     this.wsTransport.setAppId(config.appId);
     this.lobbyStore = createLobbyStore(this.wsTransport);
+    this.lobbies.setLobbyStore(this.lobbyStore);
     this.gameStore = createGameStore(this.wsTransport);
+    this.games.setGameStore(this.gameStore);
     this.gameActionsStore = createGameActionsStore(this.wsTransport);
+    this.games.setGameActionsStore(this.gameActionsStore);
     this.chatStore = createChatStore(this.wsTransport);
     this.dmThreadsStore = createDmThreadsStore();
+    this.chat.setDmThreadsStore(this.dmThreadsStore);
     this.notificationsStore = createNotificationsStore();
     this.friendsStore = createFriendsStore();
     this.notifications = new Notifications(
@@ -15084,6 +15516,29 @@ var SDK = class {
     this.wsTransport.connect();
     await this.wsTransport.waitUntilConnected(timeoutMs);
   }
+  /**
+   * Handle the full deposit-to-queue lifecycle for a lobby.
+   *
+   * After the deposit is confirmed, the backend may not have processed the
+   * `lobby.deposit.allConfirmed` event yet, so the lobby can still be in
+   * 'preparing' status. This method re-fetches the lobby and explicitly
+   * joins the queue if needed, then pushes the latest state to the store
+   * so the UI transitions immediately.
+   */
+  async depositAndJoinQueue(lobbyId) {
+    const result = await this.escrow.depositForLobby(lobbyId);
+    if (!result.canProceedToQueue) {
+      const lobby2 = await this.lobbies.getLobby(lobbyId);
+      this.lobbyStore.setBaseState([lobby2]);
+      return { ...result, lobby: lobby2 };
+    }
+    let lobby = await this.lobbies.getLobby(lobbyId);
+    if (lobby.status === "preparing") {
+      lobby = await this.lobbies.joinQueue(lobbyId);
+    }
+    this.lobbyStore.setBaseState([lobby]);
+    return { ...result, lobby };
+  }
 };
 var import_utils = __toESM2(require_dist(), 1);
 var export_MICRO_UNITS = import_utils.MICRO_UNITS;
@@ -15094,10 +15549,34 @@ var export_toMajor = import_utils.toMajor;
 var import_tweetnacl = __toESM(require_nacl_fast(), 1);
 import { Keypair } from "@solana/web3.js";
 import bs58 from "bs58";
+function decodeJwtSub(token) {
+  try {
+    const parts2 = token.split(".");
+    if (parts2.length < 2) return null;
+    const base64 = parts2[1].replace(/-/g, "+").replace(/_/g, "/");
+    const json = Buffer.from(base64, "base64").toString("utf-8");
+    const parsed = JSON.parse(json);
+    return typeof parsed.sub === "string" ? parsed.sub : null;
+  } catch {
+    return null;
+  }
+}
+function signatureToBytes(sig) {
+  if (sig.includes("-") || sig.includes("_")) {
+    const padded = sig.replace(/-/g, "+").replace(/_/g, "/") + "==".slice(sig.length % 4 === 0 ? 4 : sig.length % 4);
+    return new Uint8Array(Buffer.from(padded, "base64"));
+  }
+  if (/[+/=]/.test(sig)) {
+    return new Uint8Array(Buffer.from(sig, "base64"));
+  }
+  return bs58.decode(sig);
+}
 var DimAgentClient = class {
   sdk;
   agentConfig;
+  externalSignerMode;
   keypair;
+  _externalAddress = null;
   config;
   authenticated = false;
   userId = null;
@@ -15111,21 +15590,35 @@ var DimAgentClient = class {
   constructor(config) {
     this.config = config;
     this.agentConfig = config.agentConfig;
-    const secretKeyBytes = bs58.decode(config.walletPrivateKey);
-    this.keypair = Keypair.fromSecretKey(secretKeyBytes);
+    this.externalSignerMode = !config.walletPrivateKey;
+    if (config.walletPrivateKey) {
+      const secretKeyBytes = bs58.decode(config.walletPrivateKey);
+      this.keypair = Keypair.fromSecretKey(secretKeyBytes);
+    } else {
+      this.keypair = null;
+    }
+    const storage = new NodeStorage();
+    if (config.accessToken) {
+      storage.set(TOKEN_KEY, config.accessToken);
+      const sub = decodeJwtSub(config.accessToken);
+      if (sub) {
+        this.authenticated = true;
+        this.userId = sub;
+      }
+    }
     this.sdk = new SDK({
       appId: "dim-agents",
       baseUrl: config.apiUrl || "https://api.dim.cool",
-      storage: new NodeStorage(),
+      storage,
       autoPay: {
-        enabled: true,
+        enabled: !this.externalSignerMode,
         maxAmountMinor: 25e3,
         maxRetries: 1
       }
     });
   }
   get walletAddress() {
-    return this.keypair.publicKey.toBase58();
+    return this.keypair?.publicKey.toBase58() ?? this._externalAddress ?? "";
   }
   get isAuthenticated() {
     return this.authenticated;
@@ -15134,17 +15627,23 @@ var DimAgentClient = class {
     return this.userId;
   }
   async authenticate() {
+    if (!this.keypair) {
+      throw new Error(
+        "No keypair configured. Use dim_request_auth_message + dim_complete_login for external signer mode."
+      );
+    }
+    const keypair = this.keypair;
     this.sdk.wallet.setSigner({
       address: this.walletAddress,
       signMessage: async (message) => {
         const signature = import_tweetnacl.default.sign.detached(
           new TextEncoder().encode(message),
-          this.keypair.secretKey
+          keypair.secretKey
         );
         return Buffer.from(signature).toString("base64");
       },
       signTransaction: async (transaction) => {
-        transaction.partialSign(this.keypair);
+        transaction.partialSign(keypair);
         return transaction;
       }
     });
@@ -15198,26 +15697,61 @@ var DimAgentClient = class {
   get pendingEventCount() {
     return this.eventQueue.length;
   }
-  /** Get the Keypair for transaction signing. */
+  /** Get the Keypair for transaction signing (keypair mode only). */
   getKeypair() {
+    if (!this.keypair) {
+      throw new Error(
+        "No keypair configured \u2014 running in external signer mode."
+      );
+    }
     return this.keypair;
   }
-  // ── Game chat cursors ────────────────────────────────────────────────
-  /** Get the last-seen chat timestamp for a game. */
-  getGameChatCursor(gameId) {
-    return this.gameChatCursors.get(gameId);
-  }
-  /** Update the last-seen chat timestamp for a game. */
-  setGameChatCursor(gameId, timestamp) {
-    this.gameChatCursors.set(gameId, timestamp);
-  }
-  // ── Spend tracking ──────────────────────────────────────────────────
-  resetDailySpendIfNeeded() {
-    const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-    if (this.spendResetDate !== today) {
-      this.dailySpendMinor = 0;
-      this.spendResetDate = today;
-    }
+  /** Request the auth handshake message for a given address (external signer mode). */
+  async requestAuthMessage(address) {
+    return this.sdk.auth.generateHandshake(address);
+  }
+  /**
+   * Complete authentication using an externally provided signature (external signer mode).
+   * @param address - Solana wallet address (base58)
+   * @param signature - Detached ed25519 signature in base58, base64, or base64url (from sign_solana_message)
+   */
+  async completeAuth(address, signature) {
+    const signatureBytes = signatureToBytes(signature);
+    const signedMessage = Buffer.from(signatureBytes).toString("base64");
+    const response = await this.sdk.auth.loginWithExternalSignature(
+      address,
+      signedMessage,
+      {
+        referralCode: this.config.referralCode,
+        walletMeta: { type: "phantom-embedded", provider: "injected" }
+      }
+    );
+    this.sdk.wsTransport.setAccessToken(response.access_token);
+    this._externalAddress = address;
+    this.authenticated = true;
+    this.userId = response.user.id;
+    return {
+      userId: response.user.id,
+      username: response.user.username,
+      accessToken: response.access_token
+    };
+  }
+  // ── Game chat cursors ────────────────────────────────────────────────
+  /** Get the last-seen chat timestamp for a game. */
+  getGameChatCursor(gameId) {
+    return this.gameChatCursors.get(gameId);
+  }
+  /** Update the last-seen chat timestamp for a game. */
+  setGameChatCursor(gameId, timestamp) {
+    this.gameChatCursors.set(gameId, timestamp);
+  }
+  // ── Spend tracking ──────────────────────────────────────────────────
+  resetDailySpendIfNeeded() {
+    const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+    if (this.spendResetDate !== today) {
+      this.dailySpendMinor = 0;
+      this.spendResetDate = today;
+    }
   }
   recordSpend(amountMinor) {
     this.resetDailySpendIfNeeded();
@@ -15329,6 +15863,77 @@ async function login(client) {
     };
   }
 }
+async function requestAuthMessage(client, args) {
+  try {
+    const { message } = await client.requestAuthMessage(args.address);
+    return {
+      data: {
+        message,
+        address: args.address,
+        nextStep: 'Sign this message with sign_solana_message (networkId: "solana:mainnet"), then call dim_complete_login with the address and the signature. Accepted formats: base58, base64, or base64url (all formats returned by wallet MCPs are accepted).'
+      }
+    };
+  } catch (error) {
+    return {
+      error: `Failed to get auth message: ${error instanceof Error ? error.message : String(error)}`,
+      isError: true
+    };
+  }
+}
+async function completeLogin(client, args) {
+  try {
+    const result = await client.completeAuth(args.address, args.signature);
+    client.startEventListeners();
+    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 client.sdk.referrals.getSummary();
+      if (!summary.hasReferrer) {
+        nextSteps.push(
+          "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 = {
+      success: true,
+      userId: result.userId,
+      username: result.username ?? null,
+      walletAddress: client.walletAddress,
+      walletNote: "DIM is noncustodial. Signing is handled by your external wallet for this session.",
+      safetyRules: SAFETY_RULES,
+      nextSteps
+    };
+    const ac = client.agentConfig;
+    const dailyLimit = ac?.dailySpendLimit ?? 20;
+    response.agentConfig = {
+      autoAcceptFriendRequests: ac?.autoAcceptFriendRequests ?? false,
+      autoReplyDms: ac?.autoReplyDms ?? false,
+      autoPlayGames: ac?.autoPlayGames ?? false,
+      maxBetPerGame: ac?.maxBetPerGame ?? 1,
+      dailySpendLimit: dailyLimit,
+      autoJoinGlobalChat: ac?.autoJoinGlobalChat ?? false,
+      autoPromoteReferrals: ac?.autoPromoteReferrals ?? false,
+      dailySpentSoFar: client.dailySpentDollars,
+      dailyRemaining: dailyLimit - client.dailySpentDollars
+    };
+    return { data: response };
+  } catch (error) {
+    return {
+      error: `Login failed: ${error instanceof Error ? error.message : String(error)}`,
+      isError: true
+    };
+  }
+}
 async function getProfile(client) {
   try {
     if (!client.currentUserId) {
@@ -15457,10 +16062,19 @@ async function listFriends(client, args) {
     };
   }
 }
-async function getIncomingFriendRequests(client) {
+async function getIncomingFriendRequests(client, args) {
   try {
-    const result = await client.sdk.users.getIncomingFriendRequests();
-    return { data: result };
+    const result = await client.sdk.users.getIncomingFriendRequests({
+      limit: args?.limit,
+      cursor: args?.cursor
+    });
+    return {
+      data: {
+        items: result.items,
+        nextCursor: result.nextCursor,
+        hasMore: !!result.nextCursor
+      }
+    };
   } catch (error) {
     return {
       error: `Failed to get requests: ${error instanceof Error ? error.message : String(error)}`,
@@ -15581,6 +16195,42 @@ async function sendUsdc(client, args) {
     const spendErr = client.checkSpendLimit(args.amount);
     if (spendErr) return { error: spendErr, isError: true };
     const amountMinor = Math.round(args.amount * 1e6);
+    if (client.externalSignerMode) {
+      const senderAddress = client.walletAddress;
+      if (!senderAddress) {
+        return {
+          error: "Wallet address not set. Call dim_complete_login first.",
+          isError: true
+        };
+      }
+      const prepared = await client.sdk.wallet.prepareTransfer(
+        senderAddress,
+        args.recipient,
+        amountMinor
+      );
+      return {
+        data: {
+          needsSigning: true,
+          unsignedTx: prepared.transaction,
+          fee: prepared.fee,
+          totalAmount: prepared.totalAmount,
+          recipientAddress: prepared.recipientAddress,
+          ataCreated: prepared.ataCreated ?? false,
+          confirmWith: {
+            tool: "dim_confirm_send_usdc",
+            params: {
+              recipientAddress: prepared.recipientAddress,
+              amount: amountMinor,
+              fee: prepared.fee,
+              token: "USDC",
+              ataCreated: prepared.ataCreated ?? false,
+              recipientInput: args.recipient
+            }
+          },
+          hint: "Sign and broadcast unsignedTx with send_solana_transaction, then call dim_confirm_send_usdc with the signature and the confirmWith.params."
+        }
+      };
+    }
     const result = await client.sdk.wallet.send(args.recipient, amountMinor);
     client.recordSpend(amountMinor);
     return {
@@ -15601,11 +16251,74 @@ async function sendUsdc(client, args) {
     };
   }
 }
+async function confirmSendUsdc(client, args) {
+  try {
+    const senderAddress = client.walletAddress;
+    const result = await client.sdk.wallet.confirmTransferSignature(
+      args.signature,
+      senderAddress,
+      args.recipientAddress,
+      args.amount,
+      args.token || "USDC",
+      args.ataCreated,
+      args.recipientInput
+    );
+    client.recordSpend(args.amount);
+    return {
+      data: {
+        success: true,
+        signature: result.signature,
+        status: result.status,
+        recipientAddress: args.recipientAddress
+      }
+    };
+  } catch (error) {
+    return {
+      error: `Failed to confirm USDC transfer: ${error instanceof Error ? error.message : String(error)}`,
+      isError: true
+    };
+  }
+}
 async function tipUser(client, args) {
   try {
     const spendErr = client.checkSpendLimit(args.amount);
     if (spendErr) return { error: spendErr, isError: true };
     const amountMinor = Math.round(args.amount * 1e6);
+    if (client.externalSignerMode) {
+      const senderAddress = client.walletAddress;
+      if (!senderAddress) {
+        return {
+          error: "Wallet address not set. Call dim_complete_login first.",
+          isError: true
+        };
+      }
+      const prepared = await client.sdk.tips.prepare({
+        recipientUsername: args.recipientUsername,
+        amount: amountMinor,
+        supportsPresign: false
+      });
+      return {
+        data: {
+          needsSigning: true,
+          unsignedTx: prepared.transaction,
+          fee: prepared.fee,
+          totalAmount: prepared.totalAmount,
+          recipientAddress: prepared.recipientAddress,
+          confirmWith: {
+            tool: "dim_confirm_tip_user",
+            params: {
+              recipientAddress: prepared.recipientAddress,
+              recipientUserId: prepared.recipientUserId,
+              recipientUsername: prepared.recipientUsername,
+              amount: prepared.amount,
+              fee: prepared.fee,
+              ataCreated: false
+            }
+          },
+          hint: "Sign and broadcast unsignedTx with send_solana_transaction, then call dim_confirm_tip_user with the signature and the confirmWith.params."
+        }
+      };
+    }
     const result = await client.sdk.tips.send(
       args.recipientUsername,
       amountMinor
@@ -15628,6 +16341,38 @@ async function tipUser(client, args) {
     };
   }
 }
+async function confirmTipUser(client, args) {
+  try {
+    const senderAddress = client.walletAddress;
+    await client.sdk.wallet.confirmTransferSignature(
+      args.signature,
+      senderAddress,
+      args.recipientAddress,
+      args.amount,
+      "USDC",
+      args.ataCreated ?? false,
+      args.recipientUsername
+    );
+    await client.sdk.tips.broadcast({
+      recipientUserId: args.recipientUserId,
+      amount: args.amount
+    });
+    client.recordSpend(args.amount);
+    return {
+      data: {
+        success: true,
+        signature: args.signature,
+        recipient: args.recipientUsername,
+        broadcastedToGlobalChat: true
+      }
+    };
+  } catch (error) {
+    return {
+      error: `Failed to confirm tip: ${error instanceof Error ? error.message : String(error)}`,
+      isError: true
+    };
+  }
+}
 async function getWalletActivity(client, args) {
   try {
     const activity = await client.sdk.wallet.getActivity({
@@ -15734,6 +16479,7 @@ function buildRpsContext(state, agentUserId) {
     roundHistory: state.roundHistory,
     phase: roundState?.phase,
     timeRemaining: roundState?.timeRemaining,
+    ...state.bufferEndsAt != null && { bufferEndsAt: state.bufferEndsAt },
     moveFormat: 'dim_submit_action: gameType="rock-paper-scissors", action="play", payload={ action: "rock"|"paper"|"scissors" }'
   };
 }
@@ -15746,6 +16492,7 @@ function buildChessContext(state, agentUserId) {
     yourColor,
     whiteTimeMs: state.whiteTimeMs,
     blackTimeMs: state.blackTimeMs,
+    ...state.bufferEndsAt != null && { bufferEndsAt: state.bufferEndsAt },
     moveFormat: 'dim_submit_action: gameType="chess", action="move", payload={ from: "e2", to: "e4" }'
   };
 }
@@ -15955,6 +16702,23 @@ async function createLobby(client, args) {
 }
 async function depositForLobby(client, args) {
   try {
+    if (client.externalSignerMode) {
+      const { transaction } = await client.sdk.escrow.prepareAndStartDeposit(
+        args.lobbyId,
+        false
+      );
+      return {
+        data: {
+          needsSigning: true,
+          unsignedTx: transaction,
+          confirmWith: {
+            tool: "dim_confirm_lobby_deposit",
+            params: { lobbyId: args.lobbyId }
+          },
+          hint: "Sign and broadcast unsignedTx with send_solana_transaction, then call dim_confirm_lobby_deposit with the lobbyId and signature."
+        }
+      };
+    }
     const result = await client.sdk.escrow.depositForLobbySync(args.lobbyId);
     return {
       data: {
@@ -15971,6 +16735,44 @@ async function depositForLobby(client, args) {
     };
   }
 }
+async function confirmLobbyDeposit(client, args) {
+  try {
+    await client.sdk.escrow.confirmDepositSignature(
+      args.lobbyId,
+      args.signature
+    );
+    const MAX_WAIT_MS = 6e4;
+    const POLL_INTERVAL_MS = 1e3;
+    const startTime = Date.now();
+    while (Date.now() - startTime < MAX_WAIT_MS) {
+      const status = await client.sdk.escrow.getDepositStatus(args.lobbyId);
+      if (status.canProceedToQueue) {
+        return {
+          data: {
+            signature: args.signature,
+            status: "confirmed",
+            canProceedToQueue: true,
+            hint: "Deposit confirmed. Call dim_join_queue to enter matchmaking."
+          }
+        };
+      }
+      await new Promise((r) => setTimeout(r, POLL_INTERVAL_MS));
+    }
+    return {
+      data: {
+        signature: args.signature,
+        status: "pending",
+        canProceedToQueue: false,
+        hint: "Deposit submitted but not yet confirmed on-chain. Try dim_confirm_lobby_deposit again in a few seconds."
+      }
+    };
+  } catch (error) {
+    return {
+      error: `Failed to confirm deposit: ${error instanceof Error ? error.message : String(error)}`,
+      isError: true
+    };
+  }
+}
 async function leaveLobby(client, args) {
   try {
     const result = await client.sdk.lobbies.leaveLobby(args.lobbyId);
@@ -16040,7 +16842,7 @@ async function joinQueue(client, args) {
         gameId,
         matched: !!matched,
         ...spectateUrl && { spectateUrl },
-        hint: matched ? `Game started! Call dim_game_loop with gameId "${gameId}" to play.${spectateUrl ? ` Tell the user they can spectate at ${spectateUrl}` : ""}` : "No match found within timeout. Call dim_join_queue again to resume waiting."
+        hint: matched ? `Game matched! Call dim_game_loop with gameId "${gameId}" IMMEDIATELY \u2014 do NOT wait for user input. The game has a start buffer; dim_game_loop will block until your first turn begins.${spectateUrl ? ` Tell the user they can spectate at ${spectateUrl}` : ""}` : "No match found within timeout. Call dim_join_queue again to resume waiting."
       }
     };
   } catch (error) {
@@ -16115,6 +16917,23 @@ async function donateToPot(client, args) {
     const spendErr = client.checkSpendLimit(args.amount);
     if (spendErr) return { error: spendErr, isError: true };
     const amountMinor = Math.round(args.amount * 1e6);
+    if (client.externalSignerMode) {
+      const prepared = await client.sdk.games.prepareGameDonation(
+        args.gameId,
+        amountMinor
+      );
+      return {
+        data: {
+          needsSigning: true,
+          unsignedTx: prepared.transaction,
+          confirmWith: {
+            tool: "dim_confirm_donate_to_pot",
+            params: { gameId: args.gameId, amount: amountMinor }
+          },
+          hint: "Sign and broadcast unsignedTx with send_solana_transaction, then call dim_confirm_donate_to_pot with the signature."
+        }
+      };
+    }
     const result = await client.sdk.games.sendDonation(
       args.gameId,
       amountMinor
@@ -16138,6 +16957,29 @@ async function donateToPot(client, args) {
     };
   }
 }
+async function confirmDonateToPot(client, args) {
+  try {
+    const result = await client.sdk.games.confirmGameDonationSignature(
+      args.gameId,
+      args.amount,
+      args.signature
+    );
+    client.recordSpend(args.amount);
+    return {
+      data: {
+        success: true,
+        gameId: args.gameId,
+        signature: result.signature,
+        status: result.status
+      }
+    };
+  } catch (error) {
+    return {
+      error: `Failed to confirm donation: ${error instanceof Error ? error.message : String(error)}`,
+      isError: true
+    };
+  }
+}
 async function getGame(client, args) {
   try {
     const game = await client.sdk.games.getGame(args.gameId);
@@ -16149,6 +16991,12 @@ async function getGame(client, args) {
     };
   }
 }
+function isInStartingPhase(state) {
+  const roundState = state.roundState;
+  if (roundState?.phase === "starting") return true;
+  if (state.status === "active" && state.currentPlayerId == null) return true;
+  return false;
+}
 async function gameLoop(client, args) {
   try {
     const { gameId } = args;
@@ -16166,7 +17014,7 @@ async function gameLoop(client, args) {
       if (state?.status === "completed") {
         return buildGameLoopReturn(client, gameId, state, "completed");
       }
-      if (state?.currentPlayerId === client.currentUserId) {
+      if (state?.currentPlayerId === client.currentUserId && !isInStartingPhase(state)) {
         return buildGameLoopReturn(client, gameId, state, "your-turn");
       }
       await raceTimeout(
@@ -16792,10 +17640,10 @@ async function checkNotifications(client) {
         isError: true
       };
     }
-    const [notifications, dmThreads, friendRequests] = await Promise.all([
+    const [notifications, dmThreads, friendRequestsPage] = await Promise.all([
       client.sdk.notifications.list({ page: 1, limit: 20 }),
       client.sdk.chat.listDmThreads(),
-      client.sdk.users.getIncomingFriendRequests()
+      client.sdk.users.getIncomingFriendRequests({ limit: 20 })
     ]);
     const unreadDms = dmThreads.filter(
       (t) => (t.unreadCount ?? 0) > 0
@@ -16807,9 +17655,10 @@ async function checkNotifications(client) {
         unreadNotificationCount: notifications.unreadCount,
         notifications: notifications.notifications.filter((n) => !n.read),
         unreadDmThreads: unreadDms,
-        incomingFriendRequests: friendRequests,
+        incomingFriendRequests: friendRequestsPage.items,
+        hasMoreIncomingFriendRequests: !!friendRequestsPage.nextCursor,
         pendingWsEvents: client.pendingEventCount,
-        hint: "Use dim_get_pending_events to drain buffered real-time events."
+        hint: "Use dim_get_pending_events to drain buffered real-time events. Use dim_get_incoming_friend_requests with cursor for more friend requests if hasMoreIncomingFriendRequests is true."
       }
     };
   } catch (error) {
@@ -17195,6 +18044,22 @@ async function getGameHistory(client, args) {
     };
   }
 }
+async function reportUser(client, args) {
+  try {
+    await client.sdk.reports.create(args.userId, args.reason);
+    return {
+      data: {
+        success: true,
+        hint: "Report submitted. The DIM moderation team will review it."
+      }
+    };
+  } catch (error) {
+    return {
+      error: `Failed to report user: ${error instanceof Error ? error.message : String(error)}`,
+      isError: true
+    };
+  }
+}
 async function getMyStats(client) {
   try {
     if (!client.currentUserId) {
@@ -17225,6 +18090,36 @@ async function getMyStats(client) {
 
 // ../dim-agent-core/src/tools/index.ts
 var TOOL_DEFINITIONS = [
+  // ── External signer mode (auth) ──────────────────────────────────────
+  {
+    name: "dim_request_auth_message",
+    description: "External wallet login step 1: given a Solana wallet address, returns the message to sign. Sign it with sign_solana_message on your wallet MCP (e.g. Phantom), then call dim_complete_login.",
+    params: {
+      address: {
+        type: "string",
+        description: "Your Solana wallet address (base58)",
+        required: true
+      }
+    },
+    execute: (c, a) => requestAuthMessage(c, a)
+  },
+  {
+    name: "dim_complete_login",
+    description: "External wallet login step 2: provide the wallet address and signature from sign_solana_message to complete authentication with DIM.",
+    params: {
+      address: {
+        type: "string",
+        description: "Your Solana wallet address (base58)",
+        required: true
+      },
+      signature: {
+        type: "string",
+        description: "Signature from sign_solana_message \u2014 base58, base64, or base64url accepted",
+        required: true
+      }
+    },
+    execute: (c, a) => completeLogin(c, a)
+  },
   // ── Auth ─────────────────────────────────────────────────────────────
   {
     name: "dim_login",
@@ -17378,9 +18273,23 @@ var TOOL_DEFINITIONS = [
   },
   {
     name: "dim_get_incoming_friend_requests",
-    description: "List pending incoming friend requests.",
-    params: {},
-    execute: (c) => getIncomingFriendRequests(c)
+    description: "List pending incoming friend requests. Returns { items, nextCursor, hasMore }. Pass cursor from a previous response to page through results.",
+    params: {
+      limit: {
+        type: "number",
+        description: "Maximum number of requests to return (1\u2013100, default 50).",
+        required: false
+      },
+      cursor: {
+        type: "string",
+        description: "Pagination cursor from a previous response nextCursor field. Omit for the first page.",
+        required: false
+      }
+    },
+    execute: (c, a) => getIncomingFriendRequests(
+      c,
+      a
+    )
   },
   // ── Chat ─────────────────────────────────────────────────────────────
   {
@@ -17506,6 +18415,90 @@ var TOOL_DEFINITIONS = [
     },
     execute: (c, a) => tipUser(c, a)
   },
+  {
+    name: "dim_confirm_send_usdc",
+    description: "External wallet: confirm a USDC transfer after signing and broadcasting the transaction. Provide the on-chain signature and the params from the confirmWith object returned by dim_send_usdc.",
+    params: {
+      signature: {
+        type: "string",
+        description: "On-chain transaction signature returned by send_solana_transaction",
+        required: true
+      },
+      recipientAddress: {
+        type: "string",
+        description: "Recipient Solana address (from confirmWith.params)",
+        required: true
+      },
+      amount: {
+        type: "number",
+        description: "Amount in USDC minor units (from confirmWith.params)",
+        required: true
+      },
+      fee: {
+        type: "number",
+        description: "Fee in minor units (from confirmWith.params)"
+      },
+      token: {
+        type: "string",
+        description: "Token type: USDC or SOL (default: USDC)"
+      },
+      ataCreated: {
+        type: "string",
+        description: "Whether a new ATA was created (from confirmWith.params)"
+      },
+      recipientInput: {
+        type: "string",
+        description: "Original recipient input (from confirmWith.params)"
+      }
+    },
+    execute: (c, a) => confirmSendUsdc(
+      c,
+      a
+    )
+  },
+  {
+    name: "dim_confirm_tip_user",
+    description: "External wallet: confirm a tip after signing and broadcasting the transaction. Provide the on-chain signature and the params from the confirmWith object returned by dim_tip_user.",
+    params: {
+      signature: {
+        type: "string",
+        description: "On-chain transaction signature returned by send_solana_transaction",
+        required: true
+      },
+      recipientAddress: {
+        type: "string",
+        description: "Recipient Solana address (from confirmWith.params)",
+        required: true
+      },
+      recipientUserId: {
+        type: "string",
+        description: "Recipient user ID (from confirmWith.params)",
+        required: true
+      },
+      recipientUsername: {
+        type: "string",
+        description: "Recipient username (from confirmWith.params)",
+        required: true
+      },
+      amount: {
+        type: "number",
+        description: "Amount in USDC minor units (from confirmWith.params)",
+        required: true
+      },
+      fee: {
+        type: "number",
+        description: "Fee in minor units (from confirmWith.params)"
+      },
+      ataCreated: {
+        type: "string",
+        description: "Whether a new ATA was created (from confirmWith.params)"
+      }
+    },
+    execute: (c, a) => confirmTipUser(
+      c,
+      a
+    )
+  },
   {
     name: "dim_get_wallet_activity",
     description: "Get recent wallet transaction activity (deposits, payouts, transfers, refunds) and your DIM wallet address. Highlights any claimable items.",
@@ -17565,6 +18558,23 @@ var TOOL_DEFINITIONS = [
     params: {},
     execute: (c) => getMyStats(c)
   },
+  {
+    name: "dim_report_user",
+    description: "Report a user for cheating, harassment, or other violations. Rate limited to 5 reports per hour.",
+    params: {
+      userId: {
+        type: "string",
+        description: "The ID of the user to report",
+        required: true
+      },
+      reason: {
+        type: "string",
+        description: "Reason for the report (max 300 characters)",
+        required: true
+      }
+    },
+    execute: (c, a) => reportUser(c, a)
+  },
   {
     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.",
@@ -17602,6 +18612,23 @@ var TOOL_DEFINITIONS = [
     },
     execute: (c, a) => depositForLobby(c, a)
   },
+  {
+    name: "dim_confirm_lobby_deposit",
+    description: "External wallet: confirm a lobby deposit after signing and broadcasting the transaction. Polls until the deposit is confirmed on-chain, then returns canProceedToQueue.",
+    params: {
+      lobbyId: {
+        type: "string",
+        description: "The lobby ID (from confirmWith.params)",
+        required: true
+      },
+      signature: {
+        type: "string",
+        description: "On-chain transaction signature returned by send_solana_transaction",
+        required: true
+      }
+    },
+    execute: (c, a) => confirmLobbyDeposit(c, a)
+  },
   {
     name: "dim_leave_lobby",
     description: "Leave a lobby. Use this to exit a lobby you created or joined. Returns when you have left.",
@@ -17694,6 +18721,31 @@ var TOOL_DEFINITIONS = [
     },
     execute: (c, a) => gameLoop(c, a)
   },
+  {
+    name: "dim_confirm_donate_to_pot",
+    description: "External wallet: confirm a game pot donation after signing and broadcasting the transaction.",
+    params: {
+      signature: {
+        type: "string",
+        description: "On-chain transaction signature returned by send_solana_transaction",
+        required: true
+      },
+      gameId: {
+        type: "string",
+        description: "The game ID (from confirmWith.params)",
+        required: true
+      },
+      amount: {
+        type: "number",
+        description: "Amount in USDC minor units (from confirmWith.params)",
+        required: true
+      }
+    },
+    execute: (c, a) => confirmDonateToPot(
+      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.",
@@ -18087,11 +19139,18 @@ async function executeWithAuthRetry(client, tool, params) {
   if (tool.name === "dim_login") {
     return tool.execute(client, params);
   }
+  if (client.externalSignerMode) {
+    return tool.execute(client, params);
+  }
   try {
     const result = await tool.execute(client, params);
     if (!result.error && !result.isError) return result;
     if (!isUnauthorizedResult(result)) return result;
-    await client.authenticate();
+    try {
+      await client.authenticate();
+    } catch {
+      return { error: UNAUTHORIZED_MESSAGE, isError: true };
+    }
     const retryResult = await tool.execute(client, params);
     if (retryResult.isError || retryResult.error) {
       if (isUnauthorizedResult(retryResult)) {
@@ -18294,6 +19353,10 @@ function registerResources(server2, client) {
 }
 
 // src/server.ts
+var HOSTED_EXCLUDED_TOOLS = /* @__PURE__ */ new Set([
+  "dim_game_loop",
+  "dim_get_pending_events"
+]);
 function paramToZod(p) {
   let schema;
   if (p.enum) {
@@ -18314,14 +19377,14 @@ function paramToZod(p) {
   if (!p.required) schema = schema.optional();
   return schema.describe(p.description);
 }
-function createDimMcpServer(config) {
+function buildMcpServer(client, mode) {
   const server2 = new McpServer({
     name: "dim",
     version: "1.0.0",
     description: "DIM Gaming Platform \u2014 Play games, chat, send USDC, challenge users, and earn referral income. DIM is noncustodial; your Solana address is returned by dim_get_profile and dim_get_balance. Start by calling dim_login. 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."
   });
-  const client = new DimAgentClient(config);
   for (const tool of TOOL_DEFINITIONS) {
+    if (mode === "hosted" && HOSTED_EXCLUDED_TOOLS.has(tool.name)) continue;
     const zodParams = {};
     for (const [key, param] of Object.entries(tool.params)) {
       zodParams[key] = paramToZod(param);
@@ -18351,6 +19414,7 @@ function createDimMcpServer(config) {
       }
     );
   }
+  const gameHint = mode === "hosted" ? "Game flow: dim_create_lobby \u2192 dim_deposit_for_lobby (returns unsignedTx \u2014 sign with Phantom MCP) \u2192 dim_join_queue \u2192 poll dim_get_lobby until matched \u2192 dim_get_game_state \u2192 dim_submit_action \u2192 repeat. For real-time game_loop, use the DIM CLI (npx @dimcool/cli)." : "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.";
   server2.tool(
     "dim_list_instructions",
     "List all available DIM tools with short descriptions.",
@@ -18364,7 +19428,7 @@ function createDimMcpServer(config) {
               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.",
+              hint: gameHint,
               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: {
@@ -18385,6 +19449,15 @@ function createDimMcpServer(config) {
     })
   );
   registerResources(server2, client);
+  return server2;
+}
+function createDimMcpServer(clientOrConfig, options) {
+  const mode = options?.mode ?? "local";
+  if (clientOrConfig instanceof DimAgentClient) {
+    return buildMcpServer(clientOrConfig, mode);
+  }
+  const client = new DimAgentClient(clientOrConfig);
+  const server2 = buildMcpServer(client, mode);
   return { server: server2, client };
 }
 
@@ -18517,12 +19590,11 @@ if (cliArgs[0] === "init-wallet") {
 var walletPrivateKey = await resolveWalletPrivateKey(cliArgs);
 if (!walletPrivateKey) {
   console.error(
-    "Error: DIM wallet key is not configured.\nProvide DIM_WALLET_PRIVATE_KEY, or initialize a local wallet store.\n\nExamples:\n  DIM_WALLET_PRIVATE_KEY=your-base58-key npx @dimcool/mcp\n  npx @dimcool/mcp init-wallet\n  DIM_WALLET_AUTO_CREATE=true npx @dimcool/mcp"
+    "No DIM wallet key configured \u2014 starting in external signer mode.\nUse dim_request_auth_message \u2192 sign_solana_message \u2192 dim_complete_login to authenticate.\n\nTo use a dedicated wallet instead:\n  DIM_WALLET_PRIVATE_KEY=your-base58-key npx @dimcool/mcp\n  npx @dimcool/mcp init-wallet\n  DIM_WALLET_AUTO_CREATE=true npx @dimcool/mcp"
   );
-  process.exit(1);
 }
 var { server } = createDimMcpServer({
-  walletPrivateKey,
+  walletPrivateKey: walletPrivateKey ?? void 0,
   apiUrl: process.env.DIM_API_URL || "https://api.dim.cool",
   referralCode: process.env.DIM_REFERRAL_CODE
 });