ice-puzzle-mcp

Instructions

Implementation Reference

• src/tools/level-management.ts:36-53 (registration)

  Complete tool registration for create_level including name, description, input schema, and handler function.
  { name: 'create_level', description: 'Create a new empty ice puzzle level. This becomes the current working draft.', inputSchema: { type: 'object', properties: { name: { type: 'string', description: 'Level name' }, width: { type: 'number', description: 'Grid width (5-25, default 10)', minimum: 5, maximum: 25 }, height: { type: 'number', description: 'Grid height (5-25, default 10)', minimum: 5, maximum: 25 }, }, required: ['name'], }, handler: async (args) => { const draft = draftStore.createDraft(args.name, args.width, args.height); const viz = renderLevel(draft, { showCoords: true }); return { content: [{ type: 'text', text: `Level "${args.name}" created!\n\n${formatDraftSummary(draft)}\n\n${viz}` }] }; }, },
• src/tools/level-management.ts:39-47 (schema)

  Input schema defining the accepted arguments: name (required string), width (optional number 5-25, default 10), height (optional number 5-25, default 10).
  inputSchema: { type: 'object', properties: { name: { type: 'string', description: 'Level name' }, width: { type: 'number', description: 'Grid width (5-25, default 10)', minimum: 5, maximum: 25 }, height: { type: 'number', description: 'Grid height (5-25, default 10)', minimum: 5, maximum: 25 }, }, required: ['name'], },
• src/tools/level-management.ts:48-52 (handler)

  Handler function that creates a new level draft using draftStore.createDraft() and returns a formatted response with level summary and visualization.
  handler: async (args) => { const draft = draftStore.createDraft(args.name, args.width, args.height); const viz = renderLevel(draft, { showCoords: true }); return { content: [{ type: 'text', text: `Level "${args.name}" created!\n\n${formatDraftSummary(draft)}\n\n${viz}` }] }; },
• src/store/draft-store.ts:88-116 (helper)

  The createDraft method in DraftStore that initializes a new DraftState with default positions (bottom-left start, top-right goal), empty obstacles/warps, and resets history.
  createDraft(name: string, width: number = 10, height: number = 10): DraftState { this.warpCounter = 1; this.undoStack = []; this.redoStack = []; this.lastSolvableSnapshot = null; const draft: DraftState = { id: null, previewId: null, name, description: '', gridWidth: width, gridHeight: height, par: 0, startPosition: { x: 1, y: height - 2 }, // bottom-left goalPosition: { x: width - 2, y: 1 }, // top-right obstacles: [], warpPairs: [], thinIceTiles: [], pushableRocks: [], pressurePlate: null, barrier: null, manualSolveMechanicsBaseline: null, manualSolveFingerprint: null, isDirty: false, lastSolverResult: null, }; this.currentDraft = draft; return draft; }
• src/tools/level-management.ts:14-32 (helper)

  formatDraftSummary helper function used by the handler to display level information including grid size, par, start/goal positions, obstacles, warps, and solver status.
  function formatDraftSummary(draft: DraftState): string { const solverInfo = draft.lastSolverResult ? formatSolverResult(draft.lastSolverResult) : 'Not yet solved'; return [ `Name: ${draft.name}`, `Grid: ${draft.gridWidth}x${draft.gridHeight}`, `Par: ${draft.par > 0 ? draft.par : 'not set'}`, `Start: (${draft.startPosition.x}, ${draft.startPosition.y})`, `Goal: (${draft.goalPosition.x}, ${draft.goalPosition.y})`, `Obstacles: ${draft.obstacles.length}`, `Warps: ${draft.warpPairs.length} pairs`, `Thin Ice: ${draft.thinIceTiles.length}`, `Pushable Rocks: ${draft.pushableRocks.length}`, draft.pressurePlate ? `Pressure Plate: (${draft.pressurePlate.x}, ${draft.pressurePlate.y})` : '', draft.barrier ? `Barrier: (${draft.barrier.x}, ${draft.barrier.y})` : '', `Solver: ${solverInfo}`, ].filter(Boolean).join('\n'); }