obsbot-mcp 0.6.3 → 0.8.0

package/dist/tail2/snapshot.js

@@ -0,0 +1,157 @@
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+export class SrtNotEnabledError extends Error {
+    constructor() {
+        super("the Tail 2's SRT output is not enabled. In OBSBOT Center switch the " +
+            "camera's streaming output to SRT (listener mode) first — note this " +
+            "disables NDI while active and does not survive a camera reboot. The " +
+            "listener serves immediately once enabled.");
+        this.name = "SrtNotEnabledError";
+    }
+}
+const JPEG_SOI = 0xffd8;
+/** Parse width/height out of a JPEG's SOF0/SOF2 marker (avoids a second ffprobe). */
+const jpegDims = (buf) => {
+    let i = 2;
+    while (i + 9 < buf.length) {
+        if (buf[i] !== 0xff) {
+            i++;
+            continue;
+        }
+        const marker = buf[i + 1];
+        if (marker === 0xd8 || (marker >= 0xd0 && marker <= 0xd9)) {
+            i += 2;
+            continue;
+        }
+        const len = buf.readUInt16BE(i + 2);
+        if (marker === 0xc0 || marker === 0xc2) {
+            return { height: buf.readUInt16BE(i + 5), width: buf.readUInt16BE(i + 7) };
+        }
+        i += 2 + len;
+    }
+    return null;
+};
+export async function srtSnapshot(host, opts = {}, spawnImpl = spawn) {
+    const maxDim = Math.round(opts.maxDim ?? 640);
+    const quality = Math.round(opts.quality ?? 80);
+    const port = opts.port ?? 5000;
+    const streamId = opts.streamId ?? "mainstream";
+    const timeoutMs = opts.timeoutMs ?? 20000;
+    const url = `srt://${host}:${port}?mode=caller&latency=120&streamid=${streamId}`;
+    const args = [
+        "-hide_banner", "-loglevel", "error",
+        "-rw_timeout", String(timeoutMs * 1000),
+        "-i", url,
+        "-frames:v", "1",
+        "-vf", `scale='min(${maxDim},iw)':-2`,
+        "-q:v", String(Math.max(2, Math.min(31, Math.round(31 - (quality * 29) / 100)))),
+        "-f", "image2", "-",
+    ];
+    return new Promise((resolve, reject) => {
+        const child = spawnImpl("ffmpeg", args, { stdio: ["ignore", "pipe", "pipe"] });
+        const chunks = [];
+        let stderr = "";
+        const timer = setTimeout(() => {
+            child.kill();
+            reject(new Error(`SRT snapshot timed out after ${timeoutMs + 5000}ms — SRT is likely off or mid-configuration in Center (settings changes require the output to be off). Re-enable it and retry.`));
+        }, timeoutMs + 5000);
+        child.stdout?.on("data", (c) => chunks.push(c));
+        child.stderr?.on("data", (c) => (stderr += c.toString()));
+        child.on("error", (e) => {
+            clearTimeout(timer);
+            reject(new Error(`ffmpeg is required for Tail 2 snapshots and failed to run: ${e.message}. Install it (winget install Gyan.FFmpeg) and retry.`));
+        });
+        child.on("close", (code) => {
+            clearTimeout(timer);
+            const jpg = Buffer.concat(chunks);
+            if (code !== 0 || jpg.length < 4 || jpg.readUInt16BE(0) !== JPEG_SOI) {
+                reject(new Error(`SRT snapshot failed (ffmpeg exit ${code}): ${stderr.slice(0, 300) || "no frame"}`));
+                return;
+            }
+            const dims = jpegDims(jpg);
+            resolve({
+                mime: "image/jpeg",
+                width: dims?.width ?? 0,
+                height: dims?.height ?? 0,
+                base64: jpg.toString("base64"),
+            });
+        });
+    });
+}
+/**
+ * Grab a frame from the NDI Tools "NDI Webcam" DirectShow device (Windows
+ * only). NOT used by the snapshot tool automatically: on the reference
+ * machine (2026-09-26) the bridge's user-configured output slots delivered
+ * uniformly black frames to ffmpeg (YAVG=YMAX=16) while other slots hung,
+ * and probing the devices disrupts the app. Kept for manual/verified use —
+ * if a slot is confirmed live (e.g. previews correctly in OBS), this works.
+ * Never force-kill the Webcam app: that corrupts its output-slot config.
+ */
+export async function ndiWebcamSnapshot(opts = {}, spawnImpl = spawn) {
+    if (process.platform !== "win32")
+        return null;
+    // The virtual devices stay registered even when the bridge app is closed
+    // (and list four slots whose signal-bearing one varies across restarts —
+    // measured 2026-09-26), so without the app running an attempt is just a
+    // guaranteed hang. Guard on the process first.
+    const running = await new Promise((resolve) => {
+        const child = spawnImpl("tasklist", ["/FI", "IMAGENAME eq Webcam.exe", "/NH"], { stdio: ["ignore", "pipe", "ignore"] });
+        let out = "";
+        const timer = setTimeout(() => { child.kill(); resolve(false); }, 5000);
+        child.stdout?.on("data", (c) => (out += c.toString()));
+        child.on("error", () => { clearTimeout(timer); resolve(false); });
+        child.on("close", () => { clearTimeout(timer); resolve(/webcam\.exe/i.test(out)); });
+    });
+    if (!running)
+        return null;
+    const maxDim = Math.round(opts.maxDim ?? 640);
+    const quality = Math.round(opts.quality ?? 80);
+    const timeoutMs = opts.timeoutMs ?? 15000;
+    // Enumerate DirectShow video devices; find the NDI Webcam bridge.
+    const listed = await new Promise((resolve) => {
+        let out = "";
+        const child = spawnImpl("ffmpeg", ["-hide_banner", "-list_devices", "true", "-f", "dshow", "-i", "dummy"], { stdio: ["ignore", "ignore", "pipe"] });
+        const timer = setTimeout(() => { child.kill(); resolve(""); }, 10000);
+        child.stderr?.on("data", (c) => (out += c.toString()));
+        child.on("error", () => { clearTimeout(timer); resolve(""); });
+        child.on("close", () => { clearTimeout(timer); resolve(out); });
+    });
+    const m = /"([^"]*NDI Webcam[^"]*)"/i.exec(listed);
+    if (!m)
+        return null;
+    const device = m[1];
+    return new Promise((resolve) => {
+        const child = spawnImpl("ffmpeg", [
+            "-hide_banner", "-loglevel", "error",
+            "-rtbufsize", "100M",
+            "-f", "dshow", "-i", `video=${device}`,
+            "-frames:v", "1",
+            "-vf", `scale='min(${maxDim},iw)':-2`,
+            "-q:v", String(Math.max(2, Math.min(31, Math.round(31 - (quality * 29) / 100)))),
+            "-f", "image2", "-",
+        ], { stdio: ["ignore", "pipe", "pipe"] });
+        const chunks = [];
+        const timer = setTimeout(() => { child.kill(); resolve(null); }, timeoutMs);
+        child.stdout?.on("data", (c) => chunks.push(c));
+        child.on("error", () => { clearTimeout(timer); resolve(null); });
+        child.on("close", () => {
+            clearTimeout(timer);
+            const jpg = Buffer.concat(chunks);
+            if (jpg.length < 4 || jpg.readUInt16BE(0) !== JPEG_SOI) {
+                resolve(null);
+                return;
+            }
+            const dims = jpegDims(jpg);
+            resolve({
+                mime: "image/jpeg",
+                width: dims?.width ?? 0,
+                height: dims?.height ?? 0,
+                base64: jpg.toString("base64"),
+            });
+        });
+    });
+}
+/** Standard NDI Tools install location, for the options report. */
+export const NDI_WEBCAM_EXE = "C:\\Program Files\\NDI\\NDI 6 Tools\\Webcam\\Webcam.exe";
+export const ndiToolsInstalled = () => existsSync(NDI_WEBCAM_EXE);
+//# sourceMappingURL=snapshot.js.map

