BULC Building Designer

Instructions

Implementation Reference

• src/tools/fds-data.ts:411-418 (handler)

  Handler logic for the 'bulc_clear_fds_data' tool. Validates the input arguments using ClearFdsDataSchema and sends a 'clear_fds_data' command to the BULC client.

  case "bulc_clear_fds_data": {
    const validated = ClearFdsDataSchema.parse(args);
    result = await client.sendCommand({
      action: "clear_fds_data",
      params: validated,
    });
    break;
  }

• src/tools/fds-data.ts:261-280 (schema)

  Tool schema definition for 'bulc_clear_fds_data', including name, description, input schema requiring 'furnitureId', and annotations indicating it's destructive.

  {
    name: "bulc_clear_fds_data",
    description:
      "Clear FDS configuration from a furniture item. " +
      "Removes fire source, detector, sprinkler, HVAC, or thermocouple settings.",
    inputSchema: {
      type: "object" as const,
      properties: {
        furnitureId: {
          type: "string",
          description: "Furniture ID to clear FDS data from",
        },
      },
      required: ["furnitureId"],
    },
    annotations: {
      readOnlyHint: false,
      destructiveHint: true,
    },
  },

• src/tools/fds-data.ts:342-344 (schema)

  Zod validation schema for the input of 'bulc_clear_fds_data' tool, ensuring 'furnitureId' is a string.

  const ClearFdsDataSchema = z.object({
    furnitureId: z.string(),
  });

• src/index.ts:84-93 (registration)

  Registration/routing in the main tool call handler: routes 'bulc_clear_fds_data' (and other FDS tools) to handleFdsDataTool.

  if (
    name === "bulc_get_fds_data" ||
    name === "bulc_set_fds_fire_source" ||
    name === "bulc_set_fds_detector" ||
    name === "bulc_set_fds_sprinkler" ||
    name === "bulc_set_fds_hvac" ||
    name === "bulc_set_fds_thermocouple" ||
    name === "bulc_clear_fds_data"
  ) {
    return await handleFdsDataTool(name, safeArgs);

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

  Includes fdsDataTools (containing 'bulc_clear_fds_data' schema) in the allTools array returned by listTools handler.

  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
  ];