@butlr/butlr-mcp-server 0.1.0

package/dist/utils/asset-flattener.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Utilities for flattening hierarchical topology into searchable lists
+ */
+import type { Site } from "../clients/types.js";
+export interface FlattenedAsset {
+    id: string;
+    name: string;
+    type: "site" | "building" | "floor" | "room" | "zone" | "sensor" | "hive";
+    site_id?: string;
+    site_name?: string;
+    building_id?: string;
+    building_name?: string;
+    floor_id?: string;
+    floor_name?: string;
+    room_id?: string;
+    room_name?: string;
+    timezone?: string;
+    siteNumber?: number;
+    customID?: string;
+    org_id?: string;
+    building_number?: number;
+    capacity?: {
+        max?: number;
+        mid?: number;
+    };
+    address?: {
+        lines?: string[];
+        country?: string;
+    };
+    floorNumber?: number;
+    installation_date?: number;
+    area?: {
+        value?: number;
+        unit?: string;
+    };
+    roomType?: string;
+    coordinates?: number[][] | number[];
+    mac_address?: string;
+    mode?: "presence" | "traffic";
+    model?: string;
+    hive_serial?: string;
+    is_online?: boolean;
+    serialNumber?: string;
+    hiveVersion?: string;
+}
+/**
+ * Flatten topology hierarchy into a searchable list
+ */
+export declare function flattenTopology(sites: Site[]): FlattenedAsset[];
+//# sourceMappingURL=asset-flattener.d.ts.map

package/dist/utils/asset-flattener.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-flattener.d.ts","sourceRoot":"","sources":["../../src/utils/asset-flattener.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAEhD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;IAG1E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAGhB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAGjD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAGzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC;IAGpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IAGpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,cAAc,EAAE,CAmI/D"}

package/dist/utils/asset-flattener.js

@@ -0,0 +1,131 @@
+/**
+ * Utilities for flattening hierarchical topology into searchable lists
+ */
+/**
+ * Flatten topology hierarchy into a searchable list
+ */
+export function flattenTopology(sites) {
+    const flattened = [];
+    for (const site of sites) {
+        // Add site
+        flattened.push({
+            id: site.id,
+            name: site.name,
+            type: "site",
+            timezone: site.timezone,
+            siteNumber: site.siteNumber,
+            customID: site.customID,
+            org_id: site.org_id,
+        });
+        // Add buildings
+        for (const building of site.buildings || []) {
+            flattened.push({
+                id: building.id,
+                name: building.name,
+                type: "building",
+                site_id: site.id,
+                site_name: site.name,
+                building_number: building.building_number || building.buildingNumber,
+                customID: building.customID,
+                capacity: building.capacity,
+                address: building.address,
+            });
+            // Add floors
+            for (const floor of building.floors || []) {
+                flattened.push({
+                    id: floor.id,
+                    name: floor.name,
+                    type: "floor",
+                    site_id: site.id,
+                    site_name: site.name,
+                    building_id: building.id,
+                    building_name: building.name,
+                    floorNumber: floor.floorNumber,
+                    customID: floor.customID,
+                    timezone: floor.timezone,
+                    installation_date: floor.installation_date,
+                    capacity: floor.capacity,
+                    area: floor.area,
+                });
+                // Add rooms
+                for (const room of floor.rooms || []) {
+                    flattened.push({
+                        id: room.id,
+                        name: room.name,
+                        type: "room",
+                        site_id: site.id,
+                        site_name: site.name,
+                        building_id: building.id,
+                        building_name: building.name,
+                        floor_id: floor.id,
+                        floor_name: floor.name,
+                        roomType: room.roomType,
+                        customID: room.customID,
+                        capacity: room.capacity,
+                        area: room.area,
+                        coordinates: room.coordinates,
+                    });
+                }
+                // Add zones
+                for (const zone of floor.zones || []) {
+                    flattened.push({
+                        id: zone.id,
+                        name: zone.name,
+                        type: "zone",
+                        site_id: site.id,
+                        site_name: site.name,
+                        building_id: building.id,
+                        building_name: building.name,
+                        floor_id: floor.id,
+                        floor_name: floor.name,
+                        room_id: zone.roomID,
+                        customID: zone.customID,
+                        capacity: zone.capacity,
+                        coordinates: zone.coordinates,
+                    });
+                }
+                // Add sensors
+                for (const sensor of floor.sensors || []) {
+                    flattened.push({
+                        id: sensor.id,
+                        name: sensor.name,
+                        type: "sensor",
+                        site_id: site.id,
+                        site_name: site.name,
+                        building_id: building.id,
+                        building_name: building.name,
+                        floor_id: floor.id,
+                        floor_name: floor.name,
+                        room_id: sensor.roomID,
+                        mac_address: sensor.mac_address,
+                        mode: sensor.mode,
+                        model: sensor.model,
+                        hive_serial: sensor.hive_serial,
+                        is_online: sensor.is_online,
+                    });
+                }
+                // Add hives
+                for (const hive of floor.hives || []) {
+                    flattened.push({
+                        id: hive.id,
+                        name: hive.name,
+                        type: "hive",
+                        site_id: site.id,
+                        site_name: site.name,
+                        building_id: building.id,
+                        building_name: building.name,
+                        floor_id: floor.id,
+                        floor_name: floor.name,
+                        room_id: hive.roomID,
+                        serialNumber: hive.serialNumber,
+                        is_online: hive.isOnline || hive.is_online,
+                        hiveVersion: hive.hiveVersion,
+                        coordinates: hive.coordinates,
+                    });
+                }
+            }
+        }
+    }
+    return flattened;
+}
+//# sourceMappingURL=asset-flattener.js.map