package/dist/tail2/snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../src/tail2/snapshot.ts"],"names":[],"mappings":"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"}

package/dist/tail2/tools.d.ts

@@ -0,0 +1,7 @@
+import type { ToolDef } from "../mcp/tools.js";
+import type { Tail2Registry } from "./registry.js";
+import { type SrtSnapshot } from "./snapshot.js";
+export declare function createTail2Tools(registry: Tail2Registry, grab?: (host: string, o: {
+    maxDim: number;
+    quality: number;
+}) => Promise<SrtSnapshot>): ToolDef[];

package/dist/tail2/tools.js

@@ -0,0 +1,370 @@
+import { z } from "zod";
+import { srtSnapshot, ndiToolsInstalled } from "./snapshot.js";
+/**
+ * MCP tools for the OBSBOT Tail 2 (network camera — HTTP/WS control; its USB
+ * UVC mode is not used here, see TAIL2-PROTOCOL.md §11). A separate tool family from the Tiny 2's:
+ * the two cameras share semantics but not transports, and pretending otherwise
+ * would make every schema a lie somewhere. Where a tool mirrors a Tiny 2 tool
+ * (zoom, recenter, ai tracking) the semantics match on purpose; where the
+ * Tail 2 has no Tiny 2 counterpart (portrait rotation, roll bias) the tool is
+ * new.
+ *
+ * The `camera` selector here is a MAC address, device_name, or host — unlike
+ * the Tiny 2's serial-number selector. Omitted with exactly one Tail 2
+ * registered resolves to it; omitted with none tells the caller how to add
+ * one; omitted with several names them all.
+ */
+// Same defensive coercions as the Tiny 2 tools (see src/mcp/tools.ts): some
+// MCP clients serialize numbers/booleans as strings, and z.coerce.boolean()
+// would map "false" to true.
+const num = () => z.preprocess((v) => (typeof v === "string" && v.trim() !== "" && !Number.isNaN(Number(v)) ? Number(v) : v), z.number());
+const bool = () => z.preprocess((v) => (v === "true" ? true : v === "false" ? false : v), z.boolean());
+const withCamera = (shape) => z.object({ ...shape, camera: z.string().optional() });
+/**
+ * Bundle-verified enums from the camera's own web app (TAIL2-PROTOCOL.md §3).
+ * `none` is excluded from the tool's mode list — it is what `enabled:false`
+ * sends, and advertising it alongside `enabled` would make two ways to say
+ * the same thing, one of which is always wrong.
+ */
+const TAIL2_AI_MODES = [
+    "humanTrackingSingleMode",
+    "humanTrackingGroupMode",
+    "animalTrackingNormal",
+    "animalTrackingCloseUp",
+    "objectTracking",
+    "objectTrackingNormal",
+    "objectTrackingCloseUp",
+];
+const TAIL2_TRACK_SPEEDS = ["superLazy", "lazy", "slow", "fast", "crazy", "customized"];
+const devicesSchema = z.object({});
+const scanSchema = z.object({});
+const statusSchema = withCamera({});
+const infoSchema = withCamera({});
+const zoomSchema = withCamera({
+    ratio: num().pipe(z.number().min(1.0).max(12.0)),
+    speed: num().pipe(z.number().int().min(1).max(10)).default(5),
+});
+const recenterSchema = withCamera({});
+const portraitSchema = withCamera({ enable: bool() });
+const rollBiasSchema = withCamera({ angle: num().pipe(z.number().min(-90).max(90)) });
+const aiTrackSchema = withCamera({
+    enabled: bool(),
+    mode: z.enum(TAIL2_AI_MODES).default("humanTrackingSingleMode"),
+});
+const trackSpeedSchema = withCamera({ speed: z.enum(TAIL2_TRACK_SPEEDS) });
+// Preset slots: the Tail 2's API is 0-based (ids 0–2) but the tools expose
+// 1-based slots (1|2|3) to match the Tiny 2's preset tools, so a caller's
+// mental model carries across both cameras.
+const slotSchema = num().pipe(z.number().int().min(1).max(3));
+const presetListSchema = withCamera({});
+const presetSaveSchema = withCamera({ slot: slotSchema, name: z.string().max(40).optional() });
+const presetSlotSchema = withCamera({ slot: slotSchema });
+const presetRenameSchema = withCamera({ slot: slotSchema, name: z.string().max(40) });
+const snapshotSchema = withCamera({
+    resolution: num().pipe(z.number().int().min(256).max(1920)).default(640),
+    quality: num().pipe(z.number().int().min(1).max(100)).default(80),
+});
+const PRESET_SHAPE_NOTE = `unlike the Tiny 2, save OVERWRITES an occupied slot (no create-once), and ` +
+    `there is no explicit-pose write in this API at all — a slot always captures ` +
+    `the camera's CURRENT pose (measured 2026-09-26; TAIL2-PROTOCOL.md §3)`;
+const SETTLED_NOTE = `settled:false means the command was sent and acknowledged but the readback ` +
+    `had not caught up within the polling budget — the camera moves slower than ` +
+    `it acknowledges. Retry the read (or the command) rather than assuming failure.`;
+export function createTail2Tools(registry, grab = (host, o) => srtSnapshot(host, o)) {
+    return [
+        {
+            name: "obsbot_tail2_devices",
+            description: "List registered OBSBOT Tail 2 cameras (network cameras; MAC-keyed). Each entry: " +
+                "mac (the identity — pass it as `camera` to any obsbot_tail2_* tool), name, and the " +
+                "host(s) it has answered on. Registration is not liveness: an offline camera still " +
+                "appears here; use obsbot_tail2_status to check one is reachable.",
+            schema: devicesSchema,
+            handler: async () => ({
+                cameras: registry.list().map((e) => ({ mac: e.mac, name: e.name, hosts: e.hosts })),
+            }),
+        },
+        {
+            name: "obsbot_tail2_scan",
+            description: "Discover OBSBOT Tail 2 cameras on the network and register them. Listens for the " +
+                "camera's own mDNS announcements (~5s — it multicasts its MAC, name and IPs every " +
+                "few seconds, the same channel OBSBOT Center discovers by) and falls back to an HTTP " +
+                "subnet sweep only when nothing was heard (multicast-filtered networks; ~20s on a " +
+                "full /24). Returns the cameras found; they stay registered afterwards. Run this " +
+                "once to onboard a Tail 2 whose IP you don't know.",
+            schema: scanSchema,
+            handler: async () => {
+                const found = await registry.scan();
+                return {
+                    found: found.map((e) => ({ mac: e.mac, name: e.name, hosts: e.hosts })),
+                    registered: registry.list().length,
+                };
+            },
+        },
+        {
+            name: "obsbot_tail2_status",
+            description: "Read a Tail 2's full live status block (one WebSocket push): power, recording, " +
+                "portrait rotation, AI mode + tracking settings, zoom ratio, roll bias, focus modes, " +
+                "NDI/RTSP/SRT/RTMP enablement, SD card, preset list with poses (degrees + zoom " +
+                "ratio), and per-subsystem health (gimbal/AI/battery/lens/ToF). NOTE: no live " +
+                "yaw/pitch — the Tail 2 reports pose only via saved presets, so gimbal moves are " +
+                "open-loop (same limitation as the Tiny 2 on Linux).",
+            schema: statusSchema,
+            handler: async (args) => {
+                const { camera } = statusSchema.parse(args);
+                const { api } = await registry.resolve(camera);
+                return { camera: (await api.info()).mac, ...(await api.status()) };
+            },
+        },
+        {
+            name: "obsbot_tail2_info",
+            description: "Read a Tail 2's identity and static configuration in one call: device_info (name, " +
+                "MAC, wired/wireless IPs), range (zoom 1.0–12.0, focus 1–100, exposure, white " +
+                "balance 2000–10000K, image adjust ranges), and networkconfig (NDI/stream encoder " +
+                "settings). Read-only.",
+            schema: infoSchema,
+            handler: async (args) => {
+                const { camera } = infoSchema.parse(args);
+                const { api } = await registry.resolve(camera);
+                return {
+                    device: await api.info(),
+                    ranges: await api.ranges(),
+                    network: await api.networkConfig(),
+                };
+            },
+        },
+        {
+            name: "obsbot_tail2_zoom",
+            description: "Set absolute zoom ratio on a Tail 2 (1.0–12.0 — twelve x, six times the Tiny 2's " +
+                "range; scale is the camera's own ratio, not a magnification multiple). speed 1–10 " +
+                "is REQUIRED by the firmware and defaults to 5. Zoom ramps mechanically; the tool " +
+                "polls the readback and returns settled:false if it hadn't arrived within ~5s — the " +
+                "command was still sent. Hardware-verified 2026-09-26.",
+            schema: zoomSchema,
+            handler: async (args) => {
+                const { ratio, speed, camera } = zoomSchema.parse(args);
+                const { api } = await registry.resolve(camera);
+                const r = await api.zoomSet(ratio, speed);
+                return { ok: true, ratio: r.ratio, settled: r.settled, note: SETTLED_NOTE };
+            },
+        },
+        {
+            name: "obsbot_tail2_recenter",
+            description: "Recenter a Tail 2's gimbal (yaw 0 / pitch 0 / roll 0). Returns as soon as the " +
+                "command is acknowledged — the Tail 2 exposes no live pose to verify arrival " +
+                "against (open-loop, like the Tiny 2 on Linux), and note that commanding a reset " +
+                "can drop AI tracking to none (observed once 2026-09-26; re-enable with " +
+                "obsbot_tail2_ai_track if that matters). Hardware-verified 2026-09-26.",
+            schema: recenterSchema,
+            handler: async (args) => {
+                const { camera } = recenterSchema.parse(args);
+                const { api } = await registry.resolve(camera);
+                await api.recenter();
+                return { ok: true };
+            },
+        },
+        {
+            name: "obsbot_tail2_portrait",
+            description: "Rotate a Tail 2's barrel 90° for portrait framing (enable) or back to landscape " +
+                "(disable) — a motorized physical rotation no Tiny 2 has. Takes ~1.5s; the tool " +
+                "polls the status push for the new orientation and returns settled:false if the " +
+                "motor hadn't finished within ~5s. MEASURED 2026-09-26: while the motor is in " +
+                "motion the camera can acknowledge a write and silently drop it — if settled stays " +
+                "false, retry the command. Hardware-verified both directions.",
+            schema: portraitSchema,
+            handler: async (args) => {
+                const { enable, camera } = portraitSchema.parse(args);
+                const { api } = await registry.resolve(camera);
+                const r = await api.portraitSet(enable);
+                return { ok: true, portrait: r.switch_portrait, settled: r.settled, note: SETTLED_NOTE };
+            },
+        },
+        {
+            name: "obsbot_tail2_roll_bias",
+            description: "Set a Tail 2's roll trim angle in degrees (horizon correction / deliberate tilt), " +
+                "clamped to ±90. Unlike the Tiny 2 (whose roll slot is inert), this moves the " +
+                "image. Verified write+readback on hardware 2026-09-26.",
+            schema: rollBiasSchema,
+            handler: async (args) => {
+                const { angle, camera } = rollBiasSchema.parse(args);
+                const { api } = await registry.resolve(camera);
+                const r = await api.rollBiasSet(angle);
+                return { ok: true, angle: r.angle, settled: r.settled };
+            },
+        },
+        {
+            name: "obsbot_tail2_ai_track",
+            description: "Enable or disable a Tail 2's AI tracking. enabled:false stops tracking (mode `none`). " +
+                "enabled:true starts the chosen mode — default humanTrackingSingleMode (single-person " +
+                "framing, the camera's power-on default); also group human framing, animal tracking, " +
+                "and object tracking (the mode strings are the camera's own enum). NOTE: while " +
+                "tracking is active it owns the gimbal — manual moves fight it, and a recenter can " +
+                "drop tracking to none. Mode strings verified against firmware 7.2.13.1.",
+            schema: aiTrackSchema,
+            handler: async (args) => {
+                const { enabled, mode, camera } = aiTrackSchema.parse(args);
+                const { api } = await registry.resolve(camera);
+                const r = await api.aiModeSet(enabled ? mode : "none");
+                return {
+                    ok: true,
+                    mode: r.mode,
+                    settled: r.settled,
+                    ...(r.settled ? {} : { note: SETTLED_NOTE }),
+                };
+            },
+        },
+        {
+            name: "obsbot_tail2_track_speed",
+            description: "Set a Tail 2's tracking follow speed: superLazy | lazy | slow | fast | crazy | " +
+                "customized — the camera's own six-speed enum (NOT the Tiny 2's standard/sport " +
+                "pair). Verified by readback on hardware 2026-09-26.",
+            schema: trackSpeedSchema,
+            handler: async (args) => {
+                const { speed, camera } = trackSpeedSchema.parse(args);
+                const { api } = await registry.resolve(camera);
+                const r = await api.trackSpeedSet(speed);
+                return { ok: true, speed: r.speed, settled: r.settled };
+            },
+        },
+        {
+            name: "obsbot_tail2_preset_list",
+            description: "List a Tail 2's three preset slots: occupied/empty, decoded name, and pose in " +
+                "degrees + zoom ratio (pitch/yaw/roll/ratio). Slot numbers are 1–3 (the camera's " +
+                "own ids are 0-based; mapped for consistency with the Tiny 2 preset tools).",
+            schema: presetListSchema,
+            handler: async (args) => {
+                const { camera } = presetListSchema.parse(args);
+                const { api } = await registry.resolve(camera);
+                const presets = await api.presetsGet();
+                return {
+                    slots: [0, 1, 2].map((id) => {
+                        const p = presets.find((x) => x.id === id);
+                        return p
+                            ? { slot: id + 1, occupied: true, name: p.name, pose: { yaw: p.yaw, pitch: p.pitch, roll: p.roll, ratio: p.ratio } }
+                            : { slot: id + 1, occupied: false, name: null, pose: null };
+                    }),
+                };
+            },
+        },
+        {
+            name: "obsbot_tail2_preset_save",
+            description: "Save a Tail 2's CURRENT live pose into a slot (1–3): aim the camera first (via " +
+                "tracking, a recall, or physically), then save. name defaults to P1/P2/P3. NOTE: " +
+                PRESET_SHAPE_NOTE +
+                " — deleting first is unnecessary. Hardware-verified 2026-09-26.",
+            schema: presetSaveSchema,
+            handler: async (args) => {
+                const { slot, name, camera } = presetSaveSchema.parse(args);
+                const { api } = await registry.resolve(camera);
+                const r = await api.presetSave(slot - 1, name ?? `P${slot}`);
+                return { ok: true, slot, settled: r.settled, presets: r.presets };
+            },
+        },
+        {
+            name: "obsbot_tail2_preset_recall",
+            description: "Recall a Tail 2 preset slot (1–3): drives the gimbal and zoom to the saved pose. " +
+                "Refuses an empty slot. Arrival is verified through the only live observable — the " +
+                "zoom ratio from the status push — so gimbal axes are open-loop (the Tail 2 reports " +
+                "no live pose). Disable AI tracking first or it will fight the move. " +
+                "Hardware-verified 2026-09-26 (zoom 1.5 → saved 3.0 observed).",
+            schema: presetSlotSchema,
+            handler: async (args) => {
+                const { slot, camera } = presetSlotSchema.parse(args);
+                const { api } = await registry.resolve(camera);
+                const r = await api.presetRecall(slot - 1);
+                return { ok: true, slot, settled: r.settled, zoom: r.zoom };
+            },
+        },
+        {
+            name: "obsbot_tail2_preset_delete",
+            description: "Delete a Tail 2 preset slot (1–3), freeing it. Verified by the slot disappearing " +
+                "from the list.",
+            schema: presetSlotSchema,
+            handler: async (args) => {
+                const { slot, camera } = presetSlotSchema.parse(args);
+                const { api } = await registry.resolve(camera);
+                const r = await api.presetDelete(slot - 1);
+                return { ok: true, slot, settled: r.settled };
+            },
+        },
+        {
+            name: "obsbot_tail2_preset_rename",
+            description: "Rename a Tail 2 preset slot (1–3). Names travel base64 on the wire; the tool " +
+                "encodes/decodes transparently (up to 40 chars).",
+            schema: presetRenameSchema,
+            handler: async (args) => {
+                const { slot, name, camera } = presetRenameSchema.parse(args);
+                const { api } = await registry.resolve(camera);
+                const r = await api.presetRename(slot - 1, name);
+                return { ok: true, slot, settled: r.settled };
+            },
+        },
+        {
+            name: "obsbot_tail2_snapshot",
+            description: "Grab one still frame from a Tail 2 and return it as an image (for framing/lighting " +
+                "checks — and for measuring pixels). Source: the camera's SRT output via ffmpeg SRT " +
+                "caller (port 5000) — requires SRT listener mode in OBSBOT Center; exclusive with NDI, " +
+                "cleared by reboots, and Center only allows changing streaming settings while the output " +
+                "is off. Serves immediately once on. If SRT is off, returns a report of what it found " +
+                "with the available options and their costs (SRT toggle, NDI Webcam bridge caveats, " +
+                "NDI Tools install) so you can pick the cheapest path instead of dead-ending. " +
+                "resolution is the longest edge (256–1920, default 640); quality 1–100 (default 80). " +
+                "Needs ffmpeg. Frames are 16:9 1080p-sourced.",
+            schema: snapshotSchema,
+            handler: async (args) => {
+                const { resolution, quality, camera } = snapshotSchema.parse(args);
+                const entry = await registry.resolve(camera);
+                const status = await entry.api.status();
+                if (status.srt?.enable === true) {
+                    const host = entry.hosts[0];
+                    const snap = await grab(host, { maxDim: resolution, quality });
+                    return {
+                        content: [
+                            { type: "image", data: snap.base64, mimeType: snap.mime },
+                            {
+                                type: "text",
+                                text: JSON.stringify({ width: snap.width, height: snap.height, source: "srt" }),
+                            },
+                        ],
+                    };
+                }
+                // SRT off. The NDI Webcam bridge is deliberately NOT attempted
+                // automatically: on the reference machine (2026-09-26) its configured
+                // output slots delivered uniformly black frames to ffmpeg while other
+                // slots hung — an auto-grab would either stall or return a confident
+                // black image. Probing the slots also disrupts the bridge app. Report
+                // options instead; SRT remains the autonomous path.
+                const ndiOn = status.ndi?.enable === true;
+                const tools = ndiToolsInstalled();
+                const lines = [
+                    `No video source is currently grabbable from this Tail 2 (SRT off${ndiOn ? ", NDI on" : ", NDI off"}).`,
+                    "",
+                    "Options:",
+                    `1. Enable SRT listener mode in OBSBOT Center for this camera (streaming settings; the toggle ` +
+                        `disables NDI while active and is cleared by a camera reboot). Serves immediately once on — ` +
+                        `this tool then grabs autonomously. Recommended for agent-driven use.`,
+                    ...(tools
+                        ? [
+                            `2. NDI Webcam bridge (NDI Tools is installed): with NDI on and the bridge running, ` +
+                                `its 'NDI Webcam' DirectShow output can be read with ffmpeg. NOT attempted automatically: ` +
+                                `on the reference machine the configured slots delivered black frames and probing the ` +
+                                `app's devices disrupts it. If you verify a slot carries live video (e.g. OBS can preview ` +
+                                `it), this becomes a no-camera-changes source — but treat it as unverified until then.`,
+                            `   WARNING: never force-kill the Webcam app (taskkill /f) — that corrupts its output-slot ` +
+                                `configuration; close it through its own UI.`,
+                        ]
+                        : []),
+                    `3. Install NDI Tools (https://ndi.video/tools/) for option 2, or an NDI-capable ffmpeg build.`,
+                ];
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: lines.join("\n"),
+                        },
+                    ],
+                };
+            },
+        },
+    ];
+}
+//# sourceMappingURL=tools.js.map

