rhombus-node-mcp 0.1.22 → 0.1.24

package/dist/types/analytics-tool-types.js

@@ -0,0 +1,190 @@
+import { z } from "zod";
+export var AnalyticsRequestType;
+(function (AnalyticsRequestType) {
+    AnalyticsRequestType["SPACE_UTILIZATION"] = "space-utilization";
+    AnalyticsRequestType["TRAFFIC_FLOW"] = "traffic-flow";
+    AnalyticsRequestType["PEAK_VS_AVERAGE"] = "peak-vs-average";
+    AnalyticsRequestType["SCENE_INTELLIGENCE"] = "scene-intelligence";
+    AnalyticsRequestType["LOCATION_SUMMARY"] = "location-summary";
+})(AnalyticsRequestType || (AnalyticsRequestType = {}));
+export const TOOL_ARGS = {
+    requestType: z
+        .nativeEnum(AnalyticsRequestType)
+        .describe("The type of analytics report to generate."),
+    spaceUtilizationRequest: z
+        .object({
+        locationUuid: z.string().describe("The location UUID to analyze."),
+        startTimeMs: z.number().describe("Start time in milliseconds since epoch."),
+        endTimeMs: z.number().describe("End time in milliseconds since epoch."),
+        interval: z
+            .enum(["HOURLY", "DAILY", "WEEKLY", "MONTHLY"])
+            .describe("Time interval for the report."),
+    })
+        .nullable()
+        .describe("Request for space utilization report. Compares per-camera people counts against running averages. Required for 'space-utilization'."),
+    trafficFlowRequest: z
+        .object({
+        locationUuid: z.string().describe("The location UUID to analyze."),
+        startTimeMs: z.number().describe("Start time in milliseconds since epoch."),
+        endTimeMs: z.number().describe("End time in milliseconds since epoch."),
+        bucketSize: z
+            .enum(["QUARTER_HOUR", "HOUR", "DAY", "WEEK"])
+            .describe("Time bucket size for aggregation."),
+        crossingObject: z
+            .enum(["HUMAN", "VEHICLE", "UNKNOWN"])
+            .describe("Type of object to track."),
+    })
+        .nullable()
+        .describe("Request for multi-camera traffic flow report. Compares ingress/egress across all line-crossing cameras at a location. Required for 'traffic-flow'."),
+    peakVsAverageRequest: z
+        .object({
+        uuid: z
+            .string()
+            .nullable()
+            .describe("Device or location UUID depending on scope."),
+        scope: z
+            .enum(["DEVICE", "LOCATION", "ORG"])
+            .describe("Level of granularity."),
+        startTimeMs: z.number().describe("Start time in milliseconds since epoch."),
+        endTimeMs: z.number().describe("End time in milliseconds since epoch."),
+        timeZone: z
+            .string()
+            .nullable()
+            .describe("Timezone string for bucketing (e.g. 'America/New_York')."),
+    })
+        .nullable()
+        .describe("Request for peak-vs-average analysis. Shows hourly actual counts vs historical running averages. Required for 'peak-vs-average'."),
+    sceneIntelligenceRequest: z
+        .object({
+        deviceFacetUuid: z
+            .string()
+            .describe("Camera device UUID (with optional facet suffix) to query."),
+        prompt: z
+            .string()
+            .describe("The question to ask the camera (e.g. 'How many treadmills are in use?')."),
+        promptType: z
+            .enum(["COUNT", "PERCENT", "BOOLEAN"])
+            .describe("Type of answer expected: COUNT for numbers, PERCENT for percentages, BOOLEAN for yes/no."),
+        timestampMs: z
+            .number()
+            .nullable()
+            .describe("Optional timestamp to query a historical moment. Omit for real-time."),
+    })
+        .nullable()
+        .describe("Request for real-time scene intelligence. Asks a camera an arbitrary question using AI. Required for 'scene-intelligence'."),
+    locationSummaryRequest: z
+        .object({
+        locationUuid: z.string().describe("The location UUID to summarize."),
+        startTimeMs: z.number().describe("Start time in milliseconds since epoch."),
+        endTimeMs: z.number().describe("End time in milliseconds since epoch."),
+    })
+        .nullable()
+        .describe("Request for a comprehensive location analytics summary covering people counts, traffic flow, occupancy, and comparison to averages. Required for 'location-summary'."),
+};
+const TOOL_ARGS_SCHEMA = z.object(TOOL_ARGS);
+const PerCameraUtilization = z.object({
+    cameraUuid: z.string().optional(),
+    cameraName: z.string().optional(),
+    totalCount: z.number().optional(),
+    averageCount: z.number().optional(),
+    deltaPercent: z.number().optional().describe("Percentage above/below average. Positive = busier than normal."),
+});
+const TrafficFlowEntry = z.object({
+    cameraUuid: z.string().optional(),
+    cameraName: z.string().optional(),
+    totalIngress: z.number().optional(),
+    totalEgress: z.number().optional(),
+    totalTraffic: z.number().optional(),
+    peakHour: z.string().optional().describe("Human-readable peak hour label."),
+    peakHourTraffic: z.number().optional(),
+});
+const HourlyComparison = z.object({
+    hour: z.string().optional().describe("Hour label (e.g. '9 AM', '2 PM')."),
+    actualCount: z.number().optional(),
+    averageCount: z.number().optional(),
+    deltaPercent: z.number().optional(),
+});
+const SceneResult = z.object({
+    value: z.string().optional().describe("The AI answer to the question."),
+    prompt: z.string().optional(),
+    timestampMs: z.number().optional(),
+    checkCondition: z.boolean().optional(),
+});
+export const OUTPUT_SCHEMA = z.object({
+    spaceUtilization: z
+        .object({
+        locationUuid: z.string().optional(),
+        cameras: z.array(PerCameraUtilization).optional(),
+        summary: z
+            .object({
+            totalPeopleCount: z.number().optional(),
+            averagePeopleCount: z.number().optional(),
+            overallDeltaPercent: z.number().optional(),
+            busiestCamera: z.string().optional(),
+            quietestCamera: z.string().optional(),
+        })
+            .optional(),
+    })
+        .optional()
+        .describe("Space utilization report with per-camera counts vs running averages."),
+    trafficFlow: z
+        .object({
+        locationUuid: z.string().optional(),
+        cameras: z.array(TrafficFlowEntry).optional(),
+        summary: z
+            .object({
+            totalIngress: z.number().optional(),
+            totalEgress: z.number().optional(),
+            totalTraffic: z.number().optional(),
+            busiestEntrance: z.string().optional(),
+            busiestEntranceTraffic: z.number().optional(),
+        })
+            .optional(),
+    })
+        .optional()
+        .describe("Multi-camera traffic flow comparison with ingress/egress ranking."),
+    peakVsAverage: z
+        .object({
+        hourlyComparison: z.array(HourlyComparison).optional(),
+        summary: z
+            .object({
+            peakHour: z.string().optional(),
+            peakHourCount: z.number().optional(),
+            quietestHour: z.string().optional(),
+            quietestHourCount: z.number().optional(),
+            overallAverageDelta: z.number().optional().describe("Overall delta vs average across all hours."),
+        })
+            .optional(),
+    })
+        .optional()
+        .describe("Hour-by-hour actual vs. average analysis with peak/quiet hour identification."),
+    sceneIntelligence: SceneResult.optional().describe("Real-time AI answer from a camera about what it currently sees."),
+    locationSummary: z
+        .object({
+        locationUuid: z.string().optional(),
+        peopleCounts: z
+            .object({
+            totalPeople: z.number().optional(),
+            averagePerHour: z.number().optional(),
+            peakHour: z.string().optional(),
+            peakCount: z.number().optional(),
+        })
+            .optional(),
+        trafficFlow: z
+            .object({
+            totalIngress: z.number().optional(),
+            totalEgress: z.number().optional(),
+            busiestEntrance: z.string().optional(),
+        })
+            .optional(),
+        comparison: z
+            .object({
+            overallDeltaPercent: z.number().optional(),
+            trend: z.string().optional().describe("'busier' or 'quieter' compared to average."),
+        })
+            .optional(),
+    })
+        .optional()
+        .describe("Comprehensive multi-metric location analytics summary."),
+    error: z.string().optional().describe("An error message if the request failed."),
+});

