tactus-mcp 0.1.1

package/dist/buttplug.js

@@ -0,0 +1,216 @@
+import { ButtplugClient, ButtplugNodeWebsocketClientConnector, DeviceOutput, InputType, OutputType, } from "buttplug";
+import { TactusError, } from "./types.js";
+/** Buttplug output types we expose as actuators, in display order. */
+const OUTPUT_TO_ACTUATOR = [
+    [OutputType.Vibrate, "vibrate"],
+    [OutputType.Oscillate, "oscillate"],
+    [OutputType.Rotate, "rotate"],
+    [OutputType.HwPositionWithDuration, "linear"],
+    [OutputType.Position, "linear"],
+    [OutputType.Constrict, "constrict"],
+];
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+/**
+ * DeviceController backed by Buttplug/Intiface over a local WebSocket.
+ * Our code never touches BLE — Intiface owns that, so this is OS-agnostic.
+ */
+export class ButtplugController {
+    config;
+    client;
+    serverName;
+    disconnectCbs = [];
+    deviceRemovedCbs = [];
+    deviceAddedCbs = [];
+    constructor(config) {
+        this.config = config;
+        this.client = new ButtplugClient("Tactus");
+        this.client.on("disconnect", () => {
+            for (const cb of this.disconnectCbs)
+                cb();
+        });
+        this.client.on("deviceadded", (d) => {
+            for (const cb of this.deviceAddedCbs)
+                cb(d.index, d.name);
+        });
+        this.client.on("deviceremoved", (d) => {
+            for (const cb of this.deviceRemovedCbs)
+                cb(d.index, d.name);
+        });
+    }
+    async connect() {
+        const connector = new ButtplugNodeWebsocketClientConnector(this.config.intifaceUrl);
+        try {
+            await this.client.connect(connector);
+        }
+        catch {
+            throw new TactusError(`Intiface is not reachable at ${this.config.intifaceUrl}. ` +
+                `Start Intiface Central and click "Start Server", then retry.`, "NOT_CONNECTED");
+        }
+        this.serverName = this.client.serverInfo?.serverName;
+    }
+    async disconnect() {
+        if (this.client.connected)
+            await this.client.disconnect();
+    }
+    isConnected() {
+        return this.client.connected;
+    }
+    status() {
+        const connected = this.client.connected;
+        return {
+            connected,
+            intiface_url: this.config.intifaceUrl,
+            server_name: this.serverName,
+            // `client.devices` throws when the connector is down, so only read it while
+            // connected. status() must be safe to call in ANY state — especially during
+            // a reconnect, which is exactly when a caller most wants to know the state.
+            device_count: connected ? this.client.devices.size : 0,
+        };
+    }
+    listDevices() {
+        return [...this.client.devices.values()].map((d) => this.describe(d));
+    }
+    async scan(durationMs) {
+        this.requireConnected();
+        const before = new Set(this.client.devices.keys());
+        await this.client.startScanning();
+        await sleep(durationMs);
+        await this.client.stopScanning();
+        return [...this.client.devices.values()]
+            .filter((d) => !before.has(d.index))
+            .map((d) => this.describe(d));
+    }
+    async getBattery(deviceId) {
+        const device = this.requireDevice(deviceId);
+        try {
+            return await device.battery();
+        }
+        catch {
+            throw new TactusError(`Device ${deviceId} does not report battery.`, "DEVICE_ERROR");
+        }
+    }
+    async output(deviceId, type, value, target) {
+        const device = this.requireDevice(deviceId);
+        const outputType = type === "vibrate" ? OutputType.Vibrate : OutputType.Oscillate;
+        const ctor = type === "vibrate" ? DeviceOutput.Vibrate : DeviceOutput.Oscillate;
+        await this.runOnFeatures(device, outputType, type, () => ctor.percent(value), target);
+    }
+    async rotate(deviceId, speed, clockwise, target) {
+        const device = this.requireDevice(deviceId);
+        await this.runOnFeatures(device, OutputType.Rotate, "rotate", (f) => {
+            const range = f.output(OutputType.Rotate).valueRange;
+            return DeviceOutput.Rotate.value(rotateValue(range, speed, clockwise));
+        }, target);
+    }
+    async linear(deviceId, position, durationMs, target) {
+        const device = this.requireDevice(deviceId);
+        const outputType = device.hasOutput(OutputType.HwPositionWithDuration)
+            ? OutputType.HwPositionWithDuration
+            : OutputType.Position;
+        const cmd = DeviceOutput.PositionWithDuration.percent(position, durationMs);
+        await this.runOnFeatures(device, outputType, "linear", () => cmd, target);
+    }
+    async stopDevice(deviceId) {
+        await this.requireDevice(deviceId).stop();
+    }
+    async stopAll() {
+        await Promise.all([...this.client.devices.values()].map((d) => d.stop()));
+    }
+    onDisconnect(cb) {
+        this.disconnectCbs.push(cb);
+    }
+    onDeviceAdded(cb) {
+        this.deviceAddedCbs.push(cb);
+    }
+    onDeviceRemoved(cb) {
+        this.deviceRemovedCbs.push(cb);
+    }
+    // --- internals ---
+    /** Resolve the target features, build a per-feature command, and send. */
+    async runOnFeatures(device, outputType, label, build, target) {
+        const features = this.featuresFor(device, outputType, label, target);
+        try {
+            await Promise.all(features.map((f) => f.runOutput(build(f))));
+        }
+        catch (e) {
+            if (e instanceof TactusError)
+                throw e;
+            throw new TactusError(`Device ${device.index} rejected the ${label} command: ${buttplugErrorText(e)}`, "DEVICE_ERROR");
+        }
+    }
+    featuresFor(device, outputType, label, target) {
+        let features = [...device.features.values()].filter((f) => f.hasOutput(outputType));
+        if (target?.actuatorIndex !== undefined) {
+            features = features.filter((f) => f.index === target.actuatorIndex);
+            if (features.length === 0) {
+                throw new TactusError(`Device ${device.index} has no ${label} actuator at index ${target.actuatorIndex}.`, "NO_ACTUATOR");
+            }
+        }
+        if (features.length === 0) {
+            throw new TactusError(`Device ${device.index} has no ${label} actuator.`, "NO_ACTUATOR");
+        }
+        return features;
+    }
+    describe(device) {
+        const actuators = [];
+        let hasBattery = false;
+        for (const f of device.features.values()) {
+            // A feature can expose several output types that collapse to the same
+            // actuator type (e.g. Position + HwPositionWithDuration → "linear");
+            // emit at most one actuator per type per feature.
+            const seen = new Set();
+            for (const [outputType, actuatorType] of OUTPUT_TO_ACTUATOR) {
+                if (seen.has(actuatorType))
+                    continue;
+                const out = f.output(outputType);
+                if (out) {
+                    seen.add(actuatorType);
+                    actuators.push({ index: f.index, type: actuatorType, step_count: out.valueRange[1] });
+                }
+            }
+            if (f.hasInput(InputType.Battery))
+                hasBattery = true;
+        }
+        return { id: device.index, name: device.name, actuators, has_battery: hasBattery };
+    }
+    requireConnected() {
+        if (!this.client.connected) {
+            throw new TactusError(`Not connected to Intiface at ${this.config.intifaceUrl}. ` +
+                `Start Intiface Central and click "Start Server".`, "NOT_CONNECTED");
+        }
+    }
+    requireDevice(deviceId) {
+        this.requireConnected();
+        const device = this.client.devices.get(deviceId);
+        if (!device) {
+            const valid = [...this.client.devices.keys()].join(", ") || "none";
+            throw new TactusError(`Unknown device id ${deviceId}. Valid ids: [${valid}].`, "UNKNOWN_DEVICE");
+        }
+        return device;
+    }
+}
+/** Turn a Buttplug error (often a JSON string like
+ *  `{"ButtplugDeviceError":{"MessageNotSupported":"OutputCmd"}}`) into a short
+ *  human-readable phrase. */
+function buttplugErrorText(e) {
+    const raw = e instanceof Error ? e.message : String(e);
+    try {
+        const parsed = JSON.parse(raw);
+        const inner = (parsed.ButtplugDeviceError ?? parsed.ButtplugError ?? parsed);
+        const [kind, detail] = Object.entries(inner)[0] ?? [];
+        if (kind)
+            return `${kind}: ${typeof detail === "string" ? detail : JSON.stringify(detail)}`;
+    }
+    catch {
+        /* not JSON — fall through */
+    }
+    return raw;
+}
+/** Map a 0..1 speed + direction onto a feature's (possibly signed) value range. */
+function rotateValue(range, speed, clockwise) {
+    const [min, max] = range;
+    if (clockwise || min >= 0)
+        return Math.round(max * speed);
+    return Math.round(min * speed); // counter-clockwise via the negative side of the range
+}
+//# sourceMappingURL=buttplug.js.map

