@agentdeck/bridge 1.0.1 → 1.0.3

package/dist/trmnl/byos-server.js

@@ -1,301 +0,0 @@
-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

package/dist/trmnl/byos-server.js.map

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

package/dist/trmnl/frame-cache.d.ts

@@ -1,37 +0,0 @@
-/**
- * TRMNL frame cache — the rendered 1-bit PNG dashboards the BYOS HTTP routes
- * serve. The device module keeps them fresh by re-rendering on state change; the
- * daemon's /api/display + /trmnl/image routes read them. Unlike push devices
- * (Pixoo/D200H), TRMNL pulls on its own schedule, so we only hold the latest
- * frame per resolution and let each device fetch it when it polls.
- *
- * Frames are keyed by `"<W>x<H>"` rather than a single global frame: different
- * BYOS panels report different resolutions, and each must get a correctly-sized
- * image. The map is bounded (typically one resolution is in use) to cap memory.
- */
-import { type TrmnlFrame } from './image-renderer.js';
-/** Visual-state fingerprint (excludes the wall clock so it doesn't churn). */
-export declare function trmnlStateHash(evt: any): string;
-/** AWAITING/WORKING counts from the last known state — drives adaptive cadence. */
-export declare function getTrmnlActivity(): {
-    awaiting: number;
-    working: number;
-};
-/** Store the latest broadcast state for lazy rendering, without rendering now. */
-export declare function setTrmnlState(evt: any): void;
-/**
- * Re-render every cached resolution whose visual state changed. Returns true if
- * any new frame was produced. Called by the device module on each broadcast. If
- * no device has polled yet, primes the default resolution so a first poll is
- * instant.
- */
-export declare function refreshTrmnlFrame(evt: any): boolean;
-/** Force a render from the last known state for a resolution (e.g. after setup). */
-export declare function forceRenderTrmnlFrame(width?: number, height?: number): TrmnlFrame;
-/** Frame for a resolution, lazily rendered from the last known state if absent. */
-export declare function getTrmnlFrame(width?: number, height?: number): TrmnlFrame;
-/** Frame for an exact `"<W>x<H>"` key, or undefined if not cached. */
-export declare function getTrmnlFrameByKey(key: string): TrmnlFrame | undefined;
-/** Active resolution keys currently held in the cache. */
-export declare function getTrmnlFrameKeys(): string[];
-//# sourceMappingURL=frame-cache.d.ts.map

package/dist/trmnl/frame-cache.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"frame-cache.d.ts","sourceRoot":"","sources":["../../src/trmnl/frame-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAsCxE,8EAA8E;AAC9E,wBAAgB,cAAc,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CA+B/C;AAED,mFAAmF;AACnF,wBAAgB,gBAAgB,IAAI;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAUxE;AAED,kFAAkF;AAClF,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAE5C;AAuBD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAcnD;AAED,oFAAoF;AACpF,wBAAgB,qBAAqB,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU,CAEjF;AAED,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU,CAGzE;AAED,sEAAsE;AACtE,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAEtE;AAED,0DAA0D;AAC1D,wBAAgB,iBAAiB,IAAI,MAAM,EAAE,CAE5C"}

package/dist/trmnl/frame-cache.js

