BULC Building Designer

Instructions

Implementation Reference

• src/tools/evac.ts:1085-1091 (handler)

  Handler case for bulc_set_fire_coupling tool: validates input parameters using SetFireCouplingSchema and sends 'set_fire_coupling' command to the BULC client.

  case "bulc_set_fire_coupling": {
    const validated = SetFireCouplingSchema.parse(args);
    result = await client.sendCommand({
      action: "set_fire_coupling",
      params: validated,
    });
    break;

• src/tools/evac.ts:618-660 (schema)

  MCP tool schema definition for bulc_set_fire_coupling including input schema and annotations.

  {
    name: "bulc_set_fire_coupling",
    description:
      "Configure fire-evacuation coupling for FDS+EVAC integration. " +
      "Sets visibility and temperature thresholds that affect agent behavior.",
    inputSchema: {
      type: "object" as const,
      properties: {
        enabled: {
          type: "boolean",
          description: "Enable fire-EVAC coupling. Default: false",
        },
        visibilityThreshold: {
          type: "number",
          description: "Visibility threshold in meters. Agents avoid areas below this. Default: 5",
        },
        temperatureThreshold: {
          type: "number",
          description: "Temperature threshold in Celsius. Agents avoid areas above this. Default: 60",
        },
        coThreshold: {
          type: "number",
          description: "CO concentration threshold in ppm. Default: 1400",
        },
        speedReductionFactor: {
          type: "number",
          description: "Speed reduction factor in smoke (0-1). Default: 0.5",
        },
        updateInterval: {
          type: "number",
          description: "Fire data update interval in seconds. Default: 1.0",
        },
        fdsResultPath: {
          type: "string",
          description: "Path to FDS result files (.smv). Auto-detected if not specified.",
        },
      },
    },
    annotations: {
      readOnlyHint: false,
      destructiveHint: true,
    },
  },

• src/tools/evac.ts:856-864 (schema)

  Zod validation schema for input parameters of bulc_set_fire_coupling tool.

  const SetFireCouplingSchema = z.object({
    enabled: z.boolean().optional(),
    visibilityThreshold: z.number().positive().optional(),
    temperatureThreshold: z.number().positive().optional(),
    coThreshold: z.number().positive().optional(),
    speedReductionFactor: z.number().min(0).max(1).optional(),
    updateInterval: z.number().positive().optional(),
    fdsResultPath: z.string().optional(),
  });

• src/index.ts:140-147 (registration)

  Registration/dispatch logic in main tool handler that routes bulc_set_fire_coupling to handleEvacTool.

    name === "bulc_set_agent_properties" ||
    name === "bulc_generate_rset_report" ||
    name === "bulc_save_evac_result" ||
    name === "bulc_set_exit_assignment" ||
    name === "bulc_set_premovement_time" ||
    name === "bulc_set_fire_coupling"
  ) {
    return await handleEvacTool(name, safeArgs);