package/dist/buttplug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buttplug.js","sourceRoot":"","sources":["../src/buttplug.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EAEd,oCAAoC,EACpC,YAAY,EAGZ,SAAS,EACT,UAAU,GACX,MAAM,UAAU,CAAC;AAElB,OAAO,EAML,WAAW,GACZ,MAAM,YAAY,CAAC;AAEpB,sEAAsE;AACtE,MAAM,kBAAkB,GAAuD;IAC7E,CAAC,UAAU,CAAC,OAAO,EAAE,SAAS,CAAC;IAC/B,CAAC,UAAU,CAAC,SAAS,EAAE,WAAW,CAAC;IACnC,CAAC,UAAU,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC7B,CAAC,UAAU,CAAC,sBAAsB,EAAE,QAAQ,CAAC;IAC7C,CAAC,UAAU,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC/B,CAAC,UAAU,CAAC,SAAS,EAAE,WAAW,CAAC;CACpC,CAAC;AAEF,MAAM,KAAK,GAAG,CAAC,EAAU,EAAiB,EAAE,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AAEnF;;;GAGG;AACH,MAAM,OAAO,kBAAkB;IAOA;IANZ,MAAM,CAAiB;IAChC,UAAU,CAAU;IACX,aAAa,GAAsB,EAAE,CAAC;IACtC,gBAAgB,GAA8C,EAAE,CAAC;IACjE,cAAc,GAA8C,EAAE,CAAC;IAEhF,YAA6B,MAAoB;QAApB,WAAM,GAAN,MAAM,CAAc;QAC/C,IAAI,CAAC,MAAM,GAAG,IAAI,cAAc,CAAC,QAAQ,CAAC,CAAC;QAC3C,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,GAAG,EAAE;YAChC,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,aAAa;gBAAE,EAAE,EAAE,CAAC;QAC5C,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,aAAa,EAAE,CAAC,CAAuB,EAAE,EAAE;YACxD,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,cAAc;gBAAE,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QAC5D,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,eAAe,EAAE,CAAC,CAAuB,EAAE,EAAE;YAC1D,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,gBAAgB;gBAAE,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QAC9D,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,OAAO;QACX,MAAM,SAAS,GAAG,IAAI,oCAAoC,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QACpF,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACvC,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,WAAW,CACnB,gCAAgC,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI;gBACzD,8DAA8D,EAChE,eAAe,CAChB,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,UAAU;QACd,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS;YAAE,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;IAC5D,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;IAC/B,CAAC;IAED,MAAM;QACJ,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;QACxC,OAAO;YACL,SAAS;YACT,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW;YACrC,WAAW,EAAE,IAAI,CAAC,UAAU;YAC5B,4EAA4E;YAC5E,4EAA4E;YAC5E,4EAA4E;YAC5E,YAAY,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;SACvD,CAAC;IACJ,CAAC;IAED,WAAW;QACT,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IACxE,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,UAAkB;QAC3B,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QACnD,MAAM,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;QAClC,MAAM,KAAK,CAAC,UAAU,CAAC,CAAC;QACxB,MAAM,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;QACjC,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;aACrC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;aACnC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,QAAgB;QAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAC5C,IAAI,CAAC;YACH,OAAO,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,WAAW,CAAC,UAAU,QAAQ,2BAA2B,EAAE,cAAc,CAAC,CAAC;QACvF,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM,CACV,QAAgB,EAChB,IAAkB,EAClB,KAAa,EACb,MAAoB;QAEpB,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAC5C,MAAM,UAAU,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC;QAClF,MAAM,IAAI,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,SAAS,CAAC;QAChF,MAAM,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC;IACxF,CAAC;IAED,KAAK,CAAC,MAAM,CACV,QAAgB,EAChB,KAAa,EACb,SAAkB,EAClB,MAAoB;QAEpB,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAC5C,MAAM,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE;YAClE,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAE,CAAC,UAAU,CAAC;YACtD,OAAO,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC;QACzE,CAAC,EAAE,MAAM,CAAC,CAAC;IACb,CAAC;IAED,KAAK,CAAC,MAAM,CACV,QAAgB,EAChB,QAAgB,EAChB,UAAkB,EAClB,MAAoB;QAEpB,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAC5C,MAAM,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,sBAAsB,CAAC;YACpE,CAAC,CAAC,UAAU,CAAC,sBAAsB;YACnC,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC;QACxB,MAAM,GAAG,GAAG,YAAY,CAAC,oBAAoB,CAAC,OAAO,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QAC5E,MAAM,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC5E,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,QAAgB;QAC/B,MAAM,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,OAAO;QACX,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC5E,CAAC;IAED,YAAY,CAAC,EAAc;QACzB,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED,aAAa,CAAC,EAAsC;QAClD,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC;IAED,eAAe,CAAC,EAAsC;QACpD,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjC,CAAC;IAED,oBAAoB;IAEpB,0EAA0E;IAClE,KAAK,CAAC,aAAa,CACzB,MAA4B,EAC5B,UAAsB,EACtB,KAAa,EACb,KAA+D,EAC/D,MAAoB;QAEpB,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QACrE,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAChE,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,YAAY,WAAW;gBAAE,MAAM,CAAC,CAAC;YACtC,MAAM,IAAI,WAAW,CACnB,UAAU,MAAM,CAAC,KAAK,iBAAiB,KAAK,aAAa,iBAAiB,CAAC,CAAC,CAAC,EAAE,EAC/E,cAAc,CACf,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,WAAW,CACjB,MAA4B,EAC5B,UAAsB,EACtB,KAAa,EACb,MAAoB;QAEpB,IAAI,QAAQ,GAAG,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;QACpF,IAAI,MAAM,EAAE,aAAa,KAAK,SAAS,EAAE,CAAC;YACxC,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,aAAa,CAAC,CAAC;YACpE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC1B,MAAM,IAAI,WAAW,CACnB,UAAU,MAAM,CAAC,KAAK,WAAW,KAAK,sBAAsB,MAAM,CAAC,aAAa,GAAG,EACnF,aAAa,CACd,CAAC;YACJ,CAAC;QACH,CAAC;QACD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,WAAW,CAAC,UAAU,MAAM,CAAC,KAAK,WAAW,KAAK,YAAY,EAAE,aAAa,CAAC,CAAC;QAC3F,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEO,QAAQ,CAAC,MAA4B;QAC3C,MAAM,SAAS,GAAmB,EAAE,CAAC;QACrC,IAAI,UAAU,GAAG,KAAK,CAAC;QACvB,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YACzC,sEAAsE;YACtE,qEAAqE;YACrE,kDAAkD;YAClD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAgB,CAAC;YACrC,KAAK,MAAM,CAAC,UAAU,EAAE,YAAY,CAAC,IAAI,kBAAkB,EAAE,CAAC;gBAC5D,IAAI,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC;oBAAE,SAAS;gBACrC,MAAM,GAAG,GAAG,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;gBACjC,IAAI,GAAG,EAAE,CAAC;oBACR,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;oBACvB,SAAS,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBACxF,CAAC;YACH,CAAC;YACD,IAAI,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC;gBAAE,UAAU,GAAG,IAAI,CAAC;QACvD,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC;IACrF,CAAC;IAEO,gBAAgB;QACtB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YAC3B,MAAM,IAAI,WAAW,CACnB,gCAAgC,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI;gBACzD,kDAAkD,EACpD,eAAe,CAChB,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,aAAa,CAAC,QAAgB;QACpC,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACjD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC;YACnE,MAAM,IAAI,WAAW,CAAC,qBAAqB,QAAQ,iBAAiB,KAAK,IAAI,EAAE,gBAAgB,CAAC,CAAC;QACnG,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAED;;6BAE6B;AAC7B,SAAS,iBAAiB,CAAC,CAAU;IACnC,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACvD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA4B,CAAC;QAC1D,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,mBAAmB,IAAI,MAAM,CAAC,aAAa,IAAI,MAAM,CAA4B,CAAC;QACxG,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACtD,IAAI,IAAI;YAAE,OAAO,GAAG,IAAI,KAAK,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;IAC9F,CAAC;IAAC,MAAM,CAAC;QACP,6BAA6B;IAC/B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,mFAAmF;AACnF,SAAS,WAAW,CAAC,KAAgC,EAAE,KAAa,EAAE,SAAkB;IACtF,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC;IACzB,IAAI,SAAS,IAAI,GAAG,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC;IAC1D,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,uDAAuD;AACzF,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,6 @@
+import { TactusConfig } from "./types.js";
+/**
+ * Build runtime config from environment variables and CLI flags.
+ * Safety defaults (clamp on, 10-min watchdog) are intentional — see spec §7.4.
+ */
+export declare function loadConfig(argv?: readonly string[]): TactusConfig;