@@ -1,157 +0,0 @@
-/**
- * TRMNL frame cache — the rendered 1-bit PNG dashboards the BYOS HTTP routes
- * serve. The device module keeps them fresh by re-rendering on state change; the
- * daemon's /api/display + /trmnl/image routes read them. Unlike push devices
- * (Pixoo/D200H), TRMNL pulls on its own schedule, so we only hold the latest
- * frame per resolution and let each device fetch it when it polls.
- *
- * Frames are keyed by `"<W>x<H>"` rather than a single global frame: different
- * BYOS panels report different resolutions, and each must get a correctly-sized
- * image. The map is bounded (typically one resolution is in use) to cap memory.
- */
-import { renderTrmnlFrame } from './image-renderer.js';
-import { TRMNL_WIDTH, TRMNL_HEIGHT } from '@agentdeck/shared';
-const DEFAULT_KEY = `${TRMNL_WIDTH}x${TRMNL_HEIGHT}`;
-/** Bound on distinct resolutions held at once (insertion-order LRU eviction). */
-const MAX_FRAMES = 8;
-/** Resolution-keyed cache. Insertion order doubles as LRU recency. */
-const frames = new Map();
-const lastHashByKey = new Map();
-let lastStateEvt = {
-    state: 'IDLE',
-    projectName: '',
-    modelName: '',
-    mode: 'default',
-    agentType: 'daemon',
-    fiveHourPercent: 0,
-    sevenDayPercent: 0,
-    totalTokens: 0,
-    totalCost: 0,
-    options: [],
-    currentTool: '',
-    allSessions: [],
-};
-function sizeKey(width, height) {
-    const w = width && width > 0 ? Math.round(width) : TRMNL_WIDTH;
-    const h = height && height > 0 ? Math.round(height) : TRMNL_HEIGHT;
-    return `${w}x${h}`;
-}
-function parseKey(key) {
-    const m = /^(\d+)x(\d+)$/.exec(key);
-    if (!m)
-        return { width: TRMNL_WIDTH, height: TRMNL_HEIGHT };
-    return { width: Number(m[1]), height: Number(m[2]) };
-}
-/** Visual-state fingerprint (excludes the wall clock so it doesn't churn). */
-export function trmnlStateHash(evt) {
-    const sessions = Array.isArray(evt?.allSessions) ? evt.allSessions : [];
-    const sessKey = sessions
-        .map((s) => `${s?.id}:${s?.agentType}:${s?.state}:${s?.projectName}:${s?.modelName}:${s?.goal ?? ''}`)
-        .join('|');
-    // No wall-clock / freshness component: a real TRMNL caches by `filename` and
-    // skips the (battery + flaky-WiFi) re-download when it's unchanged. So the hash
-    // must change ONLY on real visual change — never churn it for a ticking clock.
-    return [
-        evt?.state,
-        evt?.projectName,
-        evt?.modelName,
-        evt?.usageKnown ? Math.round(evt?.fiveHourPercent ?? 0) : 'na',
-        evt?.usageKnown ? Math.round(evt?.sevenDayPercent ?? 0) : 'na',
-        // Reset windows roll over rarely — include them so a rollover re-renders the
-        // countdown, but they don't churn minute-to-minute.
-        evt?.fiveHourResetsAt ?? '',
-        evt?.sevenDayResetsAt ?? '',
-        // Codex (ChatGPT) rolling windows render a second footer row — fold them in
-        // so a Codex-only usage change still re-renders the panel (otherwise the
-        // Claude-only hash above would mask it and the TRMNL would skip the redraw).
-        evt?.codexRateLimits?.primary?.usedPercent != null
-            ? Math.round(evt.codexRateLimits.primary.usedPercent)
-            : 'na',
-        evt?.codexRateLimits?.secondary?.usedPercent != null
-            ? Math.round(evt.codexRateLimits.secondary.usedPercent)
-            : 'na',
-        evt?.codexRateLimits?.primary?.resetsAt ?? '',
-        evt?.codexRateLimits?.secondary?.resetsAt ?? '',
-        sessKey,
-    ].join('~');
-}
-/** AWAITING/WORKING counts from the last known state — drives adaptive cadence. */
-export function getTrmnlActivity() {
-    const sessions = Array.isArray(lastStateEvt?.allSessions) ? lastStateEvt.allSessions : [];
-    let awaiting = 0;
-    let working = 0;
-    for (const s of sessions) {
-        const st = String(s?.state ?? '').toLowerCase();
-        if (st.startsWith('awaiting'))
-            awaiting++;
-        else if (st === 'processing')
-            working++;
-    }
-    return { awaiting, working };
-}
-/** Store the latest broadcast state for lazy rendering, without rendering now. */
-export function setTrmnlState(evt) {
-    lastStateEvt = evt;
-}
-/** Render (and cache) the current state for one resolution key, with LRU eviction. */
-function renderForKey(key) {
-    const { width, height } = parseKey(key);
-    let frame = renderTrmnlFrame(lastStateEvt, undefined, { width, height });
-    // A degraded frame is a blank fallback (render threw). Keep serving the last
-    // good frame for this resolution — a stale dashboard beats an empty panel.
-    // The state hash still advances so we retry on the next real state change.
-    const prev = frames.get(key);
-    if (frame.degraded && prev && !prev.degraded)
-        frame = prev;
-    frames.delete(key); // re-insert to mark most-recently-used
-    frames.set(key, frame);
-    lastHashByKey.set(key, trmnlStateHash(lastStateEvt));
-    while (frames.size > MAX_FRAMES) {
-        const oldest = frames.keys().next().value;
-        if (oldest === undefined)
-            break;
-        frames.delete(oldest);
-        lastHashByKey.delete(oldest);
-    }
-    return frame;
-}
-/**
- * Re-render every cached resolution whose visual state changed. Returns true if
- * any new frame was produced. Called by the device module on each broadcast. If
- * no device has polled yet, primes the default resolution so a first poll is
- * instant.
- */
-export function refreshTrmnlFrame(evt) {
-    lastStateEvt = evt;
-    const hash = trmnlStateHash(evt);
-    if (frames.size === 0) {
-        renderForKey(DEFAULT_KEY);
-        return true;
-    }
-    let rendered = false;
-    for (const key of [...frames.keys()]) {
-        if (lastHashByKey.get(key) === hash)
-            continue;
-        renderForKey(key);
-        rendered = true;
-    }
-    return rendered;
-}
-/** Force a render from the last known state for a resolution (e.g. after setup). */
-export function forceRenderTrmnlFrame(width, height) {
-    return renderForKey(sizeKey(width, height));
-}
-/** Frame for a resolution, lazily rendered from the last known state if absent. */
-export function getTrmnlFrame(width, height) {
-    const key = sizeKey(width, height);
-    return frames.get(key) ?? renderForKey(key);
-}
-/** Frame for an exact `"<W>x<H>"` key, or undefined if not cached. */
-export function getTrmnlFrameByKey(key) {
-    return frames.get(key);
-}
-/** Active resolution keys currently held in the cache. */
-export function getTrmnlFrameKeys() {
-    return [...frames.keys()];
-}
-//# sourceMappingURL=frame-cache.js.map

