rhombus-node-mcp 0.1.15 → 0.1.17

package/dist/types/endpoint-to-keys-tool-types.js

@@ -0,0 +1,7 @@
+import { z } from "zod";
+export const TOOL_ARGS = {
+    endpoint: z
+        .string()
+        .describe("The API endpoint to get output keys for (e.g., 'POST /api/camera/getMinimalCameraStateList')"),
+};
+const TOOL_ARGS_SCHEMA = z.object(TOOL_ARGS);

package/dist/types/entity-lookup-tool-types.js

@@ -0,0 +1,70 @@
+import { z } from "zod";
+import { createUuidSchema } from "../types.js";
+import { TempUnit } from "../utils/temp.js";
+export const TOOL_ARGS = {
+    deviceUuids: z.array(createUuidSchema()).describe("The UUIDs of the devices to look up."),
+    timeZone: z
+        .string()
+        .describe("The timezone for formatting timestamps. This is necessary for the tool to produce accurate formatted timestamps."),
+    tempUnit: z
+        .nativeEnum(TempUnit)
+        .nullable()
+        .describe("The unit of temperature to return, if applicable. Default is Celsius."),
+};
+const TOOL_ARGS_SCHEMA = z.object(TOOL_ARGS);
+export const OUTPUT_SCHEMA = z.object({
+    // Device arrays with their counts
+    cameras: z.array(z.any()).optional().describe("List of cameras matching the provided UUIDs"),
+    camerasCount: z.number().optional().describe("Number of cameras found"),
+    doorbellCameras: z
+        .array(z.any())
+        .optional()
+        .describe("List of doorbell cameras matching the provided UUIDs"),
+    doorbellCamerasCount: z.number().optional().describe("Number of doorbell cameras found"),
+    badgeReaders: z
+        .array(z.any())
+        .optional()
+        .describe("List of badge readers matching the provided UUIDs"),
+    badgeReadersCount: z.number().optional().describe("Number of badge readers found"),
+    accessControlledDoors: z
+        .array(z.any())
+        .optional()
+        .describe("List of access controlled doors matching the provided UUIDs"),
+    accessControlledDoorsCount: z
+        .number()
+        .optional()
+        .describe("Number of access controlled doors found"),
+    audioGateways: z
+        .array(z.any())
+        .optional()
+        .describe("List of audio gateways matching the provided UUIDs"),
+    audioGatewaysCount: z.number().optional().describe("Number of audio gateways found"),
+    doorStates: z
+        .array(z.any())
+        .optional()
+        .describe("List of door sensors matching the provided UUIDs"),
+    doorStatesCount: z.number().optional().describe("Number of door sensors found"),
+    climateStates: z
+        .array(z.any())
+        .optional()
+        .describe("List of environmental sensors matching the provided UUIDs"),
+    climateStatesCount: z.number().optional().describe("Number of environmental sensors found"),
+    occupancySensorStates: z
+        .array(z.any())
+        .optional()
+        .describe("List of motion sensors matching the provided UUIDs"),
+    occupancySensorStatesCount: z.number().optional().describe("Number of motion sensors found"),
+    buttonStates: z.array(z.any()).optional().describe("List of buttons matching the provided UUIDs"),
+    buttonStatesCount: z.number().optional().describe("Number of buttons found"),
+    keypadStates: z.array(z.any()).optional().describe("List of keypads matching the provided UUIDs"),
+    keypadStatesCount: z.number().optional().describe("Number of keypads found"),
+    minimalEnvironmentalGatewayStates: z
+        .array(z.any())
+        .optional()
+        .describe("List of environmental gateways matching the provided UUIDs"),
+    minimalEnvironmentalGatewayStatesCount: z
+        .number()
+        .optional()
+        .describe("Number of environmental gateways found"),
+    error: z.string().optional().describe("An error message if the request failed."),
+});

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

