ice-puzzle-mcp

Instructions

Implementation Reference

• src/tools/tile-operations.ts:159-175 (handler)

  The main handler function for clear_region tool. It gets the current draft, calculates the bounded rectangular region from x1,y1 to x2,y2, iterates through each position and calls draftStore.removeElement(), counts cleared positions, and returns a response with the count and auto-solved visualization.
  handler: async (args) => { const draft = draftStore.getCurrentDraft(); if (!draft) return { content: [{ type: 'text', text: 'No active draft. Use create_level first.' }] }; let cleared = 0; const minX = Math.max(1, Math.min(args.x1, args.x2)); const maxX = Math.min(draft.gridWidth - 2, Math.max(args.x1, args.x2)); const minY = Math.max(1, Math.min(args.y1, args.y2)); const maxY = Math.min(draft.gridHeight - 2, Math.max(args.y1, args.y2)); for (let y = minY; y <= maxY; y++) { for (let x = minX; x <= maxX; x++) { draftStore.removeElement(x, y); cleared++; } } const current = draftStore.getCurrentDraft()!; return { content: [{ type: 'text', text: `Cleared ${cleared} positions\n\n${autoSolveAndVisualize(current)}` }] }; },
• src/tools/tile-operations.ts:149-158 (schema)

  Input schema definition for clear_region tool. Defines an object with properties x1, y1, x2, y2 (all required numbers) representing the top-left and bottom-right coordinates of the rectangular region to clear.
  inputSchema: { type: 'object', properties: { x1: { type: 'number', description: 'Top-left X' }, y1: { type: 'number', description: 'Top-left Y' }, x2: { type: 'number', description: 'Bottom-right X' }, y2: { type: 'number', description: 'Bottom-right Y' }, }, required: ['x1', 'y1', 'x2', 'y2'], },
• src/tools/tile-operations.ts:147-176 (registration)

  Tool definition object for clear_region, including name, description, inputSchema, and handler. This is part of the array returned by getTileOperationTools() function that registers all tile operation tools.
  name: 'clear_region', description: 'Clear all tiles in a rectangular region. Auto-solves after clear.', inputSchema: { type: 'object', properties: { x1: { type: 'number', description: 'Top-left X' }, y1: { type: 'number', description: 'Top-left Y' }, x2: { type: 'number', description: 'Bottom-right X' }, y2: { type: 'number', description: 'Bottom-right Y' }, }, required: ['x1', 'y1', 'x2', 'y2'], }, handler: async (args) => { const draft = draftStore.getCurrentDraft(); if (!draft) return { content: [{ type: 'text', text: 'No active draft. Use create_level first.' }] }; let cleared = 0; const minX = Math.max(1, Math.min(args.x1, args.x2)); const maxX = Math.min(draft.gridWidth - 2, Math.max(args.x1, args.x2)); const minY = Math.max(1, Math.min(args.y1, args.y2)); const maxY = Math.min(draft.gridHeight - 2, Math.max(args.y1, args.y2)); for (let y = minY; y <= maxY; y++) { for (let x = minX; x <= maxX; x++) { draftStore.removeElement(x, y); cleared++; } } const current = draftStore.getCurrentDraft()!; return { content: [{ type: 'text', text: `Cleared ${cleared} positions\n\n${autoSolveAndVisualize(current)}` }] }; }, },
• src/tools/tile-operations.ts:14-24 (helper)

  Helper function autoSolveAndVisualize() used by the clear_region handler. It exports puzzle data, solves it, updates the draft with solver result, renders the level with coordinates, and returns a formatted string with the visualization and solver info.
  function autoSolveAndVisualize(draft: DraftState): string { const puzzleData = draftStore.exportPuzzleData(); if (puzzleData) { const result = solve(puzzleData); draftStore.updateDraft({ lastSolverResult: result, isDirty: false }); } const current = draftStore.getCurrentDraft()!; const viz = renderLevel(current, { showCoords: true }); const solverInfo = current.lastSolverResult ? formatSolverResult(current.lastSolverResult) : ''; return `${viz}\n${solverInfo}`; }