@agentdeck/bridge 0.1.0 → 0.2.0

package/dist/pixoo/pixoo-camera.js

@@ -0,0 +1,271 @@
+/**
+ * Pixoo64 Camera System — zoom/pan coordinate transform + zone director.
+ *
+ * Virtual world is normalized 0~1 in both axes. Camera defines a viewport
+ * with center (cx, cy) and zoom level. At zoom=1.0 the full world is visible;
+ * at zoom=2.0 only the center quarter is visible but everything is 2× larger.
+ *
+ * Rendering pipeline:
+ *   1. Environment → 64×64 world buffer (pixel coords 0~63)
+ *   2. blitWithCamera() → 64×64 output buffer (crop + nearest-neighbor scale)
+ *   3. Scaled creatures → output buffer (high-detail grid, camera-aware sizing)
+ */
+const W = 64;
+export const CAMERA_WIDE = { cx: 0.5, cy: 0.5, zoom: 1.0 };
+export const ZONES = {
+    wide: { name: 'wide', cx: 0.5, cy: 0.5, zoom: 1.0, duration: 10 },
+    'pan-left': { name: 'pan-left', cx: 0.35, cy: 0.52, zoom: 1.15, duration: 8 },
+    'pan-right': { name: 'pan-right', cx: 0.65, cy: 0.52, zoom: 1.15, duration: 8 },
+    octopus: { name: 'octopus', cx: 0.38, cy: 0.45, zoom: 3.2, duration: 15 },
+    crayfish: { name: 'crayfish', cx: 0.72, cy: 0.55, zoom: 3.2, duration: 15 },
+    school: { name: 'school', cx: 0.5, cy: 0.40, zoom: 1.6, duration: 10 },
+    'full-tank': { name: 'full-tank', cx: 0.5, cy: 0.5, zoom: 1.0, duration: 8 },
+};
+// ===== Coordinate Transforms =====
+/** World (0~1) → screen pixel (0~63). */
+export function worldToScreen(wx, wy, cam) {
+    return [
+        (wx - cam.cx) * W * cam.zoom + W / 2,
+        (wy - cam.cy) * W * cam.zoom + W / 2,
+    ];
+}
+/** Screen pixel → world (0~1). */
+export function screenToWorld(sx, sy, cam) {
+    return [
+        (sx - W / 2) / (W * cam.zoom) + cam.cx,
+        (sy - W / 2) / (W * cam.zoom) + cam.cy,
+    ];
+}
+/** Check if a world-space point is within the camera viewport. */
+export function isVisible(wx, wy, cam, padding = 0.05) {
+    const halfView = 0.5 / cam.zoom + padding;
+    return Math.abs(wx - cam.cx) <= halfView && Math.abs(wy - cam.cy) <= halfView;
+}
+/** Clamp camera so the viewport stays within world bounds. */
+export function clampCamera(cam) {
+    const halfView = 0.5 / cam.zoom;
+    return {
+        cx: Math.max(halfView, Math.min(1 - halfView, cam.cx)),
+        cy: Math.max(halfView, Math.min(1 - halfView, cam.cy)),
+        zoom: cam.zoom,
+    };
+}
+/** Linearly interpolate between two cameras. */
+export function lerpCamera(a, b, t) {
+    const s = Math.max(0, Math.min(1, t));
+    return {
+        cx: a.cx + (b.cx - a.cx) * s,
+        cy: a.cy + (b.cy - a.cy) * s,
+        zoom: a.zoom + (b.zoom - a.zoom) * s,
+    };
+}
+/** Smoothstep ease-in-out. */
+export function easeInOut(t) {
+    const s = Math.max(0, Math.min(1, t));
+    return s * s * (3 - 2 * s);
+}
+// ===== Blit: world buffer → output with camera transform =====
+/**
+ * Crop + nearest-neighbor scale from a 64×64 world buffer into a 64×64 output.
+ * At zoom 1.0: 1:1 copy.  At zoom 2.0: center 32×32 upscaled to fill output.
+ */
+export function blitWithCamera(world, output, cam) {
+    const cxPx = cam.cx * W;
+    const cyPx = cam.cy * W;
+    const viewSize = W / cam.zoom;
+    const left = cxPx - viewSize / 2;
+    const top = cyPx - viewSize / 2;
+    for (let sy = 0; sy < W; sy++) {
+        for (let sx = 0; sx < W; sx++) {
+            const wx = Math.floor(left + sx / cam.zoom);
+            const wy = Math.floor(top + sy / cam.zoom);
+            const dstIdx = (sy * W + sx) * 3;
+            if (wx >= 0 && wx < W && wy >= 0 && wy < W) {
+                const srcIdx = (wy * W + wx) * 3;
+                output[dstIdx] = world[srcIdx];
+                output[dstIdx + 1] = world[srcIdx + 1];
+                output[dstIdx + 2] = world[srcIdx + 2];
+            }
+            // out-of-bounds stays black (Uint8Array zero-init)
+        }
+    }
+}
+const TRANSITION_SEC = 8; // ease-in-out zone transition (8s for smooth camera at ~1fps)
+const ACTIVE_DWELL_SEC = 6; // seconds per creature in cycling-active mode
+let ds = null;
+// Idle cycle: wide overview → left pan (octopus area) → wide → right pan (crayfish area)
+const IDLE_CYCLE = [
+    ZONES.wide, ZONES['pan-left'], ZONES.wide, ZONES['pan-right'],
+];
+/**
+ * Advance the camera director by `dt` seconds and return the current camera.
+ *
+ * 3-mode state machine:
+ *   idle-cycle:     No active creatures → wide(12s) → school(10s) → full-tank(8s)
+ *   tracking:       Single active creature → zoom 2.0 tracking
+ *   cycling-active: 2+ active creatures → priority-sorted, 6s per creature
+ *
+ * @param dt               seconds since last call (~1.2s at Pixoo push rate)
+ * @param activeCreatures  creatures with state != idle (octopus PROCESSING/AWAITING, crayfish ROUTING)
+ * @param crayfishRouting  whether crayfish is actively routing (for legacy compat)
+ * @param crayfishPos      crayfish world position (if visible)
+ * @param schoolPos        dynamic tetra school center for idle tracking
+ */
+export function updateDirector(dt, activeCreatures, crayfishRouting, crayfishPos, schoolPos) {
+    if (!ds) {
+        ds = {
+            mode: 'idle-cycle',
+            camera: { ...CAMERA_WIDE },
+            idleCycle: IDLE_CYCLE,
+            idleIndex: 0,
+            currentZone: ZONES.wide,
+            targetZone: ZONES.wide,
+            zoneTimer: 0,
+            transitionT: 0,
+            transitioning: false,
+            activeIndex: 0,
+            activeDwell: 0,
+        };
+    }
+    // Sort active creatures by priority (lower = more important)
+    const sorted = [...activeCreatures].sort((a, b) => a.priority - b.priority);
+    // --- Determine mode ---
+    const prevMode = ds.mode;
+    if (sorted.length === 0) {
+        ds.mode = 'idle-cycle';
+    }
+    else if (sorted.length === 1) {
+        ds.mode = 'tracking';
+    }
+    else {
+        ds.mode = 'cycling-active';
+    }
+    // Reset on mode transition
+    if (prevMode !== ds.mode) {
+        if (ds.mode === 'idle-cycle') {
+            ds.idleIndex = 0;
+            ds.currentZone = ZONES.wide;
+            ds.targetZone = ZONES.wide;
+            ds.zoneTimer = 0;
+            ds.transitionT = 0;
+            ds.transitioning = false;
+        }
+        else if (ds.mode === 'cycling-active') {
+            ds.activeIndex = 0;
+            ds.activeDwell = 0;
+        }
+    }
+    // --- Priority interrupt: AWAITING (priority 0) jumps to front ---
+    if (ds.mode === 'cycling-active' && sorted.length > 0 && sorted[0].priority === 0) {
+        // If current target isn't the highest-priority creature, snap to it
+        if (ds.activeIndex !== 0) {
+            ds.activeIndex = 0;
+            ds.activeDwell = 0;
+        }
+    }
+    // --- Execute mode ---
+    switch (ds.mode) {
+        case 'idle-cycle': {
+            const cycle = IDLE_CYCLE;
+            if (ds.transitioning) {
+                ds.transitionT += dt / TRANSITION_SEC;
+                if (ds.transitionT >= 1) {
+                    ds.transitionT = 1;
+                    ds.transitioning = false;
+                    ds.currentZone = ds.targetZone;
+                    ds.zoneTimer = 0;
+                }
+                const t = easeInOut(ds.transitionT);
+                const fromCam = resolveIdleZoneCamera(ds.currentZone, schoolPos);
+                const toCam = resolveIdleZoneCamera(ds.targetZone, schoolPos);
+                ds.camera = lerpCamera(fromCam, toCam, t);
+            }
+            else {
+                ds.zoneTimer += dt;
+                const zoneCam = resolveIdleZoneCamera(ds.currentZone, schoolPos);
+                ds.camera = lerpCamera(ds.camera, zoneCam, Math.min(1, dt * 2));
+                if (ds.zoneTimer >= ds.currentZone.duration) {
+                    ds.idleIndex = (ds.idleIndex + 1) % cycle.length;
+                    ds.targetZone = cycle[ds.idleIndex];
+                    ds.transitioning = true;
+                    ds.transitionT = 0;
+                }
+            }
+            break;
+        }
+        case 'tracking': {
+            const c = sorted[0];
+            const yOff = c.priority === 0 ? -0.05 : 0; // AWAITING: shift up for "?" bubble
+            const target = { cx: c.x, cy: c.y + yOff, zoom: 3.2 };
+            ds.camera = lerpCamera(ds.camera, target, Math.min(1, dt * 0.8));
+            break;
+        }
+        case 'cycling-active': {
+            ds.activeDwell += dt;
+            if (ds.activeDwell >= ACTIVE_DWELL_SEC) {
+                ds.activeIndex = (ds.activeIndex + 1) % sorted.length;
+                ds.activeDwell = 0;
+            }
+            const c = sorted[ds.activeIndex % sorted.length];
+            const yOff = c.priority === 0 ? -0.05 : 0;
+            const target = { cx: c.x, cy: c.y + yOff, zoom: 3.2 };
+            ds.camera = lerpCamera(ds.camera, target, Math.min(1, dt * 0.8));
+            break;
+        }
+    }
+    return clampCamera(ds.camera);
+}
+function resolveIdleZoneCamera(zone, schoolPos) {
+    if (zone.name === 'school' && schoolPos) {
+        return { cx: schoolPos.x, cy: schoolPos.y, zoom: zone.zoom };
+    }
+    return { cx: zone.cx, cy: zone.cy, zoom: zone.zoom };
+}
+/** Jump to a specific zone immediately (for preview). */
+export function setZone(zoneName) {
+    const zone = ZONES[zoneName];
+    if (!zone)
+        return;
+    ds = {
+        mode: 'idle-cycle',
+        camera: { cx: zone.cx, cy: zone.cy, zoom: zone.zoom },
+        idleCycle: IDLE_CYCLE,
+        idleIndex: IDLE_CYCLE.findIndex(z => z.name === zoneName) ?? 0,
+        currentZone: zone,
+        targetZone: zone,
+        zoneTimer: 0,
+        transitionT: 0,
+        transitioning: false,
+        activeIndex: 0,
+        activeDwell: 0,
+    };
+}
+/** Override camera directly (for preview --zoom). */
+export function setOverride(cam) {
+    ds = {
+        mode: 'idle-cycle',
+        camera: { ...cam },
+        idleCycle: IDLE_CYCLE,
+        idleIndex: 0,
+        currentZone: ZONES.wide,
+        targetZone: ZONES.wide,
+        zoneTimer: 0,
+        transitionT: 0,
+        transitioning: false,
+        activeIndex: 0,
+        activeDwell: 0,
+    };
+}
+/** Reset director state (e.g. on reconnect). */
+export function resetDirector() {
+    ds = null;
+}
+/** Get the name of the current camera zone (for change detection). */
+export function getCurrentZoneName() {
+    if (!ds)
+        return 'wide';
+    return ds.transitioning
+        ? `${ds.currentZone.name}→${ds.targetZone.name}`
+        : ds.currentZone.name;
+}
+//# sourceMappingURL=pixoo-camera.js.map

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

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

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

