@agentdeck/bridge 1.0.5 → 1.0.7

package/dist/openclaw-session.js.map

@@ -1 +1 @@
-{"version":3,"file":"openclaw-session.js","sourceRoot":"","sources":["../src/openclaw-session.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAahF;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAA2B,EAC3B,IAA2B;IAE3B,IAAI,CAAC,uBAAuB,CAAC,EAAE,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC3F,IAAI,kBAAkB,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IAClD,MAAM,QAAQ,GAAoB;QAChC,EAAE,EAAE,kBAAkB;QACtB,IAAI,EAAE,KAAK;QACX,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,UAAU;QAC3C,SAAS,EAAE,UAAU;QACrB,KAAK,EAAE,IAAI;KACZ,CAAC;IACF,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;QAAE,QAAQ,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IAC1D,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;QAAE,QAAQ,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;IACtE,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS;QAAE,QAAQ,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;IAC5E,OAAO,CAAC,GAAG,QAAQ,EAAE,QAAQ,CAAC,CAAC;AACjC,CAAC"}
+{"version":3,"file":"openclaw-session.js","sourceRoot":"","sources":["../src/openclaw-session.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAGhF;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,kBAAkB,CAAC;AAYtD;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAA2B,EAC3B,IAA2B;IAE3B,IAAI,CAAC,uBAAuB,CAAC,EAAE,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC3F,IAAI,kBAAkB,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IAClD,MAAM,QAAQ,GAAoB;QAChC,EAAE,EAAE,mBAAmB;QACvB,IAAI,EAAE,KAAK;QACX,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,UAAU;QAC3C,SAAS,EAAE,UAAU;QACrB,KAAK,EAAE,IAAI;KACZ,CAAC;IACF,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;QAAE,QAAQ,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IAC1D,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;QAAE,QAAQ,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;IACtE,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS;QAAE,QAAQ,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;IAC5E,OAAO,CAAC,GAAG,QAAQ,EAAE,QAAQ,CAAC,CAAC;AACjC,CAAC"}

package/dist/timebox/timebox-daemon-sync.d.ts

@@ -5,6 +5,7 @@
  * (bleak/GATT). Node has no built-in BLE support, so we spawn the small Python
  * writer. This code is terminal-managed CLI daemon only.
  */
+import { type BleLinkSnapshot } from '../ble-sync-status.js';
 export declare function startTimeboxSync(httpPort: number): void;
 /**
  * Stop all managed Timebox BLE syncs and cancel pending respawns.
@@ -16,4 +17,11 @@ export declare function startTimeboxSync(httpPort: number): void;
  * awaited in parallel (BLE is per-device, so farewells don't serialize).
  */
 export declare function stopTimeboxSync(awaitFarewell?: boolean): Promise<void>;
+/**
+ * Live link state for the configured Timebox panels, in the `BLEMatrixHealth`
+ * wire shape. Called by `TimeboxModule.statusSnapshot()` so `/health` reports
+ * whether the panel is actually being driven — the configured-device list alone
+ * left every dashboard drawing a streaming panel as disconnected.
+ */
+export declare function timeboxLinkSnapshot(configuredDeviceCount: number): BleLinkSnapshot;
 //# sourceMappingURL=timebox-daemon-sync.d.ts.map

package/dist/timebox/timebox-daemon-sync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"timebox-daemon-sync.d.ts","sourceRoot":"","sources":["../../src/timebox/timebox-daemon-sync.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA4BH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAyBvD;AAiDD;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CAAC,aAAa,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAwB1E"}
+{"version":3,"file":"timebox-daemon-sync.d.ts","sourceRoot":"","sources":["../../src/timebox/timebox-daemon-sync.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EAGL,KAAK,eAAe,EAErB,MAAM,uBAAuB,CAAC;AA6B/B,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CA8BvD;AAqDD;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CAAC,aAAa,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAyB1E;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,qBAAqB,EAAE,MAAM,GAAG,eAAe,CAWlF"}

package/dist/timebox/timebox-daemon-sync.js

@@ -7,8 +7,11 @@
  */
 import { deviceId, loadTimeboxDevices } from './timebox-settings.js';
 import { createSyncCycleSquelch, spawnPythonSync, terminateSyncChild } from '../ble-sync-spawn.js';
+import { createBleLinkTracker, mergeBleLinkSnapshots, } from '../ble-sync-status.js';
 import { getBleRuntimeStatus } from '../python-ble-runtime.js';
 const entries = new Map();
+/** Set when no child could be spawned at all (missing BLE runtime). */
+let unavailableReason = null;
 const BASE_BACKOFF_MS = 5_000;
 const MAX_BACKOFF_MS = 60_000;
 const HEALTHY_UPTIME_MS = 30_000;
@@ -22,8 +25,12 @@ export function startTimeboxSync(httpPort) {
     const runtime = getBleRuntimeStatus();
     if (!runtime.ready || !runtime.python) {
         log(`sync unavailable (${runtime.reason}); run \`agentdeck ble setup\``);
+        // Register the reason so /health can say *why* the panel is dark instead of
+        // reporting a bare `connected:false` with no explanation.
+        unavailableReason = `BLE sync unavailable: ${runtime.reason}`;
         return;
     }
+    unavailableReason = null;
     for (const device of devices) {
         const id = deviceId(device);
         if (!id || entries.has(id))
@@ -36,6 +43,7 @@ export function startTimeboxSync(httpPort) {
             consecutiveFailures: 0,
             startedAt: 0,
             squelch: createSyncCycleSquelch(log),
+            link: createBleLinkTracker(),
         };
         entries.set(id, entry);
         spawnSync(entry, runtime.python, runtime.paths.scripts.timeboxSync, httpPort);
@@ -51,9 +59,12 @@ function spawnSync(entry, venvPython, syncScript, httpPort) {
     const args = [syncScript, '--address', device.address, '--url', url, '--brightness', String(brightness)];
     entry.squelch.logStart(`Starting BLE sync for ${device.name ?? 'Timebox Mini'} (${id}, bridge ${url}, brightness ${brightness}%)`);
     entry.startedAt = Date.now();
+    entry.link.noteSpawn();
     // stdout/stderr are captured into small rings so clean exits and crashes both
     // leave enough context without flooding the daemon log while running.
-    const { proc, stderrTail, outputTail } = spawnPythonSync(venvPython, args);
+    const { proc, stderrTail, outputTail } = spawnPythonSync(venvPython, args, {
+        onStatus: (payload) => entry.link.applyStatusLine(payload),
+    });
     entry.child = proc;
     proc.on('error', (err) => {
         log(`sync failed to spawn for ${id}: ${err.message}`);
@@ -74,6 +85,7 @@ function spawnSync(entry, venvPython, syncScript, httpPort) {
         const delay = Math.min(MAX_BACKOFF_MS, BASE_BACKOFF_MS * entry.consecutiveFailures);
         const tail = stderrTail() || outputTail();
         const why = tail ? `; output: ${tail}` : '';
+        entry.link.noteExit(tail || `sync exited (code=${code} signal=${signal})`, Date.now() + delay);
         entry.squelch.logExit(code, signal, uptimeMs, tail, `sync for ${id} exited (code=${code} signal=${signal})${why}; respawning in ${Math.round(delay / 1000)}s`);
         entry.respawnTimer = setTimeout(() => spawnSync(entry, venvPython, syncScript, httpPort), delay);
         if (entry.respawnTimer.unref)
@@ -114,7 +126,23 @@ export async function stopTimeboxSync(awaitFarewell = false) {
         }
     }
     entries.clear();
+    unavailableReason = null;
     if (procs.length)
         await Promise.all(procs.map((p) => terminateSyncChild(p)));
 }
+/**
+ * Live link state for the configured Timebox panels, in the `BLEMatrixHealth`
+ * wire shape. Called by `TimeboxModule.statusSnapshot()` so `/health` reports
+ * whether the panel is actually being driven — the configured-device list alone
+ * left every dashboard drawing a streaming panel as disconnected.
+ */
+export function timeboxLinkSnapshot(configuredDeviceCount) {
+    const merged = mergeBleLinkSnapshots([...entries.values()].map((e) => e.link.snapshot(configuredDeviceCount)), configuredDeviceCount);
+    // A configured device with no entry at all means the supervisor never got to
+    // spawn anything — surface that instead of an unexplained `connected:false`.
+    if (unavailableReason && configuredDeviceCount > 0 && !merged.connected) {
+        return { ...merged, statusReason: unavailableReason };
+    }
+    return merged;
+}
 //# sourceMappingURL=timebox-daemon-sync.js.map

package/dist/timebox/timebox-daemon-sync.js.map

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

package/dist/timeline-summarizer.d.ts

@@ -2,10 +2,20 @@
  * Timeline summarizer — uses local LLM to create concise 1-line summaries
  * of OpenClaw chat responses for timeline display.
  *
- * Tries: local mlx-serve qwen (port 8800) → Ollama → heuristic fallback.
- * Non-blocking — caller should fire-and-forget, update entry when ready.
+ * Tries: on-device Foundation Models → local mlx-serve qwen (port 8800) →
+ * Ollama → heuristic fallback. Non-blocking — caller should fire-and-forget,
+ * update entry when ready.
+ *
+ * The provider order is the Node mirror of Swift's `TimelineSummarizer`
+ * `.auto` chain (FoundationModels → MLX → Ollama → heuristic). It was
+ * MLX-first for a long time, which meant a CLI-only user on macOS 26 with
+ * Apple Intelligence available still got heuristic rows unless they also ran
+ * an MLX server — the same machine summarized differently depending on which
+ * daemon happened to be up. Keep the two chains in the same order.
  */
 export { extractTopicHint } from '@agentdeck/shared';
+/** Reset the cached provider availability (tests only). */
+export declare function clearSummarizerProviderCacheForTests(): void;
 /**
  * Summarize a chat response into a concise 1-line Korean summary.
  * Returns null if summarization fails (caller should use fallback).

package/dist/timeline-summarizer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"timeline-summarizer.d.ts","sourceRoot":"","sources":["../src/timeline-summarizer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAiCrD;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAoE5E"}
+{"version":3,"file":"timeline-summarizer.d.ts","sourceRoot":"","sources":["../src/timeline-summarizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAmCrD,2DAA2D;AAC3D,wBAAgB,oCAAoC,IAAI,IAAI,CAS3D;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAyF5E"}

package/dist/timeline-summarizer.js

@@ -2,12 +2,21 @@
  * Timeline summarizer — uses local LLM to create concise 1-line summaries
  * of OpenClaw chat responses for timeline display.
  *
- * Tries: local mlx-serve qwen (port 8800) → Ollama → heuristic fallback.
- * Non-blocking — caller should fire-and-forget, update entry when ready.
+ * Tries: on-device Foundation Models → local mlx-serve qwen (port 8800) →
+ * Ollama → heuristic fallback. Non-blocking — caller should fire-and-forget,
+ * update entry when ready.
+ *
+ * The provider order is the Node mirror of Swift's `TimelineSummarizer`
+ * `.auto` chain (FoundationModels → MLX → Ollama → heuristic). It was
+ * MLX-first for a long time, which meant a CLI-only user on macOS 26 with
+ * Apple Intelligence available still got heuristic rows unless they also ran
+ * an MLX server — the same machine summarized differently depending on which
+ * daemon happened to be up. Keep the two chains in the same order.
  */
 import { debug, log } from './logger.js';
 import { SUMMARY_SYSTEM_PROMPT, cleanLLMOutput, mlxChatUrl, resolveMlxModel } from '@agentdeck/shared';
 import { fetchMlxModels } from './mlx-probe.js';
+import { callFoundationModelsHelper, probeFoundationModelsHelper } from './foundation-models-helper.js';
 export { extractTopicHint } from '@agentdeck/shared';
 const MLX_URL = mlxChatUrl();
 // In-memory cache of the probe's first result, so summarizers don't hit
@@ -32,11 +41,24 @@ async function resolveModelForCall() {
 const OLLAMA_URL = 'http://localhost:11434/api/chat';
 const TIMEOUT_MS = 30_000; // 30s — first inference needs model load time
 const MAX_INPUT_CHARS = 2000;
+let fmAvailable = null;
 let mlxAvailable = null;
 let ollamaAvailable = null;
+let fmFailedAt = 0;
 let mlxFailedAt = 0;
 let ollamaFailedAt = 0;
 const RETRY_INTERVAL_MS = 60_000; // retry failed providers after 60s
+/** Reset the cached provider availability (tests only). */
+export function clearSummarizerProviderCacheForTests() {
+    fmAvailable = null;
+    mlxAvailable = null;
+    ollamaAvailable = null;
+    fmFailedAt = 0;
+    mlxFailedAt = 0;
+    ollamaFailedAt = 0;
+    probedFirstModel = null;
+    probedAt = 0;
+}
 /**
  * Summarize a chat response into a concise 1-line Korean summary.
  * Returns null if summarization fails (caller should use fallback).
@@ -49,7 +71,29 @@ export async function summarizeResponse(text) {
         : text;
     let mlxJustFailed = false;
     let ollamaJustFailed = false;
-    // Try MLX qwen first (retry after RETRY_INTERVAL_MS)
+    // Try on-device Foundation Models first — no server for the user to run,
+    // and it is the same helper process the APME judge already keeps warm.
+    // A miss here is not an error state: off-macOS, on macOS < 26, or with
+    // Apple Intelligence disabled the probe simply reports unavailable and the
+    // chain moves on. Only MLX+Ollama failing together is worth telling the
+    // user about (that pair is what the user opts into by installing them).
+    if (fmAvailable !== false || (Date.now() - fmFailedAt > RETRY_INTERVAL_MS)) {
+        try {
+            const result = await callFoundationModels(input);
+            if (result) {
+                if (fmAvailable === false)
+                    debug('summarizer', 'Foundation Models recovered');
+                fmAvailable = true;
+                return result;
+            }
+        }
+        catch (err) {
+            fmAvailable = false;
+            fmFailedAt = Date.now();
+            debug('summarizer', `Foundation Models not available: ${String(err)}`);
+        }
+    }
+    // Try MLX qwen next (retry after RETRY_INTERVAL_MS)
     if (mlxAvailable !== false || (Date.now() - mlxFailedAt > RETRY_INTERVAL_MS)) {
         try {
             const result = await callMLX(input);
@@ -99,11 +143,29 @@ export async function summarizeResponse(text) {
     if ((mlxJustFailed && ollamaJustFailed)
         || (mlxJustFailed && ollamaAvailable === false)
         || (ollamaJustFailed && mlxAvailable === false)) {
-        log('[timeline] LLM summary backend offline (MLX:8800 / Ollama:11434).', 'Timeline rows will use heuristic summaries.', 'Install MLX (`mlx_vlm.server`) or Ollama to get LLM-summarized chat_end rows.');
+        log(`[timeline] LLM summary backend offline (on-device Foundation Models: ${fmAvailable === false ? 'unavailable' : 'not reached'}, MLX:8800, Ollama:11434).`, 'Timeline rows will use heuristic summaries.', 'Install MLX (`mlx_vlm.server`) or Ollama to get LLM-summarized chat_end rows.');
     }
     return null;
 }
 // extractTopicHint and cleanLLMOutput moved to @agentdeck/shared/timeline-summarizer
+/** On-device summary via the bundled Swift helper (Apple Intelligence).
+ *  Throws when the helper is unavailable so the caller falls to MLX; the
+ *  helper owns its own request timeout, so there is no unbounded await here. */
+async function callFoundationModels(input) {
+    // Probe only on the first attempt: the probe is a full health round-trip to
+    // the helper, and after that the generate call is its own liveness check.
+    // (`fmAvailable` is null exactly once — the caller flips it either way.)
+    if (fmAvailable === null) {
+        const status = await probeFoundationModelsHelper();
+        if (!status.available)
+            throw new Error(status.reason ?? 'helper unavailable');
+    }
+    const text = await callFoundationModelsHelper(input, SUMMARY_SYSTEM_PROMPT);
+    const result = cleanLLMOutput(text);
+    if (result)
+        debug('summarizer', `Foundation Models summary: ${result}`);
+    return result;
+}
 async function callMLX(input) {
     const controller = new AbortController();
     const timer = setTimeout(() => controller.abort(), TIMEOUT_MS);

package/dist/timeline-summarizer.js.map

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

package/dist/trmnl/byos-server.d.ts

@@ -0,0 +1,39 @@
+/**
+ * TRMNL BYOS (Bring Your Own Server) HTTP handlers, mounted on the daemon hub.
+ *
+ * Implements the minimal TRMNL device contract so a stock-firmware panel pointed
+ * at `http://<daemon-host>:9120` renders the AgentDeck dashboard:
+ *
+ *   GET  /api/setup    ID:<mac>                       → { api_key, friendly_id, image_url }
+ *   GET  /api/display  ID:<mac> Access-Token:<key>    → { image_url, filename, refresh_rate, ... }
+ *   GET  /trmnl/image/<W>x<H>-<hash>.png              → 1-bit PNG frame (per resolution)
+ *   POST /api/log      ID:<mac>                        → 204 (device logs, debug only)
+ *
+ * The device authenticates only by MAC (ID header); the api_key issued at setup
+ * is a soft gate on /api/display. This is LAN-local hardware, so no token is
+ * required to fetch the image itself. Any panel auto-enrolls regardless of MAC,
+ * and the dashboard is rendered at the device-reported Width/Height so different
+ * BYOS panels render correctly. The device's FW-Version/RSSI/Battery/etc. headers
+ * are captured as runtime telemetry. See docs: https://docs.trmnl.com/go/diy/byos
+ */
+import type { IncomingMessage, ServerResponse } from 'http';
+/** Test helper — clear weak-RSSI transition tracking. */
+export declare function _resetWeakRssiTracking(): void;
+/** GET /api/setup — enroll the device (by MAC) and hand back an api_key. */
+export declare function handleTrmnlSetup(req: IncomingMessage, res: ServerResponse): void;
+/**
+ * GET /api/display — return the next image + polling cadence.
+ *
+ * NOTE: we always reply with HTTP 200; the BYOS `status` field carries the real
+ * signal (0 = show image, 202 = call /api/setup). Stock firmware treats a non-200
+ * HTTP status as an error and goes back to sleep without rendering, so HTTP 200 is
+ * required even in the "needs setup" case.
+ */
+export declare function handleTrmnlDisplay(req: IncomingMessage, res: ServerResponse): void;
+/** GET /trmnl/image/<W>x<H>-<hash>.png — serve the 1-bit PNG for that resolution. */
+export declare function handleTrmnlImage(req: IncomingMessage, res: ServerResponse): void;
+/** POST /api/log — the panel's own error report; always logged (rate-limited). */
+export declare function handleTrmnlLog(req: IncomingMessage, res: ServerResponse): void;
+/** True for any path this module owns, so the daemon router can delegate. */
+export declare function isTrmnlImagePath(pathname: string): boolean;
+//# sourceMappingURL=byos-server.d.ts.map

package/dist/trmnl/byos-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"byos-server.d.ts","sourceRoot":"","sources":["../../src/trmnl/byos-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AA+C5D,yDAAyD;AACzD,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAkGD,4EAA4E;AAC5E,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI,CA8BhF;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI,CA4ElF;AAED,qFAAqF;AACrF,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI,CAoBhF;AA0BD,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI,CA0B9E;AAED,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE1D"}

package/dist/trmnl/byos-server.js

@@ -0,0 +1,301 @@
+import { TRMNL_WIDTH, TRMNL_HEIGHT } from '@agentdeck/shared';
+import { ensureDevice, findDeviceByMac, loadTrmnlConfig, normalizeMac, effectiveRefreshRate, effectiveImageTimeout, TRMNL_WEAK_RSSI_DBM, } from './trmnl-settings.js';
+import { getTrmnlFrame, getTrmnlFrameByKey, forceRenderTrmnlFrame, getTrmnlActivity } from './frame-cache.js';
+import { recordTelemetry } from './trmnl-telemetry.js';
+import { debug, logTagged } from '../logger.js';
+const TAG = 'trmnl-byos';
+/** MACs currently flagged weak-signal — tracked so we log a transition, not every poll. */
+const weakRssiMacs = new Set();
+/**
+ * Log once when a panel's RSSI crosses into/out of the weak-link threshold. A
+ * weak/lossy WiFi link is the dominant real-world cause of the firmware's
+ * "WiFi connected / not responding" (WIFI_FAILED) screen, so this gives an
+ * operator a correlatable record — always visible (not gated behind --debug),
+ * but rate-limited to state transitions instead of spamming every poll.
+ */
+function noteRssiHealth(mac, rssi) {
+    const key = normalizeMac(mac);
+    if (!key)
+        return;
+    const isWeak = rssi != null && Number.isFinite(rssi) && rssi <= TRMNL_WEAK_RSSI_DBM;
+    const wasWeak = weakRssiMacs.has(key);
+    if (isWeak && !wasWeak) {
+        weakRssiMacs.add(key);
+        logTagged(TAG, `weak WiFi signal on ${key}: rssi=${rssi}dBm (<= ${TRMNL_WEAK_RSSI_DBM}dBm threshold) — ` +
+            `image_url_timeout widened; panel may show "not responding" if this persists`);
+    }
+    else if (!isWeak && wasWeak) {
+        weakRssiMacs.delete(key);
+        logTagged(TAG, `WiFi signal recovered on ${key}: rssi=${rssi ?? 'n/a'}dBm`);
+    }
+}
+/** Test helper — clear weak-RSSI transition tracking. */
+export function _resetWeakRssiTracking() {
+    weakRssiMacs.clear();
+}
+/**
+ * Record a poll and log when the panel comes back after missing its window.
+ * A battery e-ink panel polls on the cadence we hand it; a gap of more than
+ * 2× the slow cadence (+ grace) means at least one poll round-trip failed at
+ * the network layer — exactly the moment the firmware flashes its "TRMNL not
+ * responding" screen. Logging the gap on recovery (always visible, one line
+ * per incident) gives the operator a correlatable record of every dead window.
+ */
+function notePollGap(mac, h, cfg) {
+    const now = Date.now();
+    const prevLastSeen = recordTelemetry(mac, h, now);
+    if (prevLastSeen == null)
+        return;
+    const gapSec = Math.round((now - prevLastSeen) / 1000);
+    const expected = Math.max(cfg.refreshRate, cfg.refreshActive);
+    if (gapSec > expected * 2 + 30) {
+        logTagged(TAG, `panel ${normalizeMac(mac)} back after ${gapSec}s silence (cadence ${expected}s) — ` +
+            `it missed ≥1 poll window; likely showed "not responding" in between ` +
+            `(rssi=${h.rssi ?? 'n/a'}dBm battery=${h.batteryVoltage ?? 'n/a'}V)`);
+    }
+}
+// Sane device-reported resolution bounds; anything outside falls back to OG size.
+const MIN_DIM = 120;
+const MAX_DIM = 4000;
+function header(req, name) {
+    const v = req.headers[name.toLowerCase()];
+    return Array.isArray(v) ? (v[0] ?? '') : (v ?? '');
+}
+function toNum(v) {
+    if (!v)
+        return null;
+    const n = Number(v.trim());
+    return Number.isFinite(n) ? n : null;
+}
+/** Parse the BYOS telemetry headers a panel sends on /api/setup + /api/display. */
+function parseDeviceHeaders(req) {
+    const sane = (n) => (n != null && n >= MIN_DIM && n <= MAX_DIM ? Math.round(n) : null);
+    return {
+        mac: header(req, 'ID'),
+        accessToken: header(req, 'Access-Token'),
+        fwVersion: header(req, 'FW-Version'),
+        batteryVoltage: toNum(header(req, 'Battery-Voltage')),
+        rssi: toNum(header(req, 'RSSI')),
+        refreshRate: toNum(header(req, 'Refresh-Rate')),
+        width: sane(toNum(header(req, 'Width'))),
+        height: sane(toNum(header(req, 'Height'))),
+        userAgent: header(req, 'User-Agent'),
+    };
+}
+/** Render size for a device: its reported resolution, or the OG default. */
+function renderSize(h) {
+    return { width: h.width ?? TRMNL_WIDTH, height: h.height ?? TRMNL_HEIGHT };
+}
+/** Build the image URL, qualified by resolution so the image route serves the
+ * right-sized frame. The hash is the cache-buster the firmware re-downloads on. */
+function imageUrl(req, size, hash) {
+    return `${imageBase(req)}/trmnl/image/${size.width}x${size.height}-${hash}.png`;
+}
+function imageBase(req) {
+    // The device reached us at exactly this host:port — reuse it so the image_url
+    // is always resolvable from the device's perspective (no IP guessing).
+    return `http://${req.headers.host ?? 'localhost'}`;
+}
+function sendJson(res, status, body) {
+    const payload = JSON.stringify(body);
+    res.writeHead(status, {
+        'Content-Type': 'application/json',
+        'Cache-Control': 'no-store',
+        'Access-Control-Allow-Origin': '*',
+    });
+    res.end(payload);
+}
+/** GET /api/setup — enroll the device (by MAC) and hand back an api_key. */
+export function handleTrmnlSetup(req, res) {
+    const h = parseDeviceHeaders(req);
+    const mac = h.mac;
+    if (!mac) {
+        sendJson(res, 400, { status: 400, message: 'Missing ID (MAC) header' });
+        return;
+    }
+    const { device, created } = ensureDevice(mac);
+    if (!device) {
+        // autoRegister is off and this MAC isn't enrolled.
+        debug(TAG, `setup rejected for ${normalizeMac(mac)} (autoRegister off, not enrolled)`);
+        sendJson(res, 404, { status: 404, message: 'Device not enrolled. Add it to settings.trmnl.devices.' });
+        return;
+    }
+    notePollGap(mac, h, loadTrmnlConfig());
+    noteRssiHealth(mac, h.rssi);
+    const size = renderSize(h);
+    if (created) {
+        debug(TAG, `enrolled TRMNL ${device.mac} as ${device.friendlyId} (${size.width}x${size.height})`);
+        forceRenderTrmnlFrame(size.width, size.height); // first served image reflects live state
+    }
+    const frame = getTrmnlFrame(size.width, size.height);
+    sendJson(res, 200, {
+        status: 200,
+        api_key: device.apiKey,
+        friendly_id: device.friendlyId,
+        image_url: imageUrl(req, size, frame.contentHash),
+        filename: frame.contentHash,
+        message: 'Welcome to AgentDeck',
+    });
+}
+/**
+ * GET /api/display — return the next image + polling cadence.
+ *
+ * NOTE: we always reply with HTTP 200; the BYOS `status` field carries the real
+ * signal (0 = show image, 202 = call /api/setup). Stock firmware treats a non-200
+ * HTTP status as an error and goes back to sleep without rendering, so HTTP 200 is
+ * required even in the "needs setup" case.
+ */
+export function handleTrmnlDisplay(req, res) {
+    const h = parseDeviceHeaders(req);
+    const mac = h.mac;
+    const cfg = loadTrmnlConfig();
+    const size = renderSize(h);
+    if (mac) {
+        notePollGap(mac, h, cfg);
+        noteRssiHealth(mac, h.rssi);
+    }
+    let device = mac ? findDeviceByMac(mac) : undefined;
+    if (!device) {
+        // Real devices often carry an api_key from a prior (cloud) setup and never
+        // call /api/setup again — they poll /api/display straight away. If we answer
+        // "not registered" (status 202) they just sleep/retry forever and never show
+        // a screen. So auto-enroll on first poll (when autoRegister is on) and serve
+        // a real dashboard (status 0). Only fall back to 202 when autoRegister is off.
+        if (mac && cfg.autoRegister) {
+            const r = ensureDevice(mac);
+            device = r.device;
+            if (r.created) {
+                debug(TAG, `auto-enrolled ${normalizeMac(mac)} on display poll (${size.width}x${size.height})`);
+                forceRenderTrmnlFrame(size.width, size.height);
+            }
+        }
+        if (!device) {
+            // autoRegister off and unenrolled: serve a real, correctly-sized frame (the
+            // idle hero / dashboard) rather than a bogus `setup.png` the image route
+            // can't match. status 202 still tells the firmware "not fully set up".
+            const setupFrame = getTrmnlFrame(size.width, size.height);
+            debug(TAG, `display from unenrolled ${normalizeMac(mac)} (autoRegister off) — requesting setup`);
+            sendJson(res, 200, {
+                status: 202,
+                image_url: imageUrl(req, size, setupFrame.contentHash),
+                filename: setupFrame.contentHash,
+                refresh_rate: cfg.refreshRate,
+                image_url_timeout: effectiveImageTimeout(cfg, { rssi: h.rssi }),
+                special_function: 'sleep',
+                reset_firmware: false,
+                update_firmware: false,
+                firmware_url: null,
+            });
+            return;
+        }
+    }
+    // Soft auth only: the MAC (ID header) identifies the device. The api_key it
+    // presents may have been issued by a previous/cloud server, so we don't
+    // hard-reject on mismatch — this is same-LAN hardware.
+    const frame = getTrmnlFrame(size.width, size.height);
+    // Adaptive cadence: poll fast while an agent is AWAITING/WORKING, slow when idle.
+    const activity = getTrmnlActivity();
+    const refreshRate = effectiveRefreshRate(cfg, activity);
+    // Widen the image-download window on a weak link so a lossy GET still finishes
+    // before the firmware shows "not responding" (WIFI_FAILED).
+    const imageTimeout = effectiveImageTimeout(cfg, { rssi: h.rssi });
+    debug(TAG, `display ${normalizeMac(mac)} ${size.width}x${size.height} hash=${frame.contentHash} ` +
+        `refresh=${refreshRate}s imageTimeout=${imageTimeout}s rssi=${h.rssi ?? 'n/a'} ` +
+        `awaiting=${activity.awaiting} working=${activity.working}`);
+    sendJson(res, 200, {
+        status: 0,
+        image_url: imageUrl(req, size, frame.contentHash),
+        filename: frame.contentHash,
+        // Number (matches the reference BYOS + firmware's uint parse), not a string.
+        refresh_rate: refreshRate,
+        // Generous, link-aware image-download window so a flaky WiFi link doesn't trip
+        // the firmware's "not responding" screen.
+        image_url_timeout: imageTimeout,
+        special_function: 'sleep',
+        reset_firmware: false,
+        update_firmware: false,
+        firmware_url: null,
+    });
+}
+/** GET /trmnl/image/<W>x<H>-<hash>.png — serve the 1-bit PNG for that resolution. */
+export function handleTrmnlImage(req, res) {
+    // The URL carries the resolution (and a cache-busting hash) so we serve the
+    // right-sized frame. We ignore the hash itself — the device always wants the
+    // freshest screen for its resolution. Unknown/legacy URLs fall back to the
+    // default-size frame.
+    const pathname = (req.url || '').split('?')[0];
+    const m = /\/trmnl\/image\/(\d+)x(\d+)-[0-9a-f]+\.png$/.exec(pathname);
+    let frame;
+    if (m) {
+        const key = `${m[1]}x${m[2]}`;
+        frame = getTrmnlFrameByKey(key) ?? getTrmnlFrame(Number(m[1]), Number(m[2]));
+    }
+    if (!frame)
+        frame = getTrmnlFrame();
+    res.writeHead(200, {
+        'Content-Type': frame.contentType,
+        'Content-Length': frame.buffer.length,
+        'Cache-Control': 'no-store',
+        'Access-Control-Allow-Origin': '*',
+    });
+    res.end(frame.buffer);
+}
+// Device-log throttle: the firmware only POSTs /api/log when something went
+// wrong on its side (failed poll, image timeout, low battery), so these lines
+// ARE the root-cause record for "not responding" incidents. Always log them,
+// but cap the rate per panel so a wedged device can't flood stderr.
+const DEVICE_LOG_INTERVAL_MS = 10_000;
+const lastDeviceLogAt = new Map();
+/** Compress the firmware's log JSON into one greppable line (best effort). */
+function summarizeDeviceLog(body) {
+    try {
+        const parsed = JSON.parse(body);
+        const arr = parsed?.log?.logs_array ?? parsed?.logs?.logs_array ?? parsed?.logs_array;
+        if (Array.isArray(arr) && arr.length > 0) {
+            return arr
+                .map((e) => `[${e?.log_codeline ?? e?.log_sourcefile ?? '?'}] ${e?.log_message ?? JSON.stringify(e)}`)
+                .join(' | ')
+                .slice(0, 600);
+        }
+    }
+    catch {
+        /* not JSON — fall through to raw */
+    }
+    return body.replace(/\s+/g, ' ').slice(0, 600);
+}
+/** POST /api/log — the panel's own error report; always logged (rate-limited). */
+export function handleTrmnlLog(req, res) {
+    let body = '';
+    req.on('data', (c) => {
+        body += c;
+        if (body.length > 64_000)
+            req.destroy();
+    });
+    req.on('end', () => {
+        const mac = normalizeMac(header(req, 'ID'));
+        const now = Date.now();
+        if (now - (lastDeviceLogAt.get(mac) ?? 0) >= DEVICE_LOG_INTERVAL_MS) {
+            lastDeviceLogAt.set(mac, now);
+            logTagged(TAG, `device log from ${mac}: ${summarizeDeviceLog(body)}`);
+        }
+        else {
+            debug(TAG, `device log from ${mac} (throttled): ${body.slice(0, 500)}`);
+        }
+        res.writeHead(204, { 'Access-Control-Allow-Origin': '*' });
+        res.end();
+    });
+    req.on('error', () => {
+        try {
+            res.writeHead(204);
+            res.end();
+        }
+        catch {
+            /* ignore */
+        }
+    });
+}
+/** True for any path this module owns, so the daemon router can delegate. */
+export function isTrmnlImagePath(pathname) {
+    return pathname.startsWith('/trmnl/image/');
+}
+//# sourceMappingURL=byos-server.js.map