kill-switch-mcp 1.1.2 → 1.1.3

package/src/server.ts

@@ -1,1088 +0,0 @@
-#!/usr/bin/env node
-/**
- * Kill Switch MCP Server
- *
- * This is the bridge between Claude Code and the Kill Switch tournament arena.
- * It runs locally on the player's machine and connects to the game server.
- *
- * Tools:
- *   - login:              Log in, set up, and connect to the game.
- *   - execute_code:       Send commands to your bot during gameplay.
- *   - get_status:         Check your bot's current state without executing code.
- *   - join_game:          Join a free game mode queue.
- *   - wait_for_game_start: Wait for the game to begin.
- *   - disconnect_bot:     Disconnect from the game.
- *   - setup_game_wallet:  Set up a Tempo wallet access key for paid tournaments.
- *   - check_wallet:       Check game wallet address and USDC balance.
- *   - tournament_schedule: View upcoming paid tournaments.
- *   - join_tournament:    Join a paid tournament (deposits buy-in from game wallet).
- */
-
-import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import {
-  CallToolRequestSchema,
-  ListToolsRequestSchema
-} from '@modelcontextprotocol/sdk/types.js';
-import { existsSync } from 'fs';
-import { readFile } from 'fs/promises';
-import { join } from 'path';
-import { botManager } from './api/index.js';
-import { formatWorldState } from './sdk/formatter.js';
-import {
-  hasGameWallet,
-  getWalletInfo,
-  generateAccessKey,
-  saveAccessKey,
-  getTournamentSchedule,
-  joinTournament,
-} from './wallet/index.js';
-
-// ── Configuration ──
-// Server URL from CLI args or env. Defaults to localhost for local dev.
-// In .mcp.json: { "args": ["run", "mcp/server.ts", "--server", "play.killswitch.gg"] }
-const SERVER_URL = (() => {
-  const idx = process.argv.indexOf('--server');
-  if (idx !== -1 && process.argv[idx + 1]) return process.argv[idx + 1];
-  return process.env.KILL_SWITCH_SERVER || 'localhost';
-})();
-
-console.error(`[Kill Switch MCP] Server: ${SERVER_URL}`);
-
-// ── Game Knowledge ──
-// This description is what teaches Claude about the game. It's included in tool descriptions
-// so Claude knows the full context without needing to read docs.
-const GAME_DESCRIPTION = `Kill Switch is a Hunger Games-style battle royale where AI agents fight to the death.
-
-YOU are the brain of your player's bot. The human talks to you about strategy, and you
-execute it by sending code to the game via execute_code.
-
-## How It Works
-1. Call login to register and connect (lands you in the lobby)
-2. Your bot spawns in Barbarian Village lobby with EMPTY inventory
-3. Call join_game with mode "shorty" (or "longy" when available) to queue up
-4. Chat with your human about strategy while waiting
-5. Call wait_for_game_start — it blocks until the admin starts the match
-6. When it returns, you're at the arena edge — run to the center to grab loot!
-
-## Game Modes
-- **SHORTY**: Quick battle royale at Draynor Manor. 50 atk/str/def, 99 HP. Loot & fight.
-- **LONGY**: (Coming soon) Large survival map. Level 1 stats, skill up, craft, outlast.
-
-## The Arena (Shorty)
-- You spawn on the PERIMETER of Draynor Manor with nothing
-- Items are scattered on the ground in a cornucopia pattern:
-  - Outer ring: bronze/iron weapons, leather armor, bread/meat
-  - Mid ring: mithril/adamant weapons, chainmail, trout/salmon
-  - Center: rune weapons, rune/adamant armor, lobster/swordfish
-- Better items are closer to the center — but so is everyone else!
-
-## PERMADEATH
-- If you die, your agent is DEAD FOREVER. No respawns, no second chances.
-- Only the last agent standing wins. Winners earn party hats!
-
-## Key Actions
-- bot.pickupItem(/item name/i) — pick up ground items (CRITICAL — you start empty!)
-- bot.equipItem(/item name/i) — equip weapons and armor from inventory
-- bot.eatFood(/food name/i) — eat food to heal
-- bot.attackPlayer("name") or bot.attackPlayer(/pattern/i) — attack another player
-- sdk.getNearbyPlayers() — see nearby players (name, combatLevel, distance, x, z)
-- sdk.findGroundItem(/pattern/i) — find items on the ground near you
-- sdk.getState().player.hitpoints — your current HP
-- sdk.getInventory() — check what you've picked up
-
-## Combat Loop Pattern
-Write reactive loops in execute_code that run for 15-30 seconds, then return state:
-
-// Phase 1: Grab loot
-const items = sdk.findGroundItem(/scimitar|sword|lobster|chainbody/i);
-if (items) await bot.pickupItem(items);
-
-// Equip best weapon found
-const weapon = sdk.findInventoryItem(/rune scimitar|adamant|mithril scimitar/i);
-if (weapon) await bot.equipItem(weapon);
-
-// Phase 2: Fight
-const endTime = Date.now() + 15_000;
-while (Date.now() < endTime) {
-    const hp = sdk.getState().player.hitpoints;
-    if (hp < 25) {
-        const food = sdk.findInventoryItem(/swordfish|lobster|salmon|trout|bread|meat/i);
-        if (food) await bot.eatFood(food);
-    }
-    const players = sdk.getNearbyPlayers();
-    if (players.length > 0) {
-        const nearest = players.sort((a, b) => a.distance - b.distance)[0];
-        await bot.attackPlayer(nearest);
-    }
-    await sdk.waitForTicks(2);
-}
-return { hp: sdk.getState().player.hitpoints, inventory: sdk.getInventory(), nearbyPlayers: sdk.getNearbyPlayers() };
-
-## Key Tips
-- You start with NOTHING — picking up items is your first priority!
-- Grab a weapon first, then food, then armor
-- Risk vs reward: center has the best loot but everyone converges there
-- Keep execute_code calls to 15-30 seconds, then check state and adapt
-- The human gives you strategy ("rush center", "play safe", "grab and run") — you turn it into code`;
-
-// ── Server Setup ──
-const server = new Server(
-  { name: 'kill-switch', version: '3.0.0' },
-  { capabilities: { tools: {} } }
-);
-
-// ── Tool Definitions ──
-server.setRequestHandler(ListToolsRequestSchema, async () => {
-  return {
-    tools: [
-      {
-        name: 'login',
-        description: `Log in to Kill Switch. Creates your account if needed, connects to the game server, and opens the browser client.
-
-Call this when the user says anything like "let's play", "join the game", "log in", "connect", etc.
-
-If the user already has a bot, this will reconnect. If not, it creates a new one. Idempotent — safe to call multiple times.
-
-${GAME_DESCRIPTION}`,
-        inputSchema: {
-          type: 'object',
-          properties: {
-            agent_name: {
-              type: 'string',
-              description: 'Name for the bot (max 12 chars, alphanumeric). If not provided, a random name is generated. If the user has played before and wants to reuse their name, use that.'
-            }
-          }
-        }
-      },
-      {
-        name: 'execute_code',
-        description: `Execute TypeScript code on your connected bot. The code runs in an async context with three globals:
-  - bot: High-level actions (attackPlayer, eatFood, walkTo, equipItem, pickupItem, etc.)
-  - sdk: Low-level state access (getState, getNearbyPlayers, getInventory, findGroundItem, etc.)
-  - actions: Pre-built strategy functions loaded from your bot's actions/ directory
-
-Use actions for common patterns instead of writing loops from scratch:
-  await actions.fightLoop({ eatAt: 25, duration: 15000 })
-  await actions.lootAndEquip({ maxItems: 5 })
-  await actions.kite({ safeHp: 40 })
-
-Or write custom code using bot/sdk directly for full control.
-
-You MUST call login before using this tool.`,
-        inputSchema: {
-          type: 'object',
-          properties: {
-            code: {
-              type: 'string',
-              description: 'TypeScript code to execute. Has access to bot (BotActions) and sdk (BotSDK).'
-            },
-            timeout: {
-              type: 'number',
-              description: 'Execution timeout in minutes (default: 2, max: 60)'
-            }
-          },
-          required: ['code']
-        }
-      },
-      {
-        name: 'get_status',
-        description: 'Check your bot\'s current state without executing any code. Returns position, HP, inventory, nearby players. Use this to assess the situation before deciding what to do.',
-        inputSchema: {
-          type: 'object',
-          properties: {}
-        }
-      },
-      {
-        name: 'wait_for_game_start',
-        description: `Wait for the game to start. Call this after login and join_game while chatting with your human about strategy.
-
-This tool blocks until the game starts and your bot is teleported to the arena. When it returns, the fight is ON — immediately start your combat loop!
-
-Typical flow:
-1. login → connect to game
-2. join_game → pick a mode
-3. Chat strategy with human
-4. wait_for_game_start → blocks until game starts
-5. execute_code → start fighting!`,
-        inputSchema: {
-          type: 'object',
-          properties: {
-            timeout: {
-              type: 'number',
-              description: 'Max seconds to wait (default: 300 = 5 minutes)'
-            }
-          }
-        }
-      },
-      {
-        name: 'join_game',
-        description: `Join a specific game mode queue. Call this after login when your human says which mode to play.
-
-Available modes:
-- "shorty": Quick battle royale at Draynor Manor. 50 atk/str/def, 99 HP. Grab loot, fight, last one standing wins.
-- "longy": (Coming soon) Large survival map with skill progression.
-
-After joining, call wait_for_game_start to wait for the game to begin.`,
-        inputSchema: {
-          type: 'object',
-          properties: {
-            mode: {
-              type: 'string',
-              enum: ['shorty', 'longy'],
-              description: 'Game mode to join'
-            }
-          },
-          required: ['mode']
-        }
-      },
-      {
-        name: 'disconnect_bot',
-        description: 'Disconnect from the game. Use when done playing.',
-        inputSchema: {
-          type: 'object',
-          properties: {}
-        }
-      },
-      {
-        name: 'setup_game_wallet',
-        description: `Set up a game wallet for paid tournaments. This creates a local access key that lets you join paid tournament matches.
-
-IMPORTANT: This tool handles real (or testnet) money. Explain to the user what's happening at each step.
-
-Prerequisites:
-- The user must have the Tempo CLI installed (curl -fsSL https://tempo.xyz/install | bash)
-- The user must have run "tempo wallet login" to create their Tempo account
-
-This tool generates a local access key. The user then needs to authorize it on their Tempo account (requires biometric/passkey confirmation). After that, the key is stored locally in ~/.killswitch/ and used for all tournament deposits.
-
-Learn more about Tempo access keys: https://docs.tempo.xyz/protocol/tips/tip-1011`,
-        inputSchema: {
-          type: 'object',
-          properties: {
-            tempo_account_address: {
-              type: 'string',
-              description: 'The user\'s Tempo account address (0x...). Get this by running "tempo wallet whoami".'
-            }
-          },
-          required: ['tempo_account_address']
-        }
-      },
-      {
-        name: 'check_wallet',
-        description: `Check your game wallet status and USDC balance. Shows your Tempo account address and how much USDC you have available for tournament buy-ins.
-
-If no game wallet is set up, this will tell you to run setup_game_wallet first.`,
-        inputSchema: {
-          type: 'object',
-          properties: {}
-        }
-      },
-      {
-        name: 'tournament_schedule',
-        description: `View upcoming paid tournaments. Shows start times, buy-in amounts, and how many players have signed up.
-
-This is a read-only tool — it doesn't cost anything to check the schedule.`,
-        inputSchema: {
-          type: 'object',
-          properties: {}
-        }
-      },
-      {
-        name: 'join_tournament',
-        description: `Join a paid tournament by depositing the buy-in from your game wallet.
-
-THIS TOOL SPENDS REAL MONEY (or testnet money). Before calling this tool:
-1. Tell the user exactly which tournament they're joining (time, buy-in amount)
-2. Show their current wallet balance
-3. Ask them to confirm they want to proceed
-4. Only then call this tool
-
-The deposit is sent on-chain to the tournament's escrow contract. The user's buy-in is held in escrow until:
-- They win → they receive 90% of the pot
-- The match is cancelled → they get a full refund
-- The server goes down → they can claim a refund after 1 hour
-
-The user must be logged in (call login first) so we know their in-game username.`,
-        inputSchema: {
-          type: 'object',
-          properties: {
-            tournament_address: {
-              type: 'string',
-              description: 'The tournament contract address to join (from tournament_schedule)'
-            }
-          },
-          required: ['tournament_address']
-        }
-      }
-    ]
-  };
-});
-
-// ── Action Loading ──
-
-/** Convert kebab-case filename to camelCase function name */
-function toCamelCase(str: string): string {
-  return str.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
-}
-
-/**
- * Load custom actions from bots/<name>/actions/*.ts
- *
- * Each action file must have a default export:
- *   export default async function(bot, sdk, opts) { ... }
- *
- * The filename becomes the function name:
- *   fight-loop.ts → actions.fightLoop(opts)
- */
-async function loadActions(botName: string, bot: any, sdk: any): Promise<{ actions: Record<string, Function>; descriptions: string[] }> {
-  const { existsSync, readdirSync, cpSync, readFileSync } = await import('fs');
-  const { join, basename } = await import('path');
-  const { pathToFileURL } = await import('url');
-
-  const botsDir = join(process.cwd(), 'bots');
-  const actionsDir = join(botsDir, botName, 'actions');
-  // Defaults ship with the npm package, resolve relative to this file
-  const defaultsDir = join(new URL('.', import.meta.url).pathname, '..', 'defaults', 'actions');
-
-  console.error(`[Kill Switch] Loading actions from ${actionsDir}`);
-
-  // Copy defaults if no actions dir exists
-  if (!existsSync(actionsDir) && existsSync(defaultsDir)) {
-    cpSync(defaultsDir, actionsDir, { recursive: true });
-    console.error(`[Kill Switch] Copied default actions to ${actionsDir}`);
-  }
-
-  const actions: Record<string, Function> = {};
-  const descriptions: string[] = [];
-
-  if (!existsSync(actionsDir)) {
-    console.error(`[Kill Switch] No actions directory found at ${actionsDir}`);
-    return { actions, descriptions };
-  }
-
-  const files = readdirSync(actionsDir).filter(f => f.endsWith('.ts'));
-  console.error(`[Kill Switch] Found ${files.length} action files: ${files.join(', ')}`);
-
-  for (const file of files) {
-    const filePath = join(actionsDir, file);
-    const name = toCamelCase(basename(file, '.ts'));
-
-    try {
-      // Cache-bust so re-login picks up edited action files
-      const fileUrl = pathToFileURL(filePath).href + `?t=${Date.now()}`;
-      const mod = await import(fileUrl);
-
-      if (typeof mod.default !== 'function') {
-        console.error(`[Kill Switch] Action ${file} has no default export, skipping`);
-        continue;
-      }
-
-      // Wrap: actions.name(opts) → mod.default(bot, sdk, opts)
-      actions[name] = (opts?: any) => mod.default(bot, sdk, opts);
-
-      // Extract JSDoc description from file for discovery
-      const source = readFileSync(filePath, 'utf-8');
-      const jsdocMatch = source.match(/\/\*\*\s*\n\s*\*\s*(.+?)[\n*]/);
-      const desc = jsdocMatch ? jsdocMatch[1].trim() : 'Custom action';
-
-      descriptions.push(`  - actions.${name}(opts) — ${desc}`);
-      console.error(`[Kill Switch] Loaded action: ${name} (${file})`);
-    } catch (e: any) {
-      console.error(`[Kill Switch] Failed to load action ${file}: ${e.message}`);
-    }
-  }
-
-  console.error(`[Kill Switch] Loaded ${Object.keys(actions).length} actions: ${Object.keys(actions).join(', ')}`);
-  return { actions, descriptions };
-}
-
-// ── Helpers ──
-function generateRandomName(): string {
-  const chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
-  let result = '';
-  for (let i = 0; i < 9; i++) {
-    result += chars.charAt(Math.floor(Math.random() * chars.length));
-  }
-  return result;
-}
-
-function generateRandomPassword(): string {
-  const chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
-  let result = '';
-  for (let i = 0; i < 12; i++) {
-    result += chars.charAt(Math.floor(Math.random() * chars.length));
-  }
-  return result;
-}
-
-function parseEnv(content: string): Record<string, string> {
-  const result: Record<string, string> = {};
-  for (const line of content.split('\n')) {
-    const trimmed = line.trim();
-    if (!trimmed || trimmed.startsWith('#')) continue;
-    const [key, ...valueParts] = trimmed.split('=');
-    if (key && valueParts.length > 0) {
-      result[key.trim()] = valueParts.join('=').trim();
-    }
-  }
-  return result;
-}
-
-// Track the active bot for this session
-let activeBotName: string | null = null;
-let activeActions: Record<string, Function> = {};
-let activeActionDescriptions: string[] = [];
-
-function getActiveConnection() {
-  if (!activeBotName) return null;
-  return botManager.get(activeBotName) || null;
-}
-
-// ── Tool Handlers ──
-server.setRequestHandler(CallToolRequestSchema, async (request, extra) => {
-  const { name, arguments: args } = request.params;
-
-  try {
-    switch (name) {
-      case 'login': {
-        let botName = (args?.agent_name as string) || '';
-
-        // Check if we already have an active connection
-        if (activeBotName) {
-          const existing = botManager.get(activeBotName);
-          if (existing?.connected) {
-            const state = existing.sdk.getState();
-            const parts = [`Already connected as "${activeBotName}".`];
-            if (state) {
-              parts.push('');
-              parts.push('── Current State ──');
-              parts.push(formatWorldState(state, existing.sdk.getStateAge()));
-            }
-            parts.push('');
-            parts.push('Your bot is in the game. Talk strategy with your human while waiting for the tournament to start!');
-            return { content: [{ type: 'text', text: parts.join('\n') }] };
-          }
-        }
-
-        // Step 1: Find or create bot credentials
-        const botsDir = join(process.cwd(), 'bots');
-        let username: string;
-        let password: string;
-
-        if (botName) {
-          // User specified a name — check if it already exists
-          const envPath = join(botsDir, botName, 'bot.env');
-          if (existsSync(envPath)) {
-            console.error(`[Kill Switch] Found existing bot "${botName}"`);
-            const env = parseEnv(await readFile(envPath, 'utf-8'));
-            username = env.BOT_USERNAME || botName;
-            password = env.PASSWORD || '';
-          } else {
-            // Create new bot
-            console.error(`[Kill Switch] Creating new bot "${botName}"`);
-            username = botName;
-            password = generateRandomPassword();
-
-            // Create bot directory and env file
-            const { mkdirSync, writeFileSync } = await import('fs');
-            const botDir = join(botsDir, botName);
-            mkdirSync(botDir, { recursive: true });
-            writeFileSync(join(botDir, 'bot.env'), [
-              `BOT_USERNAME=${username}`,
-              `PASSWORD=${password}`,
-              `SERVER=${SERVER_URL}`,
-              `SHOW_CHAT=false`
-            ].join('\n'));
-          }
-        } else {
-          // No name specified — check for any existing bot first
-          const { readdirSync } = await import('fs');
-          if (existsSync(botsDir)) {
-            const dirs = readdirSync(botsDir).filter(d =>
-              d !== '_template' && existsSync(join(botsDir, d, 'bot.env'))
-            );
-            if (dirs.length > 0) {
-              // Reuse the first existing bot
-              botName = dirs[0];
-              console.error(`[Kill Switch] Reusing existing bot "${botName}"`);
-              const env = parseEnv(await readFile(join(botsDir, botName, 'bot.env'), 'utf-8'));
-              username = env.BOT_USERNAME || botName;
-              password = env.PASSWORD || '';
-            } else {
-              // Generate a random name
-              botName = generateRandomName();
-              username = botName;
-              password = generateRandomPassword();
-
-              const { mkdirSync, writeFileSync } = await import('fs');
-              const botDir = join(botsDir, botName);
-              mkdirSync(botDir, { recursive: true });
-              writeFileSync(join(botDir, 'bot.env'), [
-                `BOT_USERNAME=${username}`,
-                `PASSWORD=${password}`,
-                `SERVER=${SERVER_URL}`,
-                `SHOW_CHAT=false`
-              ].join('\n'));
-              console.error(`[Kill Switch] Created new bot "${botName}"`);
-            }
-          } else {
-            botName = generateRandomName();
-            username = botName;
-            password = generateRandomPassword();
-
-            const { mkdirSync, writeFileSync } = await import('fs');
-            const botDir = join(botsDir, botName);
-            mkdirSync(botDir, { recursive: true });
-            writeFileSync(join(botDir, 'bot.env'), [
-              `BOT_USERNAME=${username}`,
-              `PASSWORD=${password}`,
-              `SERVER=${SERVER_URL}`,
-              `SHOW_CHAT=false`
-            ].join('\n'));
-            console.error(`[Kill Switch] Created new bot "${botName}"`);
-          }
-        }
-
-        // Step 1.5: Check if agent is alive (permadeath check)
-        try {
-          const isLocal = SERVER_URL === 'localhost' || SERVER_URL === '127.0.0.1';
-          const webBase = isLocal ? `http://localhost:8888` : `https://${SERVER_URL}`;
-          const aliveRes = await fetch(`${webBase}/api/agent-alive?username=${encodeURIComponent(username!.toLowerCase())}`);
-          const aliveData = await aliveRes.json() as any;
-          if (aliveData.alive === false) {
-            return errorResponse(
-              `Agent "${username}" is PERMANENTLY DEAD (${aliveData.wins} wins, ${aliveData.kills} kills). ` +
-              `This agent can never play again. Create a new agent with a different name to play.`
-            );
-          }
-        } catch (e: any) {
-          console.error(`[Kill Switch] Agent alive check failed (continuing): ${e.message}`);
-          // Non-fatal — server might not be running yet
-        }
-
-        // Step 2: Connect to the game
-        console.error(`[Kill Switch] Connecting "${botName}" to ${SERVER_URL}...`);
-
-        // Suppress stdout logs during connection (MCP uses stdout for JSON-RPC)
-        const originalLog = console.log;
-        const originalWarn = console.warn;
-        console.log = (...a) => console.error('[log]', ...a);
-        console.warn = (...a) => console.error('[warn]', ...a);
-
-        try {
-          const connection = await botManager.connect(botName);
-
-          // Wait for initial game state
-          try {
-            await connection.sdk.waitForCondition(() => connection.sdk.getState() !== null, 20000);
-          } catch {
-            console.error(`[Kill Switch] Warning: initial state not received within 20s`);
-          }
-
-          activeBotName = botName;
-
-          // Load custom actions
-          const { actions, descriptions } = await loadActions(botName, connection.bot, connection.sdk);
-          activeActions = actions;
-          activeActionDescriptions = descriptions;
-
-          const state = connection.sdk.getState();
-          const parts = [
-            `Connected as "${username}"!`,
-            '',
-            'Your bot is in the game. A browser window should have opened showing the game view.',
-            '',
-            'You\'re in the tournament lobby (Barbarian Village) with:',
-            '  - EMPTY inventory and no equipment',
-            '  - Combat stats: 50 Attack, 50 Strength, 50 Defence, 99 Hitpoints',
-            '',
-            'NEXT STEP: Call join_game with mode "shorty" (or "longy" when available) to queue up.',
-            '',
-            'Game modes:',
-            '  - SHORTY: Quick battle royale at Draynor Manor. Loot, fight, last one standing.',
-            '  - LONGY: (Coming soon) Large survival map with skill progression.',
-            '',
-            'After joining a game, call wait_for_game_start to wait for the game to begin.',
-          ];
-
-          if (activeActionDescriptions.length > 0) {
-            parts.push('');
-            parts.push('── Loaded Actions ──');
-            parts.push('Use these in execute_code via the `actions` object:');
-            parts.push(...activeActionDescriptions);
-          }
-
-          if (state) {
-            parts.push('');
-            parts.push('── Current State ──');
-            parts.push(formatWorldState(state, connection.sdk.getStateAge()));
-          }
-
-          return { content: [{ type: 'text', text: parts.join('\n') }] };
-        } finally {
-          console.log = originalLog;
-          console.warn = originalWarn;
-        }
-      }
-
-      case 'get_status': {
-        const connection = getActiveConnection();
-        if (!connection) {
-          return errorResponse('Not connected. Call login first.');
-        }
-
-        const state = connection.sdk.getState();
-        if (!state) {
-          return errorResponse('No game state available. The game client may not be loaded yet.');
-        }
-
-        return {
-          content: [{ type: 'text', text: formatWorldState(state, connection.sdk.getStateAge()) }]
-        };
-      }
-
-      case 'execute_code': {
-        const code = args?.code as string;
-        if (!code) {
-          return errorResponse('code is required');
-        }
-
-        // Use active bot, or error
-        const botName = activeBotName;
-        if (!botName) {
-          return errorResponse('Not connected. Call login first.');
-        }
-
-        const isLongCode = code.length > 2000;
-
-        // Capture console output
-        const logs: string[] = [];
-        const originalLog = console.log;
-        const originalWarn = console.warn;
-
-        console.log = (...args) => logs.push(args.map(a => typeof a === 'object' ? JSON.stringify(a, null, 2) : String(a)).join(' '));
-        console.warn = (...args) => logs.push('[warn] ' + args.map(a => typeof a === 'object' ? JSON.stringify(a, null, 2) : String(a)).join(' '));
-
-        let connection = botManager.get(botName);
-        if (!connection) {
-          console.error(`[Kill Switch] Bot "${botName}" not connected, reconnecting...`);
-          connection = await botManager.connect(botName);
-          try {
-            await connection.sdk.waitForCondition(() => connection!.sdk.getState() !== null, 15000);
-          } catch {
-            console.error(`[Kill Switch] Warning: state not received within 15s`);
-          }
-        }
-
-        try {
-          const AsyncFunction = Object.getPrototypeOf(async function () {}).constructor;
-          const fn = new AsyncFunction('bot', 'sdk', 'actions', code);
-
-          const timeoutMinutes = Math.min(Math.max((args?.timeout as number) || 2, 0.1), 60);
-          const EXECUTION_TIMEOUT = timeoutMinutes * 60 * 1000;
-          let timeoutId: ReturnType<typeof setTimeout>;
-          const timeoutPromise = new Promise<never>((_, reject) => {
-            timeoutId = setTimeout(() => reject(new Error(`Code execution timed out after ${timeoutMinutes} minute(s)`)), EXECUTION_TIMEOUT);
-          });
-
-          const abortController = new AbortController();
-          const signal = abortController.signal;
-
-          if (extra.signal) {
-            if (extra.signal.aborted) {
-              abortController.abort(extra.signal.reason);
-            } else {
-              extra.signal.addEventListener('abort', () => {
-                console.error(`[Kill Switch] execute_code cancelled`);
-                abortController.abort('Cancelled by client');
-              }, { once: true });
-            }
-          }
-
-          const cancelPromise = new Promise<never>((_, reject) => {
-            signal.addEventListener('abort', () => {
-              reject(new Error(typeof signal.reason === 'string' ? signal.reason : 'Code execution cancelled'));
-            }, { once: true });
-          });
-
-          const cancellable = <T extends object>(target: T): T =>
-            new Proxy(target, {
-              get(obj, prop, receiver) {
-                const value = Reflect.get(obj, prop, receiver);
-                if (typeof value === 'function') {
-                  return (...args: any[]) => {
-                    if (signal.aborted) throw new Error('Execution cancelled');
-                    return value.apply(obj, args);
-                  };
-                }
-                return value;
-              }
-            });
-
-          let result: any;
-          try {
-            result = await Promise.race([fn(cancellable(connection.bot), cancellable(connection.sdk), activeActions), timeoutPromise, cancelPromise]);
-          } finally {
-            clearTimeout(timeoutId!);
-            if (!signal.aborted) abortController.abort('Execution finished');
-          }
-
-          // Build output
-          const parts: string[] = [];
-
-          if (logs.length > 0) {
-            parts.push('── Console ──');
-            parts.push(logs.join('\n'));
-          }
-
-          if (result !== undefined) {
-            if (logs.length > 0) parts.push('');
-            parts.push('── Result ──');
-            parts.push(JSON.stringify(result, null, 2));
-          }
-
-          const state = connection.sdk.getState();
-          if (state) {
-            parts.push('');
-            parts.push('── World State ──');
-            parts.push(formatWorldState(state, connection.sdk.getStateAge()));
-          }
-
-          if (isLongCode) {
-            parts.push('');
-            parts.push('── Tip ──');
-            parts.push(`Long script detected. Consider writing to a .ts file and running with: bun run bots/${botName}/script.ts`);
-          }
-
-          const output = parts.length > 0 ? parts.join('\n') : '(no output)';
-          return { content: [{ type: 'text', text: output }] };
-        } finally {
-          console.log = originalLog;
-          console.warn = originalWarn;
-        }
-      }
-
-      case 'wait_for_game_start': {
-        const connection = getActiveConnection();
-        if (!connection) {
-          return errorResponse('Not connected. Call login first.');
-        }
-
-        const timeoutSecs = Math.min(Math.max((args?.timeout as number) || 300, 10), 600);
-        // Draynor Manor arena bounds
-        const ARENA_MIN_X = 3086;
-        const ARENA_MAX_X = 3126;
-        const ARENA_MIN_Z = 3333;
-        const ARENA_MAX_Z = 3382;
-
-        console.error(`[Kill Switch] Waiting for tournament to start (timeout: ${timeoutSecs}s)...`);
-
-        const startTime = Date.now();
-        const deadline = startTime + timeoutSecs * 1000;
-
-        // Poll every 2 seconds for position change to arena
-        while (Date.now() < deadline) {
-          const state = connection.sdk.getState();
-          if (state) {
-            // Check if player has been teleported INTO the fight zone (not just nearby)
-            const x = state.player.worldX;
-            const z = state.player.worldZ;
-            if (x >= ARENA_MIN_X && x <= ARENA_MAX_X && z >= ARENA_MIN_Z && z <= ARENA_MAX_Z) {
-              const waitTime = ((Date.now() - startTime) / 1000).toFixed(1);
-              console.error(`[Kill Switch] Tournament started! (detected after ${waitTime}s)`);
-
-              const players = connection.sdk.getNearbyPlayers?.() || [];
-              const parts = [
-                'TOURNAMENT STARTED!',
-                '',
-                `You've been teleported to Draynor Manor. The fight is ON!`,
-                `Position: ${state.player.worldX}, ${state.player.worldZ}`,
-                `HP: ${state.player.hp}/${state.player.maxHp}`,
-                '',
-                `Nearby players: ${players.length > 0 ? players.map((p: any) => `${p.name} (CB ${p.combatLevel}, dist ${p.distance})`).join(', ') : 'scanning...'}`,
-                '',
-                'REMEMBER: You die = your agent dies FOREVER. No second chances.',
-                '',
-                'IMMEDIATELY:',
-                '1. Pick up weapons and food from the ground',
-                '2. Equip best weapon found, then start fighting',
-                '3. Eat when HP gets low — you have 99 HP but no food yet!',
-              ];
-
-              return { content: [{ type: 'text', text: parts.join('\n') }] };
-            }
-          }
-          await new Promise(resolve => setTimeout(resolve, 2000));
-        }
-
-        return errorResponse(`Tournament didn't start within ${timeoutSecs} seconds. Try calling wait_for_game_start again.`);
-      }
-
-      case 'join_game': {
-        const connection = getActiveConnection();
-        if (!connection) {
-          return errorResponse('Not connected. Call login first.');
-        }
-
-        const mode = args?.mode as string;
-        if (!mode || !['shorty', 'longy'].includes(mode)) {
-          return errorResponse('mode must be "shorty" or "longy"');
-        }
-
-        // Determine the web server base URL
-        const isLocal = SERVER_URL === 'localhost' || SERVER_URL === '127.0.0.1';
-        const webBase = isLocal ? `http://localhost:8888` : `https://${SERVER_URL}`;
-        const apiUrl = `${webBase}/api/join-game?username=${encodeURIComponent(activeBotName!)}&mode=${encodeURIComponent(mode)}`;
-
-        try {
-          const res = await fetch(apiUrl, { method: 'POST' });
-          const data = await res.json() as any;
-
-          if (data.error) {
-            return errorResponse(data.error);
-          }
-
-          const parts = [
-            `Joined ${mode.toUpperCase()} queue!`,
-            '',
-            `Queue position: ${data.queuePosition}`,
-            `Players in queue: ${data.queuePlayers?.join(', ') || 'just you'}`,
-            '',
-          ];
-
-          if (mode === 'shorty') {
-            parts.push('SHORTY: Quick battle royale at Draynor Manor.');
-            parts.push('Stats: 50 Attack, 50 Strength, 50 Defence, 99 Hitpoints');
-            parts.push('You start with NOTHING — grab weapons and food from the ground!');
-          } else {
-            parts.push('LONGY: Large survival map (coming soon).');
-          }
-
-          parts.push('');
-          parts.push('Now call wait_for_game_start to wait for the game to begin.');
-          parts.push('Chat strategy with your human while you wait!');
-
-          return { content: [{ type: 'text', text: parts.join('\n') }] };
-        } catch (e: any) {
-          return errorResponse(`Failed to join game: ${e.message}. Is the game server running?`);
-        }
-      }
-
-      case 'disconnect_bot': {
-        if (!activeBotName) {
-          return successResponse({ message: 'Not connected.' });
-        }
-
-        await botManager.disconnect(activeBotName);
-        const name = activeBotName;
-        activeBotName = null;
-        return successResponse({ message: `Disconnected "${name}" from the game.` });
-      }
-
-      case 'setup_game_wallet': {
-        const tempoAddress = args?.tempo_account_address as string;
-        if (!tempoAddress || !tempoAddress.startsWith('0x')) {
-          return errorResponse('A valid Tempo account address (0x...) is required. Run "tempo wallet whoami" to get yours.');
-        }
-
-        // Check if wallet already exists
-        if (hasGameWallet()) {
-          try {
-            const info = await getWalletInfo();
-            return {
-              content: [{
-                type: 'text',
-                text: [
-                  'You already have a game wallet set up.',
-                  '',
-                  `Account: ${info.address}`,
-                  `Balance: $${info.balance} USDC`,
-                  '',
-                  'To start fresh, delete ~/.killswitch/access-key.json and run this again.',
-                ].join('\n')
-              }]
-            };
-          } catch {
-            // Wallet file exists but might be corrupt, continue with setup
-          }
-        }
-
-        // Generate access key
-        const { accessKeyAddress, privateKey, instructions } = generateAccessKey();
-
-        // Save it (the player still needs to authorize it on-chain)
-        saveAccessKey(privateKey, tempoAddress);
-
-        return {
-          content: [{
-            type: 'text',
-            text: [
-              'Game wallet setup started!',
-              '',
-              `Your Tempo account: ${tempoAddress}`,
-              `Generated access key: ${accessKeyAddress}`,
-              '',
-              '── NEXT STEP ──',
-              '',
-              'You need to authorize this access key on your Tempo account.',
-              'This requires your passkey (biometric confirmation).',
-              '',
-              instructions,
-              '',
-              '── AFTER AUTHORIZATION ──',
-              '',
-              'Once authorized, your game wallet is ready. Check it with check_wallet.',
-              'Fund your Tempo account with USDC to start joining paid tournaments.',
-            ].join('\n')
-          }]
-        };
-      }
-
-      case 'check_wallet': {
-        if (!hasGameWallet()) {
-          return errorResponse(
-            'No game wallet found. Run setup_game_wallet first.\n\n' +
-            'Prerequisites:\n' +
-            '1. Install Tempo CLI: curl -fsSL https://tempo.xyz/install | bash\n' +
-            '2. Create account: tempo wallet login\n' +
-            '3. Get your address: tempo wallet whoami\n' +
-            '4. Then call setup_game_wallet with your address'
-          );
-        }
-
-        try {
-          const info = await getWalletInfo();
-          return {
-            content: [{
-              type: 'text',
-              text: [
-                '── Game Wallet ──',
-                '',
-                `Account: ${info.address}`,
-                `USDC Balance: $${info.balance}`,
-                '',
-                info.balanceRaw === 0n
-                  ? 'Your wallet is empty. Fund it by sending USDC to your account address on the Tempo network.'
-                  : 'Your wallet is funded and ready for paid tournaments. Use tournament_schedule to see upcoming games.',
-              ].join('\n')
-            }]
-          };
-        } catch (e: any) {
-          return errorResponse(`Failed to check wallet: ${e.message}`);
-        }
-      }
-
-      case 'tournament_schedule': {
-        try {
-          const slots = await getTournamentSchedule();
-
-          if (slots.length === 0) {
-            return {
-              content: [{
-                type: 'text',
-                text: 'No upcoming paid tournaments scheduled. Check back later, or paid tournaments may not be enabled on this server.'
-              }]
-            };
-          }
-
-          const lines = ['── Upcoming Paid Tournaments ──', ''];
-
-          for (let i = 0; i < slots.length; i++) {
-            const s = slots[i];
-            const time = new Date(s.startTime).toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' });
-            const buyIn = (parseInt(s.buyIn) / 1_000_000).toFixed(2);
-            lines.push(`[${i + 1}] ${time} — $${buyIn} buy-in — ${s.depositorCount}/${s.maxPlayers} players`);
-            lines.push(`    Contract: ${s.contractAddress}`);
-          }
-
-          lines.push('');
-          lines.push('To join a tournament, use join_tournament with the contract address.');
-          lines.push('Make sure you have enough USDC in your game wallet (check with check_wallet).');
-
-          return { content: [{ type: 'text', text: lines.join('\n') }] };
-        } catch (e: any) {
-          return errorResponse(`Failed to get tournament schedule: ${e.message}`);
-        }
-      }
-
-      case 'join_tournament': {
-        const tournamentAddress = args?.tournament_address as string;
-        if (!tournamentAddress || !tournamentAddress.startsWith('0x')) {
-          return errorResponse('A valid tournament contract address (0x...) is required. Use tournament_schedule to find one.');
-        }
-
-        if (!hasGameWallet()) {
-          return errorResponse('No game wallet found. Run setup_game_wallet first.');
-        }
-
-        if (!activeBotName) {
-          return errorResponse('Not logged in. Call login first so we know your in-game username.');
-        }
-
-        try {
-          const result = await joinTournament(tournamentAddress, activeBotName);
-
-          return {
-            content: [{
-              type: 'text',
-              text: [
-                'Tournament joined!',
-                '',
-                `Buy-in: $${result.amount} USDC`,
-                `Transaction: ${result.txHash}`,
-                `Username: ${activeBotName}`,
-                '',
-                'Your deposit is held in the tournament escrow contract.',
-                'Be online when the match starts or you\'ll be eliminated (buy-in stays in the pot).',
-                '',
-                'If the match is cancelled (< 2 players), you\'ll get a full refund.',
-                'If the server goes down, you can claim a refund after 1 hour.',
-              ].join('\n')
-            }]
-          };
-        } catch (e: any) {
-          return errorResponse(`Failed to join tournament: ${e.message}`);
-        }
-      }
-
-      default:
-        throw new Error(`Unknown tool: ${name}`);
-    }
-  } catch (error: any) {
-    const errorMessage = `Error: ${error.message}\n\nStack trace:\n${error.stack}`;
-    return {
-      content: [{ type: 'text', text: errorMessage }],
-      isError: true
-    };
-  }
-});
-
-function successResponse(data: any) {
-  return {
-    content: [{ type: 'text', text: JSON.stringify(data, null, 2) }]
-  };
-}
-
-function errorResponse(message: string) {
-  return {
-    content: [{ type: 'text', text: `Error: ${message}` }],
-    isError: true
-  };
-}
-
-// ── Start ──
-async function main() {
-  console.error('[Kill Switch MCP] Starting Kill Switch MCP server v3.0...');
-  console.error(`[Kill Switch MCP] Game server: ${SERVER_URL}`);
-
-  const transport = new StdioServerTransport();
-  await server.connect(transport);
-
-  console.error('[Kill Switch MCP] Ready. Waiting for Claude...');
-}
-
-main().catch((error) => {
-  console.error('[Kill Switch MCP] Fatal error:', error);
-  process.exit(1);
-});