bulc_set_fire_coupling
Destructive
Configure fire-evacuation coupling for FDS+EVAC integration by setting visibility, temperature, and CO thresholds that affect agent behavior during building evacuation simulations.
Instructions
Configure fire-evacuation coupling for FDS+EVAC integration. Sets visibility and temperature thresholds that affect agent behavior.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| enabled | No | Enable fire-EVAC coupling. Default: false | |
| visibilityThreshold | No | Visibility threshold in meters. Agents avoid areas below this. Default: 5 | |
| temperatureThreshold | No | Temperature threshold in Celsius. Agents avoid areas above this. Default: 60 | |
| coThreshold | No | CO concentration threshold in ppm. Default: 1400 | |
| speedReductionFactor | No | Speed reduction factor in smoke (0-1). Default: 0.5 | |
| updateInterval | No | Fire data update interval in seconds. Default: 1.0 | |
| fdsResultPath | No | Path to FDS result files (.smv). Auto-detected if not specified. |
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);