bulc_set_agent_properties
Destructive
Configure evacuation agent parameters like radius and speed for fire simulation in building design.
Instructions
Set default properties for evacuation agents (radius, speed, etc.).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| agentRadius | No | Default agent radius in meters. Default: 0.25 | |
| desiredSpeed | No | Default desired speed in m/s. Default: 1.2 | |
| maxSpeed | No | Default max speed in m/s. Default: 1.5 | |
| minSpacing | No | Minimum spacing for random placement in meters. Default: 0.5 |
Implementation Reference
- src/tools/evac.ts:963-970 (handler)Handler case in handleEvacTool function that validates tool arguments using Zod and forwards the 'set_agent_properties' command to the BULC client.
case "bulc_set_agent_properties": { const validated = SetAgentPropertiesSchema.parse(args); result = await client.sendCommand({ action: "set_agent_properties", params: validated, }); break; } - src/tools/evac.ts:786-791 (schema)Zod schema used for input validation in the tool handler.
const SetAgentPropertiesSchema = z.object({ agentRadius: z.number().positive().optional(), desiredSpeed: z.number().positive().optional(), maxSpeed: z.number().positive().optional(), minSpacing: z.number().positive().optional(), }); - src/tools/evac.ts:278-307 (registration)Tool definition object in evacTools array, including name, description, inputSchema for MCP listing, and annotations.
{ name: "bulc_set_agent_properties", description: "Set default properties for evacuation agents (radius, speed, etc.).", inputSchema: { type: "object" as const, properties: { agentRadius: { type: "number", description: "Default agent radius in meters. Default: 0.25", }, desiredSpeed: { type: "number", description: "Default desired speed in m/s. Default: 1.2", }, maxSpeed: { type: "number", description: "Default max speed in m/s. Default: 1.5", }, minSpacing: { type: "number", description: "Minimum spacing for random placement in meters. Default: 0.5", }, }, }, annotations: { readOnlyHint: false, destructiveHint: true, }, }, - src/index.ts:140-148 (registration)Specific routing condition in main tool call handler that directs bulc_set_agent_properties calls to the evac handler.
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); }