package/dist/types/camera-tool-types.js

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { ISOTimestampFormatDescription } from "../utils/timestampInput.js";
+import { createUuidSchema } from "../types.js";
 export const TimeWindowSecondsSchema = z.object({
     startSeconds: z.number(),
     durationSeconds: z.number(),
@@ -211,7 +212,7 @@ export const ExternalUpdateableFacetedUserConfigSchema = z.object({
         .describe("For each of the object keys: v0, v1, v2, v3, they correspond to a specific facet of the camera, since a camera may have multiple facets, up to 4. Hence, why they are zero-indexed."),
 });
 export const BASE_TOOL_ARGS = {
-    cameraUuid: z.string().nullable().describe("the camera uuid requested"),
+    cameraUuid: createUuidSchema().describe("the camera uuid requested"),
     timestampISO: z
         .string()
         .datetime({ message: "Invalid ISO 8601 date format.", offset: true })
@@ -219,6 +220,6 @@ export const BASE_TOOL_ARGS = {
         .describe(`
       the timestamp for the image. This will default to 5 minutes before the current time. You can also call time-tool to parse the user's time description.
       ` + ISOTimestampFormatDescription),
-    requestType: z.enum(["image", "get-settings"]),
+    requestType: z.enum(["image", "get-settings", "get-media-uris", "get-ai-thresholds"]),
 };
 const BASE_TOOL_ARGS_SCHEMA = z.object(BASE_TOOL_ARGS);

package/dist/types/camera-uptime-tool-types.js

@@ -0,0 +1,52 @@
+import { z } from "zod";
+import { INCLUDE_FIELDS_ARG, FILTER_BY_ARG } from "../util.js";
+export var CameraUptimeRequestType;
+(function (CameraUptimeRequestType) {
+    CameraUptimeRequestType["GET_CAMERA_UPTIME"] = "get-camera-uptime";
+    CameraUptimeRequestType["GET_FLEET_UPTIME"] = "get-fleet-uptime";
+})(CameraUptimeRequestType || (CameraUptimeRequestType = {}));
+export const TOOL_ARGS = {
+    requestType: z
+        .nativeEnum(CameraUptimeRequestType)
+        .describe("The type of uptime request to make."),
+    cameraUuid: z
+        .string()
+        .nullable()
+        .describe("Camera UUID. Required for 'get-camera-uptime'."),
+    startTimeSec: z
+        .number()
+        .describe("Start time as UNIX timestamp in seconds. Required for all requests."),
+    endTimeSec: z
+        .number()
+        .describe("End time as UNIX timestamp in seconds. Required for all requests."),
+    includeFields: INCLUDE_FIELDS_ARG,
+    filterBy: FILTER_BY_ARG,
+};
+const TOOL_ARGS_SCHEMA = z.object(TOOL_ARGS);
+const CameraUptimeSchema = z.object({
+    cameraUuid: z.string().optional(),
+    cameraName: z.string().optional(),
+    locationUuid: z.string().optional(),
+    totalUptimeSeconds: z.number().optional(),
+    totalPeriodSeconds: z.number().optional(),
+    uptimePercentage: z.number().optional(),
+    outageCount: z.number().optional(),
+    longestOutageSeconds: z.number().optional(),
+});
+export const OUTPUT_SCHEMA = z.object({
+    cameraUptime: CameraUptimeSchema.optional().describe("Uptime stats for a single camera"),
+    fleetUptime: z
+        .array(CameraUptimeSchema)
+        .optional()
+        .describe("Uptime stats for all cameras in the fleet, sorted by worst uptime first"),
+    fleetSummary: z
+        .object({
+        totalCameras: z.number().optional(),
+        averageUptimePercentage: z.number().optional(),
+        worstCamera: z.string().optional(),
+        worstUptimePercentage: z.number().optional(),
+    })
+        .optional()
+        .describe("Fleet-wide uptime summary"),
+    error: z.string().optional().describe("An error message if the request failed."),
+});

package/dist/types/clips-tool-types.js

@@ -1,10 +1,10 @@
 import { z } from "zod";
-import { createEpochSchema, ISOTimestampFormatDescription } from "../utils/timestampInput.js";
 import { createUuidSchema } from "../types.js";
+import { createEpochSchema, ISOTimestampFormatDescription, } from "../utils/timestampInput.js";
 export const TOOL_ARGS = {
-    queryType: z
-        .enum(["saved", "expiringSoon"])
-        .describe('The type of clips to retrieve. Use "saved" to get regular saved clips, and "expiringSoon" to get clips that are nearing their expiration date.'),
+    requestType: z
+        .enum(["saved", "expiringSoon", "sharedLiveStreams", "timelapseClips", "clipGroups", "sharedClips", "createClip", "deleteClip"])
+        .describe('The type of data to retrieve. Use "saved" for regular saved clips, "expiringSoon" for clips nearing expiration, "sharedLiveStreams" for all shared live video streams, or "timelapseClips" for all timelapse clips.'),
     deviceUuidFilters: z
         .array(createUuidSchema())
         .nullable()
@@ -19,18 +19,43 @@ export const TOOL_ARGS = {
         .describe("A simple string to search for within the names of the clips."),
     timestampISOAfter: z
         .string()
-        .datetime({ message: "Invalid datetime string. Expected ISO 8601 format.", offset: true })
-        .describe("The start of the time range for which to retrieve clips. Only clips that occurred AFTER this timestamp will be returned."
-        + ISOTimestampFormatDescription),
+        .datetime({
+        message: "Invalid datetime string. Expected ISO 8601 format.",
+        offset: true,
+    })
+        .nullable()
+        .describe("The start of the time range for which to retrieve clips. Only clips that occurred AFTER this timestamp will be returned. Required when requestType is saved or expiringSoon." +
+        ISOTimestampFormatDescription),
     timestampISOBefore: z
         .string()
-        .datetime({ message: "Invalid datetime string. Expected ISO 8601 format.", offset: true })
-        .describe("The end of the time range for which to retrieve clips. Only clips that occurred BEFORE this timestamp will be returned."
-        + ISOTimestampFormatDescription),
+        .datetime({
+        message: "Invalid datetime string. Expected ISO 8601 format.",
+        offset: true,
+    })
+        .nullable()
+        .describe("The end of the time range for which to retrieve clips. Only clips that occurred BEFORE this timestamp will be returned. Required when requestType is saved or expiringSoon." +
+        ISOTimestampFormatDescription),
+    clipUuid: z.string().nullable().describe("UUID of a clip. Required for 'deleteClip'."),
+    spliceRequest: z.object({
+        cameraUuid: z.string().describe("Camera UUID to create clip from"),
+        startTimeMs: z.number().describe("Start time in milliseconds"),
+        endTimeMs: z.number().describe("End time in milliseconds"),
+    }).nullable().describe("Required for 'createClip'. Specifies the camera and time range for the new clip."),
 };
 const TOOL_ARGS_SCHEMA = z.object(TOOL_ARGS);
 export const ApiPayloadSchema = TOOL_ARGS_SCHEMA.transform((args) => {
-    const { queryType, timestampISOAfter, timestampISOBefore, ...rest } = args;
+    if (args.requestType === "sharedLiveStreams" ||
+        args.requestType === "timelapseClips" ||
+        args.requestType === "clipGroups" ||
+        args.requestType === "sharedClips" ||
+        args.requestType === "createClip" ||
+        args.requestType === "deleteClip") {
+        return {};
+    }
+    const { timestampISOAfter, timestampISOBefore, ...rest } = args;
+    if (timestampISOAfter == null || timestampISOBefore == null) {
+        throw new Error("timestampISOAfter and timestampISOBefore are required when requestType is saved or expiringSoon");
+    }
     const timestampMsAfter = createEpochSchema().parse(timestampISOAfter);
     const timestampMsBefore = createEpochSchema().parse(timestampISOBefore);
     return {
@@ -39,3 +64,27 @@ export const ApiPayloadSchema = TOOL_ARGS_SCHEMA.transform((args) => {
         timestampMsBefore,
     };
 });
+export const OUTPUT_SCHEMA = z.object({
+    error: z.optional(z.string()),
+    // set these as z.any() to prevent us from over-loading the context with tool
+    savedClips: z.array(z.any()).optional(),
+    expiringClips: z.array(z.any()).optional(),
+    sharedLiveVideoStreams: z.array(z.any()).optional(),
+    timelapseClips: z.array(z.any()).optional(),
+    clipGroups: z.array(z.object({
+        uuid: z.string().optional(),
+        name: z.string().optional(),
+        clipCount: z.number().optional(),
+    })).optional().describe("List of clip groups/folders"),
+    sharedClipGroups: z.array(z.object({
+        uuid: z.string().optional(),
+        name: z.string().optional(),
+    })).optional().describe("List of shared clip groups"),
+    spliceResult: z.object({
+        success: z.boolean().optional(),
+        clipUuid: z.string().optional(),
+    }).optional().describe("Result of creating a new clip"),
+    deleteResult: z.object({
+        success: z.boolean().optional(),
+    }).optional().describe("Result of deleting a clip"),
+});

package/dist/types/door-tool-types.js

@@ -0,0 +1,64 @@
+import { z } from "zod";
+export var DoorToolRequestType;
+(function (DoorToolRequestType) {
+    DoorToolRequestType["GET_DOOR_CONTROLLER_RULES"] = "get-door-controller-rules";
+    DoorToolRequestType["CREATE_DOOR_CONTROLLER_RULE"] = "create-door-controller-rule";
+    DoorToolRequestType["GET_DOOR_POLICIES"] = "get-door-policies";
+    DoorToolRequestType["CREATE_DOOR_POLICY"] = "create-door-policy";
+})(DoorToolRequestType || (DoorToolRequestType = {}));
+export const TOOL_ARGS = {
+    requestType: z.nativeEnum(DoorToolRequestType).describe("The type of door operation to perform."),
+    doorControllerUuid: z
+        .string()
+        .nullable()
+        .describe("The UUID of the door controller device. Required for 'get-door-controller-rules' and 'create-door-controller-rule'."),
+    ruleConfig: z
+        .string()
+        .nullable()
+        .describe("JSON string of the door controller rule configuration. Required for 'create-door-controller-rule'."),
+    policyName: z
+        .string()
+        .nullable()
+        .describe("The name for the new door policy. Required for 'create-door-policy'."),
+    policyConfig: z
+        .string()
+        .nullable()
+        .describe("JSON string of door policy configuration. Required for 'create-door-policy'."),
+};
+const TOOL_ARGS_SCHEMA = z.object(TOOL_ARGS);
+export const OUTPUT_SCHEMA = z.object({
+    doorControllerRules: z
+        .array(z.object({
+        uuid: z.string().optional(),
+        name: z.string().optional(),
+        deviceUuid: z.string().optional(),
+        enabled: z.boolean().optional(),
+        ruleType: z.string().optional(),
+    }))
+        .optional()
+        .describe("List of door controller rules"),
+    createdRule: z
+        .object({
+        uuid: z.string().optional(),
+        success: z.boolean().optional(),
+    })
+        .optional()
+        .describe("Result of creating a door controller rule"),
+    doorPolicies: z
+        .array(z.object({
+        uuid: z.string().optional(),
+        name: z.string().optional(),
+        orgUuid: z.string().optional(),
+        enabled: z.boolean().optional(),
+    }))
+        .optional()
+        .describe("List of door policies"),
+    createdPolicy: z
+        .object({
+        uuid: z.string().optional(),
+        success: z.boolean().optional(),
+    })
+        .optional()
+        .describe("Result of creating a door policy"),
+    error: z.string().optional().describe("An error message if the request failed."),
+});

package/dist/types/events-tools-types.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
 import { ISOTimestampFormatDescription } from "../utils/timestampInput.js";
-import { ComponentEventEnumType } from "./schema-components.js";
+import { ComponentEventEnumType } from "./schema.js";
 import { HumanEvent } from "../api/events-tool-api.js";
 import { TempUnit } from "../utils/temp.js";
 export var EventsToolRequestType;
@@ -10,6 +10,10 @@ export var EventsToolRequestType;
     EventsToolRequestType["CLIMATE_SENSOR"] = "climate-sensor";
     EventsToolRequestType["COMPONENT_EVENTS"] = "component-events";
     EventsToolRequestType["CAMERA"] = "camera";
+    EventsToolRequestType["BUTTON_PRESS"] = "button-press";
+    EventsToolRequestType["OCCUPANCY"] = "occupancy";
+    EventsToolRequestType["PROXIMITY"] = "proximity";
+    EventsToolRequestType["DOORBELL"] = "doorbell";
 })(EventsToolRequestType || (EventsToolRequestType = {}));
 export const TOOL_ARGS = {
     eventType: z
@@ -19,7 +23,11 @@ export const TOOL_ARGS = {
         "environmental-gateway: Environmental gateway events with sensor readings and derived values. " +
         "climate-sensor: Climate sensor events with temperature, humidity, air quality readings. " +
         "component-events: All types of component events for a location (most flexible option). " +
-        "camera: Human motion events detected by cameras."),
+        "camera: Human motion events detected by cameras. " +
+        "button-press: Button press events from button sensors. " +
+        "occupancy: Occupancy sensor events with people count. " +
+        "proximity: Proximity tag events with RSSI readings. " +
+        "doorbell: Doorbell camera events."),
     startTime: z
         .string()
         .datetime({ message: "Invalid datetime string. Expected ISO 8601 format.", offset: true })
@@ -77,6 +85,22 @@ export const TOOL_ARGS = {
         .positive()
         .nullable()
         .describe("Duration in seconds to search for human motion events. Required when eventType is 'camera'. Default is 3600 (1 hour)."),
+    buttonSensorUuid: z
+        .string()
+        .nullable()
+        .describe("The UUID of the button sensor. Required when eventType is 'button-press'."),
+    occupancySensorUuid: z
+        .string()
+        .nullable()
+        .describe("The UUID of the occupancy sensor. Required when eventType is 'occupancy'."),
+    proximityTagUuids: z
+        .array(z.string())
+        .nullable()
+        .describe("Array of proximity tag UUIDs. Required when eventType is 'proximity'."),
+    doorbellCameraUuid: z
+        .string()
+        .nullable()
+        .describe("The UUID of the doorbell camera. Required when eventType is 'doorbell'."),
     tempUnit: z
         .nativeEnum(TempUnit)
         .nullable()
@@ -123,6 +147,10 @@ export const OUTPUT_SCHEMA = z.object({
         "climate-sensor",
         "component-events",
         "camera",
+        "button-press",
+        "occupancy",
+        "proximity",
+        "doorbell",
     ])
         .optional(),
     accessControlEvents: z.optional(z
@@ -154,10 +182,14 @@ export const OUTPUT_SCHEMA = z.object({
             "BLE_WAVE is a user badging in by physically waving their hand over the reader. " +
             "NFC is a user badging in by tapping their badge or their phone on the reader. " +
             "REMOTE is unlocking the door remotely through the Rhombus app."),
+        timestampMs: z
+            .number()
+            .optional()
+            .describe("Timestamp in milliseconds when the event occurred"),
         datetime: z.string().optional().describe("Datetime string of when the event occurred"),
     }))
         .nullable()
-        .describe("Access control events data including badge ins, credentials, arrivals, etc.")),
+        .describe("Access control events data including badge ins, credentials, arrivals, etc., sorted by timestamp (newest first).")),
     environmentalGatewayEvents: z.optional(z
         .object({
         events: z
@@ -252,6 +284,42 @@ export const OUTPUT_SCHEMA = z.object({
         .array(HumanEvent)
         .optional()
         .describe(`Camera events data, as requested with requestType ${EventsToolRequestType.CAMERA}`),
+    buttonPressEvents: z
+        .array(z.object({
+        timestampMs: z.number().optional(),
+        datetime: z.string().optional(),
+        sensorUuid: z.string().optional(),
+        buttonState: z.string().optional(),
+    }))
+        .optional()
+        .describe("Button press events"),
+    occupancyEvents: z
+        .array(z.object({
+        timestampMs: z.number().optional(),
+        datetime: z.string().optional(),
+        sensorUuid: z.string().optional(),
+        count: z.number().optional(),
+    }))
+        .optional()
+        .describe("Occupancy sensor events"),
+    proximityEvents: z
+        .array(z.object({
+        timestampMs: z.number().optional(),
+        datetime: z.string().optional(),
+        tagUuid: z.string().optional(),
+        rssi: z.number().optional(),
+    }))
+        .optional()
+        .describe("Proximity tag events"),
+    doorbellEvents: z
+        .array(z.object({
+        timestampMs: z.number().optional(),
+        datetime: z.string().optional(),
+        doorbellCameraUuid: z.string().optional(),
+        eventType: z.string().optional(),
+    }))
+        .optional()
+        .describe("Doorbell camera events"),
     needUserInput: z.boolean().optional(),
     commandForUser: z.string().optional(),
 });

package/dist/types/faces-tools-types.js

@@ -1,10 +1,15 @@
 import { z } from "zod";
 import { ISOTimestampFormatDescription } from "../utils/timestampInput.js";
 import { createUuidSchema } from "../types.js";
+import { INCLUDE_FIELDS_ARG, FILTER_BY_ARG } from "../util.js";
 export var RequestType;
 (function (RequestType) {
     RequestType["GET_FACE_EVENTS"] = "get-face-events";
     RequestType["GET_REGISTERED_FACES"] = "get-registered-faces";
+    RequestType["GET_PERSON_LABELS"] = "get-person-labels";
+    RequestType["SEARCH_SIMILAR_FACES"] = "search-similar-faces";
+    RequestType["GET_FACE_MATCHMAKERS"] = "get-face-matchmakers";
+    RequestType["GET_FACE_EVENTS_BY_PERSON"] = "get-face-events-by-person";
 })(RequestType || (RequestType = {}));
 export const GetRegisteredFacesArgsSchema = z.object({
     requestType: z.literal(RequestType.GET_REGISTERED_FACES),
@@ -88,6 +93,10 @@ export const TOOL_ARGS = {
     timeZone: z
         .string()
         .describe("The timezone for formatting timestamps which should come from the location of the camera for the face event. This is necessary for the tool to produce accurate formatted timestamps."),
+    faceEventUuid: z.string().nullable().describe("UUID of a face event to search similar faces from. Required for 'search-similar-faces'."),
+    personUuid: z.string().nullable().describe("UUID of a person to get face events for. Required for 'get-face-events-by-person'."),
+    includeFields: INCLUDE_FIELDS_ARG,
+    filterBy: FILTER_BY_ARG,
 };
 const TOOL_ARGS_SCHEMA = z.object(TOOL_ARGS);
 export const OUTPUT_SCHEMA = z.object({
@@ -137,7 +146,34 @@ export const OUTPUT_SCHEMA = z.object({
         orgUuid: z.optional(z.string()),
         updatedOn: z.optional(z.number()),
         uuid: z.optional(z.string()),
+        labels: z.optional(z.array(z.string())).describe("Labels assigned to this person, useful for grouping (e.g., 'Engineering', 'Visitors')."),
     })))
         .describe("A list of all people (registered faces) currently known to the Rhombus system for your organization."),
+    getPersonLabelsResponse: z
+        .optional(z.record(z.string(), z.array(z.string())))
+        .describe("A map of person UUIDs to their assigned label arrays. Use this to discover what label groups exist and which people belong to them."),
+    resolvedNames: z
+        .optional(z.record(z.string(), z.string().nullable()))
+        .describe("When faceNames are provided in a get-face-events request, this shows how each queried name was automatically resolved to a registered face. " +
+        "Key is the queried name (e.g., 'Brandon'), value is the matched registered name (e.g., 'Brandon Salzberg') or null if no match was found. " +
+        "Use these resolved names when reporting results to the user."),
+    similarFaceEvents: z.array(z.object({
+        uuid: z.string().optional(),
+        personUuid: z.string().optional(),
+        similarity: z.number().optional(),
+        eventTimestamp: z.string().optional(),
+    })).optional().describe("Similar face event results"),
+    faceMatchmakers: z.array(z.object({
+        uuid: z.string().optional(),
+        personUuid: z.string().optional(),
+        name: z.string().optional(),
+    })).optional().describe("Face matchmaker records"),
+    personFaceEvents: z.array(z.object({
+        uuid: z.string().optional(),
+        personUuid: z.string().optional(),
+        eventTimestamp: z.string().optional(),
+        deviceUuid: z.string().optional(),
+    })).optional().describe("Face events for a specific person"),
+    lastEvaluatedKey: z.string().optional().describe("For paginated requests, this is the returned last evaluated key that can be passed back in on the next request to get the next page of results"),
     error: z.optional(z.string()),
 });

package/dist/types/guest-management-tool-types.js

@@ -0,0 +1,57 @@
+import { z } from "zod";
+import { INCLUDE_FIELDS_ARG, FILTER_BY_ARG } from "../util.js";
+export var GuestManagementRequestType;
+(function (GuestManagementRequestType) {
+    GuestManagementRequestType["GET_ALL_GUESTS"] = "get-all-guests";
+    GuestManagementRequestType["GET_ACTIVITY_LOGS"] = "get-activity-logs";
+    GuestManagementRequestType["GET_ACTIVITIES_FOR_LOCATION"] = "get-activities-for-location";
+})(GuestManagementRequestType || (GuestManagementRequestType = {}));
+export const TOOL_ARGS = {
+    requestType: z
+        .nativeEnum(GuestManagementRequestType)
+        .describe("The type of guest management request to make."),
+    locationUuid: z
+        .string()
+        .nullable()
+        .describe("Location UUID. Required for 'get-activities-for-location'."),
+    startTimeMs: z
+        .number()
+        .nullable()
+        .describe("Start time filter in milliseconds since epoch. Optional for activity queries."),
+    endTimeMs: z
+        .number()
+        .nullable()
+        .describe("End time filter in milliseconds since epoch. Optional for activity queries."),
+    includeFields: INCLUDE_FIELDS_ARG,
+    filterBy: FILTER_BY_ARG,
+};
+const TOOL_ARGS_SCHEMA = z.object(TOOL_ARGS);
+const GuestSchema = z.object({
+    firstName: z.string().optional(),
+    lastName: z.string().optional(),
+    email: z.string().optional(),
+    companyName: z.string().optional(),
+    locationUuid: z.string().optional(),
+    hostUserUuid: z.string().optional(),
+    guestType: z.string().optional(),
+    checkedInStatus: z.string().optional(),
+    lastCheckedInMs: z.number().optional(),
+    lastCheckedOutMs: z.number().optional(),
+    phoneNumber: z.string().optional(),
+});
+const GuestActivitySchema = z.object({
+    activity: z.string().optional(),
+    email: z.string().optional(),
+    guestType: z.string().optional(),
+    locationUuid: z.string().optional(),
+    hostUserUuid: z.string().optional(),
+    timestampMs: z.number().optional(),
+});
+export const OUTPUT_SCHEMA = z.object({
+    guests: z.array(GuestSchema).optional().describe("List of guests in the organization"),
+    activities: z
+        .array(GuestActivitySchema)
+        .optional()
+        .describe("List of guest activity log entries"),
+    error: z.string().optional().describe("An error message if the request failed."),
+});