package/dist/tail2/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/tail2/tools.ts"],"names":[],"mappings":"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"}

package/dist/transport/helper-process.d.ts

@@ -60,6 +60,17 @@ export declare class HelperProcess {
         value: number;
         flags: number;
     }>;
+    /**
+     * Time repeated GET_CUR reads of a camera control, in the helper (C), so the
+     * ~150us cache-vs-live signal is not buried by this JSON-RPC round trip. Used
+     * by LinuxTransport.livePoseReads to detect a live-reading kernel without
+     * moving the gimbal. Reads only.
+     */
+    readLatency(property: number, samples?: number): Promise<{
+        meanUs: number;
+        minUs: number;
+        maxUs: number;
+    }>;
     procAmpSet(property: number, value: number, flags: number): Promise<void>;
     procAmpRange(property: number): Promise<{
         min: number;

package/dist/transport/helper-process.js

@@ -276,6 +276,16 @@ export class HelperProcess {
         const resp = await this.rpc({ op: "camctrl_get", property });
         return { value: resp.value, flags: resp.flags };
     }
+    /**
+     * Time repeated GET_CUR reads of a camera control, in the helper (C), so the
+     * ~150us cache-vs-live signal is not buried by this JSON-RPC round trip. Used
+     * by LinuxTransport.livePoseReads to detect a live-reading kernel without
+     * moving the gimbal. Reads only.
+     */
+    async readLatency(property, samples = 40) {
+        const resp = await this.rpc({ op: "read_latency", property, samples });
+        return { meanUs: resp.meanUs, minUs: resp.minUs, maxUs: resp.maxUs };
+    }
     async procAmpSet(property, value, flags) {
         await this.rpc({ op: "procamp_set", property, value, flags });
     }