@butlr/butlr-mcp-server 0.1.0

package/dist/utils/graphql-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql-helpers.js","sourceRoot":"","sources":["../../src/utils/graphql-helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEhF;;;;;;;;;GASG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,eAAe,IAAI,KAAK,IAAI,cAAc,IAAI,KAAK,CAAC,EAAE,CAAC;QAChG,MAAM,QAAQ,GAAG,qBAAqB,CAAC,KAAoD,CAAC,CAAC;QAC7F,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC5C,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,OAAO,CACL,CAAC,CAAC,MAAM,CAAC,WAAW;QACpB,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE;QAChC,CAAC,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,UAAU,CAAC;QAC1C,CAAC,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,CACxC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAU;IACzC,OAAO,CACL,CAAC,CAAC,IAAI,CAAC,YAAY;QACnB,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,EAAE;QAC/B,CAAC,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CACpD,CAAC;AACJ,CAAC"}

package/dist/utils/natural-language.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Natural Language Utilities for Conversational Tools
+ *
+ * Generates qualitative labels, trend descriptions, and formatted summaries
+ * to make API responses more conversational and actionable.
+ */
+/**
+ * Get qualitative occupancy label
+ * @param utilizationPercent - Occupancy as % of capacity (0-100+)
+ * @returns "quiet" | "moderate" | "busy"
+ */
+export declare function getOccupancyLabel(utilizationPercent: number): "quiet" | "moderate" | "busy";
+/**
+ * Get trend label compared to typical
+ * @param deltaPercent - Difference from typical (positive = busier, negative = quieter)
+ * @returns "lighter" | "typical" | "busier"
+ */
+export declare function getTrendLabel(deltaPercent: number): "lighter" | "typical" | "busier";
+/**
+ * Build a busyness summary string
+ * @example "Café: Moderate (12 people, 45% capacity, typical for Thursday 2pm)"
+ */
+export declare function buildBusynessSummary(params: {
+    spaceName: string;
+    occupancy: number;
+    capacity: number;
+    utilizationPercent: number;
+    trendLabel?: "lighter" | "typical" | "busier";
+    dayTime?: string;
+}): string;
+/**
+ * Build an available rooms summary
+ * @example "5 conference rooms available (capacity 4-12 people)"
+ */
+export declare function buildAvailableRoomsSummary(params: {
+    count: number;
+    roomType?: string;
+    minCapacity?: number;
+    maxCapacity?: number;
+}): string;
+/**
+ * Build a hardware health summary
+ * @example "45 of 52 sensors online (87%), 8 of 8 hives online (100%). 3 batteries critical, 7 due within 30 days."
+ */
+export declare function buildHardwareSummary(params: {
+    sensorsOnline: number;
+    sensorsTotal: number;
+    hivesOnline: number;
+    hivesTotal: number;
+    batteriesCritical: number;
+    batteriesDueSoon: number;
+}): string;
+/**
+ * Get recommendation based on busyness
+ */
+export declare function getBusinessRecommendation(label: "quiet" | "moderate" | "busy"): string;
+/**
+ * Format day and time for context
+ * @param date - Date to format (defaults to now)
+ * @param timezone - IANA timezone name (e.g. "America/Los_Angeles"). When provided,
+ *   formats in the space's local time instead of the server's system time.
+ * @example "Thursday 2pm"
+ */
+export declare function formatDayAndTime(date?: Date, timezone?: string): string;
+/**
+ * Calculate days between dates
+ */
+export declare function daysBetween(date1: Date, date2: Date): number;
+/**
+ * Calculate hours between dates
+ */
+export declare function hoursBetween(date1: Date, date2: Date): number;
+//# sourceMappingURL=natural-language.d.ts.map

package/dist/utils/natural-language.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"natural-language.d.ts","sourceRoot":"","sources":["../../src/utils/natural-language.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkBH;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,kBAAkB,EAAE,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,CAQ3F;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAUpF;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,MAAM,CAkBT;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,MAAM,CAsBT;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC3C,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;CAC1B,GAAG,MAAM,CAwBT;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,CAStF;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,IAAiB,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CA2BnF;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,GAAG,MAAM,CAG5D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,GAAG,MAAM,CAG7D"}

package/dist/utils/natural-language.js

