obsbot-mcp 0.3.1 → 0.4.1

package/README.md

@@ -42,8 +42,8 @@ If you're running from a local checkout instead of an npm install, point `comman
 ### Debug / diagnostics tools
 
 By default the server advertises only the normal control surface. Pass `--debug` to additionally
-expose the diagnostics surface — the `obsbot_probe` tool (raw XU byte get/set/query) and the
-`raw` 60-byte status block on `obsbot_get_status`:
+expose the diagnostics surface — the `obsbot_debug_probe` tool (raw XU byte get/set/query) and the
+`raw` 60-byte status block on `obsbot_status`:
 
 ```json
 {
@@ -60,64 +60,123 @@ With the installed binary, use `"command": "obsbot-mcp"` and `"args": ["--debug"
 
 ## Tools
 
+34 tools total. All names below are current as of v0.4.0 — **every tool was renamed in this
+release and there is no backward-compatible alias**; see [CHANGELOG.md](./CHANGELOG.md) for the
+full old→new mapping if you're updating a caller.
+
+### The `camera` selector
+
+Every camera-addressing tool accepts an optional `camera` parameter: the target camera's serial
+number. Omit it with a single camera attached and nothing changes — this matches the server's
+pre-v0.4.0, single-camera behaviour exactly. With more than one camera attached, a call that omits
+`camera` fails with an error naming every attached serial, so you always know what to pass next.
+
+**Exempt** (no `camera` parameter, ever): `obsbot_devices` (enumerates the whole fleet),
+`obsbot_capture_stop` / `obsbot_capture_list` (address a `sessionId`, not a device), and
+`obsbot_debug_probe` (operates on the current diagnostics transport). Two more tools honor it only
+partially — see **Capture** below.
+
+Multi-camera support is new in v0.4.0. It's exercised by the unit test suite against fakes; running
+two physical Tiny 2s at once has not yet been hardware-verified (see
+[Known limitations](#known-limitations)).
+
+`obsbot_devices` is the way to discover the serials you pass as `camera`: it reports each attached
+camera's `serial` (where obtainable — reading it requires briefly opening the camera), `name`, and
+`status` (`available` | `bound` | `busy`). A camera another process already holds comes back `busy`
+with no serial, since it can't be opened to read one.
+
 ### Device & power
 
 | Tool | Parameters | Description |
 |------|------------|-------------|
-| `obsbot_list_devices` | — | List connected OBSBOT-compatible video capture devices. |
-| `obsbot_set_run_status` | `state`: `"run" \| "sleep"` | Wake (`"run"`) or sleep the camera/gimbal. |
-| `obsbot_get_status` | — | Read the live status block: `{ awake, hdr, aiMode, trackSpeed }`. Under `--debug`, also returns the raw 60-byte block as hex. |
+| `obsbot_devices` | — | List attached OBSBOT cameras with each one's serial (where obtainable), name, and status (`available`/`bound`/`busy`). A `busy` camera is held by another process. |
+| `obsbot_wake` | `camera`? | Wake the camera/gimbal (sends `"run"`). **Moves the camera:** un-stows the gimbal back to level (pitch ~0). Most control commands also wake it implicitly. |
+| `obsbot_sleep` | `camera`? | Sleep the camera/gimbal (sends `"sleep"`). **Moves the camera:** stows the gimbal face-down at roughly pitch `84`, so `obsbot_gimbal_position` reads ~84 rather than the pose you left. |
+| `obsbot_status` | `camera`? | Read the live status block: `{ awake, hdr, faceAe, aiMode, trackSpeed }` (`faceAe` = auto-exposure metering for a detected face). Under `--debug`, also returns the raw 60-byte block as hex. |
 
 ### Gimbal (PTZ)
 
 | Tool | Parameters | Description |
 |------|------------|-------------|
-| `obsbot_ptz_move_angle` | `yaw`, `pitch`, `roll` (degrees, `roll` defaults `0`) | Move the gimbal to an absolute angle. Positive yaw pans to the camera's left, positive pitch tilts down. Yaw clamped to `[-150, 150]`, pitch to `[-90, 90]`. Absolute 1:1 degrees, hardware-verified. |
-| `obsbot_ptz_move_speed` | `yaw`, `pitch`, `roll` (deg/s, `roll` defaults `0`), `autoStopMs` (default `800`) | Drive the gimbal at a speed, then auto-stop after `autoStopMs` so it can't run away. Same yaw/pitch sign convention as `move_angle`. |
-| `obsbot_gimbal_recenter` | — | Recenter the gimbal (return to home position). |
-| `obsbot_gimbal_position` | — | Read the gimbal's current absolute `{ yaw, pitch }` in degrees via standard UVC Pan/Tilt. May lag a move still in progress. |
+| `obsbot_gimbal_move` | `yaw`, `pitch`, `roll` (degrees, `roll` defaults `0`), `camera`? | Move the gimbal to an absolute angle. Positive yaw pans to the camera's left, positive pitch tilts down. Yaw clamped to `[-150, 150]`, pitch to `[-90, 90]`. Absolute 1:1 degrees, hardware-verified. |
+| `obsbot_gimbal_move_speed` | `yaw`, `pitch`, `roll` (deg/s, clamped to `±150`, `roll` defaults `0`), `autoStopMs` (default `800`), `camera`? | Drive the gimbal at a speed, then auto-stop after `autoStopMs` so it can't run away. Same yaw/pitch sign convention as `gimbal_move`. Returns the speeds actually used. Past its limit the firmware ignores the command outright rather than saturating — 180 deg/s and above move the gimbal exactly 0° — so requests are clamped into the hardware-verified band. **Not available on Linux** — see [limitations](#linux-gimbal-position-feedback-is-not-live). |
+| `obsbot_gimbal_recenter` | `camera`? | Recenter the gimbal — drives it to yaw `0` / pitch `0`. Returns as soon as the command is sent, so poll `obsbot_gimbal_position` if you need to know it arrived. |
+| `obsbot_gimbal_position` | `camera`? | Read the gimbal's current absolute `{ yaw, pitch }` in degrees via standard UVC Pan/Tilt. Valid during a move as well as after one. On Linux this is the last-*commanded* value, not a live in-flight reading — see [limitations](#linux-gimbal-position-feedback-is-not-live). |
+
+### Gimbal presets
+
+Three on-device preset slots (1–3). Slots are **create-once**: `obsbot_preset_save` requires an
+empty slot (delete first to reuse one); every other preset tool requires the slot to already be
+occupied. Each tool re-reads the slot list after writing and returns a structured `{ ok:false }`
+failure if the device didn't land the change.
+
+| Tool | Parameters | Description |
+|------|------------|-------------|
+| `obsbot_preset_list` | `camera`? | Read the three preset slots: occupied/empty, name, and pose in degrees. |
+| `obsbot_preset_save` | `slot` (`1`\|`2`\|`3`), `camera`? | Save the gimbal's current live pose into an **empty** slot. |
+| `obsbot_preset_recall` | `slot` (`1`\|`2`\|`3`), `camera`? | Recall an **occupied** slot, driving the gimbal to its saved pose. |
+| `obsbot_preset_update` | `slot` (`1`\|`2`\|`3`), `camera`? | Overwrite an **occupied** slot with the gimbal's current live pose. |
+| `obsbot_preset_rename` | `slot` (`1`\|`2`\|`3`), `name`, `camera`? | Rename an **occupied** slot (names over 40 bytes are truncated). |
+| `obsbot_preset_delete` | `slot` (`1`\|`2`\|`3`), `camera`? | Delete an **occupied** slot, freeing it for `obsbot_preset_save`. |
 
 ### Zoom
 
+Two tools, not one — they ride different transports (standard UVC vs. the vendor command frame)
+and produce different physical zoom at the same commanded `ratio`, so merging them would silently
+change what `ratio` means. Pick by which behaviour you need.
+
 | Tool | Parameters | Description |
 |------|------------|-------------|
-| `obsbot_zoom_absolute` | `ratio` (`1.0`–`2.0`) | Set absolute zoom ratio, clamped to `[1.0, 2.0]`. |
-| `obsbot_zoom_speed` | `ratio` (`1.0`–`2.0`), `speed` (default `0`) | Zoom to a ratio at a chosen speed: `0` = device default, `1`–`10` slow→fast, `255` = maximum. |
+| `obsbot_zoom_uvc` | `ratio` (`1.0`–`2.0`), `camera`? | Standard UVC zoom: set an absolute zoom ratio, clamped to `[1.0, 2.0]`. Snaps to the requested target exactly. |
+| `obsbot_zoom_vendor` | `ratio` (`1.0`–`2.0`), `speed` (default `0`), `camera`? | Vendor zoom path with adjustable speed: zoom to a ratio at a chosen speed (`0` = device default, `1`–`10` slow→fast, `255` = maximum). **Its ratio scale differs from `obsbot_zoom_uvc`'s** and may not land exactly on the requested target — see [Known limitations](#known-limitations). |
 
 ### AI tracking
 
 | Tool | Parameters | Description |
 |------|------------|-------------|
-| `obsbot_ai_tracking` | `enabled` (bool), `mode` (default `"normal"`) | Enable/disable AI subject tracking and choose framing: `normal \| upper-body \| close-up \| headless \| lower-body`. Polls status and returns `{ verified, matched }` (`matched:false` = no subject tracked yet). |
-| `obsbot_ai_track_speed` | `speed`: `"standard" \| "sport"` | Set the tracking-speed preset (Center's Standard/Sport): `standard` (slower follow) or `sport` (snappier). |
-| `obsbot_face_focus` | `enabled` (bool) | Enable or disable face-priority autofocus. |
+| `obsbot_ai_track` | `enabled` (bool), `mode` (default `"normal"`), `camera`? | Enable/disable AI tracking and choose the mode: a human framing (`normal \| upper-body \| close-up \| headless \| lower-body`) or a scene mode (`group \| whiteboard \| desk \| hand`). Polls status and returns `{ verified, matched }` (`matched:false` = no subject tracked yet). |
+| `obsbot_ai_track_speed` | `speed`: `"standard" \| "sport"`, `camera`? | Set the tracking-speed preset (Center's Standard/Sport): `standard` (slower follow) or `sport` (snappier). |
+| `obsbot_focus_face` | `enabled` (bool), `camera`? | Enable or disable face-priority autofocus. |
 
 ### Image & lens
 
+Focus, white balance, and exposure each split into a dedicated `_auto` and `_manual` tool in
+v0.4.0 (previously one tool with a mode parameter) — auto and manual take different parameters, so
+splitting them lets each schema say exactly what it needs.
+
 | Tool | Parameters | Description |
 |------|------------|-------------|
-| `obsbot_fov` | `fov`: `"wide" \| "medium" \| "narrow"` | Set the field of view: wide (86°), medium (78°), narrow (65°). |
-| `obsbot_hdr` | `enabled` (bool) | Toggle HDR/WDR imaging on or off. |
-| `obsbot_focus` | `mode`: `"auto" \| "manual"`, `position` (`0`–`100`, default `50`) | `auto` = continuous autofocus; `manual` = set the focus motor to `position` (near→far). |
-| `obsbot_exposure` | `mode`: `"auto" \| "manual"`, `level` (`0`–`100`, default `50`) | `auto` = auto-exposure; `manual` = set `level` (0 darkest → 100 brightest). |
-| `obsbot_white_balance` | `mode`: `"auto" \| "manual"`, `temperature` (Kelvin, default `5000`) | `auto` = auto white balance; `manual` = set a colour temperature (clamped to device range). |
-| `obsbot_image_control` | `control`, `level` (`0`–`100`) | Adjust `brightness \| contrast \| hue \| saturation \| sharpness \| gain \| backlight-compensation`; `level` maps onto the device range. |
+| `obsbot_image_fov` | `fov`: `"wide" \| "medium" \| "narrow"`, `camera`? | Set the field of view: wide (86°), medium (78°), narrow (65°). |
+| `obsbot_image_hdr` | `enabled` (bool), `camera`? | Toggle HDR/WDR imaging on or off. |
+| `obsbot_focus_auto` | `camera`? | Enable continuous autofocus. |
+| `obsbot_focus_manual` | `position` (`0`–`100`, default `50`), `camera`? | Set the focus motor to `position` (near→far). |
+| `obsbot_image_exposure_auto` | `priority` (`"global" \| "face"`, optional), `camera`? | Enable auto-exposure; optional `priority` selects global vs face metering. |
+| `obsbot_image_exposure_manual` | `level` (`0`–`100`, default `50`), `camera`? | Set exposure `level` (0 darkest → 100 brightest). |
+| `obsbot_image_wb_auto` | `camera`? | Enable auto white balance. |
+| `obsbot_image_wb_manual` | `temperature` (Kelvin, default `5000`), `camera`? | Set a colour temperature (clamped to device range). |
+| `obsbot_image_adjust` | `control`, `level` (`0`–`100`), `camera`? | Adjust `brightness \| contrast \| hue \| saturation \| sharpness \| gain \| backlight-compensation`; `level` maps onto the device range. **`gain` and `backlight-compensation` are not implemented on the Tiny 2** (it reports them as zero-length controls) and are refused with an error; the other five work. |
 
 ### Capture
 
+**`obsbot_capture_record` and `obsbot_capture_preview` do not take `camera`.** They select a device
+by `source` (`device`/`virtual`/`ndi`) through ffmpeg/ffplay, not by serial — there is no
+serial-to-ffmpeg-device mapping yet. **`obsbot_capture_snapshot` honors `camera` only for
+`source:"device"`**; for `source:"virtual"`/`"ndi"` the pixel source is still resolved by device
+name, independent of `camera`.
+
 | Tool | Parameters | Description |
 |------|------------|-------------|
-| `obsbot_snapshot` | `maxDim` (`256`–`1920`, default `1024`), `quality` (`1`–`100`, default `80`), `settleMs` (default `600`), `source` (default `"device"`) | Grab one still frame and return it as an image (for framing/lighting/exposure checks). `source`: `device \| virtual \| ndi`. |
-| `obsbot_record_start` | `durationSec` (optional), `audio` (default `true`), `outputPath` (optional), `source` (default `"device"`) | Start recording to MP4. Open-ended recordings auto-stop after 60 min; audio uses the OBSBOT mic; defaults under `Videos/OBSBOT`. Returns a `sessionId`. **Needs ffmpeg.**¹ |
-| `obsbot_preview_start` | `source` (default `"device"`) | Open a live preview window. Returns a `sessionId`. **Needs ffplay.**¹ |
-| `obsbot_capture_stop` | `sessionId` | Stop a recording or preview session (recordings are finalized gracefully). |
-| `obsbot_capture_list` | — | List active recording/preview sessions. |
+| `obsbot_capture_snapshot` | `resolution` (`256`–`1920`, default `640`), `quality` (`1`–`100`, default `80`), `settleMs` (default `600`), `source` (default `"device"`), `camera`? (source:"device" only) | Grab one still frame and return it as an image (for framing/lighting/exposure checks). `resolution` is the longest edge in pixels — larger costs proportionally more tokens. `source`: `device \| virtual \| ndi`. |
+| `obsbot_capture_record` | `durationSec` (optional), `audio` (default `true`), `outputPath` (optional), `source` (default `"device"`) | Start recording to MP4. Open-ended recordings auto-stop after 60 min; audio uses the OBSBOT mic; defaults to `~/Videos/OBSBOT` on every platform, including macOS, where that is not the usual `~/Movies`. Returns a `sessionId`. **Needs ffmpeg.**¹ No `camera`. |
+| `obsbot_capture_preview` | `source` (default `"device"`) | Open a live preview window. Returns a `sessionId`. **Needs ffplay.**¹ No `camera`. |
+| `obsbot_capture_stop` | `sessionId` | Stop a recording or preview session (recordings are finalized gracefully). No `camera`. |
+| `obsbot_capture_list` | — | List active recording/preview sessions. No `camera`. |
 
 ### Diagnostics (`--debug` only)
 
 | Tool | Parameters | Description |
 |------|------------|-------------|
-| `obsbot_probe` | `mode`: `"get" \| "set" \| "query"`, plus `selector`, `length`, `hex`, `opcode`, `payloadHex` | RE/diagnostics only — raw XU byte get/set and framed table queries. Advertised only under `--debug`. |
+| `obsbot_debug_probe` | `mode`: `"get" \| "set" \| "query"`, plus `selector`, `length`, `hex`, `opcode`, `payloadHex` | RE/diagnostics only — raw XU byte get/set and framed table queries. Advertised only under `--debug`. No `camera`. |
 
 ¹ `record`/`preview` shell out to **ffmpeg**/**ffplay** (install: `winget install Gyan.FFmpeg`
 on Windows, `brew install ffmpeg` on macOS, `apt install ffmpeg` on Linux). `snapshot` does **not**
@@ -129,10 +188,14 @@ need ffmpeg — it grabs the frame through the native helper.
   (CMake + MSVC); the published npm package ships a prebuilt binary so end users need no toolchain.
 - **Linux x64** — supported from v0.2. The native helper is in `native/linux/` (CMake + GCC);
   it uses **V4L2** for standard UVC controls (zoom, focus, exposure, pan/tilt, white balance,
-  image controls) and `UVCIOC_CTRL_QUERY` for vendor Extension Unit commands (gimbal, AI tracking,
-  wake/sleep, HDR, FOV). Snapshots capture a MJPEG or YUYV frame via V4L2 mmap streaming and encode
-  to JPEG using **libjpeg**. The `linux-x64` prebuilt binary ships with the published npm package.
-  Build dependencies: `build-essential cmake libjpeg-dev libv4l-dev`.
+  image controls) and `UVCIOC_CTRL_QUERY` for vendor Extension Unit commands (gimbal speed/AI
+  tracking, wake/sleep, HDR, FOV). Snapshots capture a MJPEG or YUYV frame via V4L2 mmap streaming
+  and encode to JPEG using **libjpeg**. The `linux-x64` prebuilt binary ships with the published npm
+  package. Build dependencies: `build-essential cmake libjpeg-dev libv4l-dev`.
+
+  Gimbal *position* reads (`obsbot_gimbal_position`) reflect the last-commanded value, not live
+  in-flight position — see ["Linux gimbal position feedback"](#linux-gimbal-position-feedback-is-not-live)
+  below for why, and what would fix it.
 - **macOS 14+ (Apple Silicon and Intel)** — supported. The native helper is in `native/macos/`
   (Objective-C + **IOKit**/**AVFoundation**). It uses IOKit USB control transfers for both standard
   UVC controls and vendor Extension Unit commands, and AVFoundation for enumeration and snapshots.
@@ -159,6 +222,37 @@ make -j$(nproc)
 make install  # copies to native/prebuilt/linux-x64/
 ```
 
+### Linux gimbal position feedback is not live
+
+`obsbot_gimbal_position` on Linux reports the last position `obsbot_gimbal_move`/
+`obsbot_gimbal_recenter` commanded — not a live, in-flight reading. Hardware testing (2026-07-21)
+confirmed the OBSBOT Tiny 2's `CT_PANTILT_ABSOLUTE` control genuinely tracks live position — a raw
+USB read of that same control, bypassing the kernel, showed a real slew progressing in real time.
+The reason plain V4L2 (`VIDIOC_G_CTRL`) never sees that is that `uvcvideo` caches the control's
+value and serves the cache instead of re-querying the device (confirmed via
+`VIDIOC_QUERY_EXT_CTRL`, which reports no `V4L2_CTRL_FLAG_VOLATILE`). The driver invalidates that
+cache when the device sends a UVC Control Change interrupt — which this camera's firmware never
+does, and never advertises support for.
+
+Getting a genuinely live reading through V4L2 requires briefly detaching the kernel driver from
+the camera's control interface and reading the control directly over raw USB — but detaching that
+interface (even briefly, even without writing anything) breaks any concurrent video capture on this
+device: streaming and control share one kernel-managed USB function, so pulling the driver off one
+takes both down together. That makes a libusb-based workaround incompatible with anything actually
+using the camera as a webcam at the same time, which ruled it out as a shipped default.
+
+**A kernel patch is being worked on.** If one lands, `obsbot_gimbal_position` would become live
+through plain V4L2 with no code changes needed here. Until then:
+
+- `obsbot_gimbal_move` and `obsbot_gimbal_recenter` work normally — hardware-verified,
+  repeatedly, via direct V4L2 `VIDIOC_S_CTRL` writes. Their target values are known and clamped
+  before being sent, so they can't exceed the gimbal's mechanical range regardless of the missing
+  feedback.
+- **`obsbot_gimbal_move_speed` is not available on Linux** (hidden from the tool list entirely,
+  not just refused at runtime). A speed×duration burst has no target position to clamp — without a
+  live reading to confirm where the gimbal actually is, there's no way to bound it against the
+  mechanical limits before it gets there. It remains available on Windows/macOS.
+
 ### Building the native helper (macOS)
 
 ```bash
@@ -174,9 +268,9 @@ What has actually been exercised against hardware, and what hasn't:
 
 | Platform | Status |
 |---|---|
-| `win32-x64` | Builds in CI |
-| `linux-x64` | Builds in CI |
-| `darwin-arm64` | **Hardware-verified** — control, gimbal, zoom, and snapshot on a real Tiny 2 |
+| `win32-x64` | **Hardware-verified** — mid-session disconnect recovery (`ERROR_DEV_NOT_EXIST`, measured not guessed), camera arrival/removal push events, proactive re-bind across a **same-port** replug with no tool call, white balance, and the ProcAmp control ranges, on a real Tiny 2. A **different-port** replug recovers on the next tool call rather than proactively — see below |
+| `linux-x64` | **Hardware-verified** — gimbal absolute moves and recenter via V4L2 (20 consecutive moves with a live preview running), and the arc-second scaling fix confirmed by physical swing. Gimbal *position* is not live and `obsbot_gimbal_move_speed` is unavailable — see below |
+| `darwin-arm64` | **Hardware-verified** — control, gimbal movement **and per-axis position readback**, zoom, snapshot, USB vid/pid candidacy, serial readback and serial-keyed binding, single-owner IPC coordination, helper-death recovery, and **unaided recovery from an unplug/replug**, on a real Tiny 2 |
 | `darwin-x64` | **Build-verified only** — compiles with the right architecture and deployment target, never executed |
 
 - **The Intel (`darwin-x64`) helper has never been run.** No Intel Mac was available to test it. It
@@ -192,13 +286,76 @@ What has actually been exercised against hardware, and what hasn't:
   with no bundle identifier, so macOS attributes camera access to whichever app spawned it — your
   MCP client — and that app is named in the prompt and holds the grant. Approve once; the grant
   survives helper updates, since it is keyed to the client rather than to the helper's signature.
+- **AI tracking overrides manual gimbal moves.** When AI tracking is active (the Tiny 2's default
+  on wake), a commanded pan/tilt executes and is then pulled back to the tracked subject —
+  `obsbot_gimbal_position` shows the yaw/pitch move out and decay back to rest. This is the camera's
+  behaviour, not a bug: turn tracking off for unopposed manual control.
 - **The camera may not enumerate through a USB hub or dock.** A Tiny 2 connected through a USB-C
   dock was invisible to `ioreg` and `system_profiler` entirely — not just to this server. If
-  `obsbot_list_devices` comes back empty, try a direct connection before assuming a software fault.
-- **Only the OBSBOT Tiny 2 is supported.** On macOS the USB vendor/product IDs are hardcoded
-  (`0x3564`/`0xFEF8`), so no other model is detected at all. Windows and Linux match devices by
-  name, so a different OBSBOT may be *found* — but the vendor command set is Tiny 2 specific
-  either way.
+  `obsbot_devices` comes back empty, try a direct connection before assuming a software fault.
+- **Only the OBSBOT Tiny 2 is supported.** On Windows and macOS candidacy is gated on the Remo USB
+  vendor ID plus a known-model product ID (`0x3564`/`0xFEF8`), so no other model is detected at
+  all — and a name-matching software source, such as the "OBSBOT Virtual Camera" that OBSBOT Center
+  registers, is rejected because it reports no vid/pid. Linux still matches by name, because its
+  helper does not report vid/pid yet, so a different OBSBOT may be *found* there — but the vendor
+  command set is Tiny 2 specific either way. (On macOS the virtual camera cannot appear at all: the
+  helper enumerates USB devices through the IORegistry, which a software camera never enters.)
+- **The vendor reply mailbox is unreliable for several seconds after a replug.** On 2026-07-21 a
+  Tiny 2 was seen returning only the host's own echoed request frame from the vendor reply mailbox
+  (XU selector 2) — magic byte `0xaa` cleared to `0x00`, every other byte identical — for a
+  continuous 3.2 s. `readSerial()` threw, `bind()` found no serial, and every tool needing a bound
+  camera failed with "no OBSBOT camera found" while the device was plainly healthy: correct
+  vid/pid, opened fine, XU node 2, live status block on selector 6.
+
+  That was unexplained for a while. It is now reproducible: **immediately after a USB
+  re-enumeration**. Polling `readSerial` every 50 ms across a replug failed 22 times in 80 attempts
+  spread over the first 14 s, against 0 in 120 in steady state; the first read after arrival showed
+  exactly the echoed-request signature above, and later failures showed the reply slot populated
+  but with its magic byte still zeroed. Ruled out as causes: stale per-process device state (the
+  same long-lived helper read a brand-new uniqueID cleanly at t+49 ms), re-opening the device
+  (0/40 either way), and the per-transport sequence counter restarting at 1 (0/80).
+
+  Consequence for callers: a bind attempted in the first seconds after a replug can fail even
+  though the camera is fine. Retrying works. The arrival-driven re-bind now retries on a bounded
+  ladder for this reason, and a `readSerial` failure reports what the mailbox actually held
+  (echoed request / unparseable / a reply to another request) rather than only "no valid reply".
+  Ruled out earlier and still ruled out: reply latency (polled 3.2 s), the wrong extension unit
+  (the VideoControl interface exposes exactly one, `bUnitID 2`), the wrong `wLength` (every XU
+  selector is 60 bytes by `GET_LEN`), the reply arriving on another selector (1–19 swept), camera
+  sleep state, and contention from OBSBOT Center.
+- **Recovery after a replug is proactive, but not in every case, and it differs by platform.**
+  The server subscribes to OS camera arrival/removal events, so in the common case a replugged
+  camera re-binds itself with no tool call — `obsbot_devices` reports it `bound` again on its own.
+  Every cell below is hardware-measured:
+
+  | scenario | macOS | Windows | Linux |
+  |---|---|---|---|
+  | same-port replug | proactive | proactive | next tool call |
+  | different-port replug | proactive | next tool call | next tool call |
+
+  Where it says "next tool call", nothing is stranded — the call that follows detects the stale
+  binding, prunes it and re-binds. It costs one failed call, which is exactly how every platform
+  behaved before these events existed. The Windows difference comes from its arrival filter
+  requiring a path it has already enumerated, which is also what stops the Tiny 2's *audio*
+  interface from being reported as a second camera; macOS has no equivalent problem because it
+  re-binds by serial and ignores the path. Linux emits no bus events at all yet.
+
+  Note the interaction with the mailbox entry above: a re-bind attempted immediately after a
+  replug can still lose the first attempt, so the server retries on a short bounded ladder.
+
+- **Two-camera operation is not yet hardware-verified.** The `camera` selector and the
+  per-camera device registry are covered by the unit test suite against fake transports; running
+  two physical Tiny 2s attached at once has not been confirmed on real hardware (a second unit
+  wasn't available). Single-camera use is unaffected either way.
+- **Linux gimbal position feedback is not live, and `obsbot_gimbal_move_speed` is unavailable
+  there as a result.** See ["Linux gimbal position feedback is not live"](#linux-gimbal-position-feedback-is-not-live)
+  above — a kernel patch to fix this at the source is being worked on. `obsbot_gimbal_move` and
+  `obsbot_gimbal_recenter` are unaffected; both are hardware-verified to work normally.
+- **`obsbot_zoom_vendor`'s ratio scale doesn't match `obsbot_zoom_uvc`'s at the same `ratio`.** A
+  hardware snapshot comparison at `ratio: 2.0` showed the vendor path framed tighter than the UVC
+  path. Whether the vendor-side ratio encoding is off by a scale factor, or the two zoom controls
+  simply have different physical ranges, isn't determined yet — one comparison isn't enough to
+  tell. Tracked separately; use `obsbot_zoom_uvc` if you need the ratio to land exactly.
 
 ## No proprietary SDK
 

package/dist/codec/commands.d.ts

@@ -1,10 +1,22 @@
 import { VendorFrame, RunState } from "./types.js";
 /**
  * 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.
+ * payload. Used by the obsbot_debug_probe tool to exercise unmapped GET/query
+ * opcodes (e.g. AI_GET_QUICK_STATUS) while reverse-engineering the feedback surface.
  */
 export declare const encodeVendorProbe: (name: string, payload: Buffer) => VendorFrame;
+/**
+ * Header-only vendor GET (flags 0x01, no nested payload). On this device the
+ * framed-V3 vendor GET path only answers when the frame's flags byte is 0x01;
+ * SET commands (the vendorOp default) use 0x25. wireCmd/receiver come from the
+ * opcode table, same as every other vendor encoder.
+ */
+export declare const encodeVendorGet: (name: string) => VendorFrame;
+/**
+ * Decode a UG_GET_SN reply payload (14 ASCII bytes) into the serial string.
+ * Anything from the first NUL onward is dropped, then the result is trimmed.
+ */
+export declare const decodeSerial: (payload: Buffer) => string;
 export declare const encodeSetRunStatus: (state: RunState) => VendorFrame;
 export declare const encodePtzMoveAngle: (yaw: number, pitch: number, roll: number) => VendorFrame;
 export declare const encodePtzMoveSpeed: (yaw: number, pitch: number, roll: number) => VendorFrame;
@@ -25,8 +37,27 @@ export declare const AI_TRACK_SPEEDS: AiTrackSpeed[];
 export declare const encodeAiTrackSpeed: (speed: AiTrackSpeed) => VendorFrame;
 export declare const encodeZoomWithSpeed: (ratioX100: number, speed: number) => VendorFrame;
 export declare const encodeFaceFocus: (enable: boolean) => VendorFrame;
-export declare const encodeSetExposureMode: (manual: boolean) => VendorFrame;
-export declare const encodeSetExposureValue: (raw: number) => VendorFrame;
+/**
+ * Set exposure mode and value together.
+ *
+ * `CAM_SET_EXPOSURE_TINY2` takes a **5-byte** `[mode:u8][value:u32le]` payload and
+ * sets both fields at once. Payload width is load-bearing: the 4-byte `i32le`
+ * payload this previously shipped is SILENTLY DISCARDED — writing 500 left the
+ * readback at 330, while the 5-byte form landed immediately (verified 2026-07-20
+ * against `CAM_GET_EXPOSURE_TINY2`, which returns this same `[mode][value]` shape).
+ *
+ * The separate `CAM_SET_EXPOSURE_MODE` command is inert — writing 0 then 1 left the
+ * mode pinned — so it has been removed. Mode is only settable through this command.
+ *
+ * UNVERIFIED: which mode byte means auto and which means manual. Writing 0 reads
+ * back as 2; writing 1 reads back as 1, so the readback encoding is 1/2 rather than
+ * the 0/1 this code long assumed. Attempting to discriminate by observing whether a
+ * written value drifts was inconclusive, most likely because auto-exposure has no
+ * frames to meter while nothing is streaming. `manual` is therefore mapped to the
+ * byte the caller has always intended (1 = manual, 0 = auto) — which is at worst no
+ * worse than before, since previously neither field was written at all.
+ */
+export declare const encodeSetExposure: (manual: boolean, raw: number) => VendorFrame;
 export declare const encodeGetExposureMode: () => VendorFrame;
 export declare const encodeGetExposureValue: () => VendorFrame;
 export declare const encodeGetExposureRange: () => VendorFrame;
@@ -46,9 +77,15 @@ export declare const UVC_XU_SELECTOR = 6;
 export type FovType = "wide" | "medium" | "narrow";
 export declare const FOV_TYPES: FovType[];
 export declare const encodeFov: (fov: FovType) => Buffer;
+export declare const encodeFaceAe: (face: boolean) => Buffer;
 export declare const encodeHdr: (on: boolean) => Buffer;
 export type AiFramingMode = "normal" | "upper-body" | "close-up" | "headless" | "lower-body";
 export declare const AI_FRAMING_MODES: AiFramingMode[];
+export type AiWorkMode = "none" | "group" | "human" | "hand" | "whiteboard" | "desk";
+export declare const AI_WORK_MODES: AiWorkMode[];
+export type AiSceneMode = "group" | "whiteboard" | "desk" | "hand";
+export declare const AI_SCENE_MODES: AiSceneMode[];
+export declare const encodeAiMode: (work: AiWorkMode, framing?: AiFramingMode) => Buffer;
 export declare const encodeAiTracking: (on: boolean, mode?: AiFramingMode) => Buffer;
 export declare const CAMERA_CONTROL_PAN = 0;
 export declare const CAMERA_CONTROL_TILT = 1;
@@ -67,6 +104,7 @@ export type TrackSpeedStatus = "standard" | "sport" | "unknown";
 export interface CameraStatus {
     awake: boolean;
     hdr: boolean;
+    faceAe: boolean;
     aiMode: AiModeStatus;
     trackSpeed: TrackSpeedStatus;
 }

package/dist/codec/commands.js

@@ -5,20 +5,32 @@ import { OP_BY_NAME } from "./opcodes.js";
 // 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 vendorOp = (name, payload, flags) => {
     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 }) };
+    return { kind: "vendor", buildFrame: (seq) => buildFrame({ seq, cmd: wireCmd, receiver, payload, flags }) };
 };
 /**
  * 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.
+ * payload. Used by the obsbot_debug_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);
+/**
+ * Header-only vendor GET (flags 0x01, no nested payload). On this device the
+ * framed-V3 vendor GET path only answers when the frame's flags byte is 0x01;
+ * SET commands (the vendorOp default) use 0x25. wireCmd/receiver come from the
+ * opcode table, same as every other vendor encoder.
+ */
+export const encodeVendorGet = (name) => vendorOp(name, Buffer.alloc(0), 0x01);
+/**
+ * Decode a UG_GET_SN reply payload (14 ASCII bytes) into the serial string.
+ * Anything from the first NUL onward is dropped, then the result is trimmed.
+ */
+export const decodeSerial = (payload) => payload.toString("ascii").replace(/\0.*$/, "").trim();
 // 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
@@ -75,8 +87,27 @@ export const encodeFaceFocus = (enable) => vendorOp("CAM_SET_FACE_FOCUS", i32le(
 //    - CAM_SET_EXPOSURE_MODE (0x2442): i32le(0=auto, 1=manual)
 //    - CAM_SET_EXPOSURE_TINY2  (0x2982): i32le(value) 0..65535
 // ---------------------------------------------------------------------------
-export const encodeSetExposureMode = (manual) => vendorOp("CAM_SET_EXPOSURE_MODE", i32le(manual ? 1 : 0));
-export const encodeSetExposureValue = (raw) => vendorOp("CAM_SET_EXPOSURE_TINY2", i32le(raw));
+/**
+ * Set exposure mode and value together.
+ *
+ * `CAM_SET_EXPOSURE_TINY2` takes a **5-byte** `[mode:u8][value:u32le]` payload and
+ * sets both fields at once. Payload width is load-bearing: the 4-byte `i32le`
+ * payload this previously shipped is SILENTLY DISCARDED — writing 500 left the
+ * readback at 330, while the 5-byte form landed immediately (verified 2026-07-20
+ * against `CAM_GET_EXPOSURE_TINY2`, which returns this same `[mode][value]` shape).
+ *
+ * The separate `CAM_SET_EXPOSURE_MODE` command is inert — writing 0 then 1 left the
+ * mode pinned — so it has been removed. Mode is only settable through this command.
+ *
+ * UNVERIFIED: which mode byte means auto and which means manual. Writing 0 reads
+ * back as 2; writing 1 reads back as 1, so the readback encoding is 1/2 rather than
+ * the 0/1 this code long assumed. Attempting to discriminate by observing whether a
+ * written value drifts was inconclusive, most likely because auto-exposure has no
+ * frames to meter while nothing is streaming. `manual` is therefore mapped to the
+ * byte the caller has always intended (1 = manual, 0 = auto) — which is at worst no
+ * worse than before, since previously neither field was written at all.
+ */
+export const encodeSetExposure = (manual, raw) => vendorOp("CAM_SET_EXPOSURE_TINY2", concat(Buffer.from([manual ? 1 : 0]), u32le(raw)));
 export const encodeGetExposureMode = () => vendorOp("CAM_GET_EXPOSURE_MODE", Buffer.alloc(0));
 export const encodeGetExposureValue = () => vendorOp("CAM_GET_EXPOSURE_TINY2", Buffer.alloc(0));
 export const encodeGetExposureRange = () => vendorOp("CAM_GET_EXPOSURE_RANGE_TINY2", Buffer.alloc(0));
@@ -120,6 +151,11 @@ const uvcExt = (tag, value) => {
 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]);
+// Face-priority auto-exposure toggle. Same sel-6 uvcExt family, tag 0x03:
+// [0x03, 0x01, v] with v=1 face / 0 global. Hardware-verified 2026-07-18 — the write
+// moves status offset 0x07 (1=face, 0=global). Precondition: auto-exposure must be on
+// first. This is AE priority, distinct from face_focus (which is autofocus).
+export const encodeFaceAe = (face) => uvcExt(0x03, face ? 1 : 0);
 // HDR/WDR on/off.
 export const encodeHdr = (on) => uvcExt(0x01, on ? 1 : 0);
 const AI_FRAMING = {
@@ -130,14 +166,27 @@ const AI_FRAMING = {
     "lower-body": 4,
 };
 export const AI_FRAMING_MODES = Object.keys(AI_FRAMING);
-export const encodeAiTracking = (on, mode = "normal") => {
+const AI_WORK_MODE = {
+    none: 0,
+    group: 1,
+    human: 2,
+    hand: 3,
+    whiteboard: 4,
+    desk: 5,
+};
+export const AI_WORK_MODES = Object.keys(AI_WORK_MODE);
+export const AI_SCENE_MODES = ["group", "whiteboard", "desk", "hand"];
+export const encodeAiMode = (work, framing = "normal") => {
     const b = Buffer.alloc(60);
     b[0] = 0x16;
     b[1] = 0x02;
-    b[2] = on ? 0x02 : 0x00;
-    b[3] = on ? AI_FRAMING[mode] : 0x00;
+    b[2] = AI_WORK_MODE[work];
+    b[3] = work === "human" ? AI_FRAMING[framing] : 0x00;
     return b;
 };
+// Enable/disable human subject tracking with a framing sub-mode. This is the common
+// case, kept as a thin wrapper over encodeAiMode: enable = human, disable = none.
+export const encodeAiTracking = (on, mode = "normal") => encodeAiMode(on ? "human" : "none", mode);
 // ---------------------------------------------------------------------------
 //  UVC standard controls (IAMCameraControl / IAMVideoProcAmp) — property ids
 //  and the auto/manual flag values for focus and white balance.
@@ -168,6 +217,7 @@ export const percentToRange = (pct, min, max) => Math.round(min + (max - min) *
 // ---------------------------------------------------------------------------
 const STATUS_OFF_SLEEP = 0x02; // 0 = awake, 1 = sleep
 const STATUS_OFF_HDR = 0x06; // 0 = off, non-zero = on
+const STATUS_OFF_FACE_AE = 0x07; // 0 = global AE, 1 = face-priority AE (HW-verified 2026-07-18)
 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
@@ -183,7 +233,18 @@ const AI_MODE_TABLE = {
     "2,4": "lower-body",
     "5,0": "desk",
     "4,0": "whiteboard",
-    "6,0": "hand",
+    // Hand shows up as m=3 (= AiWorkModeType Hand) on the live Tiny 2 firmware
+    // (verified 2026-07-18); the Tiny4Linux reference lists m=6.
+    //
+    // Do NOT also map "6,0" to "hand" to cover the reference's numbering. On this
+    // firmware m=6 is the MID-SWITCH TRANSIENT the device parks at while changing
+    // framing, so it must fall through to "unknown" — verifyFraming() (src/mcp/framing.ts)
+    // relies on "unknown" meaning "not settled yet" and keeps polling. Decoding the
+    // transient as a real framing made every switch early-exit with a false-negative
+    // `verified:"hand", matched:false` on a write that had actually succeeded.
+    // Wire evidence (2026-07-21, XU sel 6 @ 60 ms, normal->upper-body):
+    //   m=2,n=0 (before) -> m=6,n=0 (~200 ms transient) -> m=2,n=1 (landed).
+    "3,0": "hand",
     "1,0": "group",
 };
 const TRACK_SPEED_TABLE = {
@@ -199,6 +260,7 @@ export const decodeStatus = (block) => {
     return {
         awake: block[STATUS_OFF_SLEEP] === 0,
         hdr: block[STATUS_OFF_HDR] !== 0,
+        faceAe: block[STATUS_OFF_FACE_AE] === 1,
         aiMode: AI_MODE_TABLE[`${m},${n}`] ?? "unknown",
         trackSpeed: TRACK_SPEED_TABLE[block[STATUS_OFF_TRACK_SPEED]] ?? "unknown",
     };

package/dist/codec/commands.js.map

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

package/dist/codec/frame.d.ts

@@ -4,6 +4,7 @@ export interface FrameOpts {
     receiver: number;
     payload: Buffer;
     sender?: number;
+    flags?: number;
 }
 export declare function buildFrame(o: FrameOpts): Buffer;
 export declare class FrameParseError extends Error {

package/dist/codec/frame.js

@@ -3,7 +3,7 @@ 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)
+    frame[1] = o.flags ?? 0x25; // 0x25 = SET (nested payload); 0x01 = header-only GET
     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