@dimcool/mcp 0.1.30 → 0.1.31

package/dist/index.js

@@ -11630,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}`);
   }
@@ -14253,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) => {
@@ -14264,6 +14280,7 @@ function createGameActionsStore(transport2) {
       const { [gameId]: _, ...rest } = state.statesByGameId;
       return { ...state, statesByGameId: rest };
     });
+    pendingEvents.delete(gameId);
   };
   const applyWsEvent = (event) => {
     switch (event.event) {
@@ -14282,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;
@@ -14303,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(
@@ -14337,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: {
@@ -14356,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: {
@@ -14370,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) => {
@@ -14394,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 || [],
           {
@@ -14419,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 = {
@@ -14444,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",
@@ -14493,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(
@@ -14513,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,
@@ -14524,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 ?? []
@@ -14535,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
@@ -14548,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) {
@@ -15211,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() {
@@ -15228,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);
       });
     }
   }
@@ -15380,6 +15549,28 @@ 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;
@@ -15406,10 +15597,19 @@ var DimAgentClient = class {
     } 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: !this.externalSignerMode,
         maxAmountMinor: 25e3,
@@ -15513,10 +15713,10 @@ var DimAgentClient = class {
   /**
    * Complete authentication using an externally provided signature (external signer mode).
    * @param address - Solana wallet address (base58)
-   * @param signatureBase58 - Detached ed25519 signature in base58 (from sign_solana_message)
+   * @param signature - Detached ed25519 signature in base58, base64, or base64url (from sign_solana_message)
    */
-  async completeAuth(address, signatureBase58) {
-    const signatureBytes = bs58.decode(signatureBase58);
+  async completeAuth(address, signature) {
+    const signatureBytes = signatureToBytes(signature);
     const signedMessage = Buffer.from(signatureBytes).toString("base64");
     const response = await this.sdk.auth.loginWithExternalSignature(
       address,
@@ -15670,7 +15870,7 @@ async function requestAuthMessage(client, args) {
       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 base58 signature.'
+        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) {
@@ -17844,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) {
@@ -17889,7 +18105,7 @@ var TOOL_DEFINITIONS = [
   },
   {
     name: "dim_complete_login",
-    description: "External wallet login step 2: provide the wallet address and base58 signature from sign_solana_message to complete authentication with DIM.",
+    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",
@@ -17898,7 +18114,7 @@ var TOOL_DEFINITIONS = [
       },
       signature: {
         type: "string",
-        description: "Base58-encoded signature returned by sign_solana_message",
+        description: "Signature from sign_solana_message \u2014 base58, base64, or base64url accepted",
         required: true
       }
     },
@@ -18342,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.",
@@ -18906,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)) {
@@ -19113,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) {
@@ -19133,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);
@@ -19170,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.",
@@ -19183,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: {
@@ -19204,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 };
 }
 

package/dist/server.d.ts

@@ -0,0 +1,31 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { DimAgentClient, DimAgentClientConfig } from '@dimcool/dim-agent-core';
+
+/** Options controlling which tools are registered. */
+interface DimMcpServerOptions {
+    /**
+     * 'local'  — all tools, WS-backed game_loop included (default).
+     * 'hosted' — stateless HTTP-only tools; dim_game_loop and
+     *            dim_get_pending_events are excluded.
+     */
+    mode?: 'local' | 'hosted';
+}
+/**
+ * Create a hosted MCP server from a pre-built DimAgentClient.
+ * Excludes WS-dependent tools (dim_game_loop, dim_get_pending_events).
+ * Returns only the McpServer — the caller owns the client lifecycle.
+ */
+declare function createDimMcpServer(client: DimAgentClient, options: DimMcpServerOptions & {
+    mode: 'hosted';
+}): McpServer;
+/**
+ * Create a local (stdio) MCP server from a config object.
+ * All tools are registered including dim_game_loop.
+ * Returns both the McpServer and the DimAgentClient it created.
+ */
+declare function createDimMcpServer(config: DimAgentClientConfig): {
+    server: McpServer;
+    client: DimAgentClient;
+};
+
+export { type DimMcpServerOptions, createDimMcpServer };