@butlr/butlr-mcp-server 0.5.0 → 0.6.0

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

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

package/dist/utils/time-range-validator.js

@@ -2,6 +2,7 @@
  * Time range validation for timeseries queries
  * Prevents excessive data queries that could timeout or overwhelm the API
  */
+import { parseTimeString } from "./time-resolver.js";
 /**
  * Validate time range based on interval
  * @param interval Aggregation interval ('1m', '1h', '1d')
@@ -11,8 +12,8 @@
  */
 export function validateTimeRange(interval, start, stop) {
     // Parse times - handle relative times by converting to absolute
-    const startTime = parseTime(start);
-    const stopTime = parseTime(stop);
+    const startTime = parseTimeString(start);
+    const stopTime = parseTimeString(stop);
     // Calculate duration in hours
     const durationMs = stopTime.getTime() - startTime.getTime();
     const durationHours = durationMs / (1000 * 60 * 60);
@@ -32,34 +33,4 @@ export function validateTimeRange(interval, start, stop) {
         throw new Error(`Start time must be before stop time. Start: ${start}, Stop: ${stop}`);
     }
 }
-/**
- * Parse time string (ISO-8601 or relative) to Date
- */
-function parseTime(timeStr) {
-    // Handle relative times like '-24h', '-1d', 'now'
-    if (timeStr === "now") {
-        return new Date();
-    }
-    // Relative time pattern: -<number><unit>
-    const relativeMatch = timeStr.match(/^-(\d+)(m|h|d)$/);
-    if (relativeMatch) {
-        const amount = parseInt(relativeMatch[1], 10);
-        const unit = relativeMatch[2];
-        const now = new Date();
-        switch (unit) {
-            case "m":
-                return new Date(now.getTime() - amount * 60 * 1000);
-            case "h":
-                return new Date(now.getTime() - amount * 60 * 60 * 1000);
-            case "d":
-                return new Date(now.getTime() - amount * 24 * 60 * 60 * 1000);
-        }
-    }
-    // Try parsing as ISO-8601
-    const parsed = new Date(timeStr);
-    if (isNaN(parsed.getTime())) {
-        throw new Error(`Invalid time format: ${timeStr}. Use ISO-8601 or relative format like '-24h'.`);
-    }
-    return parsed;
-}
 //# sourceMappingURL=time-range-validator.js.map

package/dist/utils/time-range-validator.js.map