@@ -0,0 +1,172 @@
+/**
+ * Natural Language Utilities for Conversational Tools
+ *
+ * Generates qualitative labels, trend descriptions, and formatted summaries
+ * to make API responses more conversational and actionable.
+ */
+/**
+ * Occupancy labels based on utilization percentage
+ * Thresholds can be configured via environment variables
+ */
+const DEFAULT_QUIET_THRESHOLD = 30; // < 30% = quiet
+const DEFAULT_BUSY_THRESHOLD = 70; // > 70% = busy
+const QUIET_THRESHOLD = parseInt(process.env.BUTLR_QUIET_THRESHOLD || String(DEFAULT_QUIET_THRESHOLD), 10);
+const BUSY_THRESHOLD = parseInt(process.env.BUTLR_BUSY_THRESHOLD || String(DEFAULT_BUSY_THRESHOLD), 10);
+/**
+ * Get qualitative occupancy label
+ * @param utilizationPercent - Occupancy as % of capacity (0-100+)
+ * @returns "quiet" | "moderate" | "busy"
+ */
+export function getOccupancyLabel(utilizationPercent) {
+    if (utilizationPercent < QUIET_THRESHOLD) {
+        return "quiet";
+    }
+    if (utilizationPercent < BUSY_THRESHOLD) {
+        return "moderate";
+    }
+    return "busy";
+}
+/**
+ * Get trend label compared to typical
+ * @param deltaPercent - Difference from typical (positive = busier, negative = quieter)
+ * @returns "lighter" | "typical" | "busier"
+ */
+export function getTrendLabel(deltaPercent) {
+    const TREND_THRESHOLD = 15; // >15% change = notable
+    if (deltaPercent < -TREND_THRESHOLD) {
+        return "lighter";
+    }
+    if (deltaPercent > TREND_THRESHOLD) {
+        return "busier";
+    }
+    return "typical";
+}
+/**
+ * Build a busyness summary string
+ * @example "Café: Moderate (12 people, 45% capacity, typical for Thursday 2pm)"
+ */
+export function buildBusynessSummary(params) {
+    const label = getOccupancyLabel(params.utilizationPercent);
+    const labelCapitalized = label.charAt(0).toUpperCase() + label.slice(1);
+    const parts = [
+        `${params.spaceName}: ${labelCapitalized}`,
+        `(${params.occupancy} people, ${Math.round(params.utilizationPercent)}% capacity`,
+    ];
+    if (params.trendLabel && params.trendLabel !== "typical") {
+        parts.push(`${params.trendLabel} than typical`);
+    }
+    else if (params.trendLabel === "typical" && params.dayTime) {
+        parts.push(`typical for ${params.dayTime}`);
+    }
+    parts[parts.length - 1] += ")"; // Close parenthesis
+    return parts.join(" ");
+}
+/**
+ * Build an available rooms summary
+ * @example "5 conference rooms available (capacity 4-12 people)"
+ */
+export function buildAvailableRoomsSummary(params) {
+    const roomTypeStr = params.roomType ? `${params.roomType} ` : "";
+    if (params.count === 0) {
+        return `No ${roomTypeStr}rooms currently available`;
+    }
+    const parts = [];
+    if (params.count === 1) {
+        parts.push(`1 ${roomTypeStr}room available`);
+    }
+    else {
+        parts.push(`${params.count} ${roomTypeStr}rooms available`);
+    }
+    if (params.minCapacity && params.maxCapacity) {
+        parts.push(`(capacity ${params.minCapacity}-${params.maxCapacity} people)`);
+    }
+    else if (params.minCapacity) {
+        parts.push(`(capacity ${params.minCapacity}+ people)`);
+    }
+    return parts.join(" ");
+}
+/**
+ * Build a hardware health summary
+ * @example "45 of 52 sensors online (87%), 8 of 8 hives online (100%). 3 batteries critical, 7 due within 30 days."
+ */
+export function buildHardwareSummary(params) {
+    const sensorsPercent = params.sensorsTotal > 0 ? Math.round((params.sensorsOnline / params.sensorsTotal) * 100) : 0;
+    const hivesPercent = params.hivesTotal > 0 ? Math.round((params.hivesOnline / params.hivesTotal) * 100) : 0;
+    const parts = [
+        `${params.sensorsOnline} of ${params.sensorsTotal} sensors online (${sensorsPercent}%)`,
+        `${params.hivesOnline} of ${params.hivesTotal} hives online (${hivesPercent}%)`,
+    ];
+    // Add battery health if applicable
+    if (params.batteriesCritical > 0 || params.batteriesDueSoon > 0) {
+        const batteryParts = [];
+        if (params.batteriesCritical > 0) {
+            batteryParts.push(`${params.batteriesCritical} batteries critical`);
+        }
+        if (params.batteriesDueSoon > 0) {
+            batteryParts.push(`${params.batteriesDueSoon} due within 30 days`);
+        }
+        parts.push(batteryParts.join(", "));
+    }
+    return parts.join(", ") + ".";
+}
+/**
+ * Get recommendation based on busyness
+ */
+export function getBusinessRecommendation(label) {
+    switch (label) {
+        case "quiet":
+            return "Great time to visit - not crowded";
+        case "moderate":
+            return "Good time to visit - moderately busy";
+        case "busy":
+            return "Consider waiting or visiting later - very busy";
+    }
+}
+/**
+ * Format day and time for context
+ * @param date - Date to format (defaults to now)
+ * @param timezone - IANA timezone name (e.g. "America/Los_Angeles"). When provided,
+ *   formats in the space's local time instead of the server's system time.
+ * @example "Thursday 2pm"
+ */
+export function formatDayAndTime(date = new Date(), timezone) {
+    if (timezone) {
+        try {
+            const formatter = new Intl.DateTimeFormat("en-US", {
+                timeZone: timezone,
+                weekday: "long",
+                hour: "numeric",
+                hour12: true,
+            });
+            const parts = formatter.formatToParts(date);
+            const dayName = parts.find((p) => p.type === "weekday")?.value || "";
+            const hour = parts.find((p) => p.type === "hour")?.value || "";
+            const dayPeriod = parts.find((p) => p.type === "dayPeriod")?.value || "";
+            return `${dayName} ${hour}${dayPeriod.toLowerCase()}`;
+        }
+        catch {
+            // Fall through to system-local fallback
+        }
+    }
+    const days = ["Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"];
+    const dayName = days[date.getDay()];
+    let hours = date.getHours();
+    const ampm = hours >= 12 ? "pm" : "am";
+    hours = hours % 12 || 12;
+    return `${dayName} ${hours}${ampm}`;
+}
+/**
+ * Calculate days between dates
+ */
+export function daysBetween(date1, date2) {
+    const diffMs = date2.getTime() - date1.getTime();
+    return Math.floor(diffMs / (1000 * 60 * 60 * 24));
+}
+/**
+ * Calculate hours between dates
+ */
+export function hoursBetween(date1, date2) {
+    const diffMs = date2.getTime() - date1.getTime();
+    return Math.floor(diffMs / (1000 * 60 * 60));
+}
+//# sourceMappingURL=natural-language.js.map

