obsbot-mcp 0.1.0

package/dist/codec/commands.js

@@ -0,0 +1,185 @@
+import { buildFrame } from "./frame.js";
+import { f32le, u32le, i32le, concat } from "./encoding.js";
+import { OP_BY_NAME } from "./opcodes.js";
+// Vendor frames are addressed by opcode NAME; the wire cmd and receiver come
+// from the reverse-engineered opcode table (src/codec/opcodes.ts) rather than
+// magic numbers, so the same definitions serve every platform transport and
+// new commands are a table row + a payload encoder.
+const vendorOp = (name, payload) => {
+    const op = OP_BY_NAME.get(name);
+    if (!op || op.wireCmd === null || op.receiver === null) {
+        throw new Error(`opcode "${name}" is not a sendable V3 command`);
+    }
+    const { wireCmd, receiver } = op;
+    return { kind: "vendor", buildFrame: (seq) => buildFrame({ seq, cmd: wireCmd, receiver, payload }) };
+};
+/**
+ * RE/diagnostics: build ANY opcode-table entry as a V3 frame with an arbitrary
+ * payload. Used by the obsbot_probe tool to exercise unmapped GET/query opcodes
+ * (e.g. AI_GET_QUICK_STATUS) while reverse-engineering the feedback surface.
+ */
+export const encodeVendorProbe = (name, payload) => vendorOp(name, payload);
+// The gimbal move wire payload order is [roll, pitch, yaw] (data[0..3]=roll,
+// [4..7]=pitch, [8..11]=yaw). Sending them in logical (yaw,pitch,roll) order put yaw
+// into the roll slot (roll is unused on Tiny 2), which is why move-to-angle appeared
+// inert.
+const gimbal3 = (name, yaw, pitch, roll) => vendorOp(name, concat(f32le(roll), f32le(pitch), f32le(yaw)));
+export const encodeSetRunStatus = (state) => vendorOp("CAM_SET_DEV_STATUS", Buffer.from([state === "run" ? 0 : 1, 0, 0, 0])); // wake=0, sleep=1
+export const encodePtzMoveAngle = (yaw, pitch, roll) => gimbal3("AI_SET_GIM_MOTOR_DEG", yaw, pitch, roll);
+export const encodePtzMoveSpeed = (yaw, pitch, roll) => gimbal3("AI_SET_GIM_SPEED", yaw, pitch, roll);
+export const encodeRecenter = () => vendorOp("GIM_SET_MOTOR", Buffer.alloc(6));
+export const zoomRatioToUnits = (ratio, min, max) => Math.round(min + (max - min) * (ratio - 1.0) + 0.001);
+const AI_TRACK_VIEW = {
+    "human-normal": [0, 0],
+    "human-full-body": [0, 4],
+    "human-half-body": [0, 3],
+    "human-close-up": [0, 2],
+    "human-auto-view": [0, 1],
+    "animal-normal": [1, 0],
+    "animal-close-up": [1, 2],
+    "animal-auto-view": [1, 1],
+};
+export const AI_TRACK_MODES = Object.keys(AI_TRACK_VIEW);
+/** Enable AI tracking in a specific framing mode (AI_SET_AI_TRACK_MODE, cmd 0x6f). */
+export const encodeAiTrackEnable = (mode) => {
+    const [subject, view] = AI_TRACK_VIEW[mode];
+    return vendorOp("AI_SET_AI_TRACK_MODE", concat(u32le(subject), u32le(view)));
+};
+/** Disable AI tracking of the current target (AI_SET_CANCEL_TARGET, cmd 0x6e — no payload). */
+export const encodeAiTrackDisable = () => vendorOp("AI_SET_CANCEL_TARGET", Buffer.alloc(0));
+/** Enable auto group-framing (AI_SET_AUTO_GROUP, cmd 0x70 — 8 zero bytes). */
+export const encodeAiGroupEnable = () => vendorOp("AI_SET_AUTO_GROUP", Buffer.alloc(8));
+/** Disable auto group-framing (AI_CANCEL_AUTO_GROUP, cmd 0x71 — no payload). */
+export const encodeAiGroupDisable = () => vendorOp("AI_CANCEL_AUTO_GROUP", Buffer.alloc(0));
+const AI_TRACK_SPEED = {
+    standard: 0, // device Standard (slower follow)
+    sport: 2, // device Sport (snappier follow)
+};
+export const AI_TRACK_SPEEDS = Object.keys(AI_TRACK_SPEED);
+export const encodeAiTrackSpeed = (speed) => vendorOp("AI_SET_TRACK_MODE", Buffer.from([AI_TRACK_SPEED[speed]]));
+// ---------------------------------------------------------------------------
+//  Zoom with speed  (CAM_SET_ZOOM_ABSOLUTE, cmd 0x32)
+// ---------------------------------------------------------------------------
+// The zoom-with-speed payload packs speed FIRST then ratio: data[0:4] =
+// u32le(zoom_speed), data[4:8] = u32le(zoom_ratio), where zoom_ratio is the
+// ratio × 100 (1.5× -> 150).
+export const encodeZoomWithSpeed = (ratioX100, speed) => vendorOp("CAM_SET_ZOOM_ABSOLUTE", concat(u32le(speed), u32le(ratioX100)));
+// ---------------------------------------------------------------------------
+//  Face focus  (CAM_SET_FACE_FOCUS, cmd 0x03) — int32le(enable) on V3.
+// ---------------------------------------------------------------------------
+export const encodeFaceFocus = (enable) => vendorOp("CAM_SET_FACE_FOCUS", i32le(enable ? 1 : 0));
+// ---------------------------------------------------------------------------
+//  Reads (Get commands) — the return channel. A GET request carries no nested
+//  payload (it asks, it does not set); the camera replies with a frame whose
+//  payload holds the state. Decoders take that reply payload.
+// ---------------------------------------------------------------------------
+/** Request the current face-priority autofocus state (CAM_GET_FACE_FOCUS, cmd 0x35c2). */
+export const encodeGetFaceFocus = () => vendorOp("CAM_GET_FACE_FOCUS", Buffer.alloc(0));
+/** Decode a CAM_GET_FACE_FOCUS reply payload: int32le enable flag at offset 0. */
+export const decodeFaceFocus = (payload) => {
+    if (payload.length < 4) {
+        throw new Error(`face-focus reply payload too short: ${payload.length} bytes`);
+    }
+    return { enabled: payload.readInt32LE(0) !== 0 };
+};
+// ---------------------------------------------------------------------------
+//  UVC extension-unit controls  (XU selector 6, NOT a V3 frame)
+// ---------------------------------------------------------------------------
+// FOV and (UVC-mode) WDR/HDR use a fixed 60-byte buffer written via
+// uvc_xu_set(selector = 6, buf, 0x3c). The first three bytes are [tag, 0x01,
+// value]; the rest are zero. tag 0x04 = FOV, 0x01 = WDR/HDR.
+export const UVC_XU_SELECTOR = 6;
+const uvcExt = (tag, value) => {
+    const b = Buffer.alloc(60);
+    b[0] = tag;
+    b[1] = 0x01;
+    b[2] = value & 0xff;
+    return b;
+};
+const FOV_VALUE = { wide: 0, medium: 1, narrow: 2 };
+export const FOV_TYPES = Object.keys(FOV_VALUE);
+export const encodeFov = (fov) => uvcExt(0x04, FOV_VALUE[fov]);
+// HDR/WDR on/off.
+export const encodeHdr = (on) => uvcExt(0x01, on ? 1 : 0);
+const AI_FRAMING = {
+    normal: 0,
+    "upper-body": 1,
+    "close-up": 2,
+    headless: 3,
+    "lower-body": 4,
+};
+export const AI_FRAMING_MODES = Object.keys(AI_FRAMING);
+export const encodeAiTracking = (on, mode = "normal") => {
+    const b = Buffer.alloc(60);
+    b[0] = 0x16;
+    b[1] = 0x02;
+    b[2] = on ? 0x02 : 0x00;
+    b[3] = on ? AI_FRAMING[mode] : 0x00;
+    return b;
+};
+// ---------------------------------------------------------------------------
+//  UVC standard controls (IAMCameraControl / IAMVideoProcAmp) — property ids
+//  and the auto/manual flag values for focus and white balance.
+// ---------------------------------------------------------------------------
+export const CAMERA_CONTROL_PAN = 0; // CameraControl_Pan
+export const CAMERA_CONTROL_TILT = 1; // CameraControl_Tilt
+export const CAMERA_CONTROL_FOCUS = 6; // CameraControl_Focus
+export const CAMERA_CONTROL_EXPOSURE = 4; // CameraControl_Exposure
+export const VIDEO_PROCAMP_WHITE_BALANCE = 7; // VideoProcAmp_WhiteBalance
+export const UVC_FLAG_AUTO = 1; // *_Flags_Auto
+export const UVC_FLAG_MANUAL = 2; // *_Flags_Manual
+export const IMAGE_CONTROL_PROP = {
+    brightness: 0,
+    contrast: 1,
+    hue: 2,
+    saturation: 3,
+    sharpness: 4,
+    "backlight-compensation": 8,
+    gain: 9,
+};
+export const IMAGE_CONTROLS = Object.keys(IMAGE_CONTROL_PROP);
+/** Map a 0..100 percentage onto an inclusive [min,max] device-unit range. */
+export const percentToRange = (pct, min, max) => Math.round(min + (max - min) * (pct / 100));
+// ---------------------------------------------------------------------------
+//  Status block (UVC XU selector 6, GET_CUR) — a flat fixed-offset snapshot,
+//  NOT a V3 frame reply: no magic, no CRC. Offsets confirmed against the
+//  OpenFoxes/Tiny4Linux reference (status.rs). Extend by adding offsets here.
+// ---------------------------------------------------------------------------
+const STATUS_OFF_SLEEP = 0x02; // 0 = awake, 1 = sleep
+const STATUS_OFF_HDR = 0x06; // 0 = off, non-zero = on
+const STATUS_OFF_AI_MODE_M = 0x18; // AI mode tuple, first value
+const STATUS_OFF_AI_MODE_N = 0x1c; // AI mode tuple, second value
+// Track speed lives at 0x24 on the Tiny 2 — NOT the reference's 0x21 (which reads
+// a constant here). Offset found + value map (0=standard, 2=sport) confirmed on
+// hardware 2026-07-13 against the OBSBOT Center Standard/Sport control.
+const STATUS_OFF_TRACK_SPEED = 0x24;
+const AI_MODE_TABLE = {
+    "0,0": "no-tracking",
+    "2,0": "normal",
+    "2,1": "upper-body",
+    "2,2": "close-up",
+    "2,3": "headless",
+    "2,4": "lower-body",
+    "5,0": "desk",
+    "4,0": "whiteboard",
+    "6,0": "hand",
+    "1,0": "group",
+};
+const TRACK_SPEED_TABLE = {
+    0: "standard",
+    2: "sport",
+};
+export const decodeStatus = (block) => {
+    if (block.length <= STATUS_OFF_TRACK_SPEED) {
+        throw new Error(`status block too short: ${block.length} bytes`);
+    }
+    const m = block[STATUS_OFF_AI_MODE_M];
+    const n = block[STATUS_OFF_AI_MODE_N];
+    return {
+        awake: block[STATUS_OFF_SLEEP] === 0,
+        hdr: block[STATUS_OFF_HDR] !== 0,
+        aiMode: AI_MODE_TABLE[`${m},${n}`] ?? "unknown",
+        trackSpeed: TRACK_SPEED_TABLE[block[STATUS_OFF_TRACK_SPEED]] ?? "unknown",
+    };
+};
+//# sourceMappingURL=commands.js.map