@@ -0,0 +1,257 @@
+import { z } from "zod";
+import { ISOTimestampFormatDescription } from "../utils/timestampInput.js";
+import { ComponentEventEnumType } from "./schema-components.js";
+import { HumanEvent } from "../api/events-tool-api.js";
+import { TempUnit } from "../utils/temp.js";
+export var EventsToolRequestType;
+(function (EventsToolRequestType) {
+    EventsToolRequestType["ACCESS_CONTROL"] = "access-control";
+    EventsToolRequestType["ENVIRONMENTAL_GATEWAY"] = "environmental-gateway";
+    EventsToolRequestType["CLIMATE_SENSOR"] = "climate-sensor";
+    EventsToolRequestType["COMPONENT_EVENTS"] = "component-events";
+    EventsToolRequestType["CAMERA"] = "camera";
+})(EventsToolRequestType || (EventsToolRequestType = {}));
+export const TOOL_ARGS = {
+    eventType: z
+        .nativeEnum(EventsToolRequestType)
+        .describe("The type of events to retrieve. " +
+        "access-control: Access control events like unlocks, badge ins, credentials, arrivals. " +
+        "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."),
+    startTime: z
+        .string()
+        .datetime({ message: "Invalid datetime string. Expected ISO 8601 format.", offset: true })
+        .describe("A timestamp representing when to start the search for access control events." +
+        ISOTimestampFormatDescription),
+    endTime: z
+        .string()
+        .datetime({ message: "Invalid datetime string. Expected ISO 8601 format.", offset: true })
+        .describe("A timestamp representing when to end the search for access control events." +
+        ISOTimestampFormatDescription),
+    accessControlledDoorUuids: z
+        .array(z.string())
+        .nullable()
+        .describe("The UUIDs (array) of the access controlled doors. Required when eventType is 'access-control'."),
+    deviceUuid: z
+        .string()
+        .nullable()
+        .describe("The UUID of the environmental gateway device. Required when eventType is 'environmental-gateway'  Can be obtained from the get-entity-tool for ENVIRONMENTAL_GATEWAY."),
+    sensorUuid: z
+        .string()
+        .nullable()
+        .describe("The UUID of the climate sensor. Required when eventType is 'climate-sensor'. Can be obtained from the get-entity-tool for SENSOR."),
+    limit: z
+        .number()
+        .int()
+        .positive()
+        .nullable()
+        .describe("Maximum number of climate events to return. Only applicable when eventType is 'climate-sensor'. Default is 1000. Pass null for other event types."),
+    locationUuid: z
+        .string()
+        .nullable()
+        .describe("The UUID of the location. Required when eventType is 'component-events'."),
+    componentEventTypes: z
+        .array(z.nativeEnum(ComponentEventEnumType))
+        .nullable()
+        .describe("Array of component event types to filter by. Only applicable when eventType is 'component-events'. " +
+        "If empty or null, returns all event types. Valid values: " +
+        "DoorbellEvent, DoorReaderStateChangeEvent, DoorRelayStateChangeEvent, DoorPositionIndicatorStateChangeEvent, " +
+        "RequestToExitStateChangeEvent, CredentialReceivedEvent, ButtonEvent, GenericInputStateChangeEvent, " +
+        "GenericRelayStateChangeEvent, AccessControlUnitTamperEvent, AccessControlUnitLocationLockdownStateEvent, " +
+        "DoorLocationLockdownStateEvent, PanicButtonEvent, AccessControlUnitBatteryStateChangeEvent, " +
+        "WaveToUnlockIntentExpiredEvent, DoorStateChangeEvent, DoorAuthFirstInStateEvent, DoorScheduleFirstInStateEvent, " +
+        "AccessControlUnitDoorFirstInStateEvent, AperioDoorExtensionStateEvent, AperioGatewayStateEvent, " +
+        "AperioGatewayConnectionStateChangeEvent, AperioDtcEvent, AperioTamperStateEvent."),
+    timeZone: z
+        .string()
+        .describe("The timezone of the requested locations or devices. This is necessary for the tool to produce accurate formatted timestamps."),
+    cameraUuid: z
+        .string()
+        .nullable()
+        .describe("The unique identifier for the camera. Required when eventType is 'camera'. Can be obtained from the get-entity-tool for CAMERA."),
+    duration: z
+        .number()
+        .int()
+        .positive()
+        .nullable()
+        .describe("Duration in seconds to search for human motion events. Required when eventType is 'camera'. Default is 3600 (1 hour)."),
+    tempUnit: z
+        .nativeEnum(TempUnit)
+        .nullable()
+        .describe("The unit of temperature to return. Default is Celsius."),
+};
+const TOOL_ARGS_SCHEMA = z.object(TOOL_ARGS);
+const StrippedEnvironmentalEvent = z.object({
+    timestampString: z.string().optional().describe("Human-readable formatted timestamp"),
+    temp: z.number().optional().describe("Temperature from CO2 sensor in Celsius"),
+    probeTemp: z.number().optional().describe("Temperature from probe sensor in Celsius"),
+    humidity: z.number().optional().describe("Relative humidity percentage"),
+    pm25: z.number().optional().describe("PM2.5 particulate matter reading"),
+    co2: z.number().optional().describe("CO2 concentration in PPM"),
+    vapeDetected: z.boolean().optional().describe("Whether vape was detected"),
+});
+const ClimateSensorEvent = z.object({
+    timestampString: z.string().optional().describe("Human-readable formatted timestamp"),
+    timestampMs: z.number().optional().describe("Timestamp in milliseconds"),
+    temp: z.number().optional().describe("Temperature reading in Celsius"),
+    probeTemp: z.number().optional().describe("Temperature from probe sensor"),
+    // probeTempC: z.number().optional().describe("Temperature from probe sensor in Celsius"),
+    humidity: z.number().optional().describe("Relative humidity percentage"),
+    pm25: z.number().optional().describe("PM2.5 particulate matter reading"),
+    co2: z.number().optional().describe("CO2 concentration in PPM"),
+    tvoc: z.number().optional().describe("Total Volatile Organic Compounds"),
+    iaq: z.number().optional().describe("Indoor Air Quality index"),
+    ethanol: z.number().optional().describe("Ethanol concentration"),
+    heatIndexDegF: z.number().optional().describe("Heat index in Fahrenheit"),
+    heatIndexRangeWarning: z.string().optional().describe("Heat index warning level"),
+    vapeSmokeDetected: z.boolean().optional().describe("Whether vape or smoke was detected"),
+    vapeSmokePercent: z.number().optional().describe("Vape/smoke confidence percentage"),
+    thcDetected: z.boolean().optional().describe("Whether THC was detected"),
+    thcPercent: z.number().optional().describe("THC confidence percentage"),
+    tampered: z.boolean().optional().describe("Whether the sensor was tampered with"),
+    batteryPercentage: z.number().optional().describe("Battery level percentage"),
+    locationUuid: z.string().optional().describe("Location UUID"),
+    orgUuid: z.string().optional().describe("Organization UUID"),
+});
+export const OUTPUT_SCHEMA = z.object({
+    eventType: z
+        .enum([
+        "access-control",
+        "environmental-gateway",
+        "climate-sensor",
+        "component-events",
+        "camera",
+    ])
+        .optional(),
+    accessControlEvents: z.optional(z
+        .array(z.object({
+        authenticationResult: z
+            .string()
+            .optional()
+            .describe("The result of the authentication process"),
+        authorizationResult: z
+            .string()
+            .optional()
+            .describe("The result of the authorization process"),
+        doorUuid: z
+            .string()
+            .optional()
+            .describe("The unique identifier for the access controlled door"),
+        locationUuid: z
+            .string()
+            .optional()
+            .describe("The unique identifier for the location where the event occurred"),
+        user: z
+            .string()
+            .optional()
+            .describe("The username of the person who triggered the event"),
+        credSource: z
+            .string()
+            .optional()
+            .describe("The source of the credential. Is what generated the event. " +
+            "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."),
+        datetime: z.string().optional().describe("Datetime string of when the event occurred"),
+    }))
+        .nullable()
+        .describe("Access control events data including badge ins, credentials, arrivals, etc.")),
+    environmentalGatewayEvents: z.optional(z
+        .object({
+        events: z
+            .array(StrippedEnvironmentalEvent)
+            .optional()
+            .describe("An array where each object represents a single environmental event containing sensor readings and derived values"),
+        lastEvaluatedKey: z
+            .string()
+            .optional()
+            .describe("A key for pagination if more results are available"),
+    })
+        .nullable()
+        .describe("Environmental gateway events data including sensor readings and derived values")),
+    climateSensorEvents: z.optional(z
+        .array(ClimateSensorEvent)
+        .nullable()
+        .describe("Climate sensor events data including temperature, humidity, air quality, and other readings")),
+    componentEvents: z.optional(z
+        .array(z.object({
+        eventType: z
+            .string()
+            .optional()
+            .describe("The type of component event (e.g., DoorbellEvent, CredentialReceivedEvent, etc.)"),
+        componentUuid: z
+            .string()
+            .optional()
+            .describe("The unique identifier for the component that generated the event"),
+        locationUuid: z
+            .string()
+            .optional()
+            .describe("The unique identifier for the location where the event occurred"),
+        orgUuid: z.string().optional().describe("The unique identifier for the organization"),
+        correlationId: z
+            .string()
+            .optional()
+            .describe("A correlation ID for tracking related events"),
+        ownerDeviceUuid: z
+            .string()
+            .optional()
+            .describe("The unique identifier for the device that owns this component"),
+        datetime: z
+            .string()
+            .optional()
+            .describe("Human-readable datetime string of when the event occurred"),
+        timestampMs: z
+            .number()
+            .optional()
+            .describe("Timestamp in milliseconds when the event occurred"),
+        uuid: z.string().optional().describe("The unique identifier for this specific event"),
+        // Event-specific fields
+        authenticationResult: z
+            .string()
+            .optional()
+            .describe("The result of the authentication process (for credential events)"),
+        authorizationResult: z
+            .string()
+            .optional()
+            .describe("The result of the authorization process (for credential events)"),
+        user: z
+            .string()
+            .optional()
+            .describe("The username of the person who triggered the event (for credential events)"),
+        credSource: z
+            .string()
+            .optional()
+            .describe("The source of the credential (for credential events)"),
+        doorUuid: z
+            .string()
+            .optional()
+            .describe("The unique identifier for the door (for door-related events)"),
+        doorbellCameraUuid: z
+            .string()
+            .optional()
+            .describe("The unique identifier for the doorbell camera (for doorbell events)"),
+        previousState: z
+            .string()
+            .optional()
+            .describe("The previous state before the change (for state change events)"),
+        newState: z
+            .string()
+            .optional()
+            .describe("The new state after the change (for state change events)"),
+        reason: z.string().optional().describe("The reason for the state change or event"),
+        buttonState: z
+            .string()
+            .optional()
+            .describe("The state of the button (for button events)"),
+    }))
+        .nullable()
+        .describe("Component events data for all types of access control events at a location, sorted by timestamp (newest first)")),
+    cameraEvents: z
+        .array(HumanEvent)
+        .optional()
+        .describe(`Camera events data, as requested with requestType ${EventsToolRequestType.CAMERA}`),
+    needUserInput: z.boolean().optional(),
+    commandForUser: z.string().optional(),
+});

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