package/dist/utils/natural-language.js.map

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

package/dist/utils/occupancy-helpers.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Shared helpers for occupancy tools (butlr_get_current_occupancy, butlr_get_occupancy_timeseries)
+ *
+ * Extracted from the two occupancy tools to eliminate ~200 lines of duplication.
+ * Both tools share: topology fetching, sensor filtering, asset resolution,
+ * measurement selection, and recommendation logic.
+ */
+import type { Sensor, Site, Floor, Building } from "../clients/types.js";
+import type { TimezoneMetadata } from "./timezone-helpers.js";
+import type { MeasurementRecommendation, BaseMeasurementData } from "../types/responses.js";
+/**
+ * Topology and sensor data fetched in parallel for occupancy tools.
+ */
+export interface TopologyContext {
+    sites: Site[];
+    buildings: Building[];
+    floors: Floor[];
+    productionSensors: Sensor[];
+}
+/**
+ * Fetch topology and production sensors in a single parallel call.
+ * Shared by both current-occupancy and timeseries tools.
+ */
+export declare function fetchTopologyAndSensors(): Promise<TopologyContext>;
+/**
+ * Resolved context for a single asset, including timezone, name, and sensor partitioning.
+ */
+export interface AssetContext {
+    assetType: "floor" | "room" | "zone";
+    assetName: string | undefined;
+    timezone: string;
+    tzMetadata: TimezoneMetadata;
+    presenceSensors: Sensor[];
+    trafficSensors: Sensor[];
+}
+/**
+ * Resolve full context for an asset ID: type validation, name, timezone, sensor partitioning.
+ */
+export declare function resolveAssetContext(assetId: string, ctx: TopologyContext): AssetContext;
+/**
+ * Get the measurement name for presence data based on asset type.
+ */
+export declare function getPresenceMeasurement(assetType: "floor" | "room" | "zone"): string;
+/**
+ * Get the measurement name for traffic data based on asset type.
+ */
+export declare function getTrafficMeasurement(assetType: "floor" | "room"): string;
+/**
+ * Build coverage note for presence measurement.
+ */
+export declare function getPresenceCoverageNote(assetType: "floor" | "room" | "zone", sensorCount: number): string;
+/**
+ * Build coverage note for traffic measurement.
+ */
+export declare function getTrafficCoverageNote(assetType: "floor" | "room" | "zone", sensorCount: number): string;
+/**
+ * Build measurement recommendation based on data availability AND query success.
+ *
+ * Unlike the previous implementation, this checks whether data was actually retrieved,
+ * not just whether sensors exist.
+ */
+export declare function buildRecommendation(presence: BaseMeasurementData, traffic: BaseMeasurementData, presenceHasData: boolean, trafficHasData: boolean): MeasurementRecommendation;
+//# sourceMappingURL=occupancy-helpers.d.ts.map