package/dist/utils/asset-flattener.js.map

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

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

@@ -0,0 +1,8 @@
+/**
+ * Asset helper utilities for type detection and ID parsing
+ */
+/**
+ * Detect asset type from ID prefix
+ */
+export declare function detectAssetType(id: string): "site" | "building" | "floor" | "room" | "zone" | "sensor" | "hive" | "unknown";
+//# sourceMappingURL=asset-helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"asset-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/asset-helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,eAAe,CAC7B,EAAE,EAAE,MAAM,GACT,MAAM,GAAG,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CASjF"}

package/dist/utils/asset-helpers.js

@@ -0,0 +1,24 @@
+/**
+ * Asset helper utilities for type detection and ID parsing
+ */
+/**
+ * Detect asset type from ID prefix
+ */
+export function detectAssetType(id) {
+    if (id.startsWith("site_"))
+        return "site";
+    if (id.startsWith("building_"))
+        return "building";
+    if (id.startsWith("space_") || id.startsWith("floor_"))
+        return "floor";
+    if (id.startsWith("room_"))
+        return "room";
+    if (id.startsWith("zone_"))
+        return "zone";
+    if (id.startsWith("sensor_"))
+        return "sensor";
+    if (id.startsWith("hive_"))
+        return "hive";
+    return "unknown";
+}
+//# sourceMappingURL=asset-helpers.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"asset-helpers.js","sourceRoot":"","sources":["../../src/utils/asset-helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,EAAU;IAEV,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,MAAM,CAAC;IAC1C,IAAI,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC;QAAE,OAAO,UAAU,CAAC;IAClD,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,OAAO,CAAC;IACvE,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,MAAM,CAAC;IAC1C,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,MAAM,CAAC;IAC1C,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC9C,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,MAAM,CAAC;IAC1C,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/utils/field-validator.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Field validation for selective entity detail fetching
+ * Validates that requested fields are valid for each entity type
+ */
+/** Known entity types supported by the Butlr GraphQL API */
+export declare const ENTITY_TYPES: readonly ["site", "building", "floor", "room", "zone", "sensor", "hive"];
+export type EntityType = (typeof ENTITY_TYPES)[number];
+/**
+ * Default fields for each entity type (minimal set)
+ */
+export declare const DEFAULT_FIELDS: Record<EntityType, readonly string[]>;
+/**
+ * Validate that requested fields are valid for an entity type
+ * Accepts both snake_case and camelCase field names
+ * @param entityType Type of entity (site, building, floor, room, zone, sensor, hive)
+ * @param requestedFields Array of field names
+ * @throws Error if any field is invalid
+ */
+export declare function validateFields(entityType: EntityType, requestedFields: string[]): void;
+/**
+ * Get default fields for an entity type
+ */
+export declare function getDefaultFields(entityType: EntityType): string[];
+/**
+ * Validate and return fields (use defaults if none provided)
+ * Normalizes snake_case to camelCase for GraphQL queries
+ */
+export declare function getValidatedFields(entityType: EntityType, requestedFields?: string[]): string[];
+//# sourceMappingURL=field-validator.d.ts.map

