bulc_setup_evac_stair

Instructions

Implementation Reference

• src/tools/evac.ts:918-924 (handler)

  Specific handler case for 'bulc_setup_evac_stair' tool within the main handleEvacTool function. Validates input parameters using SetupEvacStairSchema and forwards the command to the BULC client backend.

  case "bulc_setup_evac_stair": {
    const validated = SetupEvacStairSchema.parse(args);
    result = await client.sendCommand({
      action: "setup_evac_stair",
      params: validated,
    });
    break;

• src/tools/evac.ts:108-163 (schema)

  MCP tool schema definition including name, description, detailed input schema, and annotations. Part of the evacTools array.

  {
    name: "bulc_setup_evac_stair",
    description:
      "Configure a furniture item as an evacuation stair connection between floors. " +
      "Defines entry/exit positions, capacity, and travel speed.",
    inputSchema: {
      type: "object" as const,
      properties: {
        furnitureId: {
          type: "string",
          description: "Furniture ID to configure as stair",
        },
        fromFloor: {
          type: "integer",
          description: "Source floor index (0=ground floor)",
        },
        toFloor: {
          type: "integer",
          description: "Destination floor index",
        },
        entryX: {
          type: "number",
          description: "Entry point X coordinate in cm",
        },
        entryY: {
          type: "number",
          description: "Entry point Y coordinate in cm",
        },
        exitX: {
          type: "number",
          description: "Exit point X coordinate in cm",
        },
        exitY: {
          type: "number",
          description: "Exit point Y coordinate in cm",
        },
        width: {
          type: "number",
          description: "Stair width in meters. Default: 1.2",
        },
        capacity: {
          type: "integer",
          description: "Max people on stair at once. Default: 10",
        },
        travelSpeed: {
          type: "number",
          description: "Travel speed in m/s. Default: 0.6",
        },
      },
      required: ["furnitureId", "fromFloor", "toFloor"],
    },
    annotations: {
      readOnlyHint: false,
      destructiveHint: true,
    },
  },

• src/tools/evac.ts:748-759 (schema)

  Zod runtime validation schema matching the MCP inputSchema, used in the handler for safe parameter parsing.

  const SetupEvacStairSchema = z.object({
    furnitureId: z.string(),
    fromFloor: z.number().int().min(0),
    toFloor: z.number().int().min(0),
    entryX: z.number().optional(),
    entryY: z.number().optional(),
    exitX: z.number().optional(),
    exitY: z.number().optional(),
    width: z.number().positive().optional(),
    capacity: z.number().int().positive().optional(),
    travelSpeed: z.number().positive().optional(),
  });

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

  Registration of all tool schemas including evacTools (containing bulc_setup_evac_stair) into the combined allTools array, provided to MCP ListToolsRequest.

  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 (registration)

  Routing logic in main MCP CallToolRequest handler that directs 'bulc_setup_evac_stair' (matches 'evac') calls to the evac-specific handleEvacTool dispatcher.

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