package/dist/utils/occupancy-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"occupancy-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/occupancy-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAM5F;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,eAAe,CAAC,CA0BxE;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IACrC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,eAAe,GAAG,YAAY,CAiEvF;AA4BD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CASnF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAOzE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,EACpC,WAAW,EAAE,MAAM,GAClB,MAAM,CASR;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,EACpC,WAAW,EAAE,MAAM,GAClB,MAAM,CASR;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,mBAAmB,EAC7B,OAAO,EAAE,mBAAmB,EAC5B,eAAe,EAAE,OAAO,EACxB,cAAc,EAAE,OAAO,GACtB,yBAAyB,CA6B3B"}

package/dist/utils/occupancy-helpers.js

@@ -0,0 +1,203 @@
+/**
+ * Shared helpers for occupancy tools (butlr_get_current_occupancy, butlr_get_occupancy_timeseries)
+ *
+ * Extracted from the two occupancy tools to eliminate ~200 lines of duplication.
+ * Both tools share: topology fetching, sensor filtering, asset resolution,
+ * measurement selection, and recommendation logic.
+ */
+import { apolloClient } from "../clients/graphql-client.js";
+import { GET_ALL_SENSORS, GET_FULL_TOPOLOGY } from "../clients/queries/topology.js";
+import { detectAssetType } from "./asset-helpers.js";
+import { isProductionSensor } from "./graphql-helpers.js";
+import { getTimezoneForAsset, buildTimezoneMetadata } from "./timezone-helpers.js";
+import { rethrowIfGraphQLError } from "./graphql-helpers.js";
+/**
+ * Fetch topology and production sensors in a single parallel call.
+ * Shared by both current-occupancy and timeseries tools.
+ */
+export async function fetchTopologyAndSensors() {
+    let topoResult, sensorsResult;
+    try {
+        [topoResult, sensorsResult] = await Promise.all([
+            apolloClient.query({
+                query: GET_FULL_TOPOLOGY,
+                fetchPolicy: "network-only",
+            }),
+            apolloClient.query({
+                query: GET_ALL_SENSORS,
+                fetchPolicy: "network-only",
+            }),
+        ]);
+    }
+    catch (error) {
+        rethrowIfGraphQLError(error);
+        throw error;
+    }
+    const sites = topoResult.data?.sites?.data || [];
+    const buildings = sites.flatMap((s) => s.buildings || []);
+    const floors = buildings.flatMap((b) => b.floors || []);
+    const allSensors = sensorsResult.data?.sensors?.data || [];
+    const productionSensors = allSensors.filter(isProductionSensor);
+    return { sites, buildings, floors, productionSensors };
+}
+/**
+ * Resolve full context for an asset ID: type validation, name, timezone, sensor partitioning.
+ */
+export function resolveAssetContext(assetId, ctx) {
+    const assetType = detectAssetType(assetId);
+    if (!["floor", "room", "zone"].includes(assetType)) {
+        throw new Error(`Asset ${assetId} must be a floor, room, or zone. Got: ${assetType}`);
+    }
+    const typedAssetType = assetType;
+    // Resolve timezone
+    const timezone = getTimezoneForAsset(assetId, typedAssetType, ctx.floors, ctx.buildings, ctx.sites);
+    if (!timezone) {
+        throw new Error(`Could not determine timezone for asset ${assetId}`);
+    }
+    const tzMetadata = buildTimezoneMetadata(timezone);
+    // Resolve asset name
+    const assetName = findAssetName(assetId, typedAssetType, ctx.floors);
+    // Filter sensors for this asset
+    const assetSensors = ctx.productionSensors.filter((s) => {
+        const sensorFloorId = s.floor_id || s.floorID;
+        const sensorRoomId = s.room_id || s.roomID;
+        switch (typedAssetType) {
+            case "floor":
+                return sensorFloorId === assetId;
+            case "room":
+                return sensorRoomId === assetId;
+            case "zone":
+                return false; // Zones don't have direct sensor assignments
+        }
+    });
+    // Partition sensors by mode
+    const presenceSensors = assetSensors.filter((s) => s.mode === "presence");
+    let trafficSensors;
+    switch (typedAssetType) {
+        case "floor":
+            trafficSensors = assetSensors.filter((s) => s.mode === "traffic" && s.is_entrance === true);
+            break;
+        case "room":
+            trafficSensors = assetSensors.filter((s) => s.mode === "traffic" && s.is_entrance === false);
+            break;
+        default:
+            trafficSensors = [];
+    }
+    return {
+        assetType: typedAssetType,
+        assetName,
+        timezone,
+        tzMetadata,
+        presenceSensors,
+        trafficSensors,
+    };
+}
+/**
+ * Find the display name for an asset by searching the topology.
+ */
+function findAssetName(assetId, assetType, floors) {
+    switch (assetType) {
+        case "floor":
+            return floors.find((f) => f.id === assetId)?.name;
+        case "room":
+            for (const floor of floors) {
+                const room = floor.rooms?.find((r) => r.id === assetId);
+                if (room)
+                    return room.name;
+            }
+            return undefined;
+        case "zone":
+            for (const floor of floors) {
+                const zone = floor.zones?.find((z) => z.id === assetId);
+                if (zone)
+                    return zone.name;
+            }
+            return undefined;
+    }
+}
+/**
+ * Get the measurement name for presence data based on asset type.
+ */
+export function getPresenceMeasurement(assetType) {
+    switch (assetType) {
+        case "floor":
+            return "floor_occupancy";
+        case "room":
+            return "room_occupancy";
+        case "zone":
+            return "zone_occupancy";
+    }
+}
+/**
+ * Get the measurement name for traffic data based on asset type.
+ */
+export function getTrafficMeasurement(assetType) {
+    switch (assetType) {
+        case "floor":
+            return "traffic_floor_occupancy";
+        case "room":
+            return "traffic_room_occupancy";
+    }
+}
+/**
+ * Build coverage note for presence measurement.
+ */
+export function getPresenceCoverageNote(assetType, sensorCount) {
+    if (sensorCount === 0) {
+        return assetType === "zone"
+            ? "Zones support presence measurement only."
+            : `No presence sensors on this ${assetType}.`;
+    }
+    return assetType === "floor"
+        ? `Presence from ${sensorCount} sensors (may not cover entire floor).`
+        : `Presence from ${sensorCount} sensors.`;
+}
+/**
+ * Build coverage note for traffic measurement.
+ */
+export function getTrafficCoverageNote(assetType, sensorCount) {
+    if (sensorCount === 0) {
+        if (assetType === "zone")
+            return "Zones do not support traffic.";
+        if (assetType === "floor")
+            return "No main entrance sensors.";
+        return "No traffic sensors.";
+    }
+    return assetType === "floor"
+        ? `Traffic from ${sensorCount} main entrance sensors.`
+        : `Traffic from ${sensorCount} sensors.`;
+}
+/**
+ * Build measurement recommendation based on data availability AND query success.
+ *
+ * Unlike the previous implementation, this checks whether data was actually retrieved,
+ * not just whether sensors exist.
+ */
+export function buildRecommendation(presence, traffic, presenceHasData, trafficHasData) {
+    const presenceSucceeded = presence.available && presenceHasData && !presence.warning;
+    const trafficSucceeded = traffic.available && trafficHasData && !traffic.warning;
+    if (presenceSucceeded && trafficSucceeded) {
+        return {
+            recommended_measurement: "presence",
+            recommendation_reason: "Both available. Presence shows current occupants; traffic shows flow.",
+        };
+    }
+    if (presenceSucceeded) {
+        return {
+            recommended_measurement: "presence",
+            recommendation_reason: "Presence available (direct occupant count).",
+        };
+    }
+    if (trafficSucceeded) {
+        return {
+            recommended_measurement: "traffic",
+            recommendation_reason: "Traffic available (entry/exit counts).",
+        };
+    }
+    const failureReason = presence.warning || traffic.warning || "No occupancy data available.";
+    return {
+        recommended_measurement: "none",
+        recommendation_reason: failureReason,
+    };
+}
+//# sourceMappingURL=occupancy-helpers.js.map

