BULC Building Designer

Instructions

Implementation Reference

• src/tools/evac.ts:1006-1012 (handler)

  The core handler logic for the 'bulc_stop_evac' tool within the handleEvacTool function's switch statement. It forwards the request to the BULC client by sending a 'stop_evac' action with empty parameters.

  case "bulc_stop_evac": {
    result = await client.sendCommand({
      action: "stop_evac",
      params: {},
    });
    break;
  }

• src/tools/evac.ts:375-386 (registration)

  The tool registration object in the evacTools export array, defining the name, description, empty input schema, and annotations (destructive operation). This is included in the MCP tool list.

  {
    name: "bulc_stop_evac",
    description: "Stop a running evacuation simulation.",
    inputSchema: {
      type: "object" as const,
      properties: {},
    },
    annotations: {
      readOnlyHint: false,
      destructiveHint: true,
    },
  },

• src/tools/evac.ts:378-386 (schema)

  The input schema for 'bulc_stop_evac', specifying an empty object (no parameters required). Part of the tool registration.

    inputSchema: {
      type: "object" as const,
      properties: {},
    },
    annotations: {
      readOnlyHint: false,
      destructiveHint: true,
    },
  },

• src/index.ts:39-51 (registration)

  The main allTools array in the MCP server entry point, which spreads evacTools (containing bulc_stop_evac) into the complete tool list returned by ListToolsRequestHandler.

  // Combine all tools
  const allTools = [
    ...contextTools,      // 8 tools: spatial context, home info, levels, undo/redo, save
    ...roomTools,         // 5 tools: create, create_polygon, list, modify, delete
    ...wallTools,         // 5 tools: create, create_rectangle, list, modify, delete
    ...furnitureTools,    // 5 tools: catalog, place, list, modify, delete
    ...fdsDataTools,      // 7 tools: get, fire_source, detector, sprinkler, hvac, thermocouple, clear
    ...meshTools,         // 5 tools: list, create, auto, modify, delete
    ...simulationTools,   // 4 tools: get_settings, time, output, ambient
    ...fdsRunTools,       // 6 tools: preview, validate, export, run, status, stop
    ...resultTools,       // 5 tools: open_viewer, list_datasets, point_data, aset, report
    ...evacTools,         // 25 tools: setup, stairs, agents, run, results, advanced features
  ];

• src/index.ts:135-137 (handler)

  Top-level tool dispatch logic in the MCP CallToolRequestHandler that routes 'bulc_stop_evac' (matches 'bulc_' and 'evac') to the specific handleEvacTool function.

  if (name.startsWith("bulc_") && name.includes("evac")) {
    return await handleEvacTool(name, safeArgs);
  }