@butlr/butlr-mcp-server 0.1.0

package/dist/tools/butlr-fetch-entity-details.js

@@ -0,0 +1,276 @@
+import { apolloClient } from "../clients/graphql-client.js";
+import { gql } from "@apollo/client";
+import { z } from "zod";
+import { detectAssetType } from "../utils/asset-helpers.js";
+import { ENTITY_TYPES, getValidatedFields } from "../utils/field-validator.js";
+import { createValidationError } from "../errors/mcp-errors.js";
+import { rethrowIfGraphQLError } from "../utils/graphql-helpers.js";
+const FETCH_ENTITY_DETAILS_DESCRIPTION = "Retrieve specific fields for entities by ID with selective field fetching. " +
+    "Supports mixed entity types in a single call (site_, building_, floor_, room_, zone_, sensor_, hive_). " +
+    "Minimizes token usage by fetching only requested fields. " +
+    "Default fields if none specified: Sites (id, name), Buildings (id, name), Floors (id, name, floorNumber), " +
+    "Rooms (id, name), Zones (id, name), Sensors (id, mac_address), Hives (id, serialNumber).";
+/** Shared shape — used by both registerTool (SDK schema) and full validation */
+const fetchEntityDetailsInputShape = {
+    ids: z
+        .array(z.string())
+        .min(1, "ids must contain at least 1 entity ID")
+        .max(50, "ids cannot exceed 50 entities")
+        .describe("Entity IDs (mixed types supported: site_, building_, floor_, room_, zone_, sensor_, hive_)"),
+    site_fields: z
+        .array(z.string())
+        .optional()
+        .describe("Optional: Fields to fetch for sites (e.g., ['timezone', 'siteNumber', 'customID'])"),
+    building_fields: z
+        .array(z.string())
+        .optional()
+        .describe("Optional: Fields for buildings (e.g., ['capacity', 'address', 'building_number'])"),
+    floor_fields: z
+        .array(z.string())
+        .optional()
+        .describe("Optional: Fields for floors (e.g., ['floorNumber', 'capacity', 'timezone'])"),
+    room_fields: z
+        .array(z.string())
+        .optional()
+        .describe("Optional: Fields for rooms (e.g., ['roomType', 'capacity', 'coordinates'])"),
+    zone_fields: z
+        .array(z.string())
+        .optional()
+        .describe("Optional: Fields for zones (e.g., ['roomID', 'capacity'])"),
+    sensor_fields: z
+        .array(z.string())
+        .optional()
+        .describe("Optional: Fields for sensors (e.g., ['name', 'mac_address', 'mode', 'is_online'])"),
+    hive_fields: z
+        .array(z.string())
+        .optional()
+        .describe("Optional: Fields for hives (e.g., ['name', 'serialNumber', 'isOnline'])"),
+};
+export const FetchEntityDetailsArgsSchema = z.object(fetchEntityDetailsInputShape).strict();
+/**
+ * Build GraphQL query dynamically based on requested fields
+ */
+function buildQueryForFields(type, fields) {
+    // Defense-in-depth: reject any field name that isn't a simple identifier
+    for (const field of fields) {
+        if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(field) || field.startsWith("__")) {
+            throw new Error(`Invalid field name: ${field}`);
+        }
+    }
+    const fieldList = fields.join("\n      ");
+    switch (type) {
+        case "site":
+            return gql `
+        query GetSiteDetails($id: ID!) {
+          site(id: $id) {
+            ${fieldList}
+          }
+        }
+      `;
+        case "building":
+            return gql `
+        query GetBuildingDetails($id: ID!) {
+          building(id: $id) {
+            ${fieldList}
+          }
+        }
+      `;
+        case "floor":
+            return gql `
+        query GetFloorDetails($id: ID!) {
+          floor(id: $id) {
+            ${fieldList}
+          }
+        }
+      `;
+        case "room":
+            return gql `
+        query GetRoomDetails($id: ID!) {
+          room(id: $id) {
+            ${fieldList}
+          }
+        }
+      `;
+        case "zone":
+            return gql `
+        query GetZoneDetails($id: ID!) {
+          zone(id: $id) {
+            ${fieldList}
+          }
+        }
+      `;
+        case "sensor":
+            // Sensors API accepts ids parameter (batch query)
+            return gql `
+        query GetSensorDetails($ids: [String!]) {
+          sensors(ids: $ids) {
+            data {
+              ${fieldList}
+            }
+          }
+        }
+      `;
+        case "hive":
+            // Hives API accepts both ids and serial_numbers (batch query)
+            return gql `
+        query GetHiveDetails($ids: [String!], $serial_numbers: [String!]) {
+          hives(ids: $ids, serial_numbers: $serial_numbers) {
+            data {
+              ${fieldList}
+            }
+          }
+        }
+      `;
+        default:
+            throw createValidationError(`Unsupported asset type: ${type}`);
+    }
+}
+/**
+ * Execute butlr_fetch_entity_details tool
+ */
+export async function executeFetchEntityDetails(args) {
+    if (process.env.DEBUG) {
+        console.error(`[butlr-fetch-entity-details] Fetching details for ${args.ids.length} asset(s)`);
+    }
+    // Group IDs by type
+    const assetsByType = {};
+    for (const id of args.ids) {
+        const type = detectAssetType(id);
+        if (type === "unknown") {
+            throw createValidationError(`Unknown asset type for ID: ${id}`);
+        }
+        // Validate that detectAssetType returned a known EntityType
+        if (!ENTITY_TYPES.includes(type)) {
+            throw createValidationError(`Unsupported asset type: ${type}`);
+        }
+        if (!assetsByType[type]) {
+            assetsByType[type] = [];
+        }
+        assetsByType[type].push(id);
+    }
+    // Fetch assets by type
+    const results = [];
+    for (const [type, ids] of Object.entries(assetsByType)) {
+        const entityType = type;
+        // Get fields for this type
+        const fieldParam = `${type}_fields`;
+        const requestedFields = args[fieldParam];
+        // Validate and get final field list (defaults if none provided)
+        const fields = getValidatedFields(entityType, requestedFields);
+        // Build query
+        const query = buildQueryForFields(type, fields);
+        // For hives and sensors, batch query all at once
+        if (type === "hive" || type === "sensor") {
+            try {
+                // Use ids for both types (API supports it)
+                const variables = { ids };
+                const { data, error } = await apolloClient.query({
+                    query,
+                    variables,
+                    fetchPolicy: "network-only",
+                });
+                if (error) {
+                    throw error;
+                }
+                // Extract assets from response
+                const pluralType = type === "hive" ? "hives" : "sensors";
+                const dataArray = data[pluralType]?.data || [];
+                // Add all found assets
+                for (const asset of dataArray) {
+                    results.push({
+                        ...asset,
+                        _type: type,
+                    });
+                }
+                // Report missing assets
+                const foundIds = new Set(dataArray.map((a) => a.id));
+                for (const id of ids) {
+                    if (!foundIds.has(id)) {
+                        if (process.env.DEBUG) {
+                            console.error(`[butlr-fetch-entity-details] Asset not found: ${id}`);
+                        }
+                        results.push({
+                            id,
+                            _type: type,
+                            error: "Asset not found",
+                        });
+                    }
+                }
+            }
+            catch (error) {
+                rethrowIfGraphQLError(error);
+                throw error;
+            }
+        }
+        else {
+            // Query individually for other types (site, building, floor, room, zone)
+            for (const id of ids) {
+                try {
+                    const { data, error } = await apolloClient.query({
+                        query,
+                        variables: { id },
+                        fetchPolicy: "network-only",
+                    });
+                    if (error) {
+                        throw error;
+                    }
+                    const asset = data[type];
+                    if (asset) {
+                        results.push({
+                            ...asset,
+                            _type: type,
+                        });
+                    }
+                    else {
+                        if (process.env.DEBUG) {
+                            console.error(`[butlr-fetch-entity-details] Asset not found: ${id}`);
+                        }
+                        results.push({
+                            id,
+                            _type: type,
+                            error: "Asset not found",
+                        });
+                    }
+                }
+                catch (error) {
+                    rethrowIfGraphQLError(error);
+                    throw error;
+                }
+            }
+        }
+    }
+    const failedCount = results.filter((r) => r.error).length;
+    const response = {
+        entities: results,
+        requested_count: args.ids.length,
+        fetched_count: results.filter((r) => !r.error).length,
+        timestamp: new Date().toISOString(),
+    };
+    if (failedCount > 0) {
+        response.warning = `${failedCount} of ${args.ids.length} entities failed to fetch. Check individual entity 'error' fields for details.`;
+    }
+    return response;
+}
+/**
+ * Register butlr_fetch_entity_details with an McpServer instance
+ */
+export function registerFetchEntityDetails(server) {
+    server.registerTool("butlr_fetch_entity_details", {
+        title: "Fetch Entity Details",
+        description: FETCH_ENTITY_DETAILS_DESCRIPTION,
+        inputSchema: fetchEntityDetailsInputShape,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, async (args) => {
+        const validated = FetchEntityDetailsArgsSchema.parse(args);
+        const result = await executeFetchEntityDetails(validated);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=butlr-fetch-entity-details.js.map

package/dist/tools/butlr-fetch-entity-details.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"butlr-fetch-entity-details.js","sourceRoot":"","sources":["../../src/tools/butlr-fetch-entity-details.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AACrC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAmB,YAAY,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAChG,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAGpE,MAAM,gCAAgC,GACpC,6EAA6E;IAC7E,yGAAyG;IACzG,2DAA2D;IAC3D,4GAA4G;IAC5G,0FAA0F,CAAC;AAE7F,gFAAgF;AAChF,MAAM,4BAA4B,GAAG;IACnC,GAAG,EAAE,CAAC;SACH,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,GAAG,CAAC,CAAC,EAAE,uCAAuC,CAAC;SAC/C,GAAG,CAAC,EAAE,EAAE,+BAA+B,CAAC;SACxC,QAAQ,CACP,4FAA4F,CAC7F;IAEH,WAAW,EAAE,CAAC;SACX,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CAAC,oFAAoF,CAAC;IAEjG,eAAe,EAAE,CAAC;SACf,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CAAC,mFAAmF,CAAC;IAEhG,YAAY,EAAE,CAAC;SACZ,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CAAC,6EAA6E,CAAC;IAE1F,WAAW,EAAE,CAAC;SACX,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CAAC,4EAA4E,CAAC;IAEzF,WAAW,EAAE,CAAC;SACX,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CAAC,2DAA2D,CAAC;IAExE,aAAa,EAAE,CAAC;SACb,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CAAC,mFAAmF,CAAC;IAEhG,WAAW,EAAE,CAAC;SACX,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CAAC,yEAAyE,CAAC;CACvF,CAAC;AAEF,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC,4BAA4B,CAAC,CAAC,MAAM,EAAE,CAAC;AAI5F;;GAEG;AACH,SAAS,mBAAmB,CAAC,IAAY,EAAE,MAAgB;IACzD,yEAAyE;IACzE,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,CAAC,0BAA0B,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACtE,MAAM,IAAI,KAAK,CAAC,uBAAuB,KAAK,EAAE,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IACD,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAE1C,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,MAAM;YACT,OAAO,GAAG,CAAA;;;cAGF,SAAS;;;OAGhB,CAAC;QAEJ,KAAK,UAAU;YACb,OAAO,GAAG,CAAA;;;cAGF,SAAS;;;OAGhB,CAAC;QAEJ,KAAK,OAAO;YACV,OAAO,GAAG,CAAA;;;cAGF,SAAS;;;OAGhB,CAAC;QAEJ,KAAK,MAAM;YACT,OAAO,GAAG,CAAA;;;cAGF,SAAS;;;OAGhB,CAAC;QAEJ,KAAK,MAAM;YACT,OAAO,GAAG,CAAA;;;cAGF,SAAS;;;OAGhB,CAAC;QAEJ,KAAK,QAAQ;YACX,kDAAkD;YAClD,OAAO,GAAG,CAAA;;;;gBAIA,SAAS;;;;OAIlB,CAAC;QAEJ,KAAK,MAAM;YACT,8DAA8D;YAC9D,OAAO,GAAG,CAAA;;;;gBAIA,SAAS;;;;OAIlB,CAAC;QAEJ;YACE,MAAM,qBAAqB,CAAC,2BAA2B,IAAI,EAAE,CAAC,CAAC;IACnE,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,IAA4B;IAE5B,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;QACtB,OAAO,CAAC,KAAK,CAAC,qDAAqD,IAAI,CAAC,GAAG,CAAC,MAAM,WAAW,CAAC,CAAC;IACjG,CAAC;IAED,oBAAoB;IACpB,MAAM,YAAY,GAA6B,EAAE,CAAC;IAClD,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,eAAe,CAAC,EAAE,CAAC,CAAC;QACjC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,MAAM,qBAAqB,CAAC,8BAA8B,EAAE,EAAE,CAAC,CAAC;QAClE,CAAC;QAED,4DAA4D;QAC5D,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAkB,CAAC,EAAE,CAAC;YAC/C,MAAM,qBAAqB,CAAC,2BAA2B,IAAI,EAAE,CAAC,CAAC;QACjE,CAAC;QAED,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;QAC1B,CAAC;QACD,YAAY,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED,uBAAuB;IACvB,MAAM,OAAO,GAAmB,EAAE,CAAC;IAEnC,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;QACvD,MAAM,UAAU,GAAG,IAAkB,CAAC;QAEtC,2BAA2B;QAC3B,MAAM,UAAU,GAAG,GAAG,IAAI,SAAyC,CAAC;QACpE,MAAM,eAAe,GAAG,IAAI,CAAC,UAAU,CAAyB,CAAC;QAEjE,gEAAgE;QAChE,MAAM,MAAM,GAAG,kBAAkB,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;QAE/D,cAAc;QACd,MAAM,KAAK,GAAG,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAEhD,iDAAiD;QACjD,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACzC,IAAI,CAAC;gBACH,2CAA2C;gBAC3C,MAAM,SAAS,GAAG,EAAE,GAAG,EAAE,CAAC;gBAE1B,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC;oBAC/C,KAAK;oBACL,SAAS;oBACT,WAAW,EAAE,cAAc;iBAC5B,CAAC,CAAC;gBAEH,IAAI,KAAK,EAAE,CAAC;oBACV,MAAM,KAAK,CAAC;gBACd,CAAC;gBAED,+BAA+B;gBAC/B,MAAM,UAAU,GAAG,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;gBACzD,MAAM,SAAS,GAAI,IAAY,CAAC,UAAU,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;gBAExD,uBAAuB;gBACvB,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;oBAC9B,OAAO,CAAC,IAAI,CAAC;wBACX,GAAG,KAAK;wBACR,KAAK,EAAE,IAAI;qBACZ,CAAC,CAAC;gBACL,CAAC;gBAED,wBAAwB;gBACxB,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC1D,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;oBACrB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;wBACtB,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;4BACtB,OAAO,CAAC,KAAK,CAAC,iDAAiD,EAAE,EAAE,CAAC,CAAC;wBACvE,CAAC;wBACD,OAAO,CAAC,IAAI,CAAC;4BACX,EAAE;4BACF,KAAK,EAAE,IAAI;4BACX,KAAK,EAAE,iBAAiB;yBACzB,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,OAAO,KAAc,EAAE,CAAC;gBACxB,qBAAqB,CAAC,KAAK,CAAC,CAAC;gBAC7B,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;aAAM,CAAC;YACN,yEAAyE;YACzE,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;gBACrB,IAAI,CAAC;oBACH,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC;wBAC/C,KAAK;wBACL,SAAS,EAAE,EAAE,EAAE,EAAE;wBACjB,WAAW,EAAE,cAAc;qBAC5B,CAAC,CAAC;oBAEH,IAAI,KAAK,EAAE,CAAC;wBACV,MAAM,KAAK,CAAC;oBACd,CAAC;oBAED,MAAM,KAAK,GAAI,IAAY,CAAC,IAAI,CAAC,CAAC;oBAElC,IAAI,KAAK,EAAE,CAAC;wBACV,OAAO,CAAC,IAAI,CAAC;4BACX,GAAG,KAAK;4BACR,KAAK,EAAE,IAAI;yBACZ,CAAC,CAAC;oBACL,CAAC;yBAAM,CAAC;wBACN,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;4BACtB,OAAO,CAAC,KAAK,CAAC,iDAAiD,EAAE,EAAE,CAAC,CAAC;wBACvE,CAAC;wBACD,OAAO,CAAC,IAAI,CAAC;4BACX,EAAE;4BACF,KAAK,EAAE,IAAI;4BACX,KAAK,EAAE,iBAAiB;yBACzB,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;gBAAC,OAAO,KAAc,EAAE,CAAC;oBACxB,qBAAqB,CAAC,KAAK,CAAC,CAAC;oBAC7B,MAAM,KAAK,CAAC;gBACd,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC;IAC1D,MAAM,QAAQ,GAA+B;QAC3C,QAAQ,EAAE,OAAO;QACjB,eAAe,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM;QAChC,aAAa,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,MAAM;QACrD,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;IAEF,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;QACpB,QAAQ,CAAC,OAAO,GAAG,GAAG,WAAW,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,gFAAgF,CAAC;IAC1I,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B,CAAC,MAAiB;IAC1D,MAAM,CAAC,YAAY,CACjB,4BAA4B,EAC5B;QACE,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EAAE,gCAAgC;QAC7C,WAAW,EAAE,4BAA4B;QACzC,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,IAAI;SACpB;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,SAAS,GAAG,4BAA4B,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3D,MAAM,MAAM,GAAG,MAAM,yBAAyB,CAAC,SAAS,CAAC,CAAC;QAC1D,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SAC5E,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/butlr-get-asset-details.d.ts

@@ -0,0 +1,51 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+export declare const GetAssetDetailsArgsSchema: z.ZodEffects<z.ZodObject<{
+    ids: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+    include_children: z.ZodDefault<z.ZodBoolean>;
+    include_devices: z.ZodDefault<z.ZodBoolean>;
+    include_parent_context: z.ZodDefault<z.ZodBoolean>;
+}, "strict", z.ZodTypeAny, {
+    ids: string[];
+    include_children: boolean;
+    include_devices: boolean;
+    include_parent_context: boolean;
+}, {
+    ids: string[];
+    include_children?: boolean | undefined;
+    include_devices?: boolean | undefined;
+    include_parent_context?: boolean | undefined;
+}>, {
+    ids: string[];
+    include_children: boolean;
+    include_devices: boolean;
+    include_parent_context: boolean;
+}, {
+    ids: string[];
+    include_children?: boolean | undefined;
+    include_devices?: boolean | undefined;
+    include_parent_context?: boolean | undefined;
+}>;
+/**
+ * Input arguments for get_asset_details (output type from Zod schema after defaults applied)
+ */
+export type GetAssetDetailsArgs = z.output<typeof GetAssetDetailsArgsSchema>;
+/**
+ * Execute get_asset_details tool
+ */
+export declare function executeGetAssetDetails(args: GetAssetDetailsArgs): Promise<{
+    assets: Record<string, unknown>[];
+    total_count: number;
+    requested_count: number;
+    options: {
+        include_children: boolean;
+        include_devices: boolean;
+        include_parent_context: boolean;
+    };
+    timestamp: string;
+}>;
+/**
+ * Register butlr_get_asset_details with an McpServer instance
+ */
+export declare function registerGetAssetDetails(server: McpServer): void;
+//# sourceMappingURL=butlr-get-asset-details.d.ts.map

package/dist/tools/butlr-get-asset-details.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"butlr-get-asset-details.d.ts","sourceRoot":"","sources":["../../src/tools/butlr-get-asset-details.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAkCxB,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;EAYnC,CAAC;AAiCJ;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAyP7E;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,mBAAmB;;;;;;;;;;GAgGrE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAsB/D"}