@@ -0,0 +1,67 @@
+/**
+ * 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).
+ */
+/** Clear cached static PicID for a device (call when device reboots to re-sync). */
+export declare function clearStaticPicId(ip: string): void;
+/** Register a callback for device online/offline transitions. */
+export declare function onDeviceStatusChange(cb: (ip: string, online: boolean) => void): void;
+/** Clean up probe timer. Call on shutdown. */
+export declare function stopProbeTimer(): void;
+/**
+ * Wake recovery — clear all PicID caches and circuit breaker state.
+ * Devices may have rebooted during sleep, so all cached state is stale.
+ */
+export declare function handlePixooWake(): void;
+/** Get circuit breaker status for a device. */
+export declare function getDeviceBackoffStatus(ip: string): {
+    failures: number;
+    backedOff: boolean;
+    nextProbeMs: number;
+};
+/**
+ * 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 declare function pushFrame(ip: string, buffer: Uint8Array): Promise<boolean>;
+/**
+ * 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 declare function sendScrollText(ip: string, textId: number, text: string, color: string, speed?: number): Promise<boolean>;
+/** Clear all text overlays. */
+export declare function clearText(ip: string): Promise<boolean>;
+/** Set display brightness (0-100). */
+export declare function setBrightness(ip: string, value: number): Promise<boolean>;
+/** Query the device's current PicID counter. Returns 0 on failure. */
+export declare function getHttpGifId(ip: string): Promise<number>;
+/** Reset the PicID counter to prevent device lockup. */
+export declare function resetPicId(ip: string): Promise<boolean>;
+/** Switch device to the custom channel that shows SendHttpGif content. */
+export declare function switchToCustomChannel(ip: string): Promise<boolean>;
+/**
+ * Get device configuration (also serves as a connectivity test).
+ * Returns null on failure.
+ */
+export declare function getDeviceConfig(ip: string): Promise<Record<string, unknown> | null>;
+/**
+ * Discover Pixoo devices via Divoom cloud API.
+ * Falls back gracefully if cloud is unreachable.
+ */
+export declare function discoverDevices(): Promise<Array<{
+    name: string;
+    ip: string;
+}>>;
+//# sourceMappingURL=pixoo-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pixoo-client.d.ts","sourceRoot":"","sources":["../../src/pixoo/pixoo-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAgBH,oFAAoF;AACpF,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAGjD;AAmBD,iEAAiE;AACjE,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAEpF;AAoED,8CAA8C;AAC9C,wBAAgB,cAAc,IAAI,IAAI,CAKrC;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAUtC;AAED,+CAA+C;AAC/C,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAUhH;AA8DD;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CA0ChF;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAClE,OAAO,CAAC,OAAO,CAAC,CAkBlB;AAED,+BAA+B;AAC/B,wBAAsB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE5D;AAED,sCAAsC;AACtC,wBAAsB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAK/E;AAED,sEAAsE;AACtE,wBAAsB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAO9D;AAED,wDAAwD;AACxD,wBAAsB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE7D;AAED,0EAA0E;AAC1E,wBAAsB,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGxE;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAMzF;AAED;;;GAGG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAkBpF"}