@butlr/butlr-mcp-server 0.1.0

package/dist/tools/butlr-list-topology.js

@@ -0,0 +1,241 @@
+import { apolloClient } from "../clients/graphql-client.js";
+import { GET_FULL_TOPOLOGY, GET_ALL_SENSORS, GET_ALL_HIVES } from "../clients/queries/topology.js";
+import { z } from "zod";
+import { getCachedTopology, setCachedTopology, generateTopologyCacheKey, } from "../cache/topology-cache.js";
+import { formatTopologyTree } from "../utils/tree-formatter.js";
+import { isProductionSensor, isProductionHive, rethrowIfGraphQLError, } from "../utils/graphql-helpers.js";
+const LIST_TOPOLOGY_DESCRIPTION = "Display org hierarchy tree with flexible depth control. Can show full tree, specific subtrees, or flat lists. " +
+    "Supports filtering by parent asset IDs. Depth levels: 0=sites, 1=buildings, 2=floors, 3=rooms/zones, 4=hives, 5=sensors. " +
+    "Use starting_depth to choose which level to show, and traversal_depth to control how many levels below to include.";
+/** Shared shape — used by both registerTool (SDK schema) and full validation */
+const listTopologyInputShape = {
+    asset_ids: z
+        .array(z.string())
+        .optional()
+        .describe("Optional: Parent asset IDs to show tree for. If empty, shows all sites. " +
+        "Examples: ['site_123'], ['building_456'], ['floor_789']"),
+    starting_depth: z
+        .number()
+        .default(0)
+        .describe("Depth level to start showing assets. 0=sites, 1=buildings, 2=floors, 3=rooms/zones, 4=hives, 5=sensors. " +
+        "Use with traversal_depth=0 to show only assets at this level (flat list)."),
+    traversal_depth: z
+        .number()
+        .default(0)
+        .describe("How many levels below starting_depth to traverse. 0=starting level only, 1=one level below, etc. " +
+        "Default is 0 to minimize token usage. Use 10 for full tree."),
+};
+export const ListTopologyArgsSchema = z.object(listTopologyInputShape).strict();
+/**
+ * Execute butlr_list_topology tool
+ */
+export async function executeListTopology(args = {}) {
+    const startingDepth = args.starting_depth ?? 0;
+    const traversalDepth = args.traversal_depth ?? 0;
+    const assetIds = args.asset_ids ?? [];
+    if (process.env.DEBUG) {
+        console.error(`[butlr-list-topology] Fetching topology: starting_depth=${startingDepth}, traversal_depth=${traversalDepth}, assets=${assetIds.length || "all"}`);
+    }
+    // Use a cache key that includes devices
+    const cacheKey = generateTopologyCacheKey(process.env.BUTLR_ORG_ID || "default", true, // include devices
+    true, // include zones
+    undefined);
+    // Try to get cached topology
+    let sites = [];
+    let partialData = false;
+    const cached = getCachedTopology(cacheKey);
+    if (cached && cached.data && cached.data.sites) {
+        if (process.env.DEBUG) {
+            console.error("[butlr-list-topology] Using cached topology");
+        }
+        sites = cached.data.sites;
+    }
+    else {
+        // Fetch fresh topology
+        if (process.env.DEBUG) {
+            console.error("[butlr-list-topology] Fetching fresh topology");
+        }
+        try {
+            const result = await apolloClient.query({
+                query: GET_FULL_TOPOLOGY,
+                fetchPolicy: "network-only",
+            });
+            // Apollo can return both data and errors - only fail if we have no data
+            if (!result.data || !result.data.sites || !result.data.sites.data) {
+                // If we have error but no data, throw
+                if (result.error) {
+                    throw result.error;
+                }
+                throw new Error("Invalid response structure from API");
+            }
+            // Track whether the topology data is partial (errors alongside data)
+            partialData = !!result.error;
+            if (partialData && process.env.DEBUG) {
+                console.error(`[butlr-list-topology] Warning: GraphQL errors present, data may be partial`);
+            }
+            sites = result.data.sites.data;
+            // Query all sensors and hives separately (nested fields are broken)
+            if (process.env.DEBUG) {
+                console.error("[butlr-list-topology] Fetching all sensors and hives...");
+            }
+            const [sensorsResult, hivesResult] = await Promise.all([
+                apolloClient.query({
+                    query: GET_ALL_SENSORS,
+                    fetchPolicy: "network-only",
+                }),
+                apolloClient.query({
+                    query: GET_ALL_HIVES,
+                    fetchPolicy: "network-only",
+                }),
+            ]);
+            // Filter out test/placeholder devices from topology listing
+            // (Note: These filters are ONLY for topology display, not occupancy queries)
+            const allSensors = (sensorsResult.data?.sensors?.data || []).filter(isProductionSensor);
+            const allHives = (hivesResult.data?.hives?.data || []).filter(isProductionHive);
+            if (process.env.DEBUG) {
+                console.error(`[butlr-list-topology] Got ${allSensors.length} production sensors, ${allHives.length} production hives (test/placeholder devices filtered)`);
+            }
+            // Merge sensors and hives into topology by floor_id
+            sites = mergeSensorsAndHivesIntoTopology(sites, allSensors, allHives);
+            // Only cache complete topology data — partial results should be re-fetched
+            if (!partialData) {
+                setCachedTopology(cacheKey, { sites });
+                if (process.env.DEBUG) {
+                    console.error(`[butlr-list-topology] Cached topology with ${sites.length} sites`);
+                }
+            }
+            else if (process.env.DEBUG) {
+                console.error(`[butlr-list-topology] Skipping cache — topology data is partial`);
+            }
+        }
+        catch (error) {
+            rethrowIfGraphQLError(error);
+            throw error;
+        }
+    }
+    // Filter topology by asset_ids if provided
+    let filteredSites = sites;
+    if (assetIds.length > 0) {
+        filteredSites = filterTopologyByAssets(sites, assetIds);
+    }
+    // Format as tree with depth controls
+    const tree = formatTopologyTree(filteredSites, startingDepth, traversalDepth);
+    const response = {
+        tree,
+        query_params: {
+            starting_depth: startingDepth,
+            traversal_depth: traversalDepth,
+            asset_filter: assetIds.length > 0 ? assetIds : "all",
+        },
+        timestamp: new Date().toISOString(),
+    };
+    if (partialData) {
+        response.warning =
+            "Topology data may be incomplete — the API returned partial results due to upstream errors.";
+    }
+    return response;
+}
+/**
+ * Merge sensors and hives into topology structure
+ * Groups by floor_id and nests under appropriate floors
+ */
+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;
+}
+/**
+ * Filter topology to only include assets matching the provided IDs
+ * Returns a subset of the topology tree
+ */
+function filterTopologyByAssets(sites, assetIds) {
+    const idSet = new Set(assetIds);
+    const filtered = [];
+    for (const site of sites) {
+        if (idSet.has(site.id)) {
+            filtered.push(site);
+            continue;
+        }
+        const matchedBuildings = [];
+        for (const building of site.buildings || []) {
+            if (idSet.has(building.id)) {
+                matchedBuildings.push(building);
+                continue;
+            }
+            const matchedFloors = [];
+            for (const floor of building.floors || []) {
+                if (idSet.has(floor.id)) {
+                    matchedFloors.push(floor);
+                    continue;
+                }
+                const hasMatchedRoom = floor.rooms?.some((r) => idSet.has(r.id));
+                const hasMatchedZone = floor.zones?.some((z) => idSet.has(z.id));
+                const hasMatchedHive = floor.hives?.some((h) => idSet.has(h.id));
+                const hasMatchedSensor = floor.sensors?.some((s) => idSet.has(s.id));
+                if (hasMatchedRoom || hasMatchedZone || hasMatchedHive || hasMatchedSensor) {
+                    matchedFloors.push(floor);
+                }
+            }
+            if (matchedFloors.length > 0) {
+                matchedBuildings.push({ ...building, floors: matchedFloors });
+            }
+        }
+        if (matchedBuildings.length > 0) {
+            filtered.push({ ...site, buildings: matchedBuildings });
+        }
+    }
+    return filtered;
+}
+/**
+ * Register butlr_list_topology with an McpServer instance
+ */
+export function registerListTopology(server) {
+    server.registerTool("butlr_list_topology", {
+        title: "List Topology",
+        description: LIST_TOPOLOGY_DESCRIPTION,
+        inputSchema: listTopologyInputShape,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, async (args) => {
+        const validated = ListTopologyArgsSchema.parse(args);
+        const result = await executeListTopology(validated);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=butlr-list-topology.js.map

package/dist/tools/butlr-list-topology.js.map

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

package/dist/tools/butlr-search-assets.d.ts

@@ -0,0 +1,53 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+export declare const SearchAssetsArgsSchema: z.ZodEffects<z.ZodObject<{
+    query: z.ZodEffects<z.ZodString, string, string>;
+    asset_types: z.ZodOptional<z.ZodArray<z.ZodEnum<["site", "building", "floor", "room", "zone", "sensor", "hive"]>, "many">>;
+    max_results: z.ZodDefault<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    query: string;
+    max_results: number;
+    asset_types?: ("site" | "building" | "floor" | "room" | "zone" | "sensor" | "hive")[] | undefined;
+}, {
+    query: string;
+    asset_types?: ("site" | "building" | "floor" | "room" | "zone" | "sensor" | "hive")[] | undefined;
+    max_results?: number | undefined;
+}>, {
+    query: string;
+    max_results: number;
+    asset_types?: ("site" | "building" | "floor" | "room" | "zone" | "sensor" | "hive")[] | undefined;
+}, {
+    query: string;
+    asset_types?: ("site" | "building" | "floor" | "room" | "zone" | "sensor" | "hive")[] | undefined;
+    max_results?: number | undefined;
+}>;
+export type SearchAssetsArgs = z.output<typeof SearchAssetsArgsSchema>;
+/**
+ * Search result with minimal fields
+ */
+export interface SearchResult {
+    id: string;
+    name: string;
+    type: string;
+    path: string;
+    match_score: number;
+    site_id?: string;
+    building_id?: string;
+    floor_id?: string;
+    room_id?: string;
+}
+/**
+ * Execute search_assets tool
+ */
+export declare function executeSearchAssets(args: SearchAssetsArgs): Promise<{
+    query: string;
+    matches: SearchResult[];
+    total_matches: number;
+    searched_assets: number;
+    timestamp: string;
+}>;
+/**
+ * Register butlr_search_assets with an McpServer instance
+ */
+export declare function registerSearchAssets(server: McpServer): void;
+//# sourceMappingURL=butlr-search-assets.d.ts.map

package/dist/tools/butlr-search-assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"butlr-search-assets.d.ts","sourceRoot":"","sources":["../../src/tools/butlr-search-assets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAkDxB,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;EAehC,CAAC;AAgCJ,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IAEpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,gBAAgB;;;;;;GAgI/D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAsB5D"}

package/dist/tools/butlr-search-assets.js

@@ -0,0 +1,206 @@
+import { apolloClient } from "../clients/graphql-client.js";
+import { z } from "zod";
+import { GET_FULL_TOPOLOGY } from "../clients/queries/topology.js";
+import { getCachedTopology, setCachedTopology, generateTopologyCacheKey, } from "../cache/topology-cache.js";
+import { flattenTopology } from "../utils/asset-flattener.js";
+import { searchAssets } from "../utils/fuzzy-match.js";
+import { buildAssetPath } from "../utils/path-builder.js";
+import { rethrowIfGraphQLError } from "../utils/graphql-helpers.js";
+const VALID_ASSET_TYPES = ["site", "building", "floor", "room", "zone", "sensor", "hive"];
+/** Shared shape — used by both registerTool (SDK schema) and full validation */
+const searchAssetsInputShape = {
+    query: z
+        .string()
+        .min(1, "query cannot be empty")
+        .max(500, "query too long (max: 500 chars)")
+        .trim()
+        .refine((val) => val.length >= 2, "query must be at least 2 characters (after trimming whitespace)")
+        .describe("Search term to match against asset names"),
+    asset_types: z
+        .array(z.enum(VALID_ASSET_TYPES, {
+        errorMap: () => ({
+            message: `asset_type must be one of: ${VALID_ASSET_TYPES.join(", ")}`,
+        }),
+    }))
+        .min(1, "asset_types array cannot be empty (omit field to search all types)")
+        .max(VALID_ASSET_TYPES.length)
+        .optional()
+        .describe("Optional: Filter to specific asset types"),
+    max_results: z
+        .number()
+        .int("max_results must be an integer")
+        .min(1, "max_results must be at least 1")
+        .max(100, "max_results cannot exceed 100")
+        .default(20)
+        .describe("Maximum number of results to return"),
+};
+export const SearchAssetsArgsSchema = z
+    .object(searchAssetsInputShape)
+    .strict()
+    .refine((data) => {
+    if (data.asset_types) {
+        const unique = new Set(data.asset_types);
+        return unique.size === data.asset_types.length;
+    }
+    return true;
+}, {
+    message: "asset_types contains duplicate values",
+    path: ["asset_types"],
+});
+const SEARCH_ASSETS_DESCRIPTION = "Search for Butlr assets (sites, buildings, floors, rooms, zones, sensors, hives) by name using fuzzy matching. Essential prerequisite tool for finding asset IDs before calling other tools. Returns minimal matched results with breadcrumb paths, match scores, and parent context. Searches across all asset types by default, with optional filters.\n\n" +
+    "Primary Users:\n" +
+    "- All Users: Find asset IDs by human-readable names before using other tools\n" +
+    "- IT Manager: Find sensors by MAC address for troubleshooting\n" +
+    "- Field Technician: Locate sensors/hives by name or serial number before site visits\n" +
+    "- Workplace Manager: Find rooms/spaces by common names (e.g., 'café', 'huddle room 3')\n\n" +
+    "Example Queries:\n" +
+    '1. "Find the main lobby" → returns room_lobby_123\n' +
+    '2. "Search for café or coffee shop" → fuzzy matches "Café Barista", "Coffee Bar"\n' +
+    '3. "Find Floor 6 in SF Tower" → returns floor_sf_tower_6\n' +
+    '4. "Search for sensors with MAC address starting with 00:1A" → matches sensors by MAC\n' +
+    '5. "Find all conference rooms" → searches room names containing "conference"\n' +
+    '6. "Locate hive with serial number HV-2023-001" → finds hive by serial\n' +
+    '7. "Search for Chicago office" → finds site/building matching "Chicago"\n' +
+    '8. "Find focus rooms on Floor 3" → searches for rooms with "focus" in name\n\n' +
+    "When to Use:\n" +
+    "- Know a space's name but not its ID (e.g., 'Café Barista' → room_cafe_123)\n" +
+    "- Looking for sensors/hives by MAC address or serial number\n" +
+    "- Find all assets of a specific type (e.g., all sites, all conference rooms)\n" +
+    "- Exploring org topology and don't know exact asset names\n" +
+    "- Want to find spaces with partial/fuzzy names (e.g., 'cafe' matches 'Café Barista')\n\n" +
+    "When NOT to Use:\n" +
+    "- Already have asset IDs and need detailed info → use butlr_get_asset_details directly\n" +
+    "- Want to browse full organizational hierarchy → use butlr_list_topology instead\n" +
+    "- Need to analyze occupancy or sensor data → use this tool first to find IDs, then use data tools\n\n" +
+    "Search Features: Fuzzy matching (handles typos), multi-field search (name, MAC, serial), score threshold (≥70), type filtering, result limiting (default 20, max 100)\n\n" +
+    "Example Workflow: butlr_search_assets(query: 'café') → get room_cafe_123 → butlr_space_busyness(space_id_or_name: 'room_cafe_123')\n\n" +
+    "See Also: butlr_get_asset_details, butlr_list_topology, butlr_fetch_entity_details";
+/**
+ * Execute search_assets tool
+ */
+export async function executeSearchAssets(args) {
+    const maxResults = args.max_results;
+    if (process.env.DEBUG) {
+        console.error(`[search-assets] Searching for "${args.query}"` +
+            (args.asset_types ? ` in types: ${args.asset_types.join(",")}` : "") +
+            ` (max: ${maxResults})`);
+    }
+    // Use a generic cache key for full topology (we'll search across it)
+    const cacheKey = generateTopologyCacheKey(process.env.BUTLR_ORG_ID || "default", true, // include devices for comprehensive search
+    true, // include zones
+    undefined);
+    // Try to get cached topology
+    let sites = [];
+    const cached = getCachedTopology(cacheKey);
+    if (cached && cached.data && cached.data.sites) {
+        if (process.env.DEBUG) {
+            console.error("[search-assets] Using cached topology for search");
+        }
+        sites = cached.data.sites;
+    }
+    else {
+        // Fetch fresh topology
+        if (process.env.DEBUG) {
+            console.error("[search-assets] Fetching fresh topology for search");
+        }
+        try {
+            const result = await apolloClient.query({
+                query: GET_FULL_TOPOLOGY,
+                fetchPolicy: "network-only",
+            });
+            // Apollo can return both data and errors - only fail if we have no data
+            if (!result.data || !result.data.sites || !result.data.sites.data) {
+                // If we have error but no data, throw
+                if (result.error) {
+                    throw result.error;
+                }
+                throw new Error("Invalid response structure from API");
+            }
+            // Track whether the topology data is partial (errors alongside data)
+            const partialData = !!result.error;
+            if (partialData && process.env.DEBUG) {
+                console.error(`[search-assets] Warning: GraphQL errors present, data may be partial`);
+            }
+            sites = result.data.sites.data;
+            // Only cache complete topology data — partial results should be re-fetched
+            if (!partialData) {
+                setCachedTopology(cacheKey, { sites });
+                if (process.env.DEBUG) {
+                    console.error(`[search-assets] Cached topology with ${sites.length} sites`);
+                }
+            }
+            else if (process.env.DEBUG) {
+                console.error(`[search-assets] Skipping cache — topology data is partial`);
+            }
+        }
+        catch (error) {
+            rethrowIfGraphQLError(error);
+            throw error;
+        }
+    }
+    // Flatten topology into searchable list
+    const flattened = flattenTopology(sites);
+    if (process.env.DEBUG) {
+        console.error(`[search-assets] Flattened ${flattened.length} total assets`);
+    }
+    // Filter by asset types if specified
+    let searchableAssets = flattened;
+    if (args.asset_types && args.asset_types.length > 0) {
+        searchableAssets = flattened.filter((asset) => args.asset_types.includes(asset.type));
+        if (process.env.DEBUG) {
+            console.error(`[search-assets] Filtered to ${searchableAssets.length} assets of types: ${args.asset_types.join(",")}`);
+        }
+    }
+    // Perform fuzzy search
+    // Search on name, mac_address (sensors), and serialNumber (hives)
+    const matches = searchAssets(searchableAssets, args.query, {
+        matchFields: ["name", "mac_address", "serialNumber"],
+        minScore: 70,
+        maxResults,
+    });
+    if (process.env.DEBUG) {
+        console.error(`[search-assets] Found ${matches.length} matches`);
+    }
+    // Format results with minimal fields
+    const results = matches.map((match) => ({
+        id: match.asset.id,
+        name: match.asset.name,
+        type: match.asset.type,
+        path: buildAssetPath(match.asset),
+        match_score: match.score,
+        site_id: match.asset.site_id,
+        building_id: match.asset.building_id,
+        floor_id: match.asset.floor_id,
+        room_id: match.asset.room_id,
+    }));
+    return {
+        query: args.query,
+        matches: results,
+        total_matches: results.length,
+        searched_assets: searchableAssets.length,
+        timestamp: new Date().toISOString(),
+    };
+}
+/**
+ * Register butlr_search_assets with an McpServer instance
+ */
+export function registerSearchAssets(server) {
+    server.registerTool("butlr_search_assets", {
+        title: "Search Butlr Assets",
+        description: SEARCH_ASSETS_DESCRIPTION,
+        inputSchema: searchAssetsInputShape,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, async (args) => {
+        const validated = SearchAssetsArgsSchema.parse(args);
+        const result = await executeSearchAssets(validated);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=butlr-search-assets.js.map

package/dist/tools/butlr-search-assets.js.map

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

package/dist/tools/butlr-space-busyness.d.ts

@@ -0,0 +1,23 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import type { SpaceBusynessResponse } from "../types/responses.js";
+export declare const SpaceBusynessArgsSchema: z.ZodObject<{
+    space_id_or_name: z.ZodString;
+    include_trend: z.ZodDefault<z.ZodBoolean>;
+}, "strict", z.ZodTypeAny, {
+    space_id_or_name: string;
+    include_trend: boolean;
+}, {
+    space_id_or_name: string;
+    include_trend?: boolean | undefined;
+}>;
+export type SpaceBusynessArgs = z.output<typeof SpaceBusynessArgsSchema>;
+/**
+ * Execute space busyness tool
+ */
+export declare function executeSpaceBusyness(args: SpaceBusynessArgs): Promise<SpaceBusynessResponse>;
+/**
+ * Register butlr_space_busyness with an McpServer instance
+ */
+export declare function registerSpaceBusyness(server: McpServer): void;
+//# sourceMappingURL=butlr-space-busyness.d.ts.map

package/dist/tools/butlr-space-busyness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"butlr-space-busyness.d.ts","sourceRoot":"","sources":["../../src/tools/butlr-space-busyness.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAcxB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AA+BnE,eAAO,MAAM,uBAAuB;;;;;;;;;EAA6C,CAAC;AAgClF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAyDzE;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,kCAiMjE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAsB7D"}