@butlr/butlr-mcp-server 0.1.0

package/dist/tools/butlr-space-busyness.js

@@ -0,0 +1,304 @@
+import { apolloClient } from "../clients/graphql-client.js";
+import { gql } from "@apollo/client";
+import { z } from "zod";
+import { getCurrentOccupancy } from "../clients/reporting-client.js";
+import { getSingleAssetStats } from "../clients/stats-client.js";
+import { executeSearchAssets } from "./butlr-search-assets.js";
+import { buildBusynessSummary, getOccupancyLabel, getTrendLabel, getBusinessRecommendation, formatDayAndTime, } from "../utils/natural-language.js";
+import { getCachedOccupancy, setCachedOccupancy } from "../cache/occupancy-cache.js";
+import { rethrowIfGraphQLError } from "../utils/graphql-helpers.js";
+/** Shared shape -- used by both registerTool (SDK schema) and full validation */
+const spaceBusynessInputShape = {
+    space_id_or_name: z
+        .string()
+        .min(1, "space_id_or_name cannot be empty")
+        .max(200, "space_id_or_name too long (max: 200 chars)")
+        .trim()
+        .describe("Space ID (room_123) or search term ('café', 'lobby')"),
+    include_trend: z
+        .boolean()
+        .default(true)
+        .describe("Compare to typical occupancy for this day/time"),
+};
+export const SpaceBusynessArgsSchema = z.object(spaceBusynessInputShape).strict();
+const SPACE_BUSYNESS_DESCRIPTION = "Get current occupancy busyness for any room or zone with qualitative labels (quiet/moderate/busy) and trend comparison vs. typical usage. Designed for employee experience apps, wayfinding kiosks, and workplace analytics. Helps employees make real-time decisions about where to work and helps workplace teams understand space demand patterns.\n\n" +
+    "Primary Users:\n" +
+    "- Workplace Manager: Monitor amenity usage (cafés, focus rooms, lounges), optimize space allocation, improve employee experience\n" +
+    "- Employee/End User: Decide whether to visit café, find quiet focus areas, avoid crowded collaboration spaces\n" +
+    "- Facilities Coordinator: Validate HVAC/cleaning schedules match actual occupancy patterns\n" +
+    "- Portfolio Manager: Understand space demand during different times for densification analysis\n\n" +
+    "Example Queries:\n" +
+    '1. "How busy is the café right now? Should I go?"\n' +
+    '2. "Is the 3rd floor collaboration zone crowded?"\n' +
+    '3. "How full is the main lobby?"\n' +
+    '4. "Is the fitness center busy compared to usual?"\n' +
+    '5. "Check occupancy for Conference Room 401"\n' +
+    '6. "Is the outdoor terrace busier than normal for Friday afternoon?"\n' +
+    '7. "How crowded is the co-working area on Floor 2?"\n' +
+    '8. "Is the cafeteria quiet enough for a phone call right now?"\n\n' +
+    "When to Use:\n" +
+    "- Real-time 'should I go there now?' recommendations for employees\n" +
+    "- Understand if a space is busier or quieter than typical for this day/time\n" +
+    "- Troubleshooting complaints about crowded amenities (café, gym, lounge)\n" +
+    "- Validating right-sizing decisions ('Is this space too large/small for actual demand?')\n" +
+    "- Optimizing cleaning or HVAC schedules based on actual occupancy\n\n" +
+    "When NOT to Use:\n" +
+    "- Precise occupancy counts for capacity planning → use butlr_get_current_occupancy for exact numbers\n" +
+    "- Historical utilization patterns → use butlr_get_occupancy_timeseries for time series data\n" +
+    "- Entry/exit traffic counts (lobby, building entrance) → use butlr_traffic_flow instead\n" +
+    "- Searching for a space first → use butlr_search_assets to find room/zone ID by name\n\n" +
+    "Qualitative Labels: Quiet (<30% utilized), Moderate (30-70%), Busy (>=70%)\n\n" +
+    "See Also: butlr_get_current_occupancy, butlr_traffic_flow, butlr_search_assets, butlr_get_occupancy_timeseries";
+const GET_ROOM = gql `
+  query GetRoom($roomId: ID!) {
+    room(id: $roomId) {
+      id
+      name
+      floorID
+      roomType
+      capacity {
+        max
+        mid
+      }
+      floor {
+        id
+        name
+        building_id
+        building {
+          id
+          name
+          site_id
+          site {
+            timezone
+          }
+        }
+      }
+    }
+  }
+`;
+const GET_ZONE = gql `
+  query GetZone($zoneId: ID!) {
+    zone(id: $zoneId) {
+      id
+      name
+      floorID
+      capacity {
+        max
+        mid
+      }
+      floor {
+        id
+        name
+        building_id
+        building {
+          id
+          name
+          site_id
+          site {
+            timezone
+          }
+        }
+      }
+    }
+  }
+`;
+/**
+ * Execute space busyness tool
+ */
+export async function executeSpaceBusyness(args) {
+    let spaceId = args.space_id_or_name;
+    let spaceType = "room";
+    // If not an ID, search for the space
+    if (!spaceId.match(/^(room|zone)_/)) {
+        if (process.env.DEBUG) {
+            console.error(`[space-busyness] Searching for space: "${args.space_id_or_name}"`);
+        }
+        const searchResults = await executeSearchAssets({
+            query: args.space_id_or_name,
+            asset_types: ["room", "zone"],
+            max_results: 5,
+        });
+        if (searchResults.matches.length === 0) {
+            throw new Error(`No spaces found matching "${args.space_id_or_name}". Try a different search term.`);
+        }
+        // Use best match
+        const bestMatch = searchResults.matches[0];
+        spaceId = bestMatch.id;
+        spaceType = bestMatch.type;
+        if (process.env.DEBUG) {
+            console.error(`[space-busyness] Using best match: ${bestMatch.name} (${spaceId})`);
+        }
+    }
+    else {
+        // Determine type from ID prefix
+        spaceType = spaceId.startsWith("room_") ? "room" : "zone";
+    }
+    // Query space details
+    let space = null;
+    let spacePath = "";
+    let spaceTimezone;
+    try {
+        if (spaceType === "room") {
+            const result = await apolloClient.query({
+                query: GET_ROOM,
+                variables: { roomId: spaceId },
+                fetchPolicy: "network-only",
+            });
+            if (!result.data?.room) {
+                throw new Error(`Room ${spaceId} not found`);
+            }
+            space = result.data.room;
+            const floor = space.floor;
+            const building = floor?.building;
+            spacePath = building ? `${building.name} > ${floor.name} > ${space.name}` : space.name;
+            spaceTimezone = building?.site?.timezone;
+        }
+        else {
+            const result = await apolloClient.query({
+                query: GET_ZONE,
+                variables: { zoneId: spaceId },
+                fetchPolicy: "network-only",
+            });
+            if (!result.data?.zone) {
+                throw new Error(`Zone ${spaceId} not found`);
+            }
+            space = result.data.zone;
+            const floor = space.floor;
+            const building = floor?.building;
+            spacePath = building ? `${building.name} > ${floor.name} > ${space.name}` : space.name;
+            spaceTimezone = building?.site?.timezone;
+        }
+    }
+    catch (error) {
+        rethrowIfGraphQLError(error);
+        throw error;
+    }
+    // Get current occupancy (check cache first)
+    const now = new Date();
+    let currentOccupancy = 0;
+    const cached = getCachedOccupancy(spaceId, now);
+    if (cached) {
+        currentOccupancy = cached.occupancy;
+        if (process.env.DEBUG) {
+            console.error(`[space-busyness] Using cached occupancy: ${currentOccupancy}`);
+        }
+    }
+    else {
+        try {
+            const occupancyData = await getCurrentOccupancy(spaceType, [spaceId]);
+            if (occupancyData.length > 0) {
+                currentOccupancy = occupancyData[0].value;
+                setCachedOccupancy(spaceId, currentOccupancy, spaceType, now);
+            }
+        }
+        catch (error) {
+            console.error(`[space-busyness] Failed to get occupancy:`, error);
+            throw new Error(`Failed to get current occupancy for ${space.name}. The space may not have active sensors.`);
+        }
+    }
+    // Calculate utilization (null when capacity is not configured)
+    const capacityConfigured = !!(space.capacity?.max && space.capacity.max > 0);
+    const utilizationPercent = capacityConfigured
+        ? (currentOccupancy / space.capacity.max) * 100
+        : null;
+    const label = utilizationPercent !== null ? getOccupancyLabel(utilizationPercent) : null;
+    // Build response
+    const warnings = [];
+    if (!capacityConfigured) {
+        warnings.push("Capacity is not configured for this space. Utilization percentage and busyness label are unavailable. Configure capacity in the Butlr dashboard for richer insights.");
+    }
+    const response = {
+        space: {
+            id: space.id,
+            name: space.name,
+            type: spaceType,
+            path: spacePath,
+        },
+        current: {
+            occupancy: Math.round(currentOccupancy),
+            capacity: space.capacity,
+            utilization_percent: utilizationPercent !== null ? parseFloat(utilizationPercent.toFixed(1)) : null,
+            label,
+            capacity_configured: capacityConfigured,
+            as_of: now.toISOString(),
+        },
+        recommendation: label
+            ? getBusinessRecommendation(label)
+            : "Unable to assess busyness without configured capacity.",
+        summary: "", // Populated below
+        timestamp: now.toISOString(),
+    };
+    // Get trend if requested
+    if (args.include_trend !== false) {
+        try {
+            // Query last 4 weeks of data (v4 Stats API uses occupancy_avg_presence for both rooms and zones)
+            const measurement = "occupancy_avg_presence";
+            const stats = await getSingleAssetStats(measurement, spaceId, "-4w", "now");
+            if (stats) {
+                const typical = stats.mean;
+                let vsTypicalPercent;
+                if (typical > 0) {
+                    vsTypicalPercent = ((currentOccupancy - typical) / typical) * 100;
+                }
+                else if (currentOccupancy > 0) {
+                    vsTypicalPercent = 100;
+                }
+                else {
+                    vsTypicalPercent = 0;
+                }
+                const trendLabel = getTrendLabel(vsTypicalPercent);
+                response.trend = {
+                    typical_for_time: parseFloat(typical.toFixed(1)),
+                    vs_typical_percent: parseFloat(vsTypicalPercent.toFixed(1)),
+                    trend_label: trendLabel,
+                    historical_context: `${formatDayAndTime(now, spaceTimezone)} avg: ${Math.round(typical)} people (last 4 weeks)`,
+                };
+            }
+        }
+        catch (error) {
+            console.error(`[space-busyness] Failed to get trend data:`, error);
+            warnings.push("Could not retrieve historical trend data. Trend comparison is unavailable.");
+        }
+    }
+    // Build summary
+    if (capacityConfigured && utilizationPercent !== null) {
+        response.summary = buildBusynessSummary({
+            spaceName: space.name,
+            occupancy: Math.round(currentOccupancy),
+            capacity: space.capacity.max,
+            utilizationPercent,
+            trendLabel: response.trend?.trend_label,
+            dayTime: formatDayAndTime(now, spaceTimezone),
+        });
+    }
+    else {
+        response.summary = `${space.name}: ${Math.round(currentOccupancy)} people (capacity not configured)`;
+    }
+    if (warnings.length > 0) {
+        response.warning = warnings.join(" ");
+    }
+    return response;
+}
+/**
+ * Register butlr_space_busyness with an McpServer instance
+ */
+export function registerSpaceBusyness(server) {
+    server.registerTool("butlr_space_busyness", {
+        title: "Space Busyness",
+        description: SPACE_BUSYNESS_DESCRIPTION,
+        inputSchema: spaceBusynessInputShape,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    }, async (args) => {
+        const validated = SpaceBusynessArgsSchema.parse(args);
+        const result = await executeSpaceBusyness(validated);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=butlr-space-busyness.js.map

package/dist/tools/butlr-space-busyness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"butlr-space-busyness.js","sourceRoot":"","sources":["../../src/tools/butlr-space-busyness.ts"],"names":[],"mappings":"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"}

package/dist/tools/butlr-traffic-flow.d.ts

@@ -0,0 +1,39 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import type { TrafficFlowResponse } from "../types/responses.js";
+export declare const TrafficFlowArgsSchema: z.ZodEffects<z.ZodObject<{
+    space_id_or_name: z.ZodString;
+    time_window: z.ZodDefault<z.ZodEnum<["20m", "1h", "today", "custom"]>>;
+    custom_start: z.ZodOptional<z.ZodPipeline<z.ZodString, z.ZodEffects<z.ZodString, string, string>>>;
+    custom_stop: z.ZodOptional<z.ZodPipeline<z.ZodString, z.ZodEffects<z.ZodString, string, string>>>;
+}, "strict", z.ZodTypeAny, {
+    space_id_or_name: string;
+    time_window: "custom" | "20m" | "1h" | "today";
+    custom_start?: string | undefined;
+    custom_stop?: string | undefined;
+}, {
+    space_id_or_name: string;
+    time_window?: "custom" | "20m" | "1h" | "today" | undefined;
+    custom_start?: string | undefined;
+    custom_stop?: string | undefined;
+}>, {
+    space_id_or_name: string;
+    time_window: "custom" | "20m" | "1h" | "today";
+    custom_start?: string | undefined;
+    custom_stop?: string | undefined;
+}, {
+    space_id_or_name: string;
+    time_window?: "custom" | "20m" | "1h" | "today" | undefined;
+    custom_start?: string | undefined;
+    custom_stop?: string | undefined;
+}>;
+export type TrafficFlowArgs = z.output<typeof TrafficFlowArgsSchema>;
+/**
+ * Execute traffic flow tool
+ */
+export declare function executeTrafficFlow(args: TrafficFlowArgs): Promise<TrafficFlowResponse>;
+/**
+ * Register butlr_traffic_flow with an McpServer instance
+ */
+export declare function registerTrafficFlow(server: McpServer): void;
+//# sourceMappingURL=butlr-traffic-flow.d.ts.map

package/dist/tools/butlr-traffic-flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"butlr-traffic-flow.d.ts","sourceRoot":"","sources":["../../src/tools/butlr-traffic-flow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAaxB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AA0CjE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;EAc/B,CAAC;AA+BJ,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAwBrE;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,eAAe,gCAuS7D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAsB3D"}