package/dist/codec/commands.js.map

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

package/dist/codec/crc.d.ts

@@ -0,0 +1,2 @@
+/** CRC-16/USB: poly 0xA001 (reflected), init 0xFFFF, refin/refout, xorout 0xFFFF. */
+export declare const crc16usb: (data: Buffer) => number;

package/dist/codec/crc.js

@@ -0,0 +1,11 @@
+/** CRC-16/USB: poly 0xA001 (reflected), init 0xFFFF, refin/refout, xorout 0xFFFF. */
+export const crc16usb = (data) => {
+    let crc = 0xffff;
+    for (const b of data) {
+        crc ^= b;
+        for (let i = 0; i < 8; i++)
+            crc = (crc & 1) ? (crc >>> 1) ^ 0xa001 : crc >>> 1;
+    }
+    return (crc ^ 0xffff) & 0xffff;
+};
+//# sourceMappingURL=crc.js.map

package/dist/codec/crc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crc.js","sourceRoot":"","sources":["../../src/codec/crc.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAU,EAAE;IAC/C,IAAI,GAAG,GAAG,MAAM,CAAC;IACjB,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,GAAG,IAAI,CAAC,CAAC;QACT,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;YAAE,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC;IACjF,CAAC;IACD,OAAO,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC;AACjC,CAAC,CAAC"}