package/dist/utils/occupancy-helpers.js.map

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

package/dist/utils/path-builder.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Utilities for building readable breadcrumb paths for assets
+ */
+import type { FlattenedAsset } from "./asset-flattener.js";
+/**
+ * Build a human-readable path for an asset
+ * Example: "Acme Corp / Main Building / Floor 1 / Conference Room A"
+ */
+export declare function buildAssetPath(asset: FlattenedAsset): string;
+//# sourceMappingURL=path-builder.d.ts.map

package/dist/utils/path-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-builder.d.ts","sourceRoot":"","sources":["../../src/utils/path-builder.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CA+B5D"}

package/dist/utils/path-builder.js

@@ -0,0 +1,34 @@
+/**
+ * Utilities for building readable breadcrumb paths for assets
+ */
+/**
+ * Build a human-readable path for an asset
+ * Example: "Acme Corp / Main Building / Floor 1 / Conference Room A"
+ */
+export function buildAssetPath(asset) {
+    const parts = [];
+    // Add site
+    if (asset.site_name) {
+        parts.push(asset.site_name);
+    }
+    // Add building
+    if (asset.building_name) {
+        parts.push(asset.building_name);
+    }
+    // Add floor
+    if (asset.floor_name) {
+        parts.push(asset.floor_name);
+    }
+    // Add room (only if this asset is a zone or device)
+    if (asset.type === "zone" || asset.type === "sensor" || asset.type === "hive") {
+        if (asset.room_name) {
+            parts.push(asset.room_name);
+        }
+    }
+    // Add the asset itself (unless it's already the last part)
+    if (asset.type !== "site" || (asset.type === "site" && parts.length === 0)) {
+        parts.push(asset.name);
+    }
+    return parts.join(" / ");
+}
+//# sourceMappingURL=path-builder.js.map

package/dist/utils/path-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-builder.js","sourceRoot":"","sources":["../../src/utils/path-builder.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,KAAqB;IAClD,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,WAAW;IACX,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC9B,CAAC;IAED,eAAe;IACf,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAClC,CAAC;IAED,YAAY;IACZ,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAC/B,CAAC;IAED,oDAAoD;IACpD,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC9E,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YACpB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,2DAA2D;IAC3D,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;QAC3E,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC"}

package/dist/utils/time-range-validator.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Time range validation for timeseries queries
+ * Prevents excessive data queries that could timeout or overwhelm the API
+ */
+/**
+ * Validate time range based on interval
+ * @param interval Aggregation interval ('1m', '1h', '1d')
+ * @param start Start time (ISO-8601 or relative like '-24h')
+ * @param stop Stop time (ISO-8601 or relative like 'now')
+ * @throws Error if time range exceeds limits for the given interval
+ */
+export declare function validateTimeRange(interval: string, start: string, stop: string): void;
+//# sourceMappingURL=time-range-validator.d.ts.map

package/dist/utils/time-range-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-range-validator.d.ts","sourceRoot":"","sources":["../../src/utils/time-range-validator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAiCrF"}