rhombus-node-mcp/dist/types/clips-tool-types.js

MCP server for Rhombus API

import { z } from "zod";
import { createUuidSchema } from "../types.js";
import { createEpochSchema, ISOTimestampFormatDescription, } from "../utils/timestampInput.js";
export const TOOL_ARGS = {
    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()
        .describe("A list of UUIDs representing specific devices to filter clips by. Only clips emitted by these devices will be returned. Please truncate any facets, such as .v0. It is always 22 characters long."),
    locationUuidFilters: z
        .array(createUuidSchema())
        .nullable()
        .describe("A list of UUIDs representing specific locations to filter clips by. Only clips associated with these locations will be returned. Please truncate any facets, such as .v0. It is always 22 characters long."),
    searchFilter: z
        .string()
        .nullable()
        .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,
    })
        .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,
    })
        .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) => {
    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 {
        ...rest,
        timestampMsAfter,
        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"),
});