package/dist/codec/encoding.d.ts

@@ -0,0 +1,7 @@
+export declare const f32le: (n: number) => Buffer;
+export declare const u16le: (n: number) => Buffer;
+export declare const u32le: (n: number) => Buffer;
+export declare const i32le: (n: number) => Buffer;
+export declare const hexToBuf: (h: string) => Buffer;
+export declare const bufToHex: (b: Buffer) => string;
+export declare const concat: (...b: Buffer[]) => Buffer;

package/dist/codec/encoding.js

@@ -0,0 +1,8 @@
+export const f32le = (n) => { const b = Buffer.alloc(4); b.writeFloatLE(n, 0); return b; };
+export const u16le = (n) => { const b = Buffer.alloc(2); b.writeUInt16LE(n & 0xffff, 0); return b; };
+export const u32le = (n) => { const b = Buffer.alloc(4); b.writeUInt32LE(n >>> 0, 0); return b; };
+export const i32le = (n) => { const b = Buffer.alloc(4); b.writeInt32LE(n | 0, 0); return b; };
+export const hexToBuf = (h) => Buffer.from(h, "hex");
+export const bufToHex = (b) => b.toString("hex");
+export const concat = (...b) => Buffer.concat(b);
+//# sourceMappingURL=encoding.js.map