package/dist/trmnl/frame-cache.js.map

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

package/dist/trmnl/image-renderer.d.ts

@@ -1,27 +0,0 @@
-/** Initialize the renderer (loads resvg-js if available). Call once at start. */
-export declare function initTrmnlRenderer(): Promise<void>;
-export declare function isTrmnlResvgLoaded(): boolean;
-export interface TrmnlFrame {
-    buffer: Buffer;
-    /** Short stable hash of the image bytes — used as the BYOS `filename`. */
-    contentHash: string;
-    width: number;
-    height: number;
-    contentType: 'image/png';
-    /**
-     * True when this frame is a blank fallback (render threw or resvg missing),
-     * NOT a real dashboard. The frame cache uses this to keep serving the last
-     * good frame instead of flashing the panel to an empty white screen.
-     */
-    degraded?: boolean;
-}
-/**
- * Render the AgentDeck dashboard for the given broadcast state into a 1-bit PNG.
- * Accepts a raw state event or a pre-parsed DashState (passed through to the
- * shared layout). `now` may be supplied for deterministic tests.
- */
-export declare function renderTrmnlFrame(stateEvt: any, now?: Date, size?: {
-    width: number;
-    height: number;
-}): TrmnlFrame;
-//# sourceMappingURL=image-renderer.d.ts.map

package/dist/trmnl/image-renderer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"image-renderer.d.ts","sourceRoot":"","sources":["../../src/trmnl/image-renderer.ts"],"names":[],"mappings":"AA8EA,iFAAiF;AACjF,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAEvD;AAED,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C;AA4GD,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,WAAW,CAAC;IACzB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAMD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,GAAG,EACb,GAAG,CAAC,EAAE,IAAI,EACV,IAAI,CAAC,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACvC,UAAU,CAwCZ"}