obsbot-mcp 0.7.0 → 0.8.0

package/dist/tail2/api.d.ts

@@ -0,0 +1,218 @@
+/**
+ * HTTP/WS client for the OBSBOT Tail 2 control API.
+ *
+ * The Tail 2's network control plane is a lighttpd REST API plus a WebSocket
+ * status push (see TAIL2-PROTOCOL.md). Its USB-C UVC mode has a control
+ * surface of its own (§11) that this client does not use.
+ * Everything here is plain HTTP and therefore platform-independent: the same
+ * code runs on Windows, Linux and macOS with no native helper, which is the
+ * whole reason this module exists as a separate family from the Tiny 2's
+ * helper-process transports.
+ *
+ * Identity is the camera's MAC (what OBSBOT Center keys on); device_name and
+ * any of its IPs are accepted as selectors one level up, in the registry.
+ */
+/** `GET /camera/sdk/device_info` — the probe target and identity source. */
+export interface Tail2DeviceInfo {
+    device_name: string;
+    wired_ip: string;
+    wireless_ip: string;
+    mac: string;
+}
+/**
+ * One push from `ws://<host>/ws/`. The camera sends the FULL status block
+ * ~1 Hz with no subscription message. Fields the tools rely on are typed;
+ * the block carries more (and firmware may add some) — unknown fields pass
+ * through untouched via the index signature.
+ *
+ * MEASURED 2026-09-26 against firmware 7.2.13.1; see TAIL2-PROTOCOL.md §4.
+ */
+export interface Tail2Status {
+    [key: string]: unknown;
+    power_on?: boolean;
+    usb_mode?: number;
+    rec?: boolean;
+    rec_time?: number;
+    switch_portrait?: boolean;
+    ai_mode?: string;
+    zoom_ratio?: number;
+    roll_bias?: number;
+    focus_mode?: string;
+    auto_focus_mode?: string;
+    ndi?: {
+        enable?: boolean;
+    };
+    rtsp?: {
+        enable?: boolean;
+    };
+    srt?: {
+        enable?: boolean;
+    };
+    rtmp?: {
+        enable?: boolean;
+    };
+    preset_info?: Array<{
+        id: number;
+        pitch: number;
+        yaw: number;
+        roll: number;
+        ratio: number;
+        name: string;
+    }>;
+    device_status?: Record<string, unknown>;
+}
+/** A saved gimbal pose: degrees + zoom ratio. Names are base64 on the wire only. */
+export interface Preset {
+    id: number;
+    pitch: number;
+    yaw: number;
+    roll: number;
+    ratio: number;
+    name: string;
+}
+export declare class Tail2HttpError extends Error {
+    readonly status: number;
+    readonly path: string;
+    readonly body: string;
+    constructor(status: number, path: string, body: string);
+}
+/**
+ * `{"code":200,"err_idx":0}` means ACKNOWLEDGED, not applied — MEASURED
+ * 2026-09-26: a rollbias write returned 200 while the portrait motor was in
+ * motion and never landed (TAIL2-PROTOCOL.md §8.1). This is the same failure
+ * class as the Tiny 2's post-replug vendor mailbox, so every setter here
+ * verifies by readback before reporting success, with a bounded retry ladder
+ * sized for the actuator involved (the zoom motor and the portrait rotation
+ * take seconds, not milliseconds).
+ */
+export interface VerifyOpts {
+    attempts?: number;
+    delayMs?: number;
+}
+export declare class Tail2Api {
+    readonly baseUrl: string;
+    private readonly timeoutMs;
+    private readonly wsUrl;
+    constructor(opts: {
+        baseUrl: string;
+        timeoutMs?: number;
+    });
+    private req;
+    private send;
+    /**
+     * Read `read()` until `match()` holds, on a bounded ladder. Returns
+     * `settled:false` (NOT a throw) when the ladder runs out — the command was
+     * sent and acknowledged, so the caller decides whether that is failure.
+     * Mirrors `obsbot_zoom_uvc`'s `settled` contract.
+     */
+    verified<T>(read: () => Promise<T>, match: (v: T) => boolean, opts?: VerifyOpts): Promise<{
+        settled: boolean;
+        value: T;
+    }>;
+    info(): Promise<Tail2DeviceInfo>;
+    /** One-shot status: connect, take the first push, close. No persistent socket. */
+    status(): Promise<Tail2Status>;
+    ranges(): Promise<Record<string, unknown>>;
+    networkConfig(): Promise<Record<string, unknown>>;
+    imageState(): Promise<Record<string, unknown>>;
+    zoomGet(): Promise<{
+        ratio: number;
+    }>;
+    /**
+     * Absolute zoom ratio on the Tail 2's own 1.0–12.0 scale (`GET range`).
+     * `speed` is REQUIRED by the firmware (a ratio-only PUT is a 400) — both
+     * fields MEASURED 2026-09-26.
+     */
+    zoomSet(ratio: number, speed: number, verify?: VerifyOpts): Promise<{
+        settled: boolean;
+        ratio: number;
+    }>;
+    /** Gimbal recenter (`POST ptz/reset`). Open-loop: the Tail 2 reports no live pose. */
+    recenter(): Promise<void>;
+    /**
+     * Motorized 90° barrel rotation. Verified against the WS push rather than a
+     * REST readback (none exists) — and the readback MUST be tolerant of the
+     * motor taking ~1.5s, plus the swallowed-write hazard during motion.
+     */
+    portraitSet(enable: boolean, verify?: VerifyOpts): Promise<{
+        settled: boolean;
+        switch_portrait: boolean;
+    }>;
+    rollBiasGet(): Promise<{
+        angle: number;
+    }>;
+    /** Roll trim in degrees. MEASURED write + readback 2026-09-26. */
+    rollBiasSet(angle: number, verify?: VerifyOpts): Promise<{
+        settled: boolean;
+        angle: number;
+    }>;
+    aiModeGet(): Promise<{
+        mode: string;
+    }>;
+    /**
+     * `mode` strings are the camera's own enum (bundle-verified, TAIL2-PROTOCOL
+     * §3): none | humanTrackingSingleMode | humanTrackingGroupMode |
+     * animalTrackingNormal | animalTrackingCloseUp | objectTracking |
+     * objectTrackingNormal | objectTrackingCloseUp.
+     */
+    aiModeSet(mode: string, verify?: VerifyOpts): Promise<{
+        settled: boolean;
+        mode: string;
+    }>;
+    trackSpeedGet(): Promise<{
+        speed: string;
+    }>;
+    /**
+     * The Tail 2's own six-speed enum (bundle-verified): superLazy | lazy |
+     * slow | fast | crazy | customized. NOT the Tiny 2's standard/sport pair.
+     */
+    trackSpeedSet(speed: string, verify?: VerifyOpts): Promise<{
+        settled: boolean;
+        speed: string;
+    }>;
+    /**
+     * A saved pose: angles in DEGREES plus zoom ratio — the same units the
+     * tools speak. `name` is base64 on the wire; encode/decode lives here so
+     * callers never see it raw.
+     */
+    presetsGet(): Promise<Preset[]>;
+    /**
+     * `PUT ptz/preset {"operation": ..., "id": ..., "name": base64}` — one
+     * endpoint, four operations (grammar decoded from the camera's own web
+     * bundle and hardware-verified 2026-09-26; see TAIL2-PROTOCOL.md §3).
+     * IDs are 0-based (0–2); the tools expose 1-based slots for consistency
+     * with the Tiny 2's preset tools.
+     *
+     * `set` saves the CURRENT live pose — there is NO explicit-pose write
+     * anywhere in this API (measured), and `set` on an occupied slot
+     * OVERWRITES it (unlike the Tiny 2's create-once slots).
+     */
+    private presetOp;
+    /**
+     * Save the current live pose into slot `id`. The preset LIST lags the
+     * write by up to ~1s (measured), so verification is a ladder, and the
+     * pose itself can't be verified at all — the camera reports no live pose,
+     * so "the slot exists afterwards" is the honest success criterion.
+     */
+    presetSave(id: number, name: string, verify?: VerifyOpts): Promise<{
+        settled: boolean;
+        presets: Preset[];
+    }>;
+    /**
+     * Recall slot `id`. Physical arrival is verifiable through exactly one
+     * observable: the preset's zoom ratio landing in the live zoom_ratio (the
+     * WS push carries it). The gimbal axes themselves are open-loop.
+     */
+    presetRecall(id: number, verify?: VerifyOpts): Promise<{
+        settled: boolean;
+        zoom: number;
+    }>;
+    presetDelete(id: number, verify?: VerifyOpts): Promise<{
+        settled: boolean;
+        presets: Preset[];
+    }>;
+    presetRename(id: number, name: string, verify?: VerifyOpts): Promise<{
+        settled: boolean;
+        presets: Preset[];
+    }>;
+}