@@ -1 +1 @@
-{"version":3,"file":"time-range-validator.js","sourceRoot":"","sources":["../../src/utils/time-range-validator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB,EAAE,KAAa,EAAE,IAAY;IAC7E,gEAAgE;IAChE,MAAM,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAEjC,8BAA8B;IAC9B,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,EAAE,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC;IAC5D,MAAM,aAAa,GAAG,UAAU,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;IACpD,MAAM,YAAY,GAAG,aAAa,GAAG,EAAE,CAAC;IAExC,6BAA6B;IAC7B,IAAI,QAAQ,KAAK,IAAI,IAAI,aAAa,GAAG,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CACb,qEAAqE,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CACvG,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,KAAK,IAAI,IAAI,aAAa,GAAG,EAAE,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CACb,uEAAuE,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CACzG,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,KAAK,IAAI,IAAI,YAAY,GAAG,EAAE,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CACb,sEAAsE,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CACtG,CAAC;IACJ,CAAC;IAED,gCAAgC;IAChC,IAAI,SAAS,IAAI,QAAQ,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,+CAA+C,KAAK,WAAW,IAAI,EAAE,CAAC,CAAC;IACzF,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,SAAS,CAAC,OAAe;IAChC,kDAAkD;IAClD,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;QACtB,OAAO,IAAI,IAAI,EAAE,CAAC;IACpB,CAAC;IAED,yCAAyC;IACzC,MAAM,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACvD,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC9C,MAAM,IAAI,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QAEvB,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,GAAG;gBACN,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;YACtD,KAAK,GAAG;gBACN,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,MAAM,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;YAC3D,KAAK,GAAG;gBACN,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,MAAM,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IAED,0BAA0B;IAC1B,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC;IACjC,IAAI,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CACb,wBAAwB,OAAO,gDAAgD,CAChF,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"time-range-validator.js","sourceRoot":"","sources":["../../src/utils/time-range-validator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB,EAAE,KAAa,EAAE,IAAY;IAC7E,gEAAgE;IAChE,MAAM,SAAS,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAEvC,8BAA8B;IAC9B,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,EAAE,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC;IAC5D,MAAM,aAAa,GAAG,UAAU,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;IACpD,MAAM,YAAY,GAAG,aAAa,GAAG,EAAE,CAAC;IAExC,6BAA6B;IAC7B,IAAI,QAAQ,KAAK,IAAI,IAAI,aAAa,GAAG,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CACb,qEAAqE,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CACvG,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,KAAK,IAAI,IAAI,aAAa,GAAG,EAAE,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CACb,uEAAuE,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CACzG,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,KAAK,IAAI,IAAI,YAAY,GAAG,EAAE,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CACb,sEAAsE,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CACtG,CAAC;IACJ,CAAC;IAED,gCAAgC;IAChC,IAAI,SAAS,IAAI,QAAQ,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,+CAA+C,KAAK,WAAW,IAAI,EAAE,CAAC,CAAC;IACzF,CAAC;AACH,CAAC"}

package/dist/utils/time-resolver.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Time string parsing shared by request builders and validators.
+ *
+ * The v3 reporting API (ETL backend since the Aug 2026 cutover) accepts only
+ * RFC3339 timestamps: relative forms like "-20m" are rejected with a 400, and
+ * omitting filter.stop returns an empty result set. All times must be
+ * resolved to absolute timestamps client-side before sending.
+ */
+/**
+ * Parse a time string ("now", relative like "-24h", or ISO-8601) to a Date.
+ * @throws Error if the string is not a recognized time format
+ */
+export declare function parseTimeString(timeStr: string): Date;
+/**
+ * Resolve a time string to an absolute ISO-8601 timestamp string.
+ */
+export declare function resolveTimeToIso(timeStr: string): string;
+//# sourceMappingURL=time-resolver.d.ts.map

package/dist/utils/time-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-resolver.d.ts","sourceRoot":"","sources":["../../src/utils/time-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CA8BrD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD"}

package/dist/utils/time-resolver.js

@@ -0,0 +1,44 @@
+/**
+ * Time string parsing shared by request builders and validators.
+ *
+ * The v3 reporting API (ETL backend since the Aug 2026 cutover) accepts only
+ * RFC3339 timestamps: relative forms like "-20m" are rejected with a 400, and
+ * omitting filter.stop returns an empty result set. All times must be
+ * resolved to absolute timestamps client-side before sending.
+ */
+/**
+ * Parse a time string ("now", relative like "-24h", or ISO-8601) to a Date.
+ * @throws Error if the string is not a recognized time format
+ */
+export function parseTimeString(timeStr) {
+    if (timeStr === "now") {
+        return new Date();
+    }
+    // Relative time pattern: -<number><unit>
+    const relativeMatch = timeStr.match(/^-(\d+)(m|h|d)$/);
+    if (relativeMatch) {
+        const amount = parseInt(relativeMatch[1], 10);
+        const unit = relativeMatch[2];
+        const now = new Date();
+        switch (unit) {
+            case "m":
+                return new Date(now.getTime() - amount * 60 * 1000);
+            case "h":
+                return new Date(now.getTime() - amount * 60 * 60 * 1000);
+            case "d":
+                return new Date(now.getTime() - amount * 24 * 60 * 60 * 1000);
+        }
+    }
+    const parsed = new Date(timeStr);
+    if (isNaN(parsed.getTime())) {
+        throw new Error(`Invalid time format: ${timeStr}. Use ISO-8601 or relative format like '-24h'.`);
+    }
+    return parsed;
+}
+/**
+ * Resolve a time string to an absolute ISO-8601 timestamp string.
+ */
+export function resolveTimeToIso(timeStr) {
+    return parseTimeString(timeStr).toISOString();
+}
+//# sourceMappingURL=time-resolver.js.map

package/dist/utils/time-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-resolver.js","sourceRoot":"","sources":["../../src/utils/time-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;QACtB,OAAO,IAAI,IAAI,EAAE,CAAC;IACpB,CAAC;IAED,yCAAyC;IACzC,MAAM,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACvD,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC9C,MAAM,IAAI,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QAEvB,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,GAAG;gBACN,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;YACtD,KAAK,GAAG;gBACN,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,MAAM,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;YAC3D,KAAK,GAAG;gBACN,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,MAAM,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC;IACjC,IAAI,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CACb,wBAAwB,OAAO,gDAAgD,CAChF,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,OAAO,eAAe,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;AAChD,CAAC"}

package/dist/utils/topology-merge.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Shared topology/device merge.
+ *
+ * Two tools need floors to carry their `sensors` and `hives` arrays:
+ * `butlr_list_topology` renders them, and `butlr_search_assets` flattens them
+ * into its search corpus. Keeping the merge in one place is what lets both
+ * read the same `devicesMerged: true` cache entry.
+ */
+import type { Site, Sensor, Hive } from "../clients/types.js";
+/**
+ * Merge sensors and hives into topology structure.
+ * Groups by floor_id and nests under appropriate floors.
+ *
+ * IN-PLACE MUTATION: assigns `floor.sensors` and `floor.hives` directly on
+ * the input site tree (returned for chaining; no new array is allocated).
+ * `setCachedTopology` reads from the same `sites` reference that this
+ * function mutates — any caller that captures the pre-merge `sites` (via
+ * Apollo cache-restore, structural clone, or fork-then-await) would
+ * observe the un-merged shape and could write a device-incomplete tree
+ * to the cache. If you change this to immutable assignment, audit the
+ * cache write site to confirm it sees the merged result.
+ */
+export declare function mergeSensorsAndHivesIntoTopology(sites: Site[], allSensors: Sensor[], allHives: Hive[]): Site[];
+//# sourceMappingURL=topology-merge.d.ts.map

package/dist/utils/topology-merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"topology-merge.d.ts","sourceRoot":"","sources":["../../src/utils/topology-merge.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAE9D;;;;;;;;;;;;GAYG;AACH,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,IAAI,EAAE,EACb,UAAU,EAAE,MAAM,EAAE,EACpB,QAAQ,EAAE,IAAI,EAAE,GACf,IAAI,EAAE,CAqCR"}

package/dist/utils/topology-merge.js

@@ -0,0 +1,57 @@
+/**
+ * Shared topology/device merge.
+ *
+ * Two tools need floors to carry their `sensors` and `hives` arrays:
+ * `butlr_list_topology` renders them, and `butlr_search_assets` flattens them
+ * into its search corpus. Keeping the merge in one place is what lets both
+ * read the same `devicesMerged: true` cache entry.
+ */
+/**
+ * Merge sensors and hives into topology structure.
+ * Groups by floor_id and nests under appropriate floors.
+ *
+ * IN-PLACE MUTATION: assigns `floor.sensors` and `floor.hives` directly on
+ * the input site tree (returned for chaining; no new array is allocated).
+ * `setCachedTopology` reads from the same `sites` reference that this
+ * function mutates — any caller that captures the pre-merge `sites` (via
+ * Apollo cache-restore, structural clone, or fork-then-await) would
+ * observe the un-merged shape and could write a device-incomplete tree
+ * to the cache. If you change this to immutable assignment, audit the
+ * cache write site to confirm it sees the merged result.
+ */
+export function mergeSensorsAndHivesIntoTopology(sites, allSensors, allHives) {
+    // Group sensors by floor_id
+    const sensorsByFloor = {};
+    for (const sensor of allSensors) {
+        const floorId = sensor.floor_id || sensor.floorID;
+        if (floorId) {
+            if (!sensorsByFloor[floorId]) {
+                sensorsByFloor[floorId] = [];
+            }
+            sensorsByFloor[floorId].push(sensor);
+        }
+    }
+    // Group hives by floor_id
+    const hivesByFloor = {};
+    for (const hive of allHives) {
+        const floorId = hive.floor_id || hive.floorID;
+        if (floorId) {
+            if (!hivesByFloor[floorId]) {
+                hivesByFloor[floorId] = [];
+            }
+            hivesByFloor[floorId].push(hive);
+        }
+    }
+    // Merge into topology
+    for (const site of sites) {
+        for (const building of site.buildings || []) {
+            for (const floor of building.floors || []) {
+                // Add sensors and hives to this floor
+                floor.sensors = sensorsByFloor[floor.id] || [];
+                floor.hives = hivesByFloor[floor.id] || [];
+            }
+        }
+    }
+    return sites;
+}
+//# sourceMappingURL=topology-merge.js.map

package/dist/utils/topology-merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"topology-merge.js","sourceRoot":"","sources":["../../src/utils/topology-merge.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,gCAAgC,CAC9C,KAAa,EACb,UAAoB,EACpB,QAAgB;IAEhB,4BAA4B;IAC5B,MAAM,cAAc,GAA6B,EAAE,CAAC;IACpD,KAAK,MAAM,MAAM,IAAI,UAAU,EAAE,CAAC;QAChC,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,OAAO,CAAC;QAClD,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC7B,cAAc,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;YAC/B,CAAC;YACD,cAAc,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAED,0BAA0B;IAC1B,MAAM,YAAY,GAA2B,EAAE,CAAC;IAChD,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,OAAO,CAAC;QAC9C,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC3B,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;YAC7B,CAAC;YACD,YAAY,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED,sBAAsB;IACtB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,IAAI,EAAE,EAAE,CAAC;YAC5C,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;gBAC1C,sCAAsC;gBACtC,KAAK,CAAC,OAAO,GAAG,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;gBAC/C,KAAK,CAAC,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;YAC7C,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/llms.txt

@@ -112,7 +112,7 @@ Users need edit access to Butlr Studio to create tokens. If they don't have edit
 - `butlr_hardware_snapshot` — Device health check: online/offline status and battery levels
 - `butlr_available_rooms` — Find currently unoccupied rooms, filterable by capacity and tags
 - `butlr_space_busyness` — Current occupancy with qualitative labels (quiet/moderate/busy) and trend comparison
-- `butlr_traffic_flow` — Entry/exit counts with hourly breakdown for traffic-mode sensors
+- `butlr_traffic_flow` — Entry/exit counts with hourly breakdown, for a room or for one traffic-mode sensor. Accepts a room ID, a sensor ID (`sensor_...`) for per-access-point counts, or a name to search. A sensor does not need to be assigned to a room to be queried directly
 - `butlr_list_topology` — Display org hierarchy tree with flexible depth control
 - `butlr_fetch_entity_details` — Retrieve specific fields for entities by ID (minimal token usage)
 - `butlr_get_occupancy_timeseries` — Historical occupancy data with configurable time ranges

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@butlr/butlr-mcp-server",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Model Context Protocol server providing secure, read-only access to Butlr occupancy and asset data",
   "type": "module",
   "main": "dist/index.js",