obsbot-mcp 0.3.0 → 0.4.0

package/dist/transport/linux.js

@@ -1,13 +1,41 @@
+import { encodePtzMoveSpeed } from "../codec/commands.js";
+import { readSerialVia } from "./read-serial.js";
 const VENDOR_XU_SELECTOR = 0x02;
+// Unproven per-command reply path — reads back zeros. See the WindowsTransport
+// comment for the 2026-07-19 hardware sweep: sel 6 returns the status block (not
+// a reply), and preset read-back lives on flat selectors 12/13 instead.
 const RESPONSE_SELECTOR = 0x02;
 const DEFAULT_REPLY_LEN = 60;
 const STATUS_SELECTOR = 0x06;
 const STATUS_BLOCK_LEN = 60;
+// V4L2_CID_PAN_ABSOLUTE/TILT_ABSOLUTE map directly to the UVC CT_PANTILT_ABSOLUTE
+// control (Camera Terminal, selector 0x0D), whose unit is arc-seconds per both the
+// UVC and V4L2 specs — confirmed on hardware: pan range ±468000 / tilt ±324000,
+// step 3600, i.e. exactly ±130°/±90° at 3600 units per degree. A prior version of
+// this file divided by 1000 (mislabeled as "millidegrees"), which was wrong by a
+// factor of 3.6x on both the read and write side — self-consistently wrong, since
+// gimbalSet and camCtrlGet shared the same bad divisor, so a move-then-read check
+// always reported 0 error while the true physical angle was ~28% of what was asked
+// for.
+const ARCSEC_PER_DEG = 3600;
 /**
  * Linux V4L2 transport — functionally identical to {@link WindowsTransport}
  * because both delegate to the native helper process over the same JSON-RPC
  * stdio protocol. The selector constants are camera-side constants (the UVC
  * Extension Unit), not OS constants, so they are shared.
+ *
+ * Key difference: gimbal absolute movement uses V4L2 pan_absolute/tilt_absolute
+ * (hardware-verified to physically move the gimbal, repeatedly, 2026-07-21),
+ * NOT vendor V3 frames. camCtrlGet for pan/tilt reads back the same V4L2
+ * controls — this is the last-*commanded* value, not a live in-flight
+ * reading: VIDIOC_QUERY_EXT_CTRL reports these controls as non-volatile on
+ * this kernel, so V4L2 core serves its own cache rather than re-querying the
+ * device. Getting a genuinely live reading requires a raw USB read with the
+ * kernel driver briefly detached, which conflicts with any concurrent video
+ * capture (preview/recording) and was deliberately dropped from the shipped
+ * transport for that reason — see README's Linux limitations section. A
+ * kernel patch marking these controls volatile would fix this at the source;
+ * until then, gimbal moves on Linux are open-loop, same as the position read.
  */
 export class LinuxTransport {
     helper;
@@ -44,10 +72,23 @@ export class LinuxTransport {
         await this.helper.camCtrlSet(property, value, flags);
     }
     async camCtrlRange(property) {
-        return this.helper.camCtrlRange(property);
+        const result = await this.helper.camCtrlRange(property);
+        // Convert V4L2 arc-seconds → degrees for pan/tilt to match Windows convention
+        if (property === 0 || property === 1) {
+            result.min = Math.round(result.min / ARCSEC_PER_DEG);
+            result.max = Math.round(result.max / ARCSEC_PER_DEG);
+        }
+        return result;
     }
     async camCtrlGet(property) {
-        return this.helper.camCtrlGet(property);
+        const result = await this.helper.camCtrlGet(property);
+        // V4L2 pan_absolute/tilt_absolute return arc-seconds, but the rest of
+        // the codebase expects degrees (Windows DirectShow convention). This is
+        // the last-commanded value, not a live reading — see the class comment.
+        if (property === 0 || property === 1) {
+            result.value = Math.round(result.value / ARCSEC_PER_DEG);
+        }
+        return result;
     }
     async procAmpSet(property, value, flags) {
         await this.helper.procAmpSet(property, value, flags);
@@ -55,6 +96,55 @@ export class LinuxTransport {
     async procAmpRange(property) {
         return this.helper.procAmpRange(property);
     }
+    /**
+     * Move the gimbal using V4L2 pan_absolute/tilt_absolute (arc-seconds).
+     * Hardware-verified to physically move the gimbal (2026-07-21, repeated
+     * across many absolute targets). Unlike vendor V3 frames, V4L2 writes keep
+     * camCtrlGet's echo in sync with what was actually commanded.
+     *
+     * Sign convention: V4L2 pan_absolute + = camera's left (matches our yaw sign).
+     * V4L2 tilt_absolute + = tilt up (opposite of our +pitch = down convention).
+     */
+    async gimbalSet(yawDeg, pitchDeg, _rollDeg) {
+        // V4L2 pan/tilt drives in parallel — both are independent controls.
+        await Promise.all([
+            this.camCtrlSet(0, Math.round(yawDeg * ARCSEC_PER_DEG), 2),
+            this.camCtrlSet(1, Math.round(-pitchDeg * ARCSEC_PER_DEG), 2),
+        ]);
+    }
+    /**
+     * Drive the gimbal at a speed for a duration, using vendor-frame velocity
+     * protocol (fire-and-forget, no position readback). Not reachable from the
+     * Linux tool surface (obsbot_gimbal_move_speed is hidden on this platform):
+     * without a live position reading there is no way to confirm a speed burst
+     * stays within the gimbal's mechanical range before it gets there, unlike
+     * gimbalSet's absolute target, which can be clamped up front regardless of
+     * current position. Kept implemented here for ObsbotTransport conformance
+     * and for any future internal use once live feedback exists.
+     */
+    async gimbalSpeed(yaw, pitch, roll, autoStopMs) {
+        // Firmware velocity-yaw is inverted relative to position-yaw (same vendor
+        // AI_SET_GIM_SPEED opcode as Windows/macOS) — negate so +yaw pans camera-left
+        // for both move-speed and move-angle.
+        await this.sendVendor(encodePtzMoveSpeed(-yaw, pitch, roll).buildFrame(this.nextSeq()));
+        if (autoStopMs > 0) {
+            await new Promise((r) => setTimeout(r, autoStopMs));
+            await this.sendVendor(encodePtzMoveSpeed(0, 0, 0).buildFrame(this.nextSeq()));
+        }
+    }
+    /**
+     * Recenter the gimbal via V4L2 pan_absolute=0, tilt_absolute=0.
+     * Hardware-verified to physically recenter the gimbal (2026-07-21).
+     */
+    async gimbalRecenter() {
+        await Promise.all([
+            this.camCtrlSet(0, 0, 2),
+            this.camCtrlSet(1, 0, 2),
+        ]);
+    }
+    async readSerial() {
+        return readSerialVia(this);
+    }
     nextSeq() {
         this.seq = this.seq >= 0xffff ? 1 : this.seq + 1;
         return this.seq;

package/dist/transport/linux.js.map

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

package/dist/transport/macos.d.ts

@@ -20,6 +20,15 @@ export declare class MacosTransport implements ObsbotTransport {
         min: number;
         max: number;
     }>;
+    /**
+     * Read a camera-control property. Pan (0) and tilt (1) come from the standard
+     * UVC CT_PANTILT_ABSOLUTE control (selector 0x0D), which this firmware updates
+     * live during motion — including motion the host did not command (speed moves,
+     * recenter, tracking). Scaled arc-seconds → degrees.
+     *
+     * Sign convention: UVC pan positive = camera's left (matches our yaw sign);
+     * UVC tilt positive = up, which callers negate to get our +pitch = down.
+     */
     camCtrlGet(property: number): Promise<{
         value: number;
         flags: number;
@@ -29,6 +38,10 @@ export declare class MacosTransport implements ObsbotTransport {
         min: number;
         max: number;
     }>;
+    gimbalSet(yawDeg: number, pitchDeg: number, rollDeg?: number): Promise<void>;
+    gimbalSpeed(yaw: number, pitch: number, roll: number, autoStopMs: number): Promise<void>;
+    gimbalRecenter(): Promise<void>;
+    readSerial(): Promise<string>;
     nextSeq(): number;
     close(): Promise<void>;
 }

package/dist/transport/macos.js

@@ -1,10 +1,26 @@
+import { encodeRecenter, encodePtzMoveAngle, encodePtzMoveSpeed } from "../codec/commands.js";
+import { readSerialVia } from "./read-serial.js";
 // Same XU selector constants as WindowsTransport — they're defined by the
 // OBSBOT protocol, not the OS:
 const VENDOR_XU_SELECTOR = 0x02;
+// Unproven per-command reply path — reads back zeros. See the WindowsTransport
+// comment for the 2026-07-19 hardware sweep: sel 6 returns the status block (not
+// a reply), and preset read-back lives on flat selectors 12/13 instead.
 const RESPONSE_SELECTOR = 0x02;
 const DEFAULT_REPLY_LEN = 60;
 const STATUS_SELECTOR = 0x06;
 const STATUS_BLOCK_LEN = 60;
+// UVC CT_PANTILT_ABSOLUTE (selector 0x0D) is expressed in arc-seconds. The
+// helper returns the raw per-axis value; the rest of the codebase works in
+// degrees (Windows DirectShow convention), so scale here — the same shape as
+// LinuxTransport's millidegree scaling. Hardware-measured range is ±468000
+// asec pan / ±324000 asec tilt, resolution 3600 asec = 1°.
+const ARCSEC_PER_DEG = 3600;
+const CAMCTRL_PAN = 0;
+const CAMCTRL_TILT = 1;
+function isGimbalAxis(property) {
+    return property === CAMCTRL_PAN || property === CAMCTRL_TILT;
+}
 export class MacosTransport {
     helper;
     seq = 0;
@@ -37,13 +53,37 @@ export class MacosTransport {
         return this.helper.snapshot(opts);
     }
     async camCtrlSet(property, value, flags) {
+        // SET_CUR on CT_PANTILT_ABSOLUTE has never been exercised on this device —
+        // absolute moves go through vendor V3 frames instead. Refuse rather than
+        // issue an uncharacterized write.
+        if (isGimbalAxis(property)) {
+            throw new Error("camCtrlSet: pan/tilt writes are not supported on macOS — use gimbalSet (vendor V3 frames)");
+        }
         await this.helper.camCtrlSet(property, value, flags);
     }
     async camCtrlRange(property) {
-        return this.helper.camCtrlRange(property);
-    }
+        const result = await this.helper.camCtrlRange(property);
+        if (isGimbalAxis(property)) {
+            result.min = Math.round(result.min / ARCSEC_PER_DEG);
+            result.max = Math.round(result.max / ARCSEC_PER_DEG);
+        }
+        return result;
+    }
+    /**
+     * Read a camera-control property. Pan (0) and tilt (1) come from the standard
+     * UVC CT_PANTILT_ABSOLUTE control (selector 0x0D), which this firmware updates
+     * live during motion — including motion the host did not command (speed moves,
+     * recenter, tracking). Scaled arc-seconds → degrees.
+     *
+     * Sign convention: UVC pan positive = camera's left (matches our yaw sign);
+     * UVC tilt positive = up, which callers negate to get our +pitch = down.
+     */
     async camCtrlGet(property) {
-        return this.helper.camCtrlGet(property);
+        const result = await this.helper.camCtrlGet(property);
+        if (isGimbalAxis(property)) {
+            result.value = Math.round(result.value / ARCSEC_PER_DEG);
+        }
+        return result;
     }
     async procAmpSet(property, value, flags) {
         await this.helper.procAmpSet(property, value, flags);
@@ -51,6 +91,22 @@ export class MacosTransport {
     async procAmpRange(property) {
         return this.helper.procAmpRange(property);
     }
+    async gimbalSet(yawDeg, pitchDeg, rollDeg = 0) {
+        await this.sendVendor(encodePtzMoveAngle(yawDeg, pitchDeg, rollDeg).buildFrame(this.nextSeq()));
+    }
+    async gimbalSpeed(yaw, pitch, roll, autoStopMs) {
+        await this.sendVendor(encodePtzMoveSpeed(-yaw, pitch, roll).buildFrame(this.nextSeq()));
+        if (autoStopMs > 0) {
+            await new Promise((r) => setTimeout(r, autoStopMs));
+            await this.sendVendor(encodePtzMoveSpeed(0, 0, 0).buildFrame(this.nextSeq()));
+        }
+    }
+    async gimbalRecenter() {
+        await this.sendVendor(encodeRecenter().buildFrame(this.nextSeq()));
+    }
+    async readSerial() {
+        return readSerialVia(this);
+    }
     nextSeq() {
         this.seq = this.seq >= 0xffff ? 1 : this.seq + 1;
         return this.seq;

package/dist/transport/macos.js.map

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

package/dist/transport/read-serial.d.ts

@@ -0,0 +1,26 @@
+/**
+ * The transport primitives readSerial needs. MacosTransport, LinuxTransport,
+ * and WindowsTransport already implement all three as public methods, so
+ * each of them satisfies this structurally with no extra glue beyond
+ * `readSerial() { return readSerialVia(this); }`.
+ */
+export interface VendorReadPrimitives {
+    xuRaw(selector: number, data: Buffer): Promise<void>;
+    xuGetRaw(selector: number, length: number): Promise<Buffer>;
+    nextSeq(): number;
+}
+/**
+ * Send a header-only UG_GET_SN GET frame on the vendor XU selector and poll
+ * the selector-2 reply mailbox until a valid, matching reply appears.
+ *
+ * The mailbox retains the PREVIOUS reply until the new one lands (reply
+ * latency varies), so a single unvalidated read can return stale data. A
+ * reply is trusted only once it: parses cleanly (magic + header CRC +
+ * payload CRC via parseFrame), has cmd === UG_GET_SN's wire cmd, and echoes
+ * the seq this call just sent. Throws if no such reply shows up within
+ * POLL_ATTEMPTS reads.
+ *
+ * Shared by all three platform transports so this polling/validation logic
+ * exists exactly once instead of three near-identical copies.
+ */
+export declare function readSerialVia(t: VendorReadPrimitives): Promise<string>;

package/dist/transport/read-serial.js

@@ -0,0 +1,87 @@
+import { encodeVendorGet, decodeSerial } from "../codec/commands.js";
+import { parseFrame } from "../codec/frame.js";
+// Protocol constant (not platform-specific) — the vendor SET_CUR request and
+// the reply mailbox both live on XU selector 2. Kept local to this module
+// rather than imported from a transport file so this stays a standalone unit;
+// each platform transport separately defines the same constant for its own
+// sendVendor/recvVendor use.
+const VENDOR_XU_SELECTOR = 0x02;
+const UG_GET_SN_CMD = 0x18c8;
+const REPLY_LEN = 60;
+const POLL_ATTEMPTS = 8;
+// The device does not populate the reply mailbox instantly — the framed reply
+// lands tens of ms after the request. Polling with NO delay drains all 8
+// attempts in ~7ms, before the reply arrives, and reads only the stale previous
+// frame → spurious "no reply". A short delay before each read gives the reply
+// time to land. Hardware-verified 2026-07-20: 0ms delay fails every rapid read;
+// 30ms is reliable. (Unit tests use a synchronous fake helper and never exercise
+// this latency, which is why the bug shipped past them.)
+const POLL_DELAY_MS = 30;
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+/**
+ * Send a header-only UG_GET_SN GET frame on the vendor XU selector and poll
+ * the selector-2 reply mailbox until a valid, matching reply appears.
+ *
+ * The mailbox retains the PREVIOUS reply until the new one lands (reply
+ * latency varies), so a single unvalidated read can return stale data. A
+ * reply is trusted only once it: parses cleanly (magic + header CRC +
+ * payload CRC via parseFrame), has cmd === UG_GET_SN's wire cmd, and echoes
+ * the seq this call just sent. Throws if no such reply shows up within
+ * POLL_ATTEMPTS reads.
+ *
+ * Shared by all three platform transports so this polling/validation logic
+ * exists exactly once instead of three near-identical copies.
+ */
+export async function readSerialVia(t) {
+    const seq = t.nextSeq();
+    const req = encodeVendorGet("UG_GET_SN").buildFrame(seq);
+    await t.xuRaw(VENDOR_XU_SELECTOR, req);
+    const seen = new Set();
+    let last = Buffer.alloc(0);
+    for (let i = 0; i < POLL_ATTEMPTS; i++) {
+        await sleep(POLL_DELAY_MS); // let the reply land before reading the mailbox
+        const raw = await t.xuGetRaw(VENDOR_XU_SELECTOR, REPLY_LEN);
+        last = raw;
+        seen.add(raw.toString("hex"));
+        try {
+            const f = parseFrame(raw);
+            if (f.cmd === UG_GET_SN_CMD && f.seq === seq && f.payload.length > 0) {
+                return decodeSerial(f.payload);
+            }
+        }
+        catch {
+            // Not our reply yet (stale mailbox, still in flight, or garbage) —
+            // keep polling.
+        }
+    }
+    // Report what the mailbox actually held. "No valid reply" alone cannot
+    // distinguish a mute device from one answering somebody else's request, and
+    // that ambiguity is why the 3.2s vendor-path outage of 2026-07-21 was never
+    // explained: the identifying datum was read eight times and discarded eight
+    // times. Reproduced since after a different-port replug, where the mailbox
+    // stays mute for the whole poll and answers ~420ms later.
+    const churn = seen.size === 1 ? "unchanged" : `${seen.size} distinct`;
+    throw new Error(`readSerial: no valid UG_GET_SN reply — ${POLL_ATTEMPTS} reads, ${churn}; ` +
+        `mailbox ${describeMailbox(last, req, seq)}`);
+}
+/** One short phrase naming what a non-reply actually was. */
+function describeMailbox(raw, req, wantSeq) {
+    // The signature of the 2026-07-21 outage: our own request handed straight
+    // back with the magic byte zeroed.
+    if (raw.length === req.length &&
+        raw[0] === 0x00 &&
+        req[0] === 0xaa &&
+        raw.subarray(1).equals(req.subarray(1))) {
+        return "was our own request echoed back with the magic byte zeroed";
+    }
+    try {
+        const f = parseFrame(raw);
+        const empty = f.payload.length === 0 ? ", empty payload" : "";
+        return `held cmd 0x${f.cmd.toString(16)} seq ${f.seq}${empty} ` +
+            `(wanted cmd 0x${UG_GET_SN_CMD.toString(16)} seq ${wantSeq})`;
+    }
+    catch (e) {
+        return `unparseable: ${e.message}; first bytes ${raw.subarray(0, 8).toString("hex")}`;
+    }
+}
+//# sourceMappingURL=read-serial.js.map

package/dist/transport/read-serial.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-serial.js","sourceRoot":"","sources":["../../src/transport/read-serial.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,6EAA6E;AAC7E,0EAA0E;AAC1E,8EAA8E;AAC9E,2EAA2E;AAC3E,6BAA6B;AAC7B,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAEhC,MAAM,aAAa,GAAG,MAAM,CAAC;AAC7B,MAAM,SAAS,GAAG,EAAE,CAAC;AACrB,MAAM,aAAa,GAAG,CAAC,CAAC;AACxB,8EAA8E;AAC9E,yEAAyE;AACzE,gFAAgF;AAChF,8EAA8E;AAC9E,gFAAgF;AAChF,iFAAiF;AACjF,yDAAyD;AACzD,MAAM,aAAa,GAAG,EAAE,CAAC;AACzB,MAAM,KAAK,GAAG,CAAC,EAAU,EAAiB,EAAE,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AAcnF;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,CAAuB;IACzD,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC;IACxB,MAAM,GAAG,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACzD,MAAM,CAAC,CAAC,KAAK,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC;IAEvC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,IAAI,IAAI,GAAW,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEnC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,aAAa,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,gDAAgD;QAC5E,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,QAAQ,CAAC,kBAAkB,EAAE,SAAS,CAAC,CAAC;QAC5D,IAAI,GAAG,GAAG,CAAC;QACX,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QAC9B,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;YAC1B,IAAI,CAAC,CAAC,GAAG,KAAK,aAAa,IAAI,CAAC,CAAC,GAAG,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACrE,OAAO,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;YACjC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,mEAAmE;YACnE,gBAAgB;QAClB,CAAC;IACH,CAAC;IAED,uEAAuE;IACvE,4EAA4E;IAC5E,4EAA4E;IAC5E,4EAA4E;IAC5E,2EAA2E;IAC3E,0DAA0D;IAC1D,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,WAAW,CAAC;IACtE,MAAM,IAAI,KAAK,CACb,0CAA0C,aAAa,WAAW,KAAK,IAAI;QACzE,WAAW,eAAe,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,CAC/C,CAAC;AACJ,CAAC;AAED,6DAA6D;AAC7D,SAAS,eAAe,CAAC,GAAW,EAAE,GAAW,EAAE,OAAe;IAChE,0EAA0E;IAC1E,mCAAmC;IACnC,IACE,GAAG,CAAC,MAAM,KAAK,GAAG,CAAC,MAAM;QACzB,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI;QACf,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI;QACf,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EACvC,CAAC;QACD,OAAO,4DAA4D,CAAC;IACtE,CAAC;IACD,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;QAC1B,MAAM,KAAK,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9D,OAAO,cAAc,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,GAAG,GAAG,KAAK,GAAG;YAC7D,iBAAiB,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,OAAO,GAAG,CAAC;IAClE,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,gBAAiB,CAAW,CAAC,OAAO,iBAAiB,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;IACnG,CAAC;AACH,CAAC"}

package/dist/transport/transport.d.ts

@@ -57,6 +57,30 @@ export interface ObsbotTransport {
         min: number;
         max: number;
     }>;
+    /**
+     * Move the gimbal to an absolute yaw/pitch angle in degrees. Positive yaw =
+     * camera's left; positive pitch = tilt down.
+     * Platform note: Linux uses V4L2 pan_absolute/tilt_absolute (proven to move
+     * the physical gimbal and keep V4L2 readback working). Windows/macOS use
+     * vendor V3 frames (AI_SET_GIM_MOTOR_DEG).
+     */
+    gimbalSet(yawDeg: number, pitchDeg: number, rollDeg?: number): Promise<void>;
+    /**
+     * Drive the gimbal at a yaw/pitch speed (platform-specific units), then
+     * automatically stop after autoStopMs. Positive yaw = camera's left.
+     * Platform note: Linux approximates by converting speed × duration to an
+     * absolute V4L2 pan_absolute/tilt_absolute move. Windows/macOS use vendor
+     * V3 frames (AI_SET_GIM_SPEED).
+     */
+    gimbalSpeed(yaw: number, pitch: number, roll: number, autoStopMs: number): Promise<void>;
+    /** Recenter the gimbal to yaw=0, pitch=0. */
+    gimbalRecenter(): Promise<void>;
+    /**
+     * Read the camera's 14-char ASCII serial number (UG_GET_SN): sends a
+     * header-only vendor GET on the vendor XU selector and polls the reply
+     * mailbox for a valid, matching reply. Throws if no valid reply arrives.
+     */
+    readSerial(): Promise<string>;
     nextSeq(): number;
     close(): Promise<void>;
 }

package/dist/transport/windows.d.ts

@@ -29,6 +29,10 @@ export declare class WindowsTransport implements ObsbotTransport {
         min: number;
         max: number;
     }>;
+    gimbalSet(yawDeg: number, pitchDeg: number, rollDeg?: number): Promise<void>;
+    gimbalSpeed(yaw: number, pitch: number, roll: number, autoStopMs: number): Promise<void>;
+    gimbalRecenter(): Promise<void>;
+    readSerial(): Promise<string>;
     nextSeq(): number;
     close(): Promise<void>;
 }

package/dist/transport/windows.js

@@ -1,9 +1,18 @@
+import { encodeRecenter, encodePtzMoveAngle, encodePtzMoveSpeed } from "../codec/commands.js";
+import { readSerialVia } from "./read-serial.js";
 const VENDOR_XU_SELECTOR = 0x02;
 // Intended read-back selector for the (future) per-command V3-frame Get path
-// used by recvVendor. NOT YET verified on hardware — the per-command reply path
-// is unproven scaffolding; Slice 1 shipped the status-block read instead. A
-// separate constant from VENDOR_XU_SELECTOR because it may need to diverge once
-// that path is validated. Change here only.
+// used by recvVendor. This path is UNPROVEN and reads back all zeros.
+//
+// Hardware sweep 2026-07-19 (Tiny 2, camera awake) — do not re-chase this:
+//   - sel 0x02 after a vendor SET: all zeros (the long-standing symptom).
+//   - sel 0x06: returns the flat STATUS BLOCK verbatim (starts 0x25, fails
+//     parseFrame "bad magic") — it is NOT a per-command reply. Pointing
+//     recvVendor at 6 was tried and reverted; it only masked the problem.
+//   - sels 1,3,5,9,11,15,16: zeros. The `aa 29` reply frames visible in USB
+//     captures are not reachable through this xu_get surface at all.
+// Preset/state read-back instead lives on dedicated FLAT selectors (12 = list,
+// 13 = entry cursor), like STATUS_SELECTOR below — not via framed replies.
 const RESPONSE_SELECTOR = 0x02;
 const DEFAULT_REPLY_LEN = 60;
 // The camera exposes a flat status block on this XU selector; GET_CUR reads it
@@ -57,6 +66,24 @@ export class WindowsTransport {
     async procAmpRange(property) {
         return this.helper.procAmpRange(property);
     }
+    async gimbalSet(yawDeg, pitchDeg, rollDeg = 0) {
+        await this.sendVendor(encodePtzMoveAngle(yawDeg, pitchDeg, rollDeg).buildFrame(this.nextSeq()));
+    }
+    async gimbalSpeed(yaw, pitch, roll, autoStopMs) {
+        // Firmware velocity-yaw is inverted relative to position-yaw — negate yaw so
+        // the contract is consistent: +yaw pans to camera's left.
+        await this.sendVendor(encodePtzMoveSpeed(-yaw, pitch, roll).buildFrame(this.nextSeq()));
+        if (autoStopMs > 0) {
+            await new Promise((r) => setTimeout(r, autoStopMs));
+            await this.sendVendor(encodePtzMoveSpeed(0, 0, 0).buildFrame(this.nextSeq()));
+        }
+    }
+    async gimbalRecenter() {
+        await this.sendVendor(encodeRecenter().buildFrame(this.nextSeq()));
+    }
+    async readSerial() {
+        return readSerialVia(this);
+    }
     nextSeq() {
         this.seq = this.seq >= 0xffff ? 1 : this.seq + 1;
         return this.seq;

package/dist/transport/windows.js.map

@@ -1 +1 @@
-{"version":3,"file":"windows.js","sourceRoot":"","sources":["../../src/transport/windows.ts"],"names":[],"mappings":"AAGA,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAChC,6EAA6E;AAC7E,gFAAgF;AAChF,4EAA4E;AAC5E,gFAAgF;AAChF,4CAA4C;AAC5C,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAC/B,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAC7B,+EAA+E;AAC/E,2EAA2E;AAC3E,+EAA+E;AAC/E,MAAM,eAAe,GAAG,IAAI,CAAC;AAC7B,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAE5B,MAAM,OAAO,gBAAgB;IAGP;IAFZ,GAAG,GAAG,CAAC,CAAC;IAEhB,YAAoB,MAAqB;QAArB,WAAM,GAAN,MAAM,CAAe;IAAG,CAAC;IAE7C,KAAK,CAAC,UAAU,CAAC,KAAa;QAC5B,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAa,EAAE,MAAM,GAAG,iBAAiB;QACxD,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC;QACnD,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAM,GAAG,gBAAgB;QACxC,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,QAAgB,EAAE,IAAY;QACxC,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,QAAgB,EAAE,MAAc;QAC7C,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,SAAS;QACb,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAAa;QACzB,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,IAAkB;QAC/B,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,QAAgB,EAAE,KAAa,EAAE,KAAa;QAC7D,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,QAAgB;QACjC,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,QAAgB;QAC/B,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,QAAgB,EAAE,KAAa,EAAE,KAAa;QAC7D,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,QAAgB;QACjC,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC5C,CAAC;IAED,OAAO;QACL,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC,GAAG,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC;CACF"}
+{"version":3,"file":"windows.js","sourceRoot":"","sources":["../../src/transport/windows.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "obsbot-mcp",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Cross-platform MCP server for OBSBOT Tiny 2 (UVC) camera control",
   "license": "MIT",
   "author": "Michael Jordan",
@@ -35,7 +35,8 @@
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "test": "vitest run",
-    "test:watch": "vitest"
+    "test:watch": "vitest",
+    "integration": "node scripts/integration/run.mjs"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",

package/dist/device/session.d.ts

@@ -1,22 +0,0 @@
-import { DeviceManager } from "./manager.js";
-import { ObsbotTransport } from "../transport/transport.js";
-/**
- * Owns the device connection lifecycle: lazily opens the first OBSBOT, caches
- * the transport, and supports invalidation + re-open for self-healing across a
- * mid-session disconnect. A re-open after a prior open is flagged as a
- * "reconnect" so callers can surface `reconnected: true` and re-read state
- * (the device power-cycles on unplug — prior assumptions are void).
- */
-export declare class DeviceSession {
-    private mgr;
-    private transport?;
-    private opened;
-    private reconnected;
-    constructor(mgr: DeviceManager);
-    /** Return the cached transport, opening (or re-opening) the device if needed. */
-    get(): Promise<ObsbotTransport>;
-    /** Drop the cached transport (e.g. after a device error) so the next get() re-opens. */
-    invalidate(): void;
-    /** True once if the transport was re-opened after an invalidate; clears on read. */
-    takeReconnected(): boolean;
-}

package/dist/device/session.js

@@ -1,37 +0,0 @@
-/**
- * Owns the device connection lifecycle: lazily opens the first OBSBOT, caches
- * the transport, and supports invalidation + re-open for self-healing across a
- * mid-session disconnect. A re-open after a prior open is flagged as a
- * "reconnect" so callers can surface `reconnected: true` and re-read state
- * (the device power-cycles on unplug — prior assumptions are void).
- */
-export class DeviceSession {
-    mgr;
-    transport;
-    opened = false;
-    reconnected = false;
-    constructor(mgr) {
-        this.mgr = mgr;
-    }
-    /** Return the cached transport, opening (or re-opening) the device if needed. */
-    async get() {
-        if (!this.transport) {
-            this.transport = await this.mgr.openFirstObsbot();
-            if (this.opened)
-                this.reconnected = true; // this is a RE-open, not the first
-            this.opened = true;
-        }
-        return this.transport;
-    }
-    /** Drop the cached transport (e.g. after a device error) so the next get() re-opens. */
-    invalidate() {
-        this.transport = undefined;
-    }
-    /** True once if the transport was re-opened after an invalidate; clears on read. */
-    takeReconnected() {
-        const r = this.reconnected;
-        this.reconnected = false;
-        return r;
-    }
-}
-//# sourceMappingURL=session.js.map

package/dist/device/session.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/device/session.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,MAAM,OAAO,aAAa;IAKJ;IAJZ,SAAS,CAAmB;IAC5B,MAAM,GAAG,KAAK,CAAC;IACf,WAAW,GAAG,KAAK,CAAC;IAE5B,YAAoB,GAAkB;QAAlB,QAAG,GAAH,GAAG,CAAe;IAAG,CAAC;IAE1C,iFAAiF;IACjF,KAAK,CAAC,GAAG;QACP,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,IAAI,CAAC,SAAS,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC;YAClD,IAAI,IAAI,CAAC,MAAM;gBAAE,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC,mCAAmC;YAC7E,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACrB,CAAC;QACD,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,wFAAwF;IACxF,UAAU;QACR,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED,oFAAoF;IACpF,eAAe;QACb,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC;QAC3B,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;QACzB,OAAO,CAAC,CAAC;IACX,CAAC;CACF"}