package/dist/tail2/api.js

@@ -0,0 +1,267 @@
+import WebSocket from "ws";
+// The camera stores preset names as base64 of UTF-8 (decoded from the web
+// bundle's own btoa-encoder, hardware-round-tripped 2026-09-26).
+const b64encode = (s) => Buffer.from(s, "utf8").toString("base64");
+const b64decode = (s) => Buffer.from(s, "base64").toString("utf8");
+export class Tail2HttpError extends Error {
+    status;
+    path;
+    body;
+    constructor(status, path, body) {
+        super(`Tail 2 API ${path} failed with HTTP ${status}${body ? `: ${body}` : ""}`);
+        this.status = status;
+        this.path = path;
+        this.body = body;
+        this.name = "Tail2HttpError";
+    }
+}
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+export class Tail2Api {
+    baseUrl;
+    timeoutMs;
+    wsUrl;
+    constructor(opts) {
+        // Accept a bare host too — the common case is "192.168.0.132".
+        this.baseUrl = opts.baseUrl.startsWith("http") ? opts.baseUrl : `http://${opts.baseUrl}`;
+        this.timeoutMs = opts.timeoutMs ?? 5000;
+        this.wsUrl = `${this.baseUrl.replace(/^http/, "ws")}/ws/`;
+    }
+    async req(method, path, body) {
+        let res;
+        try {
+            res = await fetch(this.baseUrl + path, {
+                method,
+                headers: body !== undefined ? { "Content-Type": "application/json" } : undefined,
+                body: body !== undefined ? JSON.stringify(body) : undefined,
+                signal: AbortSignal.timeout(this.timeoutMs),
+            });
+        }
+        catch (e) {
+            throw new Error(`Tail 2 at ${this.baseUrl} is unreachable (${e instanceof Error ? e.message : String(e)}). ` +
+                `Check the camera is powered and on the network; if it changed IP, re-run obsbot_tail2_scan.`);
+        }
+        if (!res.ok) {
+            const text = await res.text().catch(() => "");
+            throw new Tail2HttpError(res.status, path, text.slice(0, 300));
+        }
+        try {
+            return (await res.json());
+        }
+        catch (e) {
+            // HTTP-level success but a body that isn't JSON: this is some OTHER
+            // device's web server on that address, not a Tail 2. Same actionable
+            // shape as unreachable — the fix is a different address, not a retry.
+            throw new Error(`Tail 2 at ${this.baseUrl} did not reply with JSON for ${path} ` +
+                `(${e instanceof Error ? e.message : String(e)}) — the address is probably another ` +
+                `device, not a Tail 2. Re-run obsbot_tail2_scan to find the camera.`);
+        }
+    }
+    async send(method, path, body) {
+        const ack = await this.req(method, path, body);
+        // Every confirmed endpoint replies {"code":200,"err_idx":0}; a non-200
+        // code with HTTP 200 has not been observed, but checking it is free and
+        // makes an err_idx≠0 reply loud instead of silent.
+        if (typeof ack.code === "number" && ack.code !== 200) {
+            throw new Error(`${path} rejected: code=${ack.code} err_idx=${ack.err_idx ?? "?"}`);
+        }
+    }
+    /**
+     * Read `read()` until `match()` holds, on a bounded ladder. Returns
+     * `settled:false` (NOT a throw) when the ladder runs out — the command was
+     * sent and acknowledged, so the caller decides whether that is failure.
+     * Mirrors `obsbot_zoom_uvc`'s `settled` contract.
+     */
+    async verified(read, match, opts = {}) {
+        const attempts = opts.attempts ?? 6;
+        const delayMs = opts.delayMs ?? 400;
+        let value = await read();
+        for (let i = 1; i < attempts && !match(value); i++) {
+            await sleep(delayMs);
+            value = await read();
+        }
+        return { settled: match(value), value };
+    }
+    // ---- reads ---------------------------------------------------------------
+    info() {
+        return this.req("GET", "/camera/sdk/device_info");
+    }
+    /** One-shot status: connect, take the first push, close. No persistent socket. */
+    status() {
+        return new Promise((resolve, reject) => {
+            const ws = new WebSocket(this.wsUrl, { handshakeTimeout: this.timeoutMs });
+            // One winner across message/error/close/timer. NOT removeAllListeners():
+            // the camera keeps pushing its ~1 Hz status while our close handshake is
+            // in flight, and a late teardown frame can raise 'error' AFTER we've
+            // stripped the handler — an unhandled 'error' on a WebSocket kills the
+            // process (measured on live hardware 2026-09-26: "Invalid WebSocket
+            // frame: invalid status code 12592"). The settled flag makes stray
+            // events no-ops; success tears the socket down with terminate() so no
+            // further frames are parsed at all.
+            let settled = false;
+            const settle = (fn) => {
+                if (settled)
+                    return;
+                settled = true;
+                clearTimeout(timer);
+                fn();
+            };
+            const timer = setTimeout(() => settle(() => {
+                ws.terminate();
+                reject(new Error(`Tail 2 status channel (${this.wsUrl}) timed out. Retry this call.`));
+            }), this.timeoutMs + 2000);
+            ws.on("error", (e) => settle(() => reject(new Error(`Tail 2 status channel failed: ${e.message}`))));
+            ws.on("close", () => settle(() => reject(new Error("status channel closed before a push arrived"))));
+            ws.on("message", (data) => {
+                try {
+                    const parsed = JSON.parse(data.toString());
+                    settle(() => {
+                        ws.terminate();
+                        resolve(parsed);
+                    });
+                }
+                catch (e) {
+                    settle(() => reject(e instanceof Error ? e : new Error(String(e))));
+                }
+            });
+        });
+    }
+    ranges() {
+        return this.req("GET", "/camera/sdk/range");
+    }
+    networkConfig() {
+        return this.req("GET", "/camera/sdk/networkconfig");
+    }
+    imageState() {
+        return this.req("GET", "/camera/sdk/image");
+    }
+    // ---- PTZ -----------------------------------------------------------------
+    zoomGet() {
+        return this.req("GET", "/camera/sdk/ptz/zoom");
+    }
+    /**
+     * Absolute zoom ratio on the Tail 2's own 1.0–12.0 scale (`GET range`).
+     * `speed` is REQUIRED by the firmware (a ratio-only PUT is a 400) — both
+     * fields MEASURED 2026-09-26.
+     */
+    async zoomSet(ratio, speed, verify = {}) {
+        await this.send("PUT", "/camera/sdk/ptz/zoom", { ratio, speed });
+        // The zoom motor ramps; 4.5s of polling covers a full 1x→12x sweep at
+        // default speed without hanging the call on a wedged motor.
+        const v = await this.verified(() => this.zoomGet(), (r) => Math.abs(r.ratio - ratio) <= 0.01, { attempts: 10, delayMs: 500, ...verify });
+        return { settled: v.settled, ratio: v.value.ratio };
+    }
+    /** Gimbal recenter (`POST ptz/reset`). Open-loop: the Tail 2 reports no live pose. */
+    async recenter() {
+        await this.send("POST", "/camera/sdk/ptz/reset", {});
+    }
+    // ---- rotation (no Tiny 2 equivalent) --------------------------------------
+    /**
+     * Motorized 90° barrel rotation. Verified against the WS push rather than a
+     * REST readback (none exists) — and the readback MUST be tolerant of the
+     * motor taking ~1.5s, plus the swallowed-write hazard during motion.
+     */
+    async portraitSet(enable, verify = {}) {
+        await this.send("POST", "/camera/sdk/switch_portrait", { enable });
+        const v = await this.verified(() => this.status(), (s) => s.switch_portrait === enable, { attempts: 12, delayMs: 450, ...verify });
+        return { settled: v.settled, switch_portrait: v.value.switch_portrait === true };
+    }
+    rollBiasGet() {
+        return this.req("GET", "/camera/sdk/ptz/rollbias");
+    }
+    /** Roll trim in degrees. MEASURED write + readback 2026-09-26. */
+    async rollBiasSet(angle, verify = {}) {
+        await this.send("PUT", "/camera/sdk/ptz/rollbias", { angle });
+        const v = await this.verified(() => this.rollBiasGet(), (r) => Math.abs(r.angle - angle) <= 0.01, verify);
+        return { settled: v.settled, angle: v.value.angle };
+    }
+    // ---- AI tracking -----------------------------------------------------------
+    aiModeGet() {
+        return this.req("GET", "/camera/sdk/ai/workmode");
+    }
+    /**
+     * `mode` strings are the camera's own enum (bundle-verified, TAIL2-PROTOCOL
+     * §3): none | humanTrackingSingleMode | humanTrackingGroupMode |
+     * animalTrackingNormal | animalTrackingCloseUp | objectTracking |
+     * objectTrackingNormal | objectTrackingCloseUp.
+     */
+    async aiModeSet(mode, verify = {}) {
+        await this.send("PUT", "/camera/sdk/ai/workmode", { mode });
+        const v = await this.verified(() => this.aiModeGet(), (r) => r.mode === mode, verify);
+        return { settled: v.settled, mode: v.value.mode };
+    }
+    trackSpeedGet() {
+        return this.req("GET", "/camera/sdk/ai/trackspeed");
+    }
+    /**
+     * The Tail 2's own six-speed enum (bundle-verified): superLazy | lazy |
+     * slow | fast | crazy | customized. NOT the Tiny 2's standard/sport pair.
+     */
+    async trackSpeedSet(speed, verify = {}) {
+        await this.send("PUT", "/camera/sdk/ai/trackspeed", { speed });
+        const v = await this.verified(() => this.trackSpeedGet(), (r) => r.speed === speed, verify);
+        return { settled: v.settled, speed: v.value.speed };
+    }
+    // ---- presets ----------------------------------------------------------------
+    /**
+     * A saved pose: angles in DEGREES plus zoom ratio — the same units the
+     * tools speak. `name` is base64 on the wire; encode/decode lives here so
+     * callers never see it raw.
+     */
+    async presetsGet() {
+        const r = await this.req("GET", "/camera/sdk/ptz/preset");
+        return (r.presetList ?? []).map((p) => ({ ...p, name: b64decode(p.name) }));
+    }
+    /**
+     * `PUT ptz/preset {"operation": ..., "id": ..., "name": base64}` — one
+     * endpoint, four operations (grammar decoded from the camera's own web
+     * bundle and hardware-verified 2026-09-26; see TAIL2-PROTOCOL.md §3).
+     * IDs are 0-based (0–2); the tools expose 1-based slots for consistency
+     * with the Tiny 2's preset tools.
+     *
+     * `set` saves the CURRENT live pose — there is NO explicit-pose write
+     * anywhere in this API (measured), and `set` on an occupied slot
+     * OVERWRITES it (unlike the Tiny 2's create-once slots).
+     */
+    async presetOp(operation, id, name) {
+        await this.send("PUT", "/camera/sdk/ptz/preset", {
+            operation,
+            id,
+            ...(name !== undefined ? { name: b64encode(name) } : {}),
+        });
+    }
+    /**
+     * Save the current live pose into slot `id`. The preset LIST lags the
+     * write by up to ~1s (measured), so verification is a ladder, and the
+     * pose itself can't be verified at all — the camera reports no live pose,
+     * so "the slot exists afterwards" is the honest success criterion.
+     */
+    async presetSave(id, name, verify = {}) {
+        await this.presetOp("set", id, name);
+        const v = await this.verified(() => this.presetsGet(), (list) => list.some((p) => p.id === id), { attempts: 6, delayMs: 350, ...verify });
+        return { settled: v.settled, presets: v.value };
+    }
+    /**
+     * Recall slot `id`. Physical arrival is verifiable through exactly one
+     * observable: the preset's zoom ratio landing in the live zoom_ratio (the
+     * WS push carries it). The gimbal axes themselves are open-loop.
+     */
+    async presetRecall(id, verify = {}) {
+        const target = (await this.presetsGet()).find((p) => p.id === id);
+        if (!target)
+            throw new Error(`preset slot ${id} is empty — nothing to recall`);
+        await this.presetOp("call", id);
+        const v = await this.verified(() => this.zoomGet(), (r) => Math.abs(r.ratio - target.ratio) <= 0.05, { attempts: 14, delayMs: 450, ...verify });
+        return { settled: v.settled, zoom: v.value.ratio };
+    }
+    async presetDelete(id, verify = {}) {
+        await this.presetOp("delete", id);
+        const v = await this.verified(() => this.presetsGet(), (list) => !list.some((p) => p.id === id), { attempts: 6, delayMs: 350, ...verify });
+        return { settled: v.settled, presets: v.value };
+    }
+    async presetRename(id, name, verify = {}) {
+        await this.presetOp("rename", id, name);
+        const v = await this.verified(() => this.presetsGet(), (list) => (list.find((p) => p.id === id)?.name ?? null) === name, { attempts: 6, delayMs: 350, ...verify });
+        return { settled: v.settled, presets: v.value };
+    }
+}
+//# sourceMappingURL=api.js.map