package/dist/utils/field-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-validator.d.ts","sourceRoot":"","sources":["../../src/utils/field-validator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,4DAA4D;AAC5D,eAAO,MAAM,YAAY,0EAQf,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AA+HvD;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAQhE,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,EAAE,GAAG,IAAI,CAuBtF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,EAAE,CAMjE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,UAAU,EAAE,eAAe,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAgB/F"}

package/dist/utils/field-validator.js

@@ -0,0 +1,197 @@
+/**
+ * Field validation for selective entity detail fetching
+ * Validates that requested fields are valid for each entity type
+ */
+/** Known entity types supported by the Butlr GraphQL API */
+export const ENTITY_TYPES = [
+    "site",
+    "building",
+    "floor",
+    "room",
+    "zone",
+    "sensor",
+    "hive",
+];
+/**
+ * Field name aliases (snake_case → camelCase)
+ * GraphQL schema uses a mix of snake_case and camelCase.
+ * Some fields have aliases (e.g., floor_id → floorID).
+ */
+const FIELD_ALIASES = {
+    floor_id: "floorID",
+    room_id: "roomID",
+    hive_id: "hiveID",
+    sensor_id: "id", // sensor_id is deprecated, use id
+};
+/**
+ * Normalize field name (convert snake_case to camelCase if alias exists)
+ */
+function normalizeFieldName(field) {
+    return FIELD_ALIASES[field] || field;
+}
+/**
+ * Valid fields for each entity type
+ * Based on GraphQL schema (mix of snake_case and camelCase)
+ */
+const VALID_FIELDS = {
+    site: ["id", "name", "timezone", "siteNumber", "customID", "org_id", "buildings"],
+    building: [
+        "id",
+        "name",
+        "building_number",
+        "site_id",
+        "customID",
+        "capacity",
+        "address",
+        "floors",
+        "site",
+    ],
+    floor: [
+        "id",
+        "name",
+        "floorNumber",
+        "building_id",
+        "timezone",
+        "installation_date",
+        "installation_status",
+        "customID",
+        "capacity",
+        "area",
+        "rooms",
+        "zones",
+        "sensors",
+        "hives",
+        "building",
+    ],
+    room: [
+        "id",
+        "name",
+        "floorID",
+        "roomType",
+        "customID",
+        "capacity",
+        "area",
+        "coordinates",
+        "rotation",
+        "note",
+        "sensors",
+        "floor",
+    ],
+    zone: [
+        "id",
+        "name",
+        "floorID",
+        "roomID",
+        "customID",
+        "capacity",
+        "area",
+        "coordinates",
+        "rotation",
+        "note",
+        "sensors",
+    ],
+    sensor: [
+        "id",
+        "name",
+        "mac_address",
+        "mode",
+        "model",
+        "roomID",
+        "hive_serial",
+        "is_online",
+        "is_streaming",
+        "height",
+        "center",
+        "orientation",
+        "field_of_view",
+        "door_line",
+        "in_direction",
+        "is_entrance",
+        "parallel_to_door",
+        "sensitivity",
+        "note",
+        "last_heartbeat",
+        "last_raw_message",
+        "last_occupancy_message",
+        "power_type",
+        "sensor_serial",
+        "installation_status",
+    ],
+    hive: [
+        "id",
+        "name",
+        "serialNumber",
+        "floorID",
+        "roomID",
+        "isOnline",
+        "coordinates",
+        "isStreaming",
+        "hiveVersion",
+        "hiveType",
+        "note",
+        "lastHeartbeat",
+        "netPathStability",
+        "installed",
+    ],
+};
+/**
+ * Default fields for each entity type (minimal set)
+ */
+export const DEFAULT_FIELDS = {
+    site: ["id", "name"],
+    building: ["id", "name"],
+    floor: ["id", "name", "floorNumber"],
+    room: ["id", "name"],
+    zone: ["id", "name"],
+    sensor: ["id", "mac_address"],
+    hive: ["id", "serialNumber"],
+};
+/**
+ * Validate that requested fields are valid for an entity type
+ * Accepts both snake_case and camelCase field names
+ * @param entityType Type of entity (site, building, floor, room, zone, sensor, hive)
+ * @param requestedFields Array of field names
+ * @throws Error if any field is invalid
+ */
+export function validateFields(entityType, requestedFields) {
+    const validFields = VALID_FIELDS[entityType];
+    if (!validFields) {
+        throw new Error(`Unknown entity type: ${entityType}. Valid types: ${Object.keys(VALID_FIELDS).join(", ")}`);
+    }
+    // Normalize field names (snake_case → camelCase) before validation
+    const normalizedFields = requestedFields.map(normalizeFieldName);
+    const invalidFields = normalizedFields.filter((field) => !validFields.includes(field));
+    if (invalidFields.length > 0) {
+        const originalInvalid = requestedFields.filter((_, i) => !validFields.includes(normalizedFields[i]));
+        throw new Error(`Invalid fields for ${entityType}: ${originalInvalid.join(", ")}. ` +
+            `Valid fields: ${validFields.join(", ")} (also accepts snake_case: floor_id, room_id, etc.)`);
+    }
+}
+/**
+ * Get default fields for an entity type
+ */
+export function getDefaultFields(entityType) {
+    const defaults = DEFAULT_FIELDS[entityType];
+    if (!defaults) {
+        throw new Error(`Unknown entity type: ${entityType}`);
+    }
+    return [...defaults];
+}
+/**
+ * Validate and return fields (use defaults if none provided)
+ * Normalizes snake_case to camelCase for GraphQL queries
+ */
+export function getValidatedFields(entityType, requestedFields) {
+    if (!requestedFields || requestedFields.length === 0) {
+        return getDefaultFields(entityType);
+    }
+    validateFields(entityType, requestedFields);
+    // Normalize field names (snake_case → camelCase)
+    const normalizedFields = requestedFields.map(normalizeFieldName);
+    // Always include 'id' field (required by Apollo cache)
+    if (!normalizedFields.includes("id")) {
+        return ["id", ...normalizedFields];
+    }
+    return normalizedFields;
+}
+//# sourceMappingURL=field-validator.js.map