@@ -0,0 +1,143 @@
+import { z } from "zod";
+import { ISOTimestampFormatDescription } from "../utils/timestampInput.js";
+import { createUuidSchema } from "../types.js";
+export var RequestType;
+(function (RequestType) {
+    RequestType["GET_FACE_EVENTS"] = "get-face-events";
+    RequestType["GET_REGISTERED_FACES"] = "get-registered-faces";
+})(RequestType || (RequestType = {}));
+export const GetRegisteredFacesArgsSchema = z.object({
+    requestType: z.literal(RequestType.GET_REGISTERED_FACES),
+});
+export const GetFaceEventsArgs = z.object({
+    pageRequest: z
+        .object({
+        lastEvaluatedKey: z
+            .string()
+            .nullable()
+            .describe("The last evaluated key from a previous pagination request"),
+        maxPageSize: z
+            .number()
+            .nullable()
+            .describe("Maximum number of results to return per page. Default to around 200. Caution against setting this to a lower number, it may make you miss information."),
+    })
+        .nullable()
+        .describe("Pagination parameters for the request"),
+    searchFilter: z
+        .object({
+        // TODO: this is causing the AI to call the tool incorrectly and always pass in deviceUUIDs. We'll leave
+        // the filtering of this to the AI for now.
+        // deviceUuids: z
+        //   .array(z.string())
+        //   .describe(
+        //     "Optional filter by a set of device UUIDs. Only face events from these devices will be returned. An empty array will be the same as omitting the filter. The strings are always 22 characters long."
+        //   ),
+        faceNameContains: z
+            .string()
+            .nullable()
+            .describe("Optional filter for face events where the detected face's name contains this substring. The search is performed only if the value is at least 3 characters long after trimming spaces. This takes precedence over 'faceNames' if both are specified. This is case-sensitive."),
+        faceNames: z.array(z.string()).describe(`Optional filter by a set of specific person names. Only face events associated with these names will be returned. An empty array will be the same as omitting the filter.
+          This is case-sensitive.`),
+        hasEmbedding: z
+            .boolean()
+            .nullable()
+            .describe("Optional filter by the presence (true) or absence (false) of a face embedding associated with the event."),
+        hasName: z
+            .boolean()
+            .nullable()
+            .describe("Optional filter by the presence (true) or absence (false) of a person name associated with the face event."),
+        labels: z
+            .array(z.string())
+            .describe("Optional filter by a set of labels associated with the face event. An empty array will be the same as omitting the filter."),
+        locationUuids: z
+            .array(createUuidSchema())
+            .describe("Optional filter by a set of location UUIDs. Only face events from these locations will be returned. An empty array will be the same as omitting the filter."),
+        personUuids: z
+            .array(createUuidSchema())
+            .describe("Optional filter by a set of person UUIDs. Only face events associated with these specific people will be returned. An empty array will be the same as omitting the filter."),
+        timestampFilter: z
+            .object({
+            rangeEnd: z
+                .string()
+                .datetime({
+                message: "Invalid datetime string. Expected ISO 8601 format.",
+                offset: true,
+            })
+                .nullable()
+                .describe("The end of the time range (inclusive) for filtering face events. If not specified, the filter defaults to the last 7 days." +
+                ISOTimestampFormatDescription),
+            rangeStart: z
+                .string()
+                .datetime({
+                message: "Invalid datetime string. Expected ISO 8601 format.",
+                offset: true,
+            })
+                .nullable()
+                .describe("The start of the time range (inclusive) for filtering face events. If not specified, the filter defaults to the last 7 days." +
+                ISOTimestampFormatDescription),
+        })
+            .nullable()
+            .describe("Time range filter for face events"),
+    })
+        .nullable()
+        .describe("Search criteria for filtering face events. Only applies to tool calls with requestType 'get-face-events'."),
+});
+export const TOOL_ARGS = {
+    requestType: z.nativeEnum(RequestType),
+    faceEventFilter: GetFaceEventsArgs,
+    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."),
+};
+const TOOL_ARGS_SCHEMA = z.object(TOOL_ARGS);
+export const OUTPUT_SCHEMA = z.object({
+    requestType: z.nativeEnum(RequestType),
+    getFaceEventsResponse: z
+        .optional(z.array(z.object({
+        deviceUuid: z.optional(z.string()),
+        eventTimestampMs: z.number().describe("The timestamp of the face event in milliseconds."),
+        eventTimestamp: z
+            .optional(z.string())
+            .describe("The timestamp of the face event in human readable format."),
+        faceName: z
+            .optional(z.string())
+            .describe("If the face matches somebody that has been registered in our system, this is the name of the person that was detected."),
+        locationUuid: z
+            .optional(z.string())
+            .describe("The UUID of the location where the face event occurred."),
+        personUuid: z.optional(z.string()).describe("The UUID of the person that was detected."),
+        // selectedPersonMatch: z.optional(
+        //   z.object({
+        //     confidence: z.number(),
+        //     faceId: z.optional(z.string()),
+        //     name: z.optional(z.string()),
+        //     uuid: z.optional(z.string()),
+        //   })
+        // ),
+        thumbnailS3Key: z
+            .optional(z.string())
+            .describe("The S3 key of the thumbnail of the face event."),
+        // topPersonMatches: z.optional(
+        //   z.array(
+        //     z.object({
+        //       confidence: z.number(),
+        //       faceId: z.optional(z.string()),
+        //       name: z.optional(z.string()),
+        //       uuid: z.optional(z.string()),
+        //     })
+        //   )
+        // ).describe("The top person matches found for this face event, in order of confidence."),
+        uuid: z.optional(z.string()),
+    })))
+        .describe("A list of all people seen over the given time period."),
+    getSavedFacesResponse: z
+        .optional(z.array(z.object({
+        createdOn: z.optional(z.number()),
+        name: z.optional(z.string()),
+        orgUuid: z.optional(z.string()),
+        updatedOn: z.optional(z.number()),
+        uuid: z.optional(z.string()),
+    })))
+        .describe("A list of all people (registered faces) currently known to the Rhombus system for your organization."),
+    error: z.optional(z.string()),
+});