package/dist/config.js

@@ -0,0 +1,38 @@
+const DEFAULT_INTIFACE_URL = "ws://127.0.0.1:12345";
+const DEFAULT_MAX_INTENSITY = 1.0;
+const DEFAULT_MAX_CONTINUOUS_MS = 600_000; // 10 minutes
+const DEFAULT_SCAN_MS = 5_000;
+const MAX_COMMANDS_PER_SEC = 20;
+const MAX_PATTERN_STEPS = 200;
+function numEnv(name, fallback) {
+    const raw = process.env[name];
+    if (raw === undefined || raw.trim() === "")
+        return fallback;
+    const n = Number(raw);
+    if (!Number.isFinite(n)) {
+        throw new Error(`Invalid ${name}="${raw}": expected a number`);
+    }
+    return n;
+}
+const clamp01 = (n) => Math.max(0, Math.min(1, n));
+/**
+ * Build runtime config from environment variables and CLI flags.
+ * Safety defaults (clamp on, 10-min watchdog) are intentional — see spec §7.4.
+ */
+export function loadConfig(argv = process.argv.slice(2)) {
+    const allowUnsafe = argv.includes("--allow-unsafe") || process.env.TACTUS_ALLOW_UNSAFE === "1";
+    // The unsafe override opens the clamp ceiling to the full range.
+    const maxIntensity = allowUnsafe
+        ? 1.0
+        : clamp01(numEnv("MAX_INTENSITY", DEFAULT_MAX_INTENSITY));
+    return {
+        intifaceUrl: process.env.INTIFACE_URL?.trim() || DEFAULT_INTIFACE_URL,
+        maxIntensity,
+        maxContinuousMs: numEnv("MAX_CONTINUOUS_MS", DEFAULT_MAX_CONTINUOUS_MS),
+        scanDefaultMs: numEnv("SCAN_DEFAULT_MS", DEFAULT_SCAN_MS),
+        maxCommandsPerSec: MAX_COMMANDS_PER_SEC,
+        maxPatternSteps: MAX_PATTERN_STEPS,
+        allowUnsafe,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,MAAM,oBAAoB,GAAG,sBAAsB,CAAC;AACpD,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAClC,MAAM,yBAAyB,GAAG,OAAO,CAAC,CAAC,aAAa;AACxD,MAAM,eAAe,GAAG,KAAK,CAAC;AAC9B,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAChC,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAE9B,SAAS,MAAM,CAAC,IAAY,EAAE,QAAgB;IAC5C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,QAAQ,CAAC;IAC5D,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACtB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,WAAW,IAAI,KAAK,GAAG,sBAAsB,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,OAAO,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAEnE;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,OAA0B,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACxE,MAAM,WAAW,GACf,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,KAAK,GAAG,CAAC;IAE7E,iEAAiE;IACjE,MAAM,YAAY,GAAG,WAAW;QAC9B,CAAC,CAAC,GAAG;QACL,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,qBAAqB,CAAC,CAAC,CAAC;IAE5D,OAAO;QACL,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,EAAE,IAAI,oBAAoB;QACrE,YAAY;QACZ,eAAe,EAAE,MAAM,CAAC,mBAAmB,EAAE,yBAAyB,CAAC;QACvE,aAAa,EAAE,MAAM,CAAC,iBAAiB,EAAE,eAAe,CAAC;QACzD,iBAAiB,EAAE,oBAAoB;QACvC,eAAe,EAAE,iBAAiB;QAClC,WAAW;KACZ,CAAC;AACJ,CAAC"}

package/dist/controller.d.ts

@@ -0,0 +1,35 @@
+import { DeviceInfo, ServerStatus } from "./types.js";
+/** Scalar outputs driven by a single 0..1 intensity. */
+export type ScalarOutput = "vibrate" | "oscillate";
+export interface DriveTarget {
+    /** Restrict to one actuator (Buttplug feature index); omit to drive all matching. */
+    actuatorIndex?: number;
+}
+/**
+ * Protocol-agnostic control core. MCP is the flagship adapter over this
+ * interface; REST/SDK adapters can be added later without touching callers
+ * (spec §1/§6). Keeping Buttplug behind this seam is what makes that possible.
+ *
+ * These are RAW ops — clamping, watchdog, rate limiting and fail-safe stop
+ * live in the safety layer that wraps this (safety.ts).
+ */
+export interface DeviceController {
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    isConnected(): boolean;
+    status(): ServerStatus;
+    listDevices(): DeviceInfo[];
+    scan(durationMs: number): Promise<DeviceInfo[]>;
+    getBattery(deviceId: number): Promise<number>;
+    output(deviceId: number, type: ScalarOutput, value: number, target?: DriveTarget): Promise<void>;
+    rotate(deviceId: number, speed: number, clockwise: boolean, target?: DriveTarget): Promise<void>;
+    linear(deviceId: number, position: number, durationMs: number, target?: DriveTarget): Promise<void>;
+    stopDevice(deviceId: number): Promise<void>;
+    stopAll(): Promise<void>;
+    /** Register a callback fired when the transport to Intiface drops. */
+    onDisconnect(cb: () => void): void;
+    /** Fired when Intiface reports a device connected (e.g. found by a scan). */
+    onDeviceAdded(cb: (id: number, name: string) => void): void;
+    /** Fired when Intiface reports a device dropped (e.g. BLE link lost / out of range). */
+    onDeviceRemoved(cb: (id: number, name: string) => void): void;
+}

package/dist/controller.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=controller.js.map

package/dist/controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.js","sourceRoot":"","sources":["../src/controller.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,75 @@
+#!/usr/bin/env node
+import { createRequire } from "node:module";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { ButtplugController } from "./buttplug.js";
+import { loadConfig } from "./config.js";
+import { SafetyLayer } from "./safety.js";
+import { makeServer, registerTools } from "./server.js";
+// Single source of truth for the version: package.json (sits one level above
+// dist/ at runtime). Avoids hard-coding the version in more than one place.
+const require = createRequire(import.meta.url);
+const { version } = require("../package.json");
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+// All logging goes to stderr — stdout is the JSON-RPC channel for stdio transport.
+const log = (msg) => console.error(`[tactus] ${msg}`);
+async function main() {
+    const config = loadConfig();
+    const controller = new ButtplugController(config);
+    const safety = new SafetyLayer(controller, config);
+    const server = makeServer(version);
+    registerTools(server, safety, controller, config);
+    let shuttingDown = false;
+    // Keep a live connection to Intiface with exponential backoff. Runs in the
+    // background so the MCP server still starts (and returns clear errors) when
+    // Intiface is down (spec §7.5).
+    const connectLoop = async () => {
+        let delay = 1_000;
+        while (!shuttingDown) {
+            try {
+                await controller.connect();
+                log(`connected to Intiface at ${config.intifaceUrl}`);
+                return;
+            }
+            catch (e) {
+                log(`${e instanceof Error ? e.message : String(e)} — retrying in ${delay}ms`);
+                await sleep(delay);
+                delay = Math.min(delay * 2, 30_000);
+            }
+        }
+    };
+    controller.onDisconnect(() => {
+        if (shuttingDown)
+            return;
+        log("Intiface connection dropped — reconnecting");
+        void connectLoop();
+    });
+    controller.onDeviceAdded((id, name) => log(`device connected: [${id}] ${name}`));
+    controller.onDeviceRemoved((id, name) => {
+        log(`device disconnected: [${id}] ${name} — clearing its safety timers`);
+        safety.forgetDevice(id);
+    });
+    // Stop everything if the AI client disconnects (transport close).
+    server.server.onclose = () => {
+        void safety.shutdown();
+    };
+    const shutdown = async (signal) => {
+        if (shuttingDown)
+            return;
+        shuttingDown = true;
+        log(`${signal} — stopping all devices`);
+        await safety.shutdown();
+        await controller.disconnect().catch(() => { });
+        process.exit(0);
+    };
+    process.on("SIGINT", () => void shutdown("SIGINT"));
+    process.on("SIGTERM", () => void shutdown("SIGTERM"));
+    void connectLoop();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    log("MCP server ready on stdio");
+}
+main().catch((e) => {
+    log(`fatal: ${e instanceof Error ? e.stack ?? e.message : String(e)}`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAExD,6EAA6E;AAC7E,4EAA4E;AAC5E,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAwB,CAAC;AAEtE,MAAM,KAAK,GAAG,CAAC,EAAU,EAAiB,EAAE,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AAEnF,mFAAmF;AACnF,MAAM,GAAG,GAAG,CAAC,GAAW,EAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,GAAG,EAAE,CAAC,CAAC;AAEpE,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,UAAU,GAAG,IAAI,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IACnC,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAElD,IAAI,YAAY,GAAG,KAAK,CAAC;IAEzB,2EAA2E;IAC3E,4EAA4E;IAC5E,gCAAgC;IAChC,MAAM,WAAW,GAAG,KAAK,IAAmB,EAAE;QAC5C,IAAI,KAAK,GAAG,KAAK,CAAC;QAClB,OAAO,CAAC,YAAY,EAAE,CAAC;YACrB,IAAI,CAAC;gBACH,MAAM,UAAU,CAAC,OAAO,EAAE,CAAC;gBAC3B,GAAG,CAAC,4BAA4B,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;gBACtD,OAAO;YACT,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,GAAG,CAAC,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,kBAAkB,KAAK,IAAI,CAAC,CAAC;gBAC9E,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC;gBACnB,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;YACtC,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,UAAU,CAAC,YAAY,CAAC,GAAG,EAAE;QAC3B,IAAI,YAAY;YAAE,OAAO;QACzB,GAAG,CAAC,4CAA4C,CAAC,CAAC;QAClD,KAAK,WAAW,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,UAAU,CAAC,aAAa,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC;IACjF,UAAU,CAAC,eAAe,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE;QACtC,GAAG,CAAC,yBAAyB,EAAE,KAAK,IAAI,+BAA+B,CAAC,CAAC;QACzE,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;IAEH,kEAAkE;IAClE,MAAM,CAAC,MAAM,CAAC,OAAO,GAAG,GAAS,EAAE;QACjC,KAAK,MAAM,CAAC,QAAQ,EAAE,CAAC;IACzB,CAAC,CAAC;IAEF,MAAM,QAAQ,GAAG,KAAK,EAAE,MAAc,EAAiB,EAAE;QACvD,IAAI,YAAY;YAAE,OAAO;QACzB,YAAY,GAAG,IAAI,CAAC;QACpB,GAAG,CAAC,GAAG,MAAM,yBAAyB,CAAC,CAAC;QACxC,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC;QACxB,MAAM,UAAU,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IACF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IACpD,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;IAEtD,KAAK,WAAW,EAAE,CAAC;IAEnB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,GAAG,CAAC,2BAA2B,CAAC,CAAC;AACnC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;IACjB,GAAG,CAAC,UAAU,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACvE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/safety.d.ts

@@ -0,0 +1,50 @@
+import { DeviceController, DriveTarget } from "./controller.js";
+import { TactusConfig } from "./types.js";
+export interface PatternStep {
+    intensity: number;
+    durationMs: number;
+}
+/**
+ * Wraps a DeviceController with the safety guarantees that are Tactus's headline
+ * feature (spec §7.4, playbook §3): intensity clamp, an INDEPENDENT watchdog
+ * timer (not check-on-next-call), per-device rate limiting, stop-preemptible
+ * patterns, and fail-safe stops that retry rather than assume success.
+ */
+export declare class SafetyLayer {
+    private readonly controller;
+    private readonly config;
+    private readonly watchdogs;
+    private readonly limiters;
+    private readonly patterns;
+    constructor(controller: DeviceController, config: TactusConfig);
+    /** Drive methods return the EFFECTIVE value actually applied (post-clamp), so
+     *  callers can see when a request was clamped — honesty over optimism. */
+    vibrate(deviceId: number, intensity: number, target?: DriveTarget): Promise<number>;
+    oscillate(deviceId: number, intensity: number, target?: DriveTarget): Promise<number>;
+    rotate(deviceId: number, speed: number, clockwise: boolean, target?: DriveTarget): Promise<number>;
+    linear(deviceId: number, position: number, durationMs: number, target?: DriveTarget): Promise<number>;
+    /**
+     * Kick off a server-side timed pattern and return immediately. Playing is
+     * driven by chained timers (NOT an awaited sleep), so a single tool call
+     * never occupies the serial stdio handler — stop_* can always preempt it
+     * (playbook §3.4).
+     */
+    startVibratePattern(deviceId: number, steps: readonly PatternStep[], repeat: number, target?: DriveTarget): void;
+    /** Fail-safe stop: if we cannot confirm the device stopped, retry — never
+     *  optimistically report success (playbook §3.1). */
+    stopDevice(deviceId: number): Promise<void>;
+    stopAll(): Promise<void>;
+    /** Drop all per-device state for a device that has disconnected. No point
+     *  keeping a watchdog/pattern/limiter alive for a device that is gone. */
+    forgetDevice(deviceId: number): void;
+    /** Best-effort emergency stop for shutdown paths; never throws. */
+    shutdown(): Promise<void>;
+    private driveScalar;
+    private clampIntensity;
+    private submit;
+    /** (Re)arm the independent auto-stop timer for a device. */
+    private armWatchdog;
+    private clearWatchdog;
+    private cancelPattern;
+    private retry;
+}