package/dist/utils/field-validator.js.map

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

package/dist/utils/fuzzy-match.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Fuzzy matching utilities for asset search
+ */
+export interface SearchableAsset {
+    id: string;
+    name: string;
+    type: "site" | "building" | "floor" | "room" | "zone" | "sensor" | "hive";
+    [key: string]: unknown;
+}
+export interface MatchResult<T extends SearchableAsset> {
+    asset: T;
+    score: number;
+    matchedField: string;
+}
+/**
+ * Simple fuzzy matching - checks if query is contained in target (case-insensitive)
+ * Returns a score based on match quality
+ */
+export declare function fuzzyMatch(query: string, target: string): number;
+/**
+ * Search through a list of assets by name
+ * Returns matches sorted by relevance score
+ */
+export declare function searchAssets<T extends SearchableAsset>(assets: T[], query: string, options?: {
+    matchFields?: string[];
+    minScore?: number;
+    maxResults?: number;
+}): MatchResult<T>[];
+//# sourceMappingURL=fuzzy-match.d.ts.map

package/dist/utils/fuzzy-match.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fuzzy-match.d.ts","sourceRoot":"","sources":["../../src/utils/fuzzy-match.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC1E,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,WAAW,CAAC,CAAC,SAAS,eAAe;IACpD,KAAK,EAAE,CAAC,CAAC;IACT,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CA6BhE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,eAAe,EACpD,MAAM,EAAE,CAAC,EAAE,EACX,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IACP,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CAChB,GACL,WAAW,CAAC,CAAC,CAAC,EAAE,CAsClB"}

