bulc_get_evac_result
Read-only
Retrieve evacuation simulation results including agent trajectories, exit statistics, and flow rate analysis for building safety assessment.
Instructions
Get detailed evacuation results including per-agent trajectories, exit statistics, and flow rate analysis.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| includeTrajectories | No | Include full trajectory data for each agent. Default: false | |
| includeFlowRates | No | Include exit flow rate analysis. Default: true | |
| includeBottlenecks | No | Identify bottleneck locations. Default: true | |
| timeRange | No | Time range [startTime, endTime] in seconds. Default: full simulation | |
| agentIds | No | Specific agent IDs to include. Default: all agents |
Implementation Reference
- src/tools/evac.ts:1094-1101 (handler)Handler case for the bulc_get_evac_result MCP tool. Validates input using GetEvacResultSchema and sends the 'get_evac_result' command to the BULC client for execution.
case "bulc_get_evac_result": { const validated = GetEvacResultSchema.parse(args); result = await client.sendCommand({ action: "get_evac_result", params: validated, }); break; } - src/tools/evac.ts:866-872 (schema)Zod runtime validation schema for bulc_get_evac_result tool input parameters.
const GetEvacResultSchema = z.object({ includeTrajectories: z.boolean().optional(), includeFlowRates: z.boolean().optional(), includeBottlenecks: z.boolean().optional(), timeRange: z.array(z.number()).length(2).optional(), agentIds: z.array(z.number().int()).optional(), }); - src/tools/evac.ts:662-698 (registration)MCP tool registration metadata for bulc_get_evac_result, including name, description, input schema, and annotations. Part of the exported evacTools array.
{ name: "bulc_get_evac_result", description: "Get detailed evacuation results including per-agent trajectories, " + "exit statistics, and flow rate analysis.", inputSchema: { type: "object" as const, properties: { includeTrajectories: { type: "boolean", description: "Include full trajectory data for each agent. Default: false", }, includeFlowRates: { type: "boolean", description: "Include exit flow rate analysis. Default: true", }, includeBottlenecks: { type: "boolean", description: "Identify bottleneck locations. Default: true", }, timeRange: { type: "array", description: "Time range [startTime, endTime] in seconds. Default: full simulation", items: { type: "number" }, }, agentIds: { type: "array", description: "Specific agent IDs to include. Default: all agents", items: { type: "integer" }, }, }, }, annotations: { readOnlyHint: true, destructiveHint: false, }, },