@agentdeck/bridge 0.1.0 → 0.2.1

package/dist/pixoo/pixoo-client.js

@@ -0,0 +1,335 @@
+/**
+ * Pixoo64 HTTP Client — direct REST API for Divoom Pixoo64 LED matrix.
+ *
+ * Zero dependencies: uses Node 18+ native fetch().
+ * All requests have 2s timeout and fail silently (display is non-critical).
+ *
+ * Frame format: 64×64 RGB = 12,288 bytes → base64 encoded.
+ *
+ * CRITICAL: PicID must be strictly incrementing — device silently ignores
+ * frames with non-sequential IDs (returns error_code:0 but doesn't update display).
+ * GetHttpGifId syncs counter; ResetHttpGifId resets to 0 (use sparingly — may crash firmware).
+ */
+import http from 'node:http';
+import { debug } from '../logger.js';
+// Pixoo's embedded HTTP server can't handle keep-alive connections properly
+// (Node 19+ defaults to keepAlive:true). Force fresh TCP per request.
+const pixooAgent = new http.Agent({ keepAlive: false, maxSockets: 1 });
+const TAG = 'Pixoo';
+const REQUEST_TIMEOUT_MS = 2000;
+const PIC_ID_RESYNC_THRESHOLD = 250; // Re-sync before ~300 overflow
+// Per-device static PicID — synced once and held forever (allows real-time streaming without loading screen)
+const devicePicId = new Map();
+/** Clear cached static PicID for a device (call when device reboots to re-sync). */
+export function clearStaticPicId(ip) {
+    devicePicId.delete(ip);
+    debug(TAG, `Static PicID cleared for ${ip} — will re-sync on next push`);
+}
+// Gamma correction LUT: pow(v/255, 0.7) * 255 — boosts dark values for LED display
+const gammaLUT = new Uint8Array(256);
+for (let i = 0; i < 256; i++) {
+    gammaLUT[i] = Math.round(Math.pow(i / 255, 0.7) * 255);
+}
+// ===== Circuit Breaker (per-device exponential backoff + auto-probe) =====
+const deviceBackoff = new Map();
+const BACKOFF_THRESHOLD = 6; // failures before backing off (ESP32 has transient drops)
+const BACKOFF_INITIAL_MS = 5_000; // 5s initial backoff (quick recovery)
+const BACKOFF_MAX_MS = 60_000; // 1m max cap
+const PROBE_INTERVAL_MS = 5_000; // Probe every 5s during backoff
+let probeTimer = null;
+let statusCallback = null;
+/** Register a callback for device online/offline transitions. */
+export function onDeviceStatusChange(cb) {
+    statusCallback = cb;
+}
+function isBackedOff(ip) {
+    const entry = deviceBackoff.get(ip);
+    if (!entry || entry.failures < BACKOFF_THRESHOLD)
+        return false;
+    return Date.now() < entry.backoffUntil;
+}
+function recordSuccess(ip) {
+    const wasBackedOff = isBackedOff(ip);
+    deviceBackoff.delete(ip);
+    if (wasBackedOff) {
+        debug(TAG, `Device ${ip} recovered — backoff cleared, re-syncing PicID`);
+        clearStaticPicId(ip); // Device may have rebooted — force fresh PicID sync
+        statusCallback?.(ip, true);
+        updateProbeTimer();
+    }
+}
+function recordFailure(ip) {
+    const wasBackedOff = isBackedOff(ip);
+    const entry = deviceBackoff.get(ip) ?? { failures: 0, backoffUntil: 0 };
+    entry.failures++;
+    if (entry.failures >= BACKOFF_THRESHOLD) {
+        const delay = Math.min(BACKOFF_INITIAL_MS * Math.pow(2, entry.failures - BACKOFF_THRESHOLD), BACKOFF_MAX_MS);
+        entry.backoffUntil = Date.now() + delay;
+        debug(TAG, `Backoff ${ip}: ${Math.round(delay / 1000)}s (${entry.failures} failures)`);
+        if (!wasBackedOff) {
+            statusCallback?.(ip, false);
+            updateProbeTimer();
+        }
+    }
+    deviceBackoff.set(ip, entry);
+}
+/** Start/stop the probe timer based on whether any device is backed off. */
+function updateProbeTimer() {
+    const anyBackedOff = [...deviceBackoff.values()].some(e => e.failures >= BACKOFF_THRESHOLD && Date.now() < e.backoffUntil);
+    if (anyBackedOff && !probeTimer) {
+        probeTimer = setInterval(probeBackedOffDevices, PROBE_INTERVAL_MS);
+        debug(TAG, 'Probe timer started (30s interval)');
+    }
+    else if (!anyBackedOff && probeTimer) {
+        clearInterval(probeTimer);
+        probeTimer = null;
+        debug(TAG, 'Probe timer stopped — all devices online');
+    }
+}
+/** Probe backed-off devices to detect recovery. */
+async function probeBackedOffDevices() {
+    const ipsToProbe = [...deviceBackoff.entries()]
+        .filter(([, e]) => e.failures >= BACKOFF_THRESHOLD)
+        .map(([ip]) => ip);
+    for (const ip of ipsToProbe) {
+        debug(TAG, `Probing backed-off device ${ip}...`);
+        const config = await getDeviceConfig(ip);
+        if (config) {
+            debug(TAG, `Probe success for ${ip} — restoring connection`);
+            recordSuccess(ip);
+            // Re-initialize: switch to custom channel
+            switchToCustomChannel(ip).catch(() => { });
+        }
+    }
+}
+/** Clean up probe timer. Call on shutdown. */
+export function stopProbeTimer() {
+    if (probeTimer) {
+        clearInterval(probeTimer);
+        probeTimer = null;
+    }
+}
+/**
+ * Wake recovery — clear all PicID caches and circuit breaker state.
+ * Devices may have rebooted during sleep, so all cached state is stale.
+ */
+export function handlePixooWake() {
+    debug(TAG, `Wake recovery — clearing ${devicePicId.size} PicID(s) and ${deviceBackoff.size} backoff(s)`);
+    for (const ip of devicePicId.keys()) {
+        clearStaticPicId(ip);
+    }
+    deviceBackoff.clear();
+    if (probeTimer) {
+        clearInterval(probeTimer);
+        probeTimer = null;
+    }
+}
+/** Get circuit breaker status for a device. */
+export function getDeviceBackoffStatus(ip) {
+    const entry = deviceBackoff.get(ip);
+    if (!entry)
+        return { failures: 0, backedOff: false, nextProbeMs: 0 };
+    const now = Date.now();
+    const backedOff = entry.failures >= BACKOFF_THRESHOLD && now < entry.backoffUntil;
+    return {
+        failures: entry.failures,
+        backedOff,
+        nextProbeMs: backedOff ? entry.backoffUntil - now : 0,
+    };
+}
+/**
+ * POST a command to the Pixoo device using node:http (not fetch).
+ * Pixoo's embedded HTTP server can't handle keep-alive connections —
+ * Node 19+ fetch uses keepAlive:true by default, causing timeouts after 2-3 requests.
+ */
+async function postCommand(ip, command) {
+    if (isBackedOff(ip))
+        return false;
+    try {
+        const result = await httpPost(ip, command);
+        if (!result) {
+            recordFailure(ip);
+            return false;
+        }
+        recordSuccess(ip);
+        return true;
+    }
+    catch (err) {
+        debug(TAG, `Request failed to ${ip}: ${err.message}`);
+        recordFailure(ip);
+        return false;
+    }
+}
+/** Low-level HTTP POST with keepAlive:false agent. */
+function httpPost(ip, body) {
+    return new Promise((resolve, reject) => {
+        const data = JSON.stringify(body);
+        const req = http.request({
+            hostname: ip,
+            port: 80,
+            path: '/post',
+            method: 'POST',
+            agent: pixooAgent,
+            headers: {
+                'Content-Type': 'application/json',
+                'Content-Length': Buffer.byteLength(data),
+            },
+            timeout: REQUEST_TIMEOUT_MS,
+        }, res => {
+            const chunks = [];
+            res.on('data', (c) => chunks.push(c));
+            res.on('end', () => {
+                if (res.statusCode && res.statusCode >= 400) {
+                    debug(TAG, `HTTP ${res.statusCode} from ${ip}`);
+                    resolve(null);
+                    return;
+                }
+                try {
+                    resolve(JSON.parse(Buffer.concat(chunks).toString()));
+                }
+                catch {
+                    resolve({});
+                }
+            });
+        });
+        req.on('error', reject);
+        req.on('timeout', () => { req.destroy(); reject(new Error('timeout')); });
+        req.end(data);
+    });
+}
+/**
+ * Push a single 64×64 RGB frame to the device.
+ * PicID increments per frame so the device renders each new image.
+ * @param buffer - 12,288 bytes (64 * 64 * 3) raw RGB
+ */
+export async function pushFrame(ip, buffer) {
+    if (buffer.length !== 64 * 64 * 3) {
+        debug(TAG, `Invalid frame size: ${buffer.length} (expected 12288)`);
+        return false;
+    }
+    // Get or initialize PicID for this device
+    let picId = devicePicId.get(ip);
+    if (picId === undefined) {
+        // First push — sync with device's current counter + 1 to ensure freshness
+        picId = await getHttpGifId(ip);
+        debug(TAG, `Synced PicID for ${ip}: ${picId}`);
+    }
+    // Increment PicID per frame (device renders new image only on new sequential ID)
+    picId++;
+    // Prevent counter overflow (~300 causes device lockup) — reset gracefully
+    if (picId >= PIC_ID_RESYNC_THRESHOLD) {
+        debug(TAG, `PicID ${picId} near overflow for ${ip}, resetting`);
+        await resetPicId(ip);
+        picId = 1;
+    }
+    devicePicId.set(ip, picId);
+    // Apply gamma boost for LED display
+    const boosted = new Uint8Array(buffer.length);
+    for (let i = 0; i < buffer.length; i++) {
+        boosted[i] = gammaLUT[buffer[i]];
+    }
+    const base64 = Buffer.from(boosted).toString('base64');
+    return postCommand(ip, {
+        Command: 'Draw/SendHttpGif',
+        PicNum: 1, // Always 1 (single image, bypasses loading screen)
+        PicWidth: 64,
+        PicOffset: 0,
+        PicID: picId, // INCREMENTS each push so device renders every frame
+        PicSpeed: 1000,
+        PicData: base64,
+    });
+}
+/**
+ * Send scrolling text overlay (device-native font, supports long text).
+ * Up to 20 simultaneous text items supported by device.
+ * @param textId - 0-19, used to update/remove specific text
+ * @param color - hex color string e.g. "#22c55e"
+ * @param speed - scroll speed 0-100 (default 50)
+ */
+export async function sendScrollText(ip, textId, text, color, speed = 50) {
+    const r = parseInt(color.slice(1, 3), 16);
+    const g = parseInt(color.slice(3, 5), 16);
+    const b = parseInt(color.slice(5, 7), 16);
+    return postCommand(ip, {
+        Command: 'Draw/SendHttpText',
+        TextId: textId,
+        x: 0,
+        y: 0,
+        dir: 0, // 0=left scroll
+        font: 2, // small built-in font
+        TextWidth: 64,
+        speed,
+        TextString: text,
+        color: `#${color.slice(1)}`,
+        align: 1,
+    });
+}
+/** Clear all text overlays. */
+export async function clearText(ip) {
+    return postCommand(ip, { Command: 'Draw/ClearHttpText' });
+}
+/** Set display brightness (0-100). */
+export async function setBrightness(ip, value) {
+    return postCommand(ip, {
+        Command: 'Channel/SetBrightness',
+        Brightness: Math.max(0, Math.min(100, value)),
+    });
+}
+/** Query the device's current PicID counter. Returns 0 on failure. */
+export async function getHttpGifId(ip) {
+    try {
+        const data = await httpPost(ip, { Command: 'Draw/GetHttpGifId' });
+        return data?.PicId ?? 0;
+    }
+    catch {
+        return 0;
+    }
+}
+/** Reset the PicID counter to prevent device lockup. */
+export async function resetPicId(ip) {
+    return postCommand(ip, { Command: 'Draw/ResetHttpGifId' });
+}
+/** Switch device to the custom channel that shows SendHttpGif content. */
+export async function switchToCustomChannel(ip) {
+    // SelectIndex: 0=Faces, 1=Cloud, 2=Visualizer, 3=Custom
+    return postCommand(ip, { Command: 'Channel/SetIndex', SelectIndex: 3 });
+}
+/**
+ * Get device configuration (also serves as a connectivity test).
+ * Returns null on failure.
+ */
+export async function getDeviceConfig(ip) {
+    try {
+        return await httpPost(ip, { Command: 'Channel/GetAllConf' });
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Discover Pixoo devices via Divoom cloud API.
+ * Falls back gracefully if cloud is unreachable.
+ */
+export async function discoverDevices() {
+    try {
+        const response = await fetch('https://app.divoom-gz.com/Device/ReturnSameLANDevice', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({}),
+            signal: AbortSignal.timeout(3000),
+        });
+        if (!response.ok)
+            return [];
+        const data = await response.json();
+        if (!data?.DeviceList)
+            return [];
+        return data.DeviceList.map((d) => ({
+            name: d.DeviceName || 'Pixoo',
+            ip: d.DevicePrivateIP,
+        }));
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=pixoo-client.js.map

package/dist/pixoo/pixoo-client.js.map

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

package/dist/pixoo/pixoo-font.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Pixoo64 Bitmap Font — 3×5 pixel font for 64×64 LED matrix.
+ *
+ * Supports ASCII uppercase A-Z, digits 0-9, and basic symbols.
+ * At 3px + 1px gap per character, a 64px line fits ~16 characters.
+ */
+/**
+ * Draw text onto a 64×64 RGB buffer.
+ * @param buf - 12,288 byte RGB buffer (mutated in place)
+ * @param x - starting X pixel
+ * @param y - starting Y pixel
+ * @param text - string to draw (auto-uppercased, unknown chars → space)
+ * @param color - hex color "#RRGGBB"
+ */
+export declare function drawText(buf: Uint8Array, x: number, y: number, text: string, color: string): void;
+/**
+ * Measure text width in pixels.
+ */
+export declare function measureText(text: string): number;
+/**
+ * Draw text centered horizontally on the 64px canvas.
+ */
+export declare function drawTextCentered(buf: Uint8Array, y: number, text: string, color: string): void;
+//# sourceMappingURL=pixoo-font.d.ts.map

package/dist/pixoo/pixoo-font.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pixoo-font.d.ts","sourceRoot":"","sources":["../../src/pixoo/pixoo-font.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAmEH;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CACtB,GAAG,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GACjE,IAAI,CA2BN;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGhD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GACtD,IAAI,CAIN"}

package/dist/pixoo/pixoo-font.js

@@ -0,0 +1,121 @@
+/**
+ * Pixoo64 Bitmap Font — 3×5 pixel font for 64×64 LED matrix.
+ *
+ * Supports ASCII uppercase A-Z, digits 0-9, and basic symbols.
+ * At 3px + 1px gap per character, a 64px line fits ~16 characters.
+ */
+// 3×5 bitmap font data. Each glyph is 5 rows of 3 bits (MSB left).
+// Format: [row0, row1, row2, row3, row4] where each row is 0b___ (3 bits)
+const GLYPHS = {
+    'A': [0b010, 0b101, 0b111, 0b101, 0b101],
+    'B': [0b110, 0b101, 0b110, 0b101, 0b110],
+    'C': [0b011, 0b100, 0b100, 0b100, 0b011],
+    'D': [0b110, 0b101, 0b101, 0b101, 0b110],
+    'E': [0b111, 0b100, 0b110, 0b100, 0b111],
+    'F': [0b111, 0b100, 0b110, 0b100, 0b100],
+    'G': [0b011, 0b100, 0b101, 0b101, 0b011],
+    'H': [0b101, 0b101, 0b111, 0b101, 0b101],
+    'I': [0b111, 0b010, 0b010, 0b010, 0b111],
+    'J': [0b001, 0b001, 0b001, 0b101, 0b010],
+    'K': [0b101, 0b110, 0b100, 0b110, 0b101],
+    'L': [0b100, 0b100, 0b100, 0b100, 0b111],
+    'M': [0b101, 0b111, 0b111, 0b101, 0b101],
+    'N': [0b101, 0b111, 0b111, 0b101, 0b101],
+    'O': [0b010, 0b101, 0b101, 0b101, 0b010],
+    'P': [0b110, 0b101, 0b110, 0b100, 0b100],
+    'Q': [0b010, 0b101, 0b101, 0b110, 0b011],
+    'R': [0b110, 0b101, 0b110, 0b101, 0b101],
+    'S': [0b011, 0b100, 0b010, 0b001, 0b110],
+    'T': [0b111, 0b010, 0b010, 0b010, 0b010],
+    'U': [0b101, 0b101, 0b101, 0b101, 0b010],
+    'V': [0b101, 0b101, 0b101, 0b010, 0b010],
+    'W': [0b101, 0b101, 0b111, 0b111, 0b101],
+    'X': [0b101, 0b101, 0b010, 0b101, 0b101],
+    'Y': [0b101, 0b101, 0b010, 0b010, 0b010],
+    'Z': [0b111, 0b001, 0b010, 0b100, 0b111],
+    '0': [0b010, 0b101, 0b101, 0b101, 0b010],
+    '1': [0b010, 0b110, 0b010, 0b010, 0b111],
+    '2': [0b110, 0b001, 0b010, 0b100, 0b111],
+    '3': [0b110, 0b001, 0b010, 0b001, 0b110],
+    '4': [0b101, 0b101, 0b111, 0b001, 0b001],
+    '5': [0b111, 0b100, 0b110, 0b001, 0b110],
+    '6': [0b011, 0b100, 0b110, 0b101, 0b010],
+    '7': [0b111, 0b001, 0b010, 0b010, 0b010],
+    '8': [0b010, 0b101, 0b010, 0b101, 0b010],
+    '9': [0b010, 0b101, 0b011, 0b001, 0b110],
+    '.': [0b000, 0b000, 0b000, 0b000, 0b010],
+    ':': [0b000, 0b010, 0b000, 0b010, 0b000],
+    '%': [0b101, 0b001, 0b010, 0b100, 0b101],
+    '/': [0b001, 0b001, 0b010, 0b100, 0b100],
+    '-': [0b000, 0b000, 0b111, 0b000, 0b000],
+    '+': [0b000, 0b010, 0b111, 0b010, 0b000],
+    '$': [0b011, 0b110, 0b010, 0b011, 0b110],
+    '!': [0b010, 0b010, 0b010, 0b000, 0b010],
+    '?': [0b110, 0b001, 0b010, 0b000, 0b010],
+    ' ': [0b000, 0b000, 0b000, 0b000, 0b000],
+    '_': [0b000, 0b000, 0b000, 0b000, 0b111],
+    '(': [0b010, 0b100, 0b100, 0b100, 0b010],
+    ')': [0b010, 0b001, 0b001, 0b001, 0b010],
+    '>': [0b100, 0b010, 0b001, 0b010, 0b100],
+    '<': [0b001, 0b010, 0b100, 0b010, 0b001],
+};
+/** Parse "#RRGGBB" hex color to [r, g, b]. */
+function parseColor(hex) {
+    return [
+        parseInt(hex.slice(1, 3), 16),
+        parseInt(hex.slice(3, 5), 16),
+        parseInt(hex.slice(5, 7), 16),
+    ];
+}
+/**
+ * Draw text onto a 64×64 RGB buffer.
+ * @param buf - 12,288 byte RGB buffer (mutated in place)
+ * @param x - starting X pixel
+ * @param y - starting Y pixel
+ * @param text - string to draw (auto-uppercased, unknown chars → space)
+ * @param color - hex color "#RRGGBB"
+ */
+export function drawText(buf, x, y, text, color) {
+    const [r, g, b] = parseColor(color);
+    const upper = text.toUpperCase();
+    let cx = x;
+    for (const ch of upper) {
+        const glyph = GLYPHS[ch];
+        if (!glyph) {
+            cx += 4; // unknown char → space
+            continue;
+        }
+        for (let row = 0; row < 5; row++) {
+            for (let col = 0; col < 3; col++) {
+                if (glyph[row] & (0b100 >> col)) {
+                    const px = cx + col;
+                    const py = y + row;
+                    if (px >= 0 && px < 64 && py >= 0 && py < 64) {
+                        const idx = (py * 64 + px) * 3;
+                        buf[idx] = r;
+                        buf[idx + 1] = g;
+                        buf[idx + 2] = b;
+                    }
+                }
+            }
+        }
+        cx += 4; // 3px glyph + 1px gap
+    }
+}
+/**
+ * Measure text width in pixels.
+ */
+export function measureText(text) {
+    if (text.length === 0)
+        return 0;
+    return text.length * 4 - 1; // each char 3px + 1px gap, minus trailing gap
+}
+/**
+ * Draw text centered horizontally on the 64px canvas.
+ */
+export function drawTextCentered(buf, y, text, color) {
+    const width = measureText(text);
+    const x = Math.max(0, Math.floor((64 - width) / 2));
+    drawText(buf, x, y, text, color);
+}
+//# sourceMappingURL=pixoo-font.js.map

package/dist/pixoo/pixoo-font.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pixoo-font.js","sourceRoot":"","sources":["../../src/pixoo/pixoo-font.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,mEAAmE;AACnE,0EAA0E;AAC1E,MAAM,MAAM,GAA6B;IACvC,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IACxC,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IACxC,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IACxC,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IACxC,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IACxC,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IACxC,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IACxC,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IACxC,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IACxC,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IACxC,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IACxC,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IACxC,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IACxC,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IACxC,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IACxC,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IACxC,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IACxC,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IACxC,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IACxC,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IACxC,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IACxC,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IACxC,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IACxC,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IACxC,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IACxC,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IACxC,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IACxC,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IACxC,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IACxC,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IACxC,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IACxC,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IACxC,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IACxC,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IACxC,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IACxC,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IACxC,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IACxC,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IACxC,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IACxC,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IACxC,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IACxC,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IACxC,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IACxC,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IACxC,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IACxC,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IACxC,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IACxC,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IACxC,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IACxC,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE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"}

package/dist/pixoo/pixoo-renderer.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Pixoo64 Frame Renderer — camera-based animated terrarium.
+ *
+ * No text. All information encoded visually:
+ *
+ *   Water color  ↔  usage zone (blue → teal → amber → red)
+ *   Waves        ↔  agent state (calm=IDLE, choppy=PROC, golden pulse=AWAITING)
+ *   Bubbles      ↔  activity density
+ *   Creatures    ↔  sessions + gateway
+ *   Particles    ↔  data flow during processing
+ *   Surface glow ↔  state color (green / blue / amber)
+ *   Camera zoom  ↔  state-driven focus (wide, octopus close-up, crayfish, school, surface)
+ *
+ * Rendering pipeline:
+ *   1. Environment → 64×64 world buffer (water, terrain, effects)
+ *   2. blitWithCamera() → output buffer (crop + scale by camera zoom/pan)
+ *   3. Scaled creatures → output buffer (HD grid sprites with camera-aware sizing)
+ *   4. Screen-space overlays (danger flash) → output buffer
+ */
+import type { StateUpdateEvent, UsageEvent } from '../types.js';
+import type { SessionInfo } from '@agentdeck/shared/protocol';
+/**
+ * Render a complete 64×64 frame with camera system.
+ * Returns 12,288-byte RGB buffer.
+ */
+export declare function renderFrame(stateEvent: StateUpdateEvent | null, usageEvent: UsageEvent | null, sessions: SessionInfo[] | null, timeOverrideMs?: number): Uint8Array;
+/** Render a static black frame with centered grey "OFFLINE" text. */
+export declare function renderDisconnectedFrame(): Uint8Array;
+export { setZone, setOverride, resetDirector } from './pixoo-camera.js';
+export type { Camera } from './pixoo-camera.js';
+export { ZONES } from './pixoo-camera.js';
+//# sourceMappingURL=pixoo-renderer.d.ts.map

package/dist/pixoo/pixoo-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pixoo-renderer.d.ts","sourceRoot":"","sources":["../../src/pixoo/pixoo-renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAkmB9D;;;GAGG;AACH,wBAAgB,WAAW,CACzB,UAAU,EAAE,gBAAgB,GAAG,IAAI,EACnC,UAAU,EAAE,UAAU,GAAG,IAAI,EAC7B,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI,EAC9B,cAAc,CAAC,EAAE,MAAM,GACtB,UAAU,CA0MZ;AAID,qEAAqE;AACrE,wBAAgB,uBAAuB,IAAI,UAAU,CAIpD;AAGD,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACxE,YAAY,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC"}