package/dist/utils/fuzzy-match.js

@@ -0,0 +1,70 @@
+/**
+ * Fuzzy matching utilities for asset search
+ */
+/**
+ * Simple fuzzy matching - checks if query is contained in target (case-insensitive)
+ * Returns a score based on match quality
+ */
+export function fuzzyMatch(query, target) {
+    const lowerQuery = query.toLowerCase().trim();
+    const lowerTarget = target.toLowerCase();
+    // Exact match
+    if (lowerTarget === lowerQuery) {
+        return 100;
+    }
+    // Starts with query
+    if (lowerTarget.startsWith(lowerQuery)) {
+        return 90;
+    }
+    // Word boundary match (e.g., "SF" matches "SF Tower") — check before generic contains
+    const words = lowerTarget.split(/\s+/);
+    for (const word of words) {
+        if (word.startsWith(lowerQuery)) {
+            return 80;
+        }
+    }
+    // Contains query
+    if (lowerTarget.includes(lowerQuery)) {
+        return 70;
+    }
+    // No match
+    return 0;
+}
+/**
+ * Search through a list of assets by name
+ * Returns matches sorted by relevance score
+ */
+export function searchAssets(assets, query, options = {}) {
+    const { matchFields = ["name"], minScore = 70, maxResults = 20 } = options;
+    if (!query || query.trim().length === 0) {
+        return [];
+    }
+    // Score each asset
+    const scored = [];
+    for (const asset of assets) {
+        let bestScore = 0;
+        let bestField = "";
+        // Try matching against each field
+        for (const field of matchFields) {
+            const value = asset[field];
+            if (typeof value === "string") {
+                const score = fuzzyMatch(query, value);
+                if (score > bestScore) {
+                    bestScore = score;
+                    bestField = field;
+                }
+            }
+        }
+        // Include if score meets threshold
+        if (bestScore >= minScore) {
+            scored.push({
+                asset,
+                score: bestScore,
+                matchedField: bestField,
+            });
+        }
+    }
+    // Sort by score (highest first) and limit results
+    return scored.sort((a, b) => b.score - a.score).slice(0, maxResults);
+}
+//# sourceMappingURL=fuzzy-match.js.map

package/dist/utils/fuzzy-match.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fuzzy-match.js","sourceRoot":"","sources":["../../src/utils/fuzzy-match.ts"],"names":[],"mappings":"AAAA;;GAEG;AAeH;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE,MAAc;IACtD,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;IAC9C,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IAEzC,cAAc;IACd,IAAI,WAAW,KAAK,UAAU,EAAE,CAAC;QAC/B,OAAO,GAAG,CAAC;IACb,CAAC;IAED,oBAAoB;IACpB,IAAI,WAAW,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACvC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,sFAAsF;IACtF,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACvC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAChC,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,iBAAiB;IACjB,IAAI,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACrC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,WAAW;IACX,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,MAAW,EACX,KAAa,EACb,UAII,EAAE;IAEN,MAAM,EAAE,WAAW,GAAG,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,EAAE,EAAE,UAAU,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;IAE3E,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,mBAAmB;IACnB,MAAM,MAAM,GAAqB,EAAE,CAAC;IAEpC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,IAAI,SAAS,GAAG,EAAE,CAAC;QAEnB,kCAAkC;QAClC,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;YAChC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;YAC3B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC9B,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;gBACvC,IAAI,KAAK,GAAG,SAAS,EAAE,CAAC;oBACtB,SAAS,GAAG,KAAK,CAAC;oBAClB,SAAS,GAAG,KAAK,CAAC;gBACpB,CAAC;YACH,CAAC;QACH,CAAC;QAED,mCAAmC;QACnC,IAAI,SAAS,IAAI,QAAQ,EAAE,CAAC;YAC1B,MAAM,CAAC,IAAI,CAAC;gBACV,KAAK;gBACL,KAAK,EAAE,SAAS;gBAChB,YAAY,EAAE,SAAS;aACxB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,kDAAkD;IAClD,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;AACvE,CAAC"}

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