package/dist/types/get-entity-tool-types.js

@@ -0,0 +1,25 @@
+import { z } from "zod";
+import { createUuidSchema } from "../types.js";
+import DeviceType from "./deviceType.js";
+import { TempUnit } from "../utils/temp.js";
+export const TOOL_ARGS = {
+    entityTypes: z
+        .array(z.nativeEnum(DeviceType).describe("The entity type to retreive"))
+        .describe("What type of entities to retrieve."),
+    filterBy: z
+        .object({
+        locationUuids: z
+            .array(createUuidSchema())
+            .nullable()
+            .describe("The UUIDs of the locations to filter by. Set to null or an enmpty array to not filter by location."),
+    })
+        .describe("Additional filters that can be applied to the result."),
+    timeZone: z
+        .string()
+        .describe("The timezone for formatting timestamps. This is necessary for the tool to produce accurate formatted timestamps."),
+    tempUnit: z
+        .nativeEnum(TempUnit)
+        .nullable()
+        .describe("The unit of temperature to return, if applicable. Default is Celsius."),
+};
+const TOOL_ARGS_SCHEMA = z.object(TOOL_ARGS);

package/dist/types/get-org-information-tool-types.js

@@ -0,0 +1,3 @@
+import { z } from "zod";
+export const TOOL_ARGS = {};
+const TOOL_ARGS_SCHEMA = z.object(TOOL_ARGS);

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