package/dist/tail2/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/tail2/api.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,IAAI,CAAC;AA4E3B,0EAA0E;AAC1E,iEAAiE;AACjE,MAAM,SAAS,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACnF,MAAM,SAAS,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AAEnF,MAAM,OAAO,cAAe,SAAQ,KAAK;IAE5B;IACA;IACA;IAHX,YACW,MAAc,EACd,IAAY,EACZ,IAAY;QAErB,KAAK,CAAC,cAAc,IAAI,qBAAqB,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAJxE,WAAM,GAAN,MAAM,CAAQ;QACd,SAAI,GAAJ,IAAI,CAAQ;QACZ,SAAI,GAAJ,IAAI,CAAQ;QAGrB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAgBD,MAAM,KAAK,GAAG,CAAC,EAAU,EAAiB,EAAE,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AAEnF,MAAM,OAAO,QAAQ;IACV,OAAO,CAAS;IACR,SAAS,CAAS;IAClB,KAAK,CAAS;IAE/B,YAAY,IAA6C;QACvD,+DAA+D;QAC/D,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,OAAO,EAAE,CAAC;QACzF,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC;QACxC,IAAI,CAAC,KAAK,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC;IAC5D,CAAC;IAEO,KAAK,CAAC,GAAG,CAAI,MAAc,EAAE,IAAY,EAAE,IAAa;QAC9D,IAAI,GAAa,CAAC;QAClB,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE;gBACrC,MAAM;gBACN,OAAO,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC,SAAS;gBAChF,IAAI,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;gBAC3D,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC;aAC5C,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CACb,aAAa,IAAI,CAAC,OAAO,oBAAoB,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK;gBAC1F,6FAA6F,CAChG,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YAC9C,MAAM,IAAI,cAAc,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QACjE,CAAC;QACD,IAAI,CAAC;YACH,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAM,CAAC;QACjC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,oEAAoE;YACpE,qEAAqE;YACrE,sEAAsE;YACtE,MAAM,IAAI,KAAK,CACb,aAAa,IAAI,CAAC,OAAO,gCAAgC,IAAI,GAAG;gBAC9D,IAAI,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,sCAAsC;gBACpF,oEAAoE,CACvE,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,IAAI,CAAC,MAAsB,EAAE,IAAY,EAAE,IAAY;QACnE,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAM,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QACpD,uEAAuE;QACvE,wEAAwE;QACxE,mDAAmD;QACnD,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,KAAK,GAAG,EAAE,CAAC;YACrD,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,mBAAmB,GAAG,CAAC,IAAI,YAAY,GAAG,CAAC,OAAO,IAAI,GAAG,EAAE,CAAC,CAAC;QACtF,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,CACZ,IAAsB,EACtB,KAAwB,EACxB,OAAmB,EAAE;QAErB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC;QACpC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,GAAG,CAAC;QACpC,IAAI,KAAK,GAAG,MAAM,IAAI,EAAE,CAAC;QACzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACnD,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;YACrB,KAAK,GAAG,MAAM,IAAI,EAAE,CAAC;QACvB,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC;IAC1C,CAAC;IAED,6EAA6E;IAE7E,IAAI;QACF,OAAO,IAAI,CAAC,GAAG,CAAkB,KAAK,EAAE,yBAAyB,CAAC,CAAC;IACrE,CAAC;IAED,kFAAkF;IAClF,MAAM;QACJ,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,EAAE,GAAG,IAAI,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,gBAAgB,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;YAC3E,yEAAyE;YACzE,yEAAyE;YACzE,qEAAqE;YACrE,uEAAuE;YACvE,oEAAoE;YACpE,mEAAmE;YACnE,sEAAsE;YACtE,oCAAoC;YACpC,IAAI,OAAO,GAAG,KAAK,CAAC;YACpB,MAAM,MAAM,GAAG,CAAC,EAAc,EAAQ,EAAE;gBACtC,IAAI,OAAO;oBAAE,OAAO;gBACpB,OAAO,GAAG,IAAI,CAAC;gBACf,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,EAAE,EAAE,CAAC;YACP,CAAC,CAAC;YACF,MAAM,KAAK,GAAG,UAAU,CACtB,GAAG,EAAE,CACH,MAAM,CAAC,GAAG,EAAE;gBACV,EAAE,CAAC,SAAS,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,KAAK,CAAC,0BAA0B,IAAI,CAAC,KAAK,+BAA+B,CAAC,CAAC,CAAC;YACzF,CAAC,CAAC,EACJ,IAAI,CAAC,SAAS,GAAG,IAAI,CACtB,CAAC;YACF,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAQ,EAAE,EAAE,CAC1B,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAC9E,CAAC;YACF,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAClB,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC,CAAC,CAC/E,CAAC;YACF,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,IAAuB,EAAE,EAAE;gBAC3C,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAgB,CAAC;oBAC1D,MAAM,CAAC,GAAG,EAAE;wBACV,EAAE,CAAC,SAAS,EAAE,CAAC;wBACf,OAAO,CAAC,MAAM,CAAC,CAAC;oBAClB,CAAC,CAAC,CAAC;gBACL,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBACtE,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,GAAG,CAA0B,KAAK,EAAE,mBAAmB,CAAC,CAAC;IACvE,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,GAAG,CAA0B,KAAK,EAAE,2BAA2B,CAAC,CAAC;IAC/E,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,GAAG,CAA0B,KAAK,EAAE,mBAAmB,CAAC,CAAC;IACvE,CAAC;IAED,6EAA6E;IAE7E,OAAO;QACL,OAAO,IAAI,CAAC,GAAG,CAAoB,KAAK,EAAE,sBAAsB,CAAC,CAAC;IACpE,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,OAAO,CACX,KAAa,EACb,KAAa,EACb,SAAqB,EAAE;QAEvB,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,sBAAsB,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QACjE,sEAAsE;QACtE,4DAA4D;QAC5D,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,QAAQ,CAC3B,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,EACpB,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC,IAAI,IAAI,EACxC,EAAE,QAAQ,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,MAAM,EAAE,CAC1C,CAAC;QACF,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACtD,CAAC;IAED,sFAAsF;IACtF,KAAK,CAAC,QAAQ;QACZ,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,uBAAuB,EAAE,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,8EAA8E;IAE9E;;;;OAIG;IACH,KAAK,CAAC,WAAW,CACf,MAAe,EACf,SAAqB,EAAE;QAEvB,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,6BAA6B,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QACnE,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,QAAQ,CAC3B,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,EACnB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,KAAK,MAAM,EACnC,EAAE,QAAQ,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,MAAM,EAAE,CAC1C,CAAC;QACF,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe,KAAK,IAAI,EAAE,CAAC;IACnF,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,GAAG,CAAoB,KAAK,EAAE,0BAA0B,CAAC,CAAC;IACxE,CAAC;IAED,kEAAkE;IAClE,KAAK,CAAC,WAAW,CACf,KAAa,EACb,SAAqB,EAAE;QAEvB,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,0BAA0B,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC9D,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,QAAQ,CAC3B,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,EACxB,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC,IAAI,IAAI,EACxC,MAAM,CACP,CAAC;QACF,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACtD,CAAC;IAED,+EAA+E;IAE/E,SAAS;QACP,OAAO,IAAI,CAAC,GAAG,CAAmB,KAAK,EAAE,yBAAyB,CAAC,CAAC;IACtE,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,SAAS,CACb,IAAY,EACZ,SAAqB,EAAE;QAEvB,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,yBAAyB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,EAAE,MAAM,CAAC,CAAC;QACtF,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IACpD,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,GAAG,CAAoB,KAAK,EAAE,2BAA2B,CAAC,CAAC;IACzE,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,aAAa,CACjB,KAAa,EACb,SAAqB,EAAE;QAEvB,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,2BAA2B,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/D,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,EAAE,MAAM,CAAC,CAAC;QAC5F,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACtD,CAAC;IAED,gFAAgF;IAEhF;;;;OAIG;IACH,KAAK,CAAC,UAAU;QACd,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,GAAG,CACtB,KAAK,EACL,wBAAwB,CACzB,CAAC;QACF,OAAO,CAAC,CAAC,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9E,CAAC;IAED;;;;;;;;;;OAUG;IACK,KAAK,CAAC,QAAQ,CACpB,SAA+C,EAC/C,EAAU,EACV,IAAa;QAEb,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,wBAAwB,EAAE;YAC/C,SAAS;YACT,EAAE;YACF,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACzD,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,UAAU,CAAC,EAAU,EAAE,IAAY,EAAE,SAAqB,EAAE;QAChE,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;QACrC,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,QAAQ,CAC3B,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,EACvB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EACvC,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,MAAM,EAAE,CACzC,CAAC;QACF,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;IAClD,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,YAAY,CAAC,EAAU,EAAE,SAAqB,EAAE;QACpD,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAClE,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,eAAe,EAAE,+BAA+B,CAAC,CAAC;QAC/E,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAChC,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,QAAQ,CAC3B,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,EACpB,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,EAC/C,EAAE,QAAQ,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,MAAM,EAAE,CAC1C,CAAC;QACF,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,EAAU,EAAE,SAAqB,EAAE;QACpD,MAAM,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAClC,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,QAAQ,CAC3B,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,EACvB,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EACxC,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,MAAM,EAAE,CACzC,CAAC;QACF,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,EAAU,EAAE,IAAY,EAAE,SAAqB,EAAE;QAClE,MAAM,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;QACxC,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,QAAQ,CAC3B,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,EACvB,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,IAAI,IAAI,CAAC,KAAK,IAAI,EAChE,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,MAAM,EAAE,CACzC,CAAC;QACF,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;IAClD,CAAC;CACF"}