@@ -0,0 +1,29 @@
+/**
+ * Shared GraphQL error handling and device filtering utilities
+ *
+ * Eliminates repeated catch-block boilerplate and test-device filtering
+ * across tool implementations.
+ */
+import type { Sensor, Hive } from "../clients/types.js";
+/**
+ * Re-throw as a formatted MCP error if the error is a GraphQL/network error.
+ * No-ops for non-GraphQL errors, allowing the caller to re-throw the original.
+ *
+ * Usage:
+ *   catch (error: unknown) {
+ *     rethrowIfGraphQLError(error);
+ *     throw error;
+ *   }
+ */
+export declare function rethrowIfGraphQLError(error: unknown): void;
+/**
+ * Check if a sensor is a production device (not a test/placeholder).
+ * Filters out mirror/virtual sensors (mi-rr-or*) and fake test sensors (fa-ke*).
+ */
+export declare function isProductionSensor(sensor: Sensor): boolean;
+/**
+ * Check if a hive is a production device (not a test/placeholder).
+ * Filters out hives with fake serial numbers.
+ */
+export declare function isProductionHive(hive: Hive): boolean;
+//# sourceMappingURL=graphql-helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graphql-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/graphql-helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAGxD;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAK1D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAO1D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAMpD"}

package/dist/utils/graphql-helpers.js

@@ -0,0 +1,43 @@
+/**
+ * Shared GraphQL error handling and device filtering utilities
+ *
+ * Eliminates repeated catch-block boilerplate and test-device filtering
+ * across tool implementations.
+ */
+import { translateGraphQLError, formatMCPError } from "../errors/mcp-errors.js";
+/**
+ * Re-throw as a formatted MCP error if the error is a GraphQL/network error.
+ * No-ops for non-GraphQL errors, allowing the caller to re-throw the original.
+ *
+ * Usage:
+ *   catch (error: unknown) {
+ *     rethrowIfGraphQLError(error);
+ *     throw error;
+ *   }
+ */
+export function rethrowIfGraphQLError(error) {
+    if (error && typeof error === "object" && ("graphQLErrors" in error || "networkError" in error)) {
+        const mcpError = translateGraphQLError(error);
+        throw new Error(formatMCPError(mcpError));
+    }
+}
+/**
+ * Check if a sensor is a production device (not a test/placeholder).
+ * Filters out mirror/virtual sensors (mi-rr-or*) and fake test sensors (fa-ke*).
+ */
+export function isProductionSensor(sensor) {
+    return (!!sensor.mac_address &&
+        sensor.mac_address.trim() !== "" &&
+        !sensor.mac_address.startsWith("mi-rr-or") &&
+        !sensor.mac_address.startsWith("fa-ke"));
+}
+/**
+ * Check if a hive is a production device (not a test/placeholder).
+ * Filters out hives with fake serial numbers.
+ */
+export function isProductionHive(hive) {
+    return (!!hive.serialNumber &&
+        hive.serialNumber.trim() !== "" &&
+        !hive.serialNumber.toLowerCase().startsWith("fake"));
+}
+//# sourceMappingURL=graphql-helpers.js.map