package/dist/codec/encoding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoding.js","sourceRoot":"","sources":["../../src/codec/encoding.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,CAAS,EAAU,EAAE,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AAC3G,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,CAAS,EAAU,EAAE,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AACrH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,CAAS,EAAU,EAAE,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AAClH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,CAAS,EAAU,EAAE,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/G,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AACrE,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACjE,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,GAAG,CAAW,EAAU,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC"}

package/dist/codec/frame.d.ts

@@ -0,0 +1,20 @@
+export interface FrameOpts {
+    seq: number;
+    cmd: number;
+    receiver: number;
+    payload: Buffer;
+    sender?: number;
+}
+export declare function buildFrame(o: FrameOpts): Buffer;
+export declare class FrameParseError extends Error {
+    constructor(message: string);
+}
+export interface ParsedFrame {
+    seq: number;
+    cmd: number;
+    receiver: number;
+    sender: number;
+    payload: Buffer;
+}
+/** Reverse of buildFrame: validate header + optional payload CRC and slice fields out. */
+export declare function parseFrame(buf: Buffer): ParsedFrame;

package/dist/codec/frame.js

@@ -0,0 +1,73 @@
+import { crc16usb } from "./crc.js";
+import { u16le } from "./encoding.js";
+export function buildFrame(o) {
+    const frame = Buffer.alloc(60); // zero-padded fixed buffer
+    frame[0] = 0xaa;
+    frame[1] = 0x25; // flags: UVC + nested payload (const for v1 cmds)
+    u16le(o.seq).copy(frame, 2);
+    u16le(12).copy(frame, 4); // len = 12 (header covered by token)
+    // token field (6-7) stays 0 for the CRC, filled after
+    frame[8] = o.sender ?? 0x0a;
+    frame[9] = o.receiver;
+    u16le(o.cmd).copy(frame, 10);
+    // header token = CRC-16/USB over frame[0:12] with 6-7 already zero
+    u16le(crc16usb(frame.subarray(0, 12))).copy(frame, 6);
+    // nested payload segment at offset 12
+    if (o.payload.length > 0) {
+        const len2 = o.payload.length;
+        u16le(len2).copy(frame, 12); // len2
+        // token2 field (14-15) zero for CRC
+        o.payload.copy(frame, 16);
+        const seg = frame.subarray(12, 12 + len2 + 4); // len2(2)+token2(2)+payload(len2)
+        u16le(crc16usb(seg)).copy(frame, 14);
+    }
+    return frame;
+}
+export class FrameParseError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "FrameParseError";
+    }
+}
+/** Reverse of buildFrame: validate header + optional payload CRC and slice fields out. */
+export function parseFrame(buf) {
+    if (buf.length < 12)
+        throw new FrameParseError(`frame too short: ${buf.length} bytes`);
+    if (buf[0] !== 0xaa)
+        throw new FrameParseError(`bad magic: 0x${buf[0].toString(16)}`);
+    // Header CRC covers bytes [0,12) with the token field (6-7) treated as zero.
+    const hdr = Buffer.from(buf.subarray(0, 12));
+    hdr[6] = 0;
+    hdr[7] = 0;
+    const wantHdr = crc16usb(hdr);
+    const gotHdr = buf.readUInt16LE(6);
+    if (gotHdr !== wantHdr) {
+        throw new FrameParseError(`header CRC mismatch: got 0x${gotHdr.toString(16)} want 0x${wantHdr.toString(16)}`);
+    }
+    const seq = buf.readUInt16LE(2);
+    const sender = buf[8];
+    const receiver = buf[9];
+    const cmd = buf.readUInt16LE(10);
+    let payload = Buffer.alloc(0);
+    if (buf.length >= 16) {
+        const len2 = buf.readUInt16LE(12);
+        if (len2 > 0) {
+            const end = 16 + len2;
+            if (buf.length < end) {
+                throw new FrameParseError(`truncated payload: need ${end} bytes, have ${buf.length}`);
+            }
+            // Payload CRC covers [12,end) with the token2 field (14-15) treated as zero.
+            const seg = Buffer.from(buf.subarray(12, end));
+            seg[2] = 0; // frame offset 14
+            seg[3] = 0; // frame offset 15
+            const wantSeg = crc16usb(seg);
+            const gotSeg = buf.readUInt16LE(14);
+            if (gotSeg !== wantSeg) {
+                throw new FrameParseError(`payload CRC mismatch: got 0x${gotSeg.toString(16)} want 0x${wantSeg.toString(16)}`);
+            }
+            payload = Buffer.from(buf.subarray(16, end));
+        }
+    }
+    return { seq, cmd, receiver, sender, payload };
+}
+//# sourceMappingURL=frame.js.map