@@ -0,0 +1,11 @@
+import { z } from "zod";
+export const TOOL_ARGS = {
+    action: z.enum(["get", "update"]),
+    locationUpdate: z
+        .object({
+        uuid: z.string(),
+        name: z.string(),
+    })
+        .nullable(),
+};
+const TOOL_ARGS_SCHEMA = z.object(TOOL_ARGS);

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

@@ -0,0 +1,97 @@
+import { z } from "zod";
+import { createUuidSchema } from "../types.js";
+import { ISOTimestampFormatDescription } from "../utils/timestampInput.js";
+export var LprToolRequestType;
+(function (LprToolRequestType) {
+    LprToolRequestType["GET_VEHICLE_EVENTS"] = "get-vehicle-events";
+    LprToolRequestType["GET_SAVED_VEHICLES"] = "get-saved-vehicles";
+    LprToolRequestType["GET_VEHICLE_LABELS"] = "get-vehicle-labels";
+})(LprToolRequestType || (LprToolRequestType = {}));
+export const VehicleEventsArgs = z.object({
+    deviceUuidFilter: z
+        .array(createUuidSchema())
+        .nullable()
+        .describe("Filter license plate events by device UUIDs. An empty array will be the same as omitting the filter."),
+    locationUuidFilter: z
+        .array(createUuidSchema())
+        .nullable()
+        .describe("Filter license plate events by location UUIDs. An empty array will be the same as omitting the filter."),
+    vehicleLabelQuery: z
+        .array(z.string())
+        .nullable()
+        .describe("Filter license plates by vehicle labels. This will do a substring search on vehicle events with these labels."),
+    licensePlateFuzzyQuery: z
+        .string()
+        .nullable()
+        .describe("Filter license plates by fuzzy search. This will do a fuzzy search on vehicle events with this license plate. You'll likely want to use this more often than vehicleLabelQuery."),
+    // startTime and endTime are required because this endpoint could potentially return a lot of data
+    startTime: z
+        .string()
+        .datetime({
+        message: "Invalid datetime string. Expected ISO 8601 format.",
+        offset: true,
+    })
+        .describe("The end of the time range (inclusive) for filtering license plate events." +
+        ISOTimestampFormatDescription),
+    endTime: z
+        .string()
+        .datetime({
+        message: "Invalid datetime string. Expected ISO 8601 format.",
+        offset: true,
+    })
+        .describe("The start of the time range (inclusive) for filtering license plate events." +
+        ISOTimestampFormatDescription),
+});
+export const TOOL_ARGS = {
+    requestType: z.nativeEnum(LprToolRequestType).describe("The type of request to make."),
+    vehicleEventsArgs: VehicleEventsArgs.nullable().describe("Only necessary for requestType 'get-vehicle-events'"),
+    timeZone: z
+        .string()
+        .describe("The timezone for formatting timestamps which should come from the location of the device for the LPR event, or the user's timezone. This is necessary for the tool to produce accurate formatted timestamps."),
+};
+const TOOL_ARGS_SCHEMA = z.object(TOOL_ARGS);
+// cherry-picked fields from /getVehicleEvents
+const VehicleEvent = z.object({
+    uuid: createUuidSchema().describe("The UUID of the license plate event."),
+    deviceUuid: z
+        .string()
+        .optional()
+        .describe("The UUID of the device that emitted the license plate event."),
+    eventTimestamp: z.string().optional().describe("The timestamp of the license plate event."),
+    imageS3Key: z
+        .string()
+        .optional()
+        .describe("The S3 key of the image of the license plate event. Do not modify this."),
+    thumbnailS3Key: z
+        .string()
+        .optional()
+        .describe("The S3 key of the thumbnail of the license plate event. Do not modify this."),
+    locationUuid: z
+        .string()
+        .optional()
+        .describe("The UUID of the location that emitted the license plate event."),
+    vehicleLicensePlate: z
+        .string()
+        .optional()
+        .describe("The license plate of the vehicle that was detected."),
+});
+const VehicleLabels = z.record(z.string(), z.array(z.string()));
+const SavedVehicle = z.object({
+    createdTimestamp: z.string().describe("The timestamp of the saved vehicle."),
+    name: z.string().describe("The name of the saved vehicle."),
+    description: z.string().describe("The description of the saved vehicle."),
+    licensePlate: z.string().describe("The license plate of the saved vehicle."),
+    orgUuid: createUuidSchema().describe("The UUID of the organization that the saved vehicle belongs to."),
+});
+export const OUTPUT_SCHEMA = z.object({
+    vehicleEvents: z
+        .array(VehicleEvent)
+        .optional()
+        .describe(`A list of license plate events, as requested by the request type${LprToolRequestType.GET_VEHICLE_EVENTS}`),
+    vehicleLabels: VehicleLabels.optional().describe(`A list of vehicle labels, as requested by the request type${LprToolRequestType.GET_VEHICLE_LABELS}`),
+    savedVehicles: z
+        .array(SavedVehicle)
+        .optional()
+        .describe(`A list of saved vehicles, as requested by the request type${LprToolRequestType.GET_SAVED_VEHICLES}`),
+    error: z.string().optional().describe("An error message if the request failed."),
+});