@agentdeck/bridge 0.2.2 → 1.0.0

package/dist/modules/serial-module.d.ts

@@ -9,6 +9,10 @@ export declare class SerialModule implements DeviceModule {
     setStateProvider(provider: () => BridgeEvent | null): void;
     /** Set a function that provides the latest usage event for ESP32 heartbeat. */
     setUsageProvider(provider: () => BridgeEvent | null): void;
+    /** Set a function that provides the current display_state for heartbeat re-sync. */
+    setDisplayStateProvider(provider: () => BridgeEvent | null): void;
+    /** Set a function that provides the current sessions_list for heartbeat re-sync. */
+    setSessionsListProvider(provider: () => BridgeEvent | null): void;
     private initialStateProvider;
     /** Set a provider that returns all initial state events for newly connected devices. */
     setInitialStateProvider(provider: () => BridgeEvent[]): void;

package/dist/modules/serial-module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serial-module.d.ts","sourceRoot":"","sources":["../../src/modules/serial-module.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAS9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,qBAAa,YAAa,YAAW,YAAY;IAC/C,QAAQ,CAAC,IAAI,YAAY;IACzB,OAAO,CAAC,aAAa,CAA2C;IAE1D,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAahE;yFACqF;IACrF,gBAAgB,CAAC,QAAQ,EAAE,MAAM,WAAW,GAAG,IAAI,GAAG,IAAI;IAK1D,+EAA+E;IAC/E,gBAAgB,CAAC,QAAQ,EAAE,MAAM,WAAW,GAAG,IAAI,GAAG,IAAI;IAI1D,OAAO,CAAC,oBAAoB,CAAsC;IAElE,wFAAwF;IACxF,uBAAuB,CAAC,QAAQ,EAAE,MAAM,WAAW,EAAE,GAAG,IAAI;IAKtD,KAAK,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAQxC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5B"}
+{"version":3,"file":"serial-module.d.ts","sourceRoot":"","sources":["../../src/modules/serial-module.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAW9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,qBAAa,YAAa,YAAW,YAAY;IAC/C,QAAQ,CAAC,IAAI,YAAY;IACzB,OAAO,CAAC,aAAa,CAA2C;IAE1D,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAShE;yFACqF;IACrF,gBAAgB,CAAC,QAAQ,EAAE,MAAM,WAAW,GAAG,IAAI,GAAG,IAAI;IAK1D,+EAA+E;IAC/E,gBAAgB,CAAC,QAAQ,EAAE,MAAM,WAAW,GAAG,IAAI,GAAG,IAAI;IAI1D,oFAAoF;IACpF,uBAAuB,CAAC,QAAQ,EAAE,MAAM,WAAW,GAAG,IAAI,GAAG,IAAI;IAIjE,oFAAoF;IACpF,uBAAuB,CAAC,QAAQ,EAAE,MAAM,WAAW,GAAG,IAAI,GAAG,IAAI;IAIjE,OAAO,CAAC,oBAAoB,CAAsC;IAElE,wFAAwF;IACxF,uBAAuB,CAAC,QAAQ,EAAE,MAAM,WAAW,EAAE,GAAG,IAAI;IAKtD,KAAK,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAQxC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5B"}

package/dist/modules/serial-module.js

@@ -1,21 +1,15 @@
-import { startESP32Serial, stopESP32Serial, broadcastESP32, setESP32StateProvider, setESP32UsageProvider, setESP32InitialStateProvider, } from '../esp32-serial.js';
+import { startESP32Serial, stopESP32Serial, broadcastESP32, setESP32StateProvider, setESP32UsageProvider, setESP32DisplayStateProvider, setESP32SessionsListProvider, setESP32InitialStateProvider, } from '../esp32-serial.js';
 export class SerialModule {
     name = 'serial';
     stateProvider = null;
     async shouldActivate(config) {
         if (config === false)
             return false;
-        if (config === true)
-            return true;
-        // auto: check if any USB serial device is connected
-        try {
-            const { readdirSync } = await import('fs');
-            const devFiles = readdirSync('/dev');
-            return devFiles.some((f) => f.startsWith('tty.usbserial') || f.startsWith('tty.wchusbserial') || f.startsWith('tty.usbmodem'));
-        }
-        catch {
-            return false;
-        }
+        // Always activate for 'auto' or true: startESP32Serial() polls /dev every 10s
+        // internally, so the module is harmless when no device is attached at daemon start.
+        // Checking /dev at startup caused a bug where plugging in ESP32 *after* the daemon
+        // started would never be detected (pollForDevices never ran).
+        return true;
     }
     /** Set a function that provides the latest state event for ESP32 heartbeat.
      *  Can be called before or after start() — if already started, wires immediately. */
@@ -27,6 +21,14 @@ export class SerialModule {
     setUsageProvider(provider) {
         setESP32UsageProvider(provider);
     }
+    /** Set a function that provides the current display_state for heartbeat re-sync. */
+    setDisplayStateProvider(provider) {
+        setESP32DisplayStateProvider(provider);
+    }
+    /** Set a function that provides the current sessions_list for heartbeat re-sync. */
+    setSessionsListProvider(provider) {
+        setESP32SessionsListProvider(provider);
+    }
     initialStateProvider = null;
     /** Set a provider that returns all initial state events for newly connected devices. */
     setInitialStateProvider(provider) {

package/dist/modules/serial-module.js.map

@@ -1 +1 @@
-{"version":3,"file":"serial-module.js","sourceRoot":"","sources":["../../src/modules/serial-module.ts"],"names":[],"mappings":"AACA,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,qBAAqB,EACrB,4BAA4B,GAC7B,MAAM,oBAAoB,CAAC;AAI5B,MAAM,OAAO,YAAY;IACd,IAAI,GAAG,QAAQ,CAAC;IACjB,aAAa,GAAsC,IAAI,CAAC;IAEhE,KAAK,CAAC,cAAc,CAAC,MAAwB;QAC3C,IAAI,MAAM,KAAK,KAAK;YAAE,OAAO,KAAK,CAAC;QACnC,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QACjC,oDAAoD;QACpD,IAAI,CAAC;YACH,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;YAC3C,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;YACrC,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC;QACjI,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;yFACqF;IACrF,gBAAgB,CAAC,QAAkC;QACjD,IAAI,CAAC,aAAa,GAAG,QAAQ,CAAC;QAC9B,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAED,+EAA+E;IAC/E,gBAAgB,CAAC,QAAkC;QACjD,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAEO,oBAAoB,GAAiC,IAAI,CAAC;IAElE,wFAAwF;IACxF,uBAAuB,CAAC,QAA6B;QACnD,IAAI,CAAC,oBAAoB,GAAG,QAAQ,CAAC;QACrC,4BAA4B,CAAC,QAAQ,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,GAAkB;QAC5B,gBAAgB,EAAE,CAAC;QACnB,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,qBAAqB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC5C,CAAC;QACD,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,IAAI;QACR,eAAe,EAAE,CAAC;IACpB,CAAC;CACF"}
+{"version":3,"file":"serial-module.js","sourceRoot":"","sources":["../../src/modules/serial-module.ts"],"names":[],"mappings":"AACA,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,qBAAqB,EACrB,4BAA4B,EAC5B,4BAA4B,EAC5B,4BAA4B,GAC7B,MAAM,oBAAoB,CAAC;AAI5B,MAAM,OAAO,YAAY;IACd,IAAI,GAAG,QAAQ,CAAC;IACjB,aAAa,GAAsC,IAAI,CAAC;IAEhE,KAAK,CAAC,cAAc,CAAC,MAAwB;QAC3C,IAAI,MAAM,KAAK,KAAK;YAAE,OAAO,KAAK,CAAC;QACnC,8EAA8E;QAC9E,oFAAoF;QACpF,mFAAmF;QACnF,8DAA8D;QAC9D,OAAO,IAAI,CAAC;IACd,CAAC;IAED;yFACqF;IACrF,gBAAgB,CAAC,QAAkC;QACjD,IAAI,CAAC,aAAa,GAAG,QAAQ,CAAC;QAC9B,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAED,+EAA+E;IAC/E,gBAAgB,CAAC,QAAkC;QACjD,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAED,oFAAoF;IACpF,uBAAuB,CAAC,QAAkC;QACxD,4BAA4B,CAAC,QAAQ,CAAC,CAAC;IACzC,CAAC;IAED,oFAAoF;IACpF,uBAAuB,CAAC,QAAkC;QACxD,4BAA4B,CAAC,QAAQ,CAAC,CAAC;IACzC,CAAC;IAEO,oBAAoB,GAAiC,IAAI,CAAC;IAElE,wFAAwF;IACxF,uBAAuB,CAAC,QAA6B;QACnD,IAAI,CAAC,oBAAoB,GAAG,QAAQ,CAAC;QACrC,4BAA4B,CAAC,QAAQ,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,GAAkB;QAC5B,gBAAgB,EAAE,CAAC;QACnB,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,qBAAqB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC5C,CAAC;QACD,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,IAAI;QACR,eAAe,EAAE,CAAC;IACpB,CAAC;CACF"}

package/dist/modules/timebox-module.d.ts

@@ -0,0 +1,9 @@
+import type { BridgeContext, DeviceModule } from './types.js';
+export declare class TimeboxModule implements DeviceModule {
+    readonly name = "timebox";
+    shouldActivate(config: 'auto' | boolean): Promise<boolean>;
+    start(ctx: BridgeContext): Promise<void>;
+    stop(): Promise<void>;
+    statusSnapshot(): Record<string, unknown>;
+}
+//# sourceMappingURL=timebox-module.d.ts.map

package/dist/modules/timebox-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timebox-module.d.ts","sourceRoot":"","sources":["../../src/modules/timebox-module.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAS9D,qBAAa,aAAc,YAAW,YAAY;IAChD,QAAQ,CAAC,IAAI,aAAa;IAEpB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAO1D,KAAK,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAaxC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAa1C"}

package/dist/modules/timebox-module.js

@@ -0,0 +1,46 @@
+import { loadTimeboxDevices, deviceId, isTimeboxAutoDiscoverEnabled, } from '../timebox/timebox-settings.js';
+import { startTimeboxSync, stopTimeboxSync } from '../timebox/timebox-daemon-sync.js';
+import { autoDiscoverTimebox } from '../timebox/timebox-discover.js';
+export class TimeboxModule {
+    name = 'timebox';
+    async shouldActivate(config) {
+        if (config === false)
+            return false;
+        if (config === true)
+            return true;
+        // Activate when a device is configured OR auto-discovery may find one.
+        return loadTimeboxDevices().length > 0 || isTimeboxAutoDiscoverEnabled();
+    }
+    async start(ctx) {
+        // Start sync for any already-configured device immediately, then run a
+        // background BLE scan if none is configured. Discovery is non-blocking so
+        // daemon startup isn't delayed by the ~5s scan; when it adds a device we
+        // re-invoke startTimeboxSync (idempotent per-address) to pick it up.
+        startTimeboxSync(ctx.port);
+        if (loadTimeboxDevices().length === 0 && isTimeboxAutoDiscoverEnabled()) {
+            void autoDiscoverTimebox().then((added) => {
+                if (added > 0)
+                    startTimeboxSync(ctx.port);
+            });
+        }
+    }
+    async stop() {
+        // Await each child's blank-panel farewell so the panel doesn't freeze on its
+        // last dashboard frame when the daemon exits.
+        await stopTimeboxSync(true);
+    }
+    statusSnapshot() {
+        const devices = loadTimeboxDevices();
+        return {
+            configuredDeviceCount: devices.length,
+            devices: devices.map((d) => ({
+                id: deviceId(d),
+                transport: 'ble',
+                address: d.address,
+                name: d.name ?? 'Timebox Mini',
+                brightness: d.brightness ?? 100,
+            })),
+        };
+    }
+}
+//# sourceMappingURL=timebox-module.js.map

package/dist/modules/timebox-module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timebox-module.js","sourceRoot":"","sources":["../../src/modules/timebox-module.ts"],"names":[],"mappings":"AACA,OAAO,EACL,kBAAkB,EAClB,QAAQ,EACR,4BAA4B,GAC7B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACtF,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAErE,MAAM,OAAO,aAAa;IACf,IAAI,GAAG,SAAS,CAAC;IAE1B,KAAK,CAAC,cAAc,CAAC,MAAwB;QAC3C,IAAI,MAAM,KAAK,KAAK;YAAE,OAAO,KAAK,CAAC;QACnC,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QACjC,uEAAuE;QACvE,OAAO,kBAAkB,EAAE,CAAC,MAAM,GAAG,CAAC,IAAI,4BAA4B,EAAE,CAAC;IAC3E,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,GAAkB;QAC5B,uEAAuE;QACvE,0EAA0E;QAC1E,yEAAyE;QACzE,qEAAqE;QACrE,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC3B,IAAI,kBAAkB,EAAE,CAAC,MAAM,KAAK,CAAC,IAAI,4BAA4B,EAAE,EAAE,CAAC;YACxE,KAAK,mBAAmB,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;gBACxC,IAAI,KAAK,GAAG,CAAC;oBAAE,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC5C,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI;QACR,6EAA6E;QAC7E,8CAA8C;QAC9C,MAAM,eAAe,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,cAAc;QACZ,MAAM,OAAO,GAAG,kBAAkB,EAAE,CAAC;QACrC,OAAO;YACL,qBAAqB,EAAE,OAAO,CAAC,MAAM;YACrC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC3B,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC;gBACf,SAAS,EAAE,KAAK;gBAChB,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,cAAc;gBAC9B,UAAU,EAAE,CAAC,CAAC,UAAU,IAAI,GAAG;aAChC,CAAC,CAAC;SACJ,CAAC;IACJ,CAAC;CACF"}

package/dist/modules/trmnl-module.d.ts

@@ -0,0 +1,38 @@
+/**
+ * TRMNL device module — keeps the BYOS frame cache fresh.
+ *
+ * TRMNL is a WiFi e-ink display that PULLS rendered images from a server on its
+ * own schedule (the BYOS /api/display contract), so unlike Pixoo/D200H this
+ * module never pushes to hardware. It only subscribes to AgentDeck state
+ * broadcasts and re-renders the cached 800×480 1-bit frame when the visual state
+ * changes; the daemon's HTTP routes (bridge/src/trmnl/byos-server.ts) serve that
+ * frame when a device polls.
+ *
+ * Rendering is gated on a device being registered (or `trmnl.enabled`) so a
+ * machine with no TRMNL panel does no extra rasterization. The gate is refreshed
+ * from settings on a short interval and immediately when a device enrolls.
+ */
+import type { DeviceModule, BridgeContext } from './types.js';
+export declare class TrmnlModule implements DeviceModule {
+    readonly name = "trmnl";
+    private lastState;
+    private lastUsage;
+    private lastSessions;
+    private gateActive;
+    private gateTimer;
+    shouldActivate(config: 'auto' | boolean): Promise<boolean>;
+    start(ctx: BridgeContext): Promise<void>;
+    stop(): Promise<void>;
+    statusSnapshot(): Record<string, unknown>;
+    /** Re-read settings to decide whether rendering is worthwhile. */
+    private refreshGate;
+    private render;
+    /**
+     * Combine the latest state_update + usage_update + sessions into one render
+     * event. usage_update is spread last so its 5H/7D + reset fields win. No time
+     * component is added: the frame hash must change only on real visual change so
+     * a real TRMNL can skip the (battery + flaky-WiFi) re-download otherwise.
+     */
+    private buildRenderState;
+}
+//# sourceMappingURL=trmnl-module.d.ts.map

package/dist/modules/trmnl-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trmnl-module.d.ts","sourceRoot":"","sources":["../../src/modules/trmnl-module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAgB9D,qBAAa,WAAY,YAAW,YAAY;IAC9C,QAAQ,CAAC,IAAI,WAAW;IAExB,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAA+C;IAE1D,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAQ1D,KAAK,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBxC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3B,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAoBzC,kEAAkE;IAClE,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,MAAM;IAWd;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;CAYzB"}

package/dist/modules/trmnl-module.js

@@ -0,0 +1,111 @@
+import { initTrmnlRenderer, isTrmnlResvgLoaded } from '../trmnl/image-renderer.js';
+import { refreshTrmnlFrame, setTrmnlState, getTrmnlFrameKeys, getTrmnlActivity } from '../trmnl/frame-cache.js';
+import { loadTrmnlConfig, effectiveRefreshRate } from '../trmnl/trmnl-settings.js';
+import { getTelemetryHealth } from '../trmnl/trmnl-telemetry.js';
+import { debug } from '../logger.js';
+const TAG = 'trmnl';
+const GATE_REFRESH_MS = 30_000;
+function isControllableOrObserved(session) {
+    // TRMNL is a read-only dashboard — show every live session (controllable or
+    // observed), unlike D200H which filters to controllable for its buttons.
+    return !!session && session.alive !== false;
+}
+export class TrmnlModule {
+    name = 'trmnl';
+    lastState = null;
+    lastUsage = null;
+    lastSessions = [];
+    gateActive = false;
+    gateTimer = null;
+    async shouldActivate(config) {
+        if (config === false)
+            return false;
+        if (config === true)
+            return true;
+        // auto: active if a device is registered or the user forced it on.
+        const cfg = loadTrmnlConfig();
+        return cfg.enabled || cfg.devices.length > 0;
+    }
+    async start(ctx) {
+        await initTrmnlRenderer();
+        this.refreshGate();
+        this.gateTimer = setInterval(() => this.refreshGate(), GATE_REFRESH_MS);
+        ctx.wsServer.onBroadcast((evt) => {
+            if (evt?.type === 'state_update') {
+                this.lastState = evt;
+                this.render();
+            }
+            else if (evt?.type === 'usage_update') {
+                // state_update never carries usage; the 5H/7D gauges + token/cost footer
+                // only exist on usage_update (same as Pixoo/ESP32). Without this the panel
+                // renders a confident 0% forever.
+                this.lastUsage = evt;
+                this.render();
+            }
+            else if (evt?.type === 'sessions_list') {
+                this.lastSessions = (evt.sessions ?? []).filter(isControllableOrObserved);
+                this.render();
+            }
+        });
+        debug(TAG, `started (resvg=${isTrmnlResvgLoaded()}, gate=${this.gateActive})`);
+    }
+    async stop() {
+        if (this.gateTimer) {
+            clearInterval(this.gateTimer);
+            this.gateTimer = null;
+        }
+    }
+    statusSnapshot() {
+        const cfg = loadTrmnlConfig();
+        const activeResolutions = getTrmnlFrameKeys();
+        const activity = getTrmnlActivity();
+        const currentRefreshRate = effectiveRefreshRate(cfg, activity);
+        return {
+            resvgLoaded: isTrmnlResvgLoaded(),
+            gateActive: this.gateActive,
+            enabled: cfg.enabled,
+            deviceCount: cfg.devices.length,
+            refreshRate: cfg.refreshRate,
+            refreshActive: cfg.refreshActive,
+            currentRefreshRate,
+            activeResolutions,
+            frameCount: activeResolutions.length,
+            // Health uses the current adaptive cadence so "stale" tracks real expectations.
+            telemetry: getTelemetryHealth(currentRefreshRate),
+        };
+    }
+    /** Re-read settings to decide whether rendering is worthwhile. */
+    refreshGate() {
+        const cfg = loadTrmnlConfig();
+        this.gateActive = cfg.enabled || cfg.devices.length > 0;
+    }
+    render() {
+        const evt = this.buildRenderState();
+        if (!this.gateActive) {
+            // No device yet — remember the state so the frame is correct the instant a
+            // device enrolls (byos-server forces a render then), but skip rasterizing.
+            setTrmnlState(evt);
+            return;
+        }
+        refreshTrmnlFrame(evt);
+    }
+    /**
+     * Combine the latest state_update + usage_update + sessions into one render
+     * event. usage_update is spread last so its 5H/7D + reset fields win. No time
+     * component is added: the frame hash must change only on real visual change so
+     * a real TRMNL can skip the (battery + flaky-WiFi) re-download otherwise.
+     */
+    buildRenderState() {
+        const u = this.lastUsage ?? {};
+        // Usage is "known" only when the hub actually has subscription quota (the
+        // gauges are meaningful); otherwise the layout renders "—" instead of 0%.
+        const usageKnown = u.fiveHourPercent != null || u.sevenDayPercent != null;
+        return {
+            ...(this.lastState ?? {}),
+            ...u,
+            usageKnown,
+            allSessions: this.lastSessions,
+        };
+    }
+}
+//# sourceMappingURL=trmnl-module.js.map

package/dist/modules/trmnl-module.js.map

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

package/dist/modules/types.d.ts

@@ -12,7 +12,7 @@ export interface BridgeContext {
 }
 /**
  * Pluggable device module interface.
- * Modules wrap optional device integrations (mDNS, ADB, ESP32 serial, Pixoo).
+ * Modules wrap optional device integrations (mDNS, ADB, ESP32 serial, Pixoo, Timebox).
  */
 export interface DeviceModule {
     readonly name: string;
@@ -31,9 +31,11 @@ export interface DeviceModule {
  */
 export interface ModuleConfigs {
     mdns?: 'auto' | boolean;
+    broadcast?: 'auto' | boolean;
     adb?: 'auto' | boolean;
     serial?: 'auto' | boolean;
     pixoo?: 'auto' | boolean;
-    d200h?: 'auto' | boolean;
+    timebox?: 'auto' | boolean;
+    idotmatrix?: 'auto' | boolean;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/modules/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/modules/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,QAAQ,CAAC;IACnB,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,IAAI,CAAC;CAC3C;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE3D,qEAAqE;IACrE,KAAK,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzC,8CAA8C;IAC9C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/modules/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,QAAQ,CAAC;IACnB,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,IAAI,CAAC;CAC3C;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE3D,qEAAqE;IACrE,KAAK,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzC,8CAA8C;IAC9C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B"}

package/dist/observed-steering.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Steering state for observed (direct `claude`, no PTY) sessions.
+ *
+ * The daemon cannot type into an observed session's terminal, but Claude Code
+ * hooks form a synchronous RPC channel that supports three steering
+ * primitives, all resolved here:
+ *
+ *   1. Device approval — a held PreToolUse response (permission-resolver.ts)
+ *      answers a genuine permission prompt with allow/deny. Gate eligibility
+ *      is decided by `shouldHoldPreToolUse` below (precision-first: every
+ *      uncertainty resolves to "don't hold" — see claude-permission-rules.ts).
+ *   2. Soft STOP — a stop flag consumed by the next PreToolUse, which returns
+ *      `deny` with an instruction to halt. Not an instant Ctrl+C (pure text
+ *      generation runs to the next tool call), but a real stop at the next
+ *      tool boundary.
+ *   3. Turn-end directives — prompts queued while the session is processing,
+ *      delivered by the Stop hook as `{decision:'block', reason}` so Claude
+ *      continues with the queued instruction instead of ending the turn.
+ *      Bounded by design: each Stop drains at most one directive, the queue
+ *      is hard-capped, and an empty queue always lets the turn end (no
+ *      stop_hook_active loop).
+ *
+ * Keyed by the Claude session UUID (same key as awaiting-overlay.ts). Lives
+ * outside the state machine for the same reason: per-session attribution.
+ */
+/** Bash signature = first two command tokens (the granularity of Claude's own
+ *  "always allow `git push`"-style session approvals); other tools = tool name. */
+export declare function gateSignature(tool: string, toolInput: Record<string, unknown> | undefined): string;
+/** Human-readable question for the gate's awaiting overlay — device-native
+ *  semantics ("Allow Bash: git push …?"), never a fabricated mirror of the
+ *  TUI prompt's option labels. Overlay caps length at 120 chars. */
+export declare function buildGateQuestion(tool: string, toolInput?: Record<string, unknown>): string;
+export declare function requestStop(sid: string): void;
+export declare function clearStop(sid: string): boolean;
+export declare function isStopRequested(sid: string): boolean;
+/** One-shot consume by the PreToolUse deny path. */
+export declare function consumeStop(sid: string): boolean;
+export declare const STOP_DENY_REASON: string;
+export declare function queueDirective(sid: string, text: string): boolean;
+/** Pop exactly one directive (Stop hook drains one per turn end). A pending
+ *  STOP outranks directives: stopping wins, the queue is discarded. */
+export declare function takeDirective(sid: string): string | undefined;
+export declare function queuedDirectiveCount(sid: string): number;
+/** User re-engaged in the terminal — their own prompt supersedes anything the
+ *  deck queued, and a pending STOP is moot. */
+export declare function clearOnUserPrompt(sid: string): boolean;
+export declare function clearSession(sid: string): void;
+export interface HoldDecision {
+    hold: boolean;
+    requestId?: string;
+    reason: string;
+}
+export interface HoldContext {
+    sessionId: string;
+    tool: string;
+    toolInput: Record<string, unknown> | undefined;
+    permissionMode: string | undefined;
+    cwd: string | undefined;
+    /** Connected dashboard clients that could answer — no client, no hold. */
+    clientCount: number;
+    enabled: boolean;
+}
+/**
+ * Should this PreToolUse be held for device approval? Precision-first: hold
+ * ONLY when every check says Claude would genuinely prompt the user. Any
+ * uncertainty → pass through untouched (Claude's normal flow, zero latency).
+ */
+export declare function shouldHoldPreToolUse(ctx: HoldContext): HoldDecision;
+/** The held gate resolved (device decision, timeout, sweep). `undecided` marks
+ *  a pass-through release, which arms the auto-approval learner below. */
+export declare function gateReleased(sid: string, requestId: string, opts: {
+    undecided: boolean;
+    tool: string;
+    toolInput?: Record<string, unknown>;
+}): void;
+/** A permission_prompt Notification arrived — every recent undecided release
+ *  was a GENUINE prompt, so nothing should be learned as auto-approved. */
+export declare function notePermissionPromptShown(sid: string): void;
+/**
+ * PostToolUse arrived. If a recent undecided release matches this tool and no
+ * permission_prompt Notification came in between, Claude auto-approved it
+ * (session-scoped "always allow" we cannot read) — suppress the signature so
+ * it is never held again this session.
+ */
+export declare function noteToolEnd(sid: string, tool: string | undefined): void;
+/** Enrichment snapshot for sessions_list (devices render STOPPING / queue badges). */
+export declare function steeringSnapshot(sid: string): {
+    stopRequested: boolean;
+    queuedDirectives: number;
+};
+/** Test helper. */
+export declare function _resetSteering(): void;
+//# sourceMappingURL=observed-steering.d.ts.map

package/dist/observed-steering.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observed-steering.d.ts","sourceRoot":"","sources":["../src/observed-steering.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AA4CH;mFACmF;AACnF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,MAAM,CAMlG;AAED;;oEAEoE;AACpE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAK3F;AAID,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAG7C;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAK9C;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAQpD;AAED,oDAAoD;AACpD,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAKhD;AAED,eAAO,MAAM,gBAAgB,QAGuC,CAAC;AAIrE,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAUjE;AAED;uEACuE;AACvE,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAU7D;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMxD;AAED;+CAC+C;AAC/C,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAOtD;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAE9C;AAID,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC/C,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,0EAA0E;IAC1E,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,WAAW,GAAG,YAAY,CAqBnE;AAED;0EAC0E;AAC1E,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAC9E,IAAI,CAYN;AAED;2EAC2E;AAC3E,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAG3D;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAevE;AAED,sFAAsF;AACtF,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,aAAa,EAAE,OAAO,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE,CAKlG;AAED,mBAAmB;AACnB,wBAAgB,cAAc,IAAI,IAAI,CAErC"}