package/dist/codec/frame.js.map

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

package/dist/codec/opcodes.d.ts

@@ -0,0 +1,32 @@
+/** One vendor command and its wire addressing. */
+export interface Opcode {
+    /** Command enum member name, e.g. "AI_SET_GIM_SPEED". */
+    name: string;
+    /** Subsystem group: "Camera" | "Ai" | "Gimbal" | "SysMg" | "TXBle" | ... */
+    subsystem: string;
+    /** Logical command set (CmdSet enum value). */
+    set: number;
+    /** Logical command id within the subsystem (Cmd<Sub> enum value). */
+    cmdId: number;
+    /** 16-bit wire cmd (frame bytes 10-11, little-endian), or null if V0-only. */
+    wireCmd: number | null;
+    /** Receiver byte (frame byte 9), or null if V0-only. */
+    receiver: number | null;
+}
+export declare const OPCODES: readonly Opcode[];
+/** Lookup by enum-member name (e.g. OP_BY_NAME.get("AI_SET_GIM_SPEED")). */
+export declare const OP_BY_NAME: ReadonlyMap<string, Opcode>;
+/** Commands sendable over the V3 wire protocol (have a concrete wireCmd). */
+export declare const SENDABLE: readonly Opcode[];
+/**
+ * Names of commands that can brick the device, erase user data, flash firmware,
+ * reset to factory state, cut power, or run arbitrary code. Any code path that
+ * dispatches an opcode by name (e.g. a future vendorOp/raw-command tool) MUST
+ * refuse — or require explicit human confirmation — when the name is in here.
+ * These are the same commands cordoned off at the end of OPCODES above.
+ */
+export declare const DESTRUCTIVE_NAMES: ReadonlySet<string>;
+/** True when the named command is potentially destructive (see DESTRUCTIVE_NAMES). */
+export declare const isDestructive: (name: string) => boolean;
+/** The potentially-destructive opcodes, cordoned off from the rest of the table. */
+export declare const DESTRUCTIVE: readonly Opcode[];