package/dist/tail2/mdns.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Passive mDNS discovery for the OBSBOT Tail 2.
+ *
+ * The Tail 2 has no mDNS query responder — it ANNOUNCES. Every few seconds it
+ * multicasts a response-framed packet to 224.0.0.251:5353 (IPv4, and the same
+ * digest over IPv6 link-local) carrying, in the TXT record of its
+ * `_remo_mdns._tcp.local` service, a full device digest: both MACs, both IPs,
+ * the hex-encoded device name, battery and sleep flags. Measured 2026-09-30 by
+ * capturing OBSBOT Center's discovery: Center sent no queries either — the
+ * announcements alone are how everything on the LAN finds the camera.
+ * TAIL2-PROTOCOL.md §2a.
+ *
+ * So discovery here is a listen, not a sweep: bind 5353 with SO_REUSEADDR
+ * (the OS's own responder holds the port on every platform; multicast
+ * delivery to multiple REUSEADDR sockets is uniform across Windows, Linux
+ * and macOS — it is how NDI tools coexist), join the group on every
+ * non-internal IPv4 interface, and collect Tail 2-shaped announcements.
+ * TAIL2-PROTOCOL.md §7a.
+ */
+/** What one camera's announcement tells us — identity straight from the camera. */
+export interface Tail2Announcement {
+    mac: string;
+    name: string;
+    /** Wired first, then wireless, then the address the packet arrived from. */
+    hosts: string[];
+}
+/**
+ * Extract a Tail 2 announcement from one mDNS packet, or null for anything
+ * else on the wire. Detection is by the digest's own shape — TXT strings that
+ * JSON-parse into an object carrying a `ble_mac` (the registry's identity
+ * MAC) plus a reachable IP — so other devices' mDNS traffic parses to nothing
+ * and registers nothing. `srcIp` is where the packet came from; it becomes a
+ * host of last resort and a live-reachability hint.
+ */
+export declare function parseTail2Announcement(buf: Buffer, srcIp?: string): Tail2Announcement | null;
+/** Accumulates announcements across packets, keyed by MAC. Testable without
+ *  sockets: push() buffers, results() the deduplicated list. */
+export declare function createAnnouncementCollector(): {
+    push(buf: Buffer, srcIp?: string): void;
+    results(): Tail2Announcement[];
+};
+/**
+ * Listen for Tail 2 announcements for `ms` milliseconds (the camera repeats
+ * every few seconds, so 5s is ample) and return what was heard. Never throws:
+ * a bind failure or a network without multicast yields an empty list, and the
+ * caller falls back to the HTTP sweep.
+ */
+export declare function listenForTail2Announcements(ms?: number): Promise<Tail2Announcement[]>;