@owine/unifi-protect-mcp 2.14.2 → 3.0.0

package/dist/tools/cameras.js

@@ -5,44 +5,41 @@ const zod_1 = require("zod");
 const responses_js_1 = require("../utils/responses.js");
 const safety_js_1 = require("../utils/safety.js");
 const url_js_1 = require("../utils/url.js");
+const paging_js_1 = require("../utils/paging.js");
+const params_js_1 = require("../utils/params.js");
 const cameras_js_1 = require("../schemas/cameras.js");
+// Each gate's confirm input and handler check share one action text.
+const OPEN_STREAM = (0, safety_js_1.confirmGate)("open an RTSPS stream (its URL is a credential for live video)");
+const OPEN_TALKBACK = (0, safety_js_1.confirmGate)("open a two-way audio session");
+const DISABLE_MIC = (0, safety_js_1.confirmGate)("permanently disable the microphone");
 function registerCameraTools(server, client, readOnly) {
     // --- Read-only tools (always registered) ---
     server.registerTool("protect_list_cameras", {
-        description: "List all cameras managed by UniFi Protect. Returns array; each camera includes (Integration API 7.3.47-verified fields): id, mac, name, modelKey, state (CONNECTED/DISCONNECTED), type (hardware model name, e.g. UVC G6 Turret), guid (hardware MODEL GUID — every camera of the same model returns the same value, so it is NOT a per-camera identifier; use id), activePatrolSlot, hasPackageCamera, hdrType, isMicEnabled, micVolume, videoMode, featureFlags (hasHdr, hasMic, hasSpeaker, hasLedStatus, smartDetectTypes[], smartDetectAudioTypes[], videoModes[], supportFullHdSnapshot), lcdMessage (type, resetAt, text), ledSettings (isEnabled, floodLed, welcomeLed), osdSettings (isNameEnabled, isDateEnabled, isLogoEnabled, isDebugEnabled, overlayLocation), smartDetectSettings (objectTypes[], audioTypes[]). The Integration API does NOT expose recording state, motion timestamps, connection/last-seen, firmware, host, or per-channel stream config.",
+        description: "List all cameras managed by UniFi Protect. Returns array; each camera includes (Integration API 7.3.70-verified fields): id, mac, name, modelKey, state (CONNECTED/DISCONNECTED), type (hardware model name, e.g. UVC G6 Turret), guid (hardware MODEL GUID — every camera of the same model returns the same value, so it is NOT a per-camera identifier; use id), activePatrolSlot, hasPackageCamera, hdrType, isMicEnabled, micVolume, videoMode, featureFlags (hasHdr, hasMic, hasSpeaker, hasLedStatus, smartDetectTypes[], smartDetectAudioTypes[], videoModes[], supportFullHdSnapshot), lcdMessage (type, resetAt, text), ledSettings (isEnabled, floodLed, welcomeLed), osdSettings (isNameEnabled, isDateEnabled, isLogoEnabled, isDebugEnabled, overlayLocation), smartDetectSettings (objectTypes[], audioTypes[]). The Integration API does NOT expose recording state, motion timestamps, connection/last-seen, firmware, host, or per-channel stream config." + paging_js_1.PAGING_NOTE,
+        inputSchema: paging_js_1.pagingInput,
         outputSchema: cameras_js_1.cameraListOutputSchema,
         annotations: safety_js_1.READ_ONLY,
-    }, async () => {
-        try {
-            const data = await client.get("/cameras");
-            return (0, responses_js_1.formatSuccess)(data);
-        }
-        catch (err) {
-            return (0, responses_js_1.formatError)(err);
-        }
+    }, async ({ limit, offset }) => {
+        const data = await client.get("/cameras");
+        return (0, responses_js_1.formatSuccess)((0, paging_js_1.pageOf)(data, limit, offset));
     });
     server.registerTool("protect_get_camera", {
-        description: "Get details for a specific camera by ID. The Protect Integration API returns the SAME field set as protect_list_cameras entries (id, mac, name, modelKey, state, type, guid, activePatrolSlot, hasPackageCamera, hdrType, isMicEnabled, micVolume, videoMode, featureFlags, lcdMessage, ledSettings, osdSettings, smartDetectSettings) — there is no extended/by-id-only payload (confirmed live on 7.3.47). Recording state, motion events, zones, and channel/RTSP config are NOT exposed by this API surface.",
-        inputSchema: { id: zod_1.z.string().describe("Camera ID") },
+        description: "Get details for a specific camera by ID. The Protect Integration API returns the SAME field set as protect_list_cameras entries (id, mac, name, modelKey, state, type, guid, activePatrolSlot, hasPackageCamera, hdrType, isMicEnabled, micVolume, videoMode, featureFlags, lcdMessage, ledSettings, osdSettings, smartDetectSettings) — there is no extended/by-id-only payload (confirmed live on 7.3.70). Recording state, motion events, zones, and channel/RTSP config are NOT exposed by this API surface.",
+        inputSchema: { id: (0, params_js_1.resourceId)().describe("Camera ID") },
         outputSchema: cameras_js_1.cameraOutputSchema,
         annotations: safety_js_1.READ_ONLY,
     }, async ({ id }) => {
-        try {
-            const data = await client.get((0, url_js_1.safePath) `/cameras/${id}`);
-            return (0, responses_js_1.formatSuccess)(data);
-        }
-        catch (err) {
-            return (0, responses_js_1.formatError)(err);
-        }
+        const data = await client.get((0, url_js_1.safePath) `/cameras/${id}`);
+        return (0, responses_js_1.formatSuccess)(data);
     });
     server.registerTool("protect_get_snapshot", {
-        description: "Get a JPEG snapshot from a camera. Returns a base64-encoded image/jpeg (rendered directly by MCP clients). Use highQuality=true for full-resolution capture; set channel=package to capture from the secondary package camera on doorbells with hasPackageCamera=true.",
+        description: "Get a JPEG snapshot from a camera. Returns a base64-encoded image/jpeg (rendered directly by MCP clients). Use highQuality=true to force a 1080p-or-higher capture; set channel=package to capture from the secondary package camera on doorbells with hasPackageCamera=true. Fails with HTTP 503 when the camera is offline or unreachable. A snapshot too large for one MCP message is refused with an error; try without highQuality.",
         inputSchema: {
-            id: zod_1.z.string().describe("Camera ID"),
+            id: (0, params_js_1.resourceId)().describe("Camera ID"),
             highQuality: zod_1.z
                 .boolean()
                 .optional()
-                .describe("If true, request a high-quality snapshot"),
+                .describe("If true, force a 1080p-or-higher resolution snapshot"),
             channel: zod_1.z
                 .enum(["main", "package"])
                 .optional()
@@ -50,237 +47,215 @@ function registerCameraTools(server, client, readOnly) {
         },
         annotations: safety_js_1.READ_ONLY,
     }, async ({ id, highQuality, channel }) => {
-        try {
-            const params = new URLSearchParams();
-            if (highQuality)
-                params.set("highQuality", "true");
-            if (channel)
-                params.set("channel", channel);
-            const query = params.toString();
-            const url = query
-                ? (0, url_js_1.safePath) `/cameras/${id}/snapshot` + `?${query}`
-                : (0, url_js_1.safePath) `/cameras/${id}/snapshot`;
-            const { data, mimeType } = await client.getBinary(url);
-            return {
-                content: [
-                    {
-                        type: "image",
-                        data: data.toString("base64"),
-                        mimeType,
-                    },
-                ],
-            };
-        }
-        catch (err) {
-            return (0, responses_js_1.formatError)(err);
-        }
+        const params = new URLSearchParams();
+        if (highQuality)
+            params.set("highQuality", "true");
+        if (channel)
+            params.set("channel", channel);
+        const query = params.toString();
+        const url = query
+            ? (0, url_js_1.safePath) `/cameras/${id}/snapshot` + `?${query}`
+            : (0, url_js_1.safePath) `/cameras/${id}/snapshot`;
+        const { data, mimeType } = await client.getBinary(url);
+        return {
+            content: [
+                {
+                    type: "image",
+                    data: data.toString("base64"),
+                    mimeType,
+                },
+            ],
+        };
     });
     server.registerTool("protect_get_rtsp_streams", {
-        description: "Get active RTSPS stream sessions for a camera. Returns the per-quality stream URLs currently published (keys typically: high, medium, low, package). Empty/missing keys mean no session is currently active at that quality — use protect_create_rtsp_stream to start one.",
-        inputSchema: { id: zod_1.z.string().describe("Camera ID") },
+        description: "Get active RTSPS stream sessions for a camera. Returns: high, medium, low, package — each an rtsps:// URL, or null (or absent) when no session is active at that quality. Use protect_create_rtsp_stream to start one. Each URL is a bearer credential for live video: do not repeat it unless the user asked for it.",
+        inputSchema: { id: (0, params_js_1.resourceId)().describe("Camera ID") },
         outputSchema: cameras_js_1.rtspStreamOutputSchema,
         annotations: safety_js_1.READ_ONLY,
     }, async ({ id }) => {
-        try {
-            const data = await client.get((0, url_js_1.safePath) `/cameras/${id}/rtsps-stream`);
-            return (0, responses_js_1.formatSuccess)(data);
-        }
-        catch (err) {
-            return (0, responses_js_1.formatError)(err);
-        }
+        const data = await client.get((0, url_js_1.safePath) `/cameras/${id}/rtsps-stream`);
+        return (0, responses_js_1.formatSuccess)(data);
     });
     // --- Write tools (skipped in read-only mode) ---
     if (readOnly)
         return;
     server.registerTool("protect_update_camera", {
-        description: "Update camera settings (partial update via PATCH)",
+        description: "Update camera settings (partial update via PATCH). Returns: the full updated camera (same fields as protect_get_camera).",
         inputSchema: {
-            id: zod_1.z.string().describe("Camera ID"),
+            id: (0, params_js_1.resourceId)().describe("Camera ID"),
             settings: zod_1.z
-                .record(zod_1.z.string(), zod_1.z.unknown())
-                .describe("Partial camera settings to update. Known fields: name (string), osdSettings (object), ledSettings (object), lcdMessage (object: type, resetAt, text), videoMode (string: \"default\" | \"highFps\" | \"sport\" | \"slowShutter\" | \"lprReflex\" | \"lprNoneReflex\"), hdrType (string: \"auto\" | \"on\" | \"off\"), micVolume (number 0-100), smartDetectSettings (object)"),
-            dryRun: zod_1.z
-                .boolean()
-                .optional()
-                .describe("If true, return what would happen without making changes"),
+                .object({
+                name: zod_1.z.string().optional().describe("Camera name"),
+                osdSettings: zod_1.z
+                    .record(zod_1.z.string(), zod_1.z.unknown())
+                    .optional()
+                    .describe("On-screen display (isNameEnabled, isDateEnabled, isLogoEnabled, isDebugEnabled, overlayLocation)"),
+                ledSettings: zod_1.z
+                    .record(zod_1.z.string(), zod_1.z.unknown())
+                    .optional()
+                    .describe("LED settings (isEnabled, welcomeLed, floodLed)"),
+                lcdMessage: zod_1.z
+                    .record(zod_1.z.string(), zod_1.z.unknown())
+                    .optional()
+                    .describe('Doorbell LCD message (type, resetAt, text), e.g. { type: "DO_NOT_DISTURB", resetAt: 0 }'),
+                micVolume: zod_1.z.number().min(0).max(100).optional().describe("Mic volume (0-100)"),
+                videoMode: zod_1.z
+                    .enum(["default", "highFps", "sport", "slowShutter", "lprReflex", "lprNoneReflex"])
+                    .optional()
+                    .describe("Video mode"),
+                hdrType: zod_1.z.enum(["auto", "on", "off"]).optional().describe("HDR mode"),
+                smartDetectSettings: zod_1.z
+                    .record(zod_1.z.string(), zod_1.z.unknown())
+                    .optional()
+                    .describe("Smart detection (objectTypes[], audioTypes[])"),
+            })
+                .loose()
+                .refine((o) => Object.keys(o).length > 0, "settings must include at least one field")
+                .describe("Partial camera settings to update"),
+            dryRun: (0, safety_js_1.dryRunInput)(),
         },
         outputSchema: cameras_js_1.cameraOutputSchema,
-        annotations: safety_js_1.WRITE,
+        annotations: safety_js_1.DESTRUCTIVE,
     }, async ({ id, settings, dryRun }) => {
-        try {
-            if (dryRun) {
-                return (0, safety_js_1.formatDryRun)("PATCH", (0, url_js_1.safePath) `/cameras/${id}`, settings);
-            }
-            const data = await client.patch((0, url_js_1.safePath) `/cameras/${id}`, settings);
-            return (0, responses_js_1.formatSuccess)(data);
-        }
-        catch (err) {
-            return (0, responses_js_1.formatError)(err);
+        if (dryRun) {
+            return (0, safety_js_1.formatDryRun)("PATCH", (0, url_js_1.safePath) `/cameras/${id}`, settings);
         }
+        const data = await client.patch((0, url_js_1.safePath) `/cameras/${id}`, settings);
+        return (0, responses_js_1.formatSuccess)(data);
     });
     server.registerTool("protect_create_rtsp_stream", {
-        description: "Create an RTSPS stream session for a camera",
+        description: "Create an RTSPS stream session for a camera. Returns: one key per requested quality (high, medium, low, package), each an rtsps:// URL. The package quality is only available on cameras with hasPackageCamera=true. Requires confirm: true: the returned URLs are bearer credentials for live video.",
         inputSchema: {
-            id: zod_1.z.string().describe("Camera ID"),
+            id: (0, params_js_1.resourceId)().describe("Camera ID"),
             qualities: zod_1.z
                 .array(zod_1.z.enum(["high", "medium", "low", "package"]))
-                .describe("Quality levels to include in the RTSPS stream"),
-            dryRun: zod_1.z
-                .boolean()
-                .optional()
-                .describe("If true, return what would happen without making changes"),
+                .min(1)
+                .describe("Quality levels to include in the RTSPS stream (at least one)"),
+            confirm: OPEN_STREAM.input,
+            dryRun: (0, safety_js_1.dryRunInput)(),
         },
         outputSchema: cameras_js_1.rtspStreamOutputSchema,
-        annotations: safety_js_1.WRITE,
-    }, async ({ id, qualities, dryRun }) => {
-        try {
-            if (dryRun) {
-                return (0, safety_js_1.formatDryRun)("POST", (0, url_js_1.safePath) `/cameras/${id}/rtsps-stream`, { qualities });
-            }
-            const data = await client.post((0, url_js_1.safePath) `/cameras/${id}/rtsps-stream`, {
-                qualities,
-            });
-            return (0, responses_js_1.formatSuccess)(data);
-        }
-        catch (err) {
-            return (0, responses_js_1.formatError)(err);
+        annotations: safety_js_1.DESTRUCTIVE,
+    }, async ({ id, qualities, confirm, dryRun }) => {
+        if (dryRun) {
+            return (0, safety_js_1.formatDryRun)("POST", (0, url_js_1.safePath) `/cameras/${id}/rtsps-stream`, { qualities });
         }
+        const denied = OPEN_STREAM.check(confirm);
+        if (denied)
+            return denied;
+        const data = await client.post((0, url_js_1.safePath) `/cameras/${id}/rtsps-stream`, {
+            qualities,
+        });
+        return (0, responses_js_1.formatSuccess)(data);
     });
     server.registerTool("protect_delete_rtsp_stream", {
         description: "Stop and delete an active RTSPS stream session for a camera",
         inputSchema: {
-            id: zod_1.z.string().describe("Camera ID"),
+            id: (0, params_js_1.resourceId)().describe("Camera ID"),
             qualities: zod_1.z
                 .array(zod_1.z.enum(["high", "medium", "low", "package"]))
-                .describe("Quality levels to remove from the RTSPS stream"),
-            dryRun: zod_1.z
-                .boolean()
-                .optional()
-                .describe("If true, return what would happen without making changes"),
+                .min(1)
+                .describe("Quality levels to remove from the RTSPS stream (at least one)"),
+            dryRun: (0, safety_js_1.dryRunInput)(),
         },
         annotations: safety_js_1.DESTRUCTIVE,
     }, async ({ id, qualities, dryRun }) => {
-        try {
-            if (dryRun) {
-                return (0, safety_js_1.formatDryRun)("DELETE", (0, url_js_1.safePath) `/cameras/${id}/rtsps-stream?qualities=${qualities.join(",")}`);
-            }
-            const data = await client.delete((0, url_js_1.safePath) `/cameras/${id}/rtsps-stream?qualities=${qualities.join(",")}`);
-            return (0, responses_js_1.formatSuccess)(data);
-        }
-        catch (err) {
-            return (0, responses_js_1.formatError)(err);
+        // Protect expects repeated keys (qualities=high&qualities=medium), not
+        // a comma-joined value — safePath would encode the comma as %2C.
+        const params = new URLSearchParams();
+        for (const quality of qualities)
+            params.append("qualities", quality);
+        const url = (0, url_js_1.safePath) `/cameras/${id}/rtsps-stream` + `?${params.toString()}`;
+        if (dryRun) {
+            return (0, safety_js_1.formatDryRun)("DELETE", url);
         }
+        const data = await client.delete(url);
+        return (0, responses_js_1.formatSuccess)(data);
     });
     server.registerTool("protect_create_talkback", {
-        description: "Create a talkback (two-way audio) session for a camera. Returns: url, codec, samplingRate, bitsPerSample (the audio config for encoding outbound audio).",
+        description: "Create a talkback (two-way audio) session for a camera. Returns: url, codec, samplingRate, bitsPerSample (the audio config for encoding outbound audio). Requires confirm: true: the session opens two-way audio to the camera, and the returned url lets anyone holding it talk through the camera.",
         inputSchema: {
-            id: zod_1.z.string().describe("Camera ID"),
-            dryRun: zod_1.z
-                .boolean()
-                .optional()
-                .describe("If true, return what would happen without making changes"),
+            id: (0, params_js_1.resourceId)().describe("Camera ID"),
+            confirm: OPEN_TALKBACK.input,
+            dryRun: (0, safety_js_1.dryRunInput)(),
         },
         outputSchema: cameras_js_1.talkbackSessionOutputSchema,
-        annotations: safety_js_1.WRITE,
-    }, async ({ id, dryRun }) => {
-        try {
-            if (dryRun) {
-                return (0, safety_js_1.formatDryRun)("POST", (0, url_js_1.safePath) `/cameras/${id}/talkback-session`);
-            }
-            const data = await client.post((0, url_js_1.safePath) `/cameras/${id}/talkback-session`);
-            return (0, responses_js_1.formatSuccess)(data);
-        }
-        catch (err) {
-            return (0, responses_js_1.formatError)(err);
+        annotations: safety_js_1.DESTRUCTIVE,
+    }, async ({ id, confirm, dryRun }) => {
+        if (dryRun) {
+            return (0, safety_js_1.formatDryRun)("POST", (0, url_js_1.safePath) `/cameras/${id}/talkback-session`);
         }
+        const denied = OPEN_TALKBACK.check(confirm);
+        if (denied)
+            return denied;
+        const data = await client.post((0, url_js_1.safePath) `/cameras/${id}/talkback-session`);
+        return (0, responses_js_1.formatSuccess)(data);
     });
     server.registerTool("protect_disable_mic", {
-        description: "IRREVERSIBLE: Permanently disable the microphone on a camera. Can only be re-enabled by factory resetting the camera.",
+        description: "IRREVERSIBLE: Permanently disable the microphone on a camera. Can only be re-enabled by factory resetting the camera. Returns: the full updated camera (same fields as protect_get_camera). Requires confirm: true.",
         inputSchema: {
-            id: zod_1.z.string().describe("Camera ID"),
-            confirm: zod_1.z
-                .literal(true)
-                .describe("Must be true to confirm this irreversible action"),
+            id: (0, params_js_1.resourceId)().describe("Camera ID"),
+            confirm: DISABLE_MIC.input,
+            dryRun: (0, safety_js_1.dryRunInput)(),
         },
+        outputSchema: cameras_js_1.cameraOutputSchema,
         annotations: safety_js_1.DESTRUCTIVE,
-    }, async ({ id, confirm }) => {
-        const denied = (0, safety_js_1.requireConfirmation)(confirm, "permanently disable the microphone");
+    }, async ({ id, confirm, dryRun }) => {
+        if (dryRun) {
+            return (0, safety_js_1.formatDryRun)("POST", (0, url_js_1.safePath) `/cameras/${id}/disable-mic-permanently`);
+        }
+        const denied = DISABLE_MIC.check(confirm);
         if (denied)
             return denied;
-        try {
-            const data = await client.post((0, url_js_1.safePath) `/cameras/${id}/disable-mic-permanently`);
-            return (0, responses_js_1.formatSuccess)(data);
-        }
-        catch (err) {
-            return (0, responses_js_1.formatError)(err);
-        }
+        const data = await client.post((0, url_js_1.safePath) `/cameras/${id}/disable-mic-permanently`);
+        return (0, responses_js_1.formatSuccess)(data);
     });
     server.registerTool("protect_start_ptz_patrol", {
         description: "Start PTZ patrol on a camera at a given slot",
         inputSchema: {
-            id: zod_1.z.string().describe("Camera ID"),
+            id: (0, params_js_1.resourceId)().describe("Camera ID"),
             slot: zod_1.z.number().int().min(0).max(4).describe("Patrol slot number (0-4)"),
-            dryRun: zod_1.z
-                .boolean()
-                .optional()
-                .describe("If true, return what would happen without making changes"),
+            dryRun: (0, safety_js_1.dryRunInput)(),
         },
         annotations: safety_js_1.WRITE,
     }, async ({ id, slot, dryRun }) => {
-        try {
-            if (dryRun) {
-                return (0, safety_js_1.formatDryRun)("POST", (0, url_js_1.safePath) `/cameras/${id}/ptz/patrol/start/${slot}`);
-            }
-            const data = await client.post((0, url_js_1.safePath) `/cameras/${id}/ptz/patrol/start/${slot}`);
-            return (0, responses_js_1.formatSuccess)(data);
-        }
-        catch (err) {
-            return (0, responses_js_1.formatError)(err);
+        if (dryRun) {
+            return (0, safety_js_1.formatDryRun)("POST", (0, url_js_1.safePath) `/cameras/${id}/ptz/patrol/start/${slot}`);
         }
+        const data = await client.post((0, url_js_1.safePath) `/cameras/${id}/ptz/patrol/start/${slot}`);
+        return (0, responses_js_1.formatSuccess)(data);
     });
     server.registerTool("protect_stop_ptz_patrol", {
         description: "Stop PTZ patrol on a camera",
         inputSchema: {
-            id: zod_1.z.string().describe("Camera ID"),
-            dryRun: zod_1.z
-                .boolean()
-                .optional()
-                .describe("If true, return what would happen without making changes"),
+            id: (0, params_js_1.resourceId)().describe("Camera ID"),
+            dryRun: (0, safety_js_1.dryRunInput)(),
         },
         annotations: safety_js_1.WRITE,
     }, async ({ id, dryRun }) => {
-        try {
-            if (dryRun) {
-                return (0, safety_js_1.formatDryRun)("POST", (0, url_js_1.safePath) `/cameras/${id}/ptz/patrol/stop`);
-            }
-            const data = await client.post((0, url_js_1.safePath) `/cameras/${id}/ptz/patrol/stop`);
-            return (0, responses_js_1.formatSuccess)(data);
-        }
-        catch (err) {
-            return (0, responses_js_1.formatError)(err);
+        if (dryRun) {
+            return (0, safety_js_1.formatDryRun)("POST", (0, url_js_1.safePath) `/cameras/${id}/ptz/patrol/stop`);
         }
+        const data = await client.post((0, url_js_1.safePath) `/cameras/${id}/ptz/patrol/stop`);
+        return (0, responses_js_1.formatSuccess)(data);
     });
     server.registerTool("protect_goto_ptz_preset", {
         description: "Move camera PTZ to a preset position",
         inputSchema: {
-            id: zod_1.z.string().describe("Camera ID"),
-            slot: zod_1.z.number().int().min(-1).max(4).describe("PTZ preset slot number (0-4, or -1 for home position)"),
-            dryRun: zod_1.z
-                .boolean()
-                .optional()
-                .describe("If true, return what would happen without making changes"),
+            id: (0, params_js_1.resourceId)().describe("Camera ID"),
+            slot: zod_1.z
+                .number()
+                .int()
+                .min(-1)
+                .describe("PTZ preset slot: -1 for the home position, 0 or higher for saved presets"),
+            dryRun: (0, safety_js_1.dryRunInput)(),
         },
         annotations: safety_js_1.WRITE,
     }, async ({ id, slot, dryRun }) => {
-        try {
-            if (dryRun) {
-                return (0, safety_js_1.formatDryRun)("POST", (0, url_js_1.safePath) `/cameras/${id}/ptz/goto/${slot}`);
-            }
-            const data = await client.post((0, url_js_1.safePath) `/cameras/${id}/ptz/goto/${slot}`);
-            return (0, responses_js_1.formatSuccess)(data);
-        }
-        catch (err) {
-            return (0, responses_js_1.formatError)(err);
+        if (dryRun) {
+            return (0, safety_js_1.formatDryRun)("POST", (0, url_js_1.safePath) `/cameras/${id}/ptz/goto/${slot}`);
         }
+        const data = await client.post((0, url_js_1.safePath) `/cameras/${id}/ptz/goto/${slot}`);
+        return (0, responses_js_1.formatSuccess)(data);
     });
 }

package/dist/tools/device-actions.d.ts

@@ -1,3 +1,3 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ToolRegistrar } from "./registrar.js";
 import { ProtectClient } from "../client.js";
-export declare function registerDeviceActionTools(server: McpServer, client: ProtectClient, readOnly: boolean): void;
+export declare function registerDeviceActionTools(server: ToolRegistrar, client: ProtectClient, readOnly: boolean): void;