obsbot-mcp 0.3.0 → 0.4.0

package/dist/codec/frame.js.map

@@ -1 +1 @@
-{"version":3,"file":"frame.js","sourceRoot":"","sources":["../../src/codec/frame.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"frame.js","sourceRoot":"","sources":["../../src/codec/frame.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAItC,MAAM,UAAU,UAAU,CAAC,CAAY;IACrC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAY,2BAA2B;IACtE,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAChB,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAiB,sDAAsD;IAClG,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAC5B,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAmB,qCAAqC;IACjF,sDAAsD;IACtD,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,IAAI,IAAI,CAAC;IAC5B,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;IACtB,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC7B,mEAAmE;IACnE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACtD,sCAAsC;IACtC,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAc,OAAO;QACjD,oCAAoC;QACpC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC1B,MAAM,GAAG,GAAG,KAAK,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,kCAAkC;QACjF,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAUD,0FAA0F;AAC1F,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,IAAI,GAAG,CAAC,MAAM,GAAG,EAAE;QAAE,MAAM,IAAI,eAAe,CAAC,oBAAoB,GAAG,CAAC,MAAM,QAAQ,CAAC,CAAC;IACvF,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI;QAAE,MAAM,IAAI,eAAe,CAAC,gBAAgB,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAEtF,6EAA6E;IAC7E,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IAC7C,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACX,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACX,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC9B,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACnC,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;QACvB,MAAM,IAAI,eAAe,CACvB,8BAA8B,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,WAAW,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CACnF,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAChC,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IACtB,MAAM,QAAQ,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IACxB,MAAM,GAAG,GAAG,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;IAEjC,IAAI,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC9B,IAAI,GAAG,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;QACrB,MAAM,IAAI,GAAG,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QAClC,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,EAAE,GAAG,IAAI,CAAC;YACtB,IAAI,GAAG,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;gBACrB,MAAM,IAAI,eAAe,CAAC,2BAA2B,GAAG,gBAAgB,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;YACxF,CAAC;YACD,6EAA6E;YAC7E,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC;YAC/C,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,kBAAkB;YAC9B,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,kBAAkB;YAC9B,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;YAC9B,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;YACpC,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;gBACvB,MAAM,IAAI,eAAe,CACvB,+BAA+B,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,WAAW,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CACpF,CAAC;YACJ,CAAC;YACD,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AACjD,CAAC"}

package/dist/codec/preset.d.ts

@@ -0,0 +1,40 @@
+export interface PresetPose {
+    pan: number;
+    tilt: number;
+    roll: number;
+    zoom: number;
+}
+export declare const encodePresetAdd: (seq: number, slot: number, pose: PresetPose) => Buffer;
+export declare const encodePresetUpdate: (seq: number, slot: number, pose: PresetPose) => Buffer;
+export declare const encodePresetRecall: (seq: number, slot: number) => Buffer;
+export declare const encodePresetDelete: (seq: number, slot: number) => Buffer;
+export declare const encodePresetSetName: (seq: number, slot: number, name: string) => Buffer;
+export declare const encodeBootPose: (seq: number, slot: number, pose: PresetPose) => Buffer;
+export declare const encodeBootFlags: (seq: number) => Buffer;
+export interface PresetListBlock {
+    count: number;
+    slots: number[];
+}
+export declare const decodePresetList: (block: Buffer) => PresetListBlock;
+export declare const implausiblePresetListReason: (block: Buffer) => string | null;
+export interface PresetEntry {
+    end: boolean;
+    slot?: 1 | 2 | 3;
+    name?: string;
+    pose?: PresetPose;
+}
+export declare const decodePresetEntry: (block: Buffer) => PresetEntry;
+export interface PresetSlot {
+    slot: 1 | 2 | 3;
+    occupied: boolean;
+    name: string | null;
+    pose: PresetPose | null;
+}
+export declare const assemblePresetSlots: (perSlot: {
+    slot: 1 | 2 | 3;
+    name: string;
+    pose: PresetPose;
+}[]) => PresetSlot[];
+export declare const encodeGimBootPosSet: (seq: number, pose: PresetPose) => Buffer;
+export declare const encodeGimBootPosReset: (seq: number) => Buffer;
+export declare const encodeGimBootPosTrigger: (seq: number) => Buffer;

package/dist/codec/preset.js

@@ -0,0 +1,198 @@
+import { buildFrame } from "./frame.js";
+import { f32le, u32le, concat } from "./encoding.js";
+import { OP_BY_NAME } from "./opcodes.js";
+// Opcodes come from the generated table (tools/opcodes/opcodes.json, extracted from
+// libdev.dll with PDB symbols) under the firmware's OWN names. This file previously
+// kept a hand-written copy with invented names — notably `BOOT_POSE: 0x3ec4` and
+// `BOOT_FLAGS: 0x3e44`, neither of which is what those commands do:
+//   0x3ec4 = AI_SET_BOOT_PRESET_UPDATE_ONLY — BINDS AN EXISTING PRESET as the boot
+//            preset (hence OBSBOT Center's preset-identifying step before it)
+//   0x3e44 = AI_SET_BOOT_PRESETS_ACTIONS   — a "boot presets actions" record
+// Those invented names actively misled the reading of this protocol, so resolve by
+// real name and let the table be the single source of truth.
+const op = (name) => {
+    const wire = OP_BY_NAME.get(name)?.wireCmd;
+    if (wire == null)
+        throw new Error(`unknown or non-sendable opcode: ${name}`);
+    return wire;
+};
+const CMD = {
+    ADD: op("AI_SET_GIMBAL_PRESET_ADD"),
+    UPDATE: op("AI_SET_PRESET_UPDATE_ONLY"),
+    RECALL: op("AI_SET_GIMBAL_PRESET_TRIG"),
+    DELETE: op("AI_SET_GIMBAL_PRESET_DELETE"),
+    SET_NAME: op("AI_SET_GIMBAL_PRESET_ID_NAME"),
+    // Legacy names retained for the existing As-Initial-State replay path; see the
+    // real semantics above. Prefer the GIM_BOOT_POS family below.
+    BOOT_POSE: op("AI_SET_BOOT_PRESET_UPDATE_ONLY"),
+    BOOT_FLAGS: op("AI_SET_BOOT_PRESETS_ACTIONS"),
+    // The purpose-built boot-pose family: set / reset / trigger, all decoded.
+    GIM_BOOT_POS_SET: op("AI_SET_GIM_BOOT_POS"),
+    GIM_BOOT_POS_RESET: op("AI_RST_GIM_BOOT_POS"),
+    GIM_BOOT_POS_TRIGGER: op("AI_TRG_GIM_BOOT_POS"),
+};
+const RECEIVER = 0x04;
+const idx = (slot) => u32le(slot - 1);
+const poseBytes = (p) => concat(f32le(p.pan), f32le(p.tilt), f32le(p.roll), f32le(p.zoom), f32le(-1000));
+export const encodePresetAdd = (seq, slot, pose) => buildFrame({ seq, cmd: CMD.ADD, receiver: RECEIVER, payload: concat(idx(slot), poseBytes(pose)) });
+export const encodePresetUpdate = (seq, slot, pose) => buildFrame({ seq, cmd: CMD.UPDATE, receiver: RECEIVER, payload: concat(idx(slot), poseBytes(pose)) });
+export const encodePresetRecall = (seq, slot) => buildFrame({ seq, cmd: CMD.RECALL, receiver: RECEIVER,
+    payload: concat(idx(slot), f32le(1), f32le(1), f32le(1), f32le(1)) });
+export const encodePresetDelete = (seq, slot) => buildFrame({ seq, cmd: CMD.DELETE, receiver: RECEIVER, payload: idx(slot) });
+export const encodePresetSetName = (seq, slot, name) => buildFrame({ seq, cmd: CMD.SET_NAME, receiver: RECEIVER,
+    payload: concat(idx(slot), Buffer.from(name, "ascii")) });
+// RETAINED AS DECODED PROTOCOL KNOWLEDGE — NOT REACHABLE FROM ANY TOOL.
+// This is the OBSBOT Center "As Initial State" replay. It was removed from the tool
+// surface once the command names were recovered: 0x3ec4 is AI_SET_BOOT_PRESET_UPDATE_ONLY
+// (binds an existing preset as the boot preset) and 0x3e44 is AI_SET_BOOT_PRESETS_ACTIONS
+// (an undecoded 40-byte "actions" record captured from one device state, carrying no slot
+// binding of its own). Neither has a decoded way to be undone. The GIM_BOOT_POS family
+// below does the same job with a real reset, so prefer it. Kept here, with its golden
+// tests, so the captured sequence is not lost.
+//
+// Boot-pose sequence: slot index + pose, but — unlike ADD/UPDATE — the trailing
+// float is a plain 0.0, not the -1000 sentinel. Confirmed against a captured
+// OBSBOT Center "As Initial State" wire frame (cmd 0x3ec4); do not fold this
+// back into poseBytes(), which ADD/UPDATE's golden tests pin to -1000.
+export const encodeBootPose = (seq, slot, pose) => buildFrame({
+    seq,
+    cmd: CMD.BOOT_POSE,
+    receiver: RECEIVER,
+    payload: concat(idx(slot), f32le(pose.pan), f32le(pose.tilt), f32le(pose.roll), f32le(pose.zoom), f32le(0)),
+});
+// Captured verbatim from the single observed As-Initial-State wire sequence (cmd
+// 0x3e44). Carries no slot index of its own — the target slot is conveyed by the
+// preceding encodeBootPose frame. Internal structure of these 40 bytes is NOT
+// decoded (no per-field meaning known) and this constant has NOT been
+// hardware-replayed independently — only observed as part of the captured sequence.
+const BOOT_FLAGS_BLOCK = Buffer.from("feffffffffffffff80ffffffffffffff00000000ffffffff00000000000000000000000000000000", "hex");
+export const encodeBootFlags = (seq) => buildFrame({ seq, cmd: CMD.BOOT_FLAGS, receiver: RECEIVER, payload: BOOT_FLAGS_BLOCK });
+export const decodePresetList = (block) => {
+    const count = block[0];
+    const slots = [];
+    for (let i = 0; i < count; i++)
+        slots.push(block[1 + i]);
+    return { count, slots };
+};
+// C1: sanity-check a raw selector-12 read BEFORE a caller echoes it back to reset
+// the entry cursor. Selector 12's write semantics for anything OTHER than exactly
+// what the device just returned are undecoded, so a failed/short/garbage read
+// (asleep camera, stale handle, transient USB error) must never be echoed —
+// echoing is only proven non-destructive for a genuine device response. Returns
+// a human-readable reason if the block looks implausible, or null if it's safe
+// to trust and echo.
+//
+// Design note: this checks the WHOLE returned block for all-zero, not just the
+// leading `1 + count` bytes. `block[0]` IS `count`, so for any count > 0 the
+// leading bytes can never be all-zero by construction — a "leading bytes"
+// check is only ever triggered by count === 0, which would make it equivalent
+// to unconditionally rejecting "zero presets saved" (a legitimate device
+// state, not distinguishable from failure by count alone). Checking the full
+// block instead targets the actual failure signature — a dead/asleep read
+// returning nothing — while still accepting a genuine empty-list reply as
+// long as ANY other byte in the 60-byte block is non-zero.
+export const implausiblePresetListReason = (block) => {
+    if (block.length < 1)
+        return "empty response (0 bytes)";
+    const count = block[0];
+    if (count > 3)
+        return `implausible slot count ${count} (device has 3 slots)`;
+    if (block.length < 1 + count)
+        return `short response: ${block.length} bytes for count=${count}`;
+    if (block.equals(Buffer.alloc(block.length)))
+        return "all-zero response — looks like a failed/short read";
+    return null;
+};
+const ENTRY_END = 0x02;
+// Minimum bytes needed to read the fixed header (status, slotIdx, 2 reserved,
+// pitch i16, yaw i16, zoom u8) before the variable-length base64 name starts
+// at offset 10.
+const ENTRY_HEADER_LEN = 10;
+export const decodePresetEntry = (block) => {
+    if (block.length > 0 && block[0] === ENTRY_END)
+        return { end: true };
+    // I4: a buffer too short to hold the fixed header can't be decoded — without
+    // this guard, block.readInt16LE(4)/(6) below throws a raw RangeError that
+    // surfaces to the caller as an opaque ERR_OUT_OF_RANGE. Treat it the same as
+    // end-of-list/invalid instead.
+    if (block.length < ENTRY_HEADER_LEN)
+        return { end: true };
+    // I3/I4: an all-zero header is exactly what a failed/short USB read decodes
+    // as (status 0x00 "not end", slotIdx 0, pitch/yaw/zoom all 0) — it is NOT a
+    // real occupied slot. A committed preset's zoom is always >=1.0 (block[8]
+    // >=100), so an all-zero header never corresponds to a genuine entry. Treat
+    // it as end-of-list/invalid: the dangerous failure mode for a create-once
+    // resource is a false OCCUPIED read, never a false EMPTY.
+    if (block.subarray(0, ENTRY_HEADER_LEN).equals(Buffer.alloc(ENTRY_HEADER_LEN))) {
+        return { end: true };
+    }
+    const slotIdx = block[1];
+    // I4: only slot indices 0..2 are valid on this 3-slot device. Without this
+    // check a garbage block[1] (e.g. 7) silently becomes slot:8, which then
+    // misses assemblePresetSlots's 1|2|3 lookup and collapses to an all-empty
+    // result instead of surfacing the corruption.
+    if (slotIdx > 2)
+        return { end: true };
+    const slot = (slotIdx + 1);
+    const pitch = block.readInt16LE(4) / 100;
+    const yaw = block.readInt16LE(6) / 100;
+    const zoom = block[8] / 100;
+    const nul = block.indexOf(0, 10);
+    const b64 = block.subarray(10, nul === -1 ? block.length : nul).toString("ascii");
+    const name = Buffer.from(b64, "base64").toString("ascii");
+    return { end: false, slot, name, pose: { pan: yaw, tilt: pitch, roll: 0, zoom } };
+};
+// I1: this used to take an unused `_count` parameter. Decision: drop it rather
+// than consume it here — the authoritative-count reconciliation belongs one
+// level up, in mcp/tools.ts's getPresetSlots, which has BOTH the selector-12
+// list (the device's own claim of which slots are occupied) and the walked
+// selector-13 entries available to cross-check against each other. By the time
+// perSlot reaches this function it is already trusted; this function's only
+// job is reshaping it into the fixed 3-slot view.
+export const assemblePresetSlots = (perSlot) => {
+    const byslot = new Map(perSlot.map((e) => [e.slot, e]));
+    return [1, 2, 3].map((slot) => {
+        const e = byslot.get(slot);
+        return e
+            ? { slot, occupied: true, name: e.name, pose: e.pose }
+            : { slot, occupied: false, name: null, pose: null };
+    });
+};
+// --- Boot pose: the direct, reversible family --------------------------------
+// AI_SET_GIM_BOOT_POS / AI_RST_GIM_BOOT_POS / AI_TRG_GIM_BOOT_POS. Unlike the
+// As-Initial-State replay (which binds a preset and writes an undecoded 40-byte
+// "actions" record), every command here is decoded, and RST restores the factory
+// default — so setting a boot pose is undoable.
+//
+// PAYLOAD LAYOUT IS A HYPOTHESIS, pending hardware. Field ORDER is solid: read
+// from libdev's own movss stores in aiSetGimbalBootPosR (buf+0x05 = yaw from
+// [rbx+0xC], +0x09 = pitch from [rbx+8], +0x0D = roll from [rbx+4], +0x11 = zoom).
+// What is NOT confirmed is whether the UVC path uses the same framing as that
+// (network) path, which had an extra zero byte at +0x04 and unaligned floats. We
+// mirror our own frame convention instead: u32 id, then four aligned floats.
+//
+// RESOLVED 2026-07-20. The layout above is correct, and it is now confirmed by
+// readback rather than inference: AI_GET_GIM_BOOT_POS (0x3884) returns this exact
+// record, and the vendor GET path works once framed with frame[1] = 0x01 (the
+// header-only GET flavour). The old note here — that our transport cannot read
+// vendor GET replies — was wrong; GETs were being sent with the SET flags byte,
+// which the device does not answer.
+//
+// PAYLOAD WIDTH IS LOAD-BEARING: the device requires 24 bytes (six float32) and
+// SILENTLY DISCARDS a 20-byte payload — no error, no state change, readback
+// unchanged. This encoder shipped 20 bytes, so every boot-pose write it ever made
+// was thrown away. Proven by write -> physical replug -> read: writing
+// [0, -35, -20, 0, 1, 0] brought the camera up at yaw -34 / pitch -20.
+// See tiny2_specification.md section 6.1.
+export const encodeGimBootPosSet = (seq, pose) => buildFrame({
+    seq,
+    cmd: CMD.GIM_BOOT_POS_SET,
+    receiver: RECEIVER,
+    // Slot 0 is 0: the boot pose is a single global setting, not one of the 3 slots.
+    // (u32le(0) is bit-identical to the float32 0.0 the device reports in slot 0.)
+    // The trailing float32 0.0 is REQUIRED — without it the write is discarded.
+    payload: concat(u32le(0), f32le(pose.pan), f32le(pose.tilt), f32le(pose.roll), f32le(pose.zoom), f32le(0)),
+});
+export const encodeGimBootPosReset = (seq) => buildFrame({ seq, cmd: CMD.GIM_BOOT_POS_RESET, receiver: RECEIVER, payload: Buffer.alloc(0) });
+export const encodeGimBootPosTrigger = (seq) => buildFrame({ seq, cmd: CMD.GIM_BOOT_POS_TRIGGER, receiver: RECEIVER, payload: Buffer.alloc(0) });
+//# sourceMappingURL=preset.js.map

package/dist/codec/preset.js.map

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

package/dist/codec/types.d.ts

@@ -10,4 +10,8 @@ export interface ZoomUnits {
 export interface DeviceInfo {
     path: string;
     name: string;
+    locationId?: number;
+    serial?: string;
+    vid?: number;
+    pid?: number;
 }

package/dist/device/helper-factory.d.ts

@@ -0,0 +1,25 @@
+import { DeviceManager } from "./manager.js";
+import { HelperProcess } from "../transport/helper-process.js";
+/**
+ * Build the factory DeviceManager spawns its helpers through, with every
+ * helper subscribed to the OS bus events before it is started.
+ *
+ * Subscribing HERE rather than at a call site is the point: there is no single
+ * long-lived helper. The scratch scanner is promoted into the registry when a
+ * camera binds and the next scan spawns another, so whichever process happens
+ * to be alive when the cable moves has to be the one that reports it. Without
+ * this the server learns about an unplug only by failing a call against a dead
+ * handle — `obsbot_devices` reports a phantom `bound` entry, serial and all,
+ * for a camera sitting on the desk, and the first call after a replug fails by
+ * design.
+ *
+ * `getMgr` is a thunk rather than the manager itself because the manager is
+ * constructed WITH this factory and so does not exist yet when the factory is
+ * built. It is resolved when an event fires, long after construction.
+ *
+ * `make` is injectable so this can be tested against a fake helper instead of
+ * spawning the real binary. The subscription is the whole feature and it is
+ * two lines; left inline in startServer() nothing covered it, and deleting it
+ * broke no test.
+ */
+export declare function helperFactory(getMgr: () => DeviceManager, make?: () => HelperProcess): () => Promise<HelperProcess>;

package/dist/device/helper-factory.js

@@ -0,0 +1,40 @@
+import { HelperProcess } from "../transport/helper-process.js";
+/**
+ * Build the factory DeviceManager spawns its helpers through, with every
+ * helper subscribed to the OS bus events before it is started.
+ *
+ * Subscribing HERE rather than at a call site is the point: there is no single
+ * long-lived helper. The scratch scanner is promoted into the registry when a
+ * camera binds and the next scan spawns another, so whichever process happens
+ * to be alive when the cable moves has to be the one that reports it. Without
+ * this the server learns about an unplug only by failing a call against a dead
+ * handle — `obsbot_devices` reports a phantom `bound` entry, serial and all,
+ * for a camera sitting on the desk, and the first call after a replug fails by
+ * design.
+ *
+ * `getMgr` is a thunk rather than the manager itself because the manager is
+ * constructed WITH this factory and so does not exist yet when the factory is
+ * built. It is resolved when an event fires, long after construction.
+ *
+ * `make` is injectable so this can be tested against a fake helper instead of
+ * spawning the real binary. The subscription is the whole feature and it is
+ * two lines; left inline in startServer() nothing covered it, and deleting it
+ * broke no test.
+ */
+export function helperFactory(getMgr, make = () => new HelperProcess()) {
+    return async () => {
+        const helper = make();
+        // Before start(), not after: a camera plugged in during spawn would
+        // otherwise emit into nothing and the arrival would simply be lost.
+        //
+        // The handlers never reject (see DeviceManager), but they ARE async while
+        // these listeners are sync — swallow explicitly so a surprise rejection
+        // cannot become an unhandled one and kill the process from a stdout line
+        // handler, losing every in-flight request because a cable moved.
+        helper.onCameraArrived((e) => void getMgr().handleCameraArrived(e).catch(() => { }));
+        helper.onCameraDeparted((e) => void getMgr().handleCameraDeparted(e).catch(() => { }));
+        await helper.start();
+        return helper;
+    };
+}
+//# sourceMappingURL=helper-factory.js.map

package/dist/device/helper-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper-factory.js","sourceRoot":"","sources":["../../src/device/helper-factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAE/D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,aAAa,CAC3B,MAA2B,EAC3B,OAA4B,GAAG,EAAE,CAAC,IAAI,aAAa,EAAE;IAErD,OAAO,KAAK,IAAI,EAAE;QAChB,MAAM,MAAM,GAAG,IAAI,EAAE,CAAC;QACtB,oEAAoE;QACpE,oEAAoE;QACpE,EAAE;QACF,0EAA0E;QAC1E,wEAAwE;QACxE,yEAAyE;QACzE,iEAAiE;QACjE,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,MAAM,EAAE,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC,CAAC;QACpF,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,MAAM,EAAE,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC,CAAC;QACtF,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACrB,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC"}