BULC Building Designer

Instructions

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,
    },
  },