@agentdeck/bridge 1.0.12 → 1.0.14

package/dist/d200h/hid-protocol.js

@@ -0,0 +1,124 @@
+/**
+ * D200H HID Protocol — D200-compatible 1024-byte packet protocol
+ *
+ * Packet structure:
+ *   [0-1]  Header: 0x7C 0x7C
+ *   [2-3]  Command: big-endian uint16
+ *   [4-7]  Length:  little-endian uint32
+ *   [8-1023] Payload (zero-padded)
+ *
+ * Image delivery: ZIP(manifest.json + icons/*.png) sent in chunked 1024-byte packets.
+ * ZIP quirk: bytes at offset 1016, 2040, 3064... must NOT be 0x00 or 0x7C.
+ */
+import { randomBytes } from 'crypto';
+const TAG = 'd200h-hid';
+const PACKET_SIZE = 1024;
+const HEADER = Buffer.from([0x7c, 0x7c]);
+const INVALID_BOUNDARY_BYTES = [0x00, 0x7c];
+// --- Commands ---
+export const CMD = {
+    SET_BUTTONS: 0x0001,
+    PARTIAL_UPDATE: 0x000d,
+    SET_SMALL_WINDOW: 0x0006,
+    SET_BRIGHTNESS: 0x000a,
+    SET_LABEL_STYLE: 0x000b,
+    IN_BUTTON: 0x0101,
+    IN_DEVICE_INFO: 0x0303,
+};
+// --- Packet building ---
+export function buildPacket(command, payload, totalLength) {
+    const pkt = Buffer.alloc(PACKET_SIZE, 0);
+    // Header
+    pkt[0] = 0x7c;
+    pkt[1] = 0x7c;
+    // Command (big-endian uint16)
+    pkt.writeUInt16BE(command, 2);
+    // Length (little-endian uint32) — total file size for multi-packet, else payload length
+    pkt.writeUInt32LE(totalLength ?? payload.length, 4);
+    // Payload
+    payload.copy(pkt, 8, 0, Math.min(payload.length, PACKET_SIZE - 8));
+    return pkt;
+}
+/**
+ * Build all packets for a ZIP file transfer (SET_BUTTONS or PARTIAL_UPDATE).
+ * First packet has the header; subsequent packets are raw 1024-byte chunks.
+ */
+export function buildZipPackets(zipData, command = CMD.SET_BUTTONS) {
+    const packets = [];
+    const fileSize = zipData.length;
+    // First packet: header(8) + first chunk
+    const firstChunkSize = PACKET_SIZE - 8;
+    const firstChunk = zipData.subarray(0, firstChunkSize);
+    packets.push(buildPacket(command, firstChunk, fileSize));
+    // Remaining chunks (raw, no header)
+    for (let offset = firstChunkSize; offset < fileSize; offset += PACKET_SIZE) {
+        const chunk = Buffer.alloc(PACKET_SIZE, 0);
+        zipData.copy(chunk, 0, offset, Math.min(offset + PACKET_SIZE, fileSize));
+        packets.push(chunk);
+    }
+    return packets;
+}
+export function buildBrightnessPacket(brightness) {
+    const val = Math.max(0, Math.min(100, Math.round(brightness)));
+    return buildPacket(CMD.SET_BRIGHTNESS, Buffer.from(String(val), 'utf-8'));
+}
+export function buildSmallWindowPacket(mode, cpu, mem, time, gpu) {
+    const data = `${mode}|${cpu}|${mem}|${time}|${gpu}`;
+    return buildPacket(CMD.SET_SMALL_WINDOW, Buffer.from(data, 'utf-8'));
+}
+export function parseIncoming(data) {
+    if (data.length < 8)
+        return null;
+    if (data[0] !== 0x7c || data[1] !== 0x7c)
+        return null;
+    const command = data.readUInt16BE(2);
+    if (command === CMD.IN_BUTTON && data.length >= 12) {
+        return {
+            type: 'button',
+            data: {
+                state: data[8],
+                index: data[9],
+                pressed: data[11] === 0x01,
+            },
+        };
+    }
+    if (command === CMD.IN_DEVICE_INFO) {
+        try {
+            const jsonStr = data.subarray(8).toString('ascii').split('\0')[0];
+            const info = JSON.parse(jsonStr);
+            return {
+                type: 'device_info',
+                data: {
+                    serialNumber: info.SerialNumber ?? '',
+                    firmwareVersion: info.Dversion ?? '',
+                    deviceType: info.DeviceType ?? '',
+                    hardwareVersion: info.HardwareVersion ?? '',
+                },
+            };
+        }
+        catch {
+            return { type: 'unknown', command, raw: data };
+        }
+    }
+    return { type: 'unknown', command, raw: data };
+}
+// --- ZIP validation (boundary byte workaround) ---
+/**
+ * Check if a ZIP has invalid bytes at 1024-byte chunk boundaries.
+ * At offset 1016, 2040, 3064... the byte must not be 0x00 or 0x7C.
+ */
+export function validateZipBoundaries(zipData) {
+    for (let i = 1016; i < zipData.length; i += PACKET_SIZE) {
+        if (INVALID_BOUNDARY_BYTES.includes(zipData[i])) {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * Generate a random dummy string to pad the ZIP until boundaries are valid.
+ */
+export function generateDummyPadding(attempt) {
+    return 'AgentDeck ' + randomBytes(8 * (attempt + 1)).toString('hex');
+}
+//# sourceMappingURL=hid-protocol.js.map

package/dist/d200h/hid-protocol.js.map

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

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

@@ -0,0 +1,24 @@
+/**
+ * D200H Image Renderer — Renders AgentDeck state as 196×196 PNG key icons
+ * using the shared SVG renderers (same visual output as Stream Deck plugin).
+ *
+ * Pipeline: state → shared SVG generators (144×144) → resvg rasterize (196×196 PNG) → ZIP
+ *
+ * Falls back to solid-color PNGs if resvg-js is not available.
+ */
+import { parseState, buildButtonCommandMap } from '@agentdeck/shared';
+export { parseState, buildButtonCommandMap };
+export type { DashState, ButtonCommand, KeySlot } from '@agentdeck/shared';
+/** Initialize the renderer (call once at module start). */
+export declare function initRenderer(): Promise<void>;
+export declare function isResvgLoaded(): boolean;
+/**
+ * Render the full AgentDeck dashboard as a ZIP ready for SET_BUTTONS.
+ * Uses shared SVG renderers → resvg rasterization for SD+-quality output.
+ */
+export declare function renderDashboardZip(stateEvt: any): Buffer;
+/**
+ * Create a simple hash of the visual state for change detection.
+ */
+export declare function stateHash(stateEvt: any): string;
+//# sourceMappingURL=image-renderer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"image-renderer.d.ts","sourceRoot":"","sources":["../../src/d200h/image-renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,OAAO,EAEL,UAAU,EACV,qBAAqB,EAEtB,MAAM,mBAAmB,CAAC;AAI3B,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,CAAC;AAC7C,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AA2D3E,2DAA2D;AAC3D,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAElD;AAED,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AA+LD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,GAAG,GAAG,MAAM,CAmExD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,GAAG,GAAG,MAAM,CAI/C"}

package/dist/d200h/image-renderer.js

@@ -0,0 +1,321 @@
+/**
+ * D200H Image Renderer — Renders AgentDeck state as 196×196 PNG key icons
+ * using the shared SVG renderers (same visual output as Stream Deck plugin).
+ *
+ * Pipeline: state → shared SVG generators (144×144) → resvg rasterize (196×196 PNG) → ZIP
+ *
+ * Falls back to solid-color PNGs if resvg-js is not available.
+ */
+import { deflateSync } from 'zlib';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+import { existsSync } from 'node:fs';
+// Layout/command engine is shared with the Ulanzi Studio plugin (single source
+// of truth for the reflowing 5×3 grid). Rasterization + ZIP packing stay here.
+import { computeLayout, parseState, buildButtonCommandMap, renderUsageWideSlot, } from '@agentdeck/shared';
+import { debug } from '../logger.js';
+// Re-export the engine bits the D200H module + tests import from here.
+export { parseState, buildButtonCommandMap };
+import { validateZipBoundaries } from './hid-protocol.js';
+const TAG = 'd200h-render';
+const ICON_SIZE = 196;
+// --- Font supply for resvg ---
+// resvg drops every <text> element unless it has a font to shape glyphs with.
+// We load a small set of bundled OFL fonts explicitly via `fontFiles` (NOT
+// `loadSystemFonts`, which re-scans the whole OS font tree on every `new Resvg()`
+// — i.e. 14× per frame — and is the reason the original code set it to `false`).
+// `defaultFontFamily` makes unresolved families in the shared SVG renderers
+// (e.g. `Inter`, `Arial`, `monospace`) fall back to a design-system face
+// instead of rendering nothing. Computed once at module load.
+const FONT_OPTS = (() => {
+    try {
+        // bridge/{src,dist}/d200h/image-renderer.{ts,js} → bridge/assets/fonts
+        const here = dirname(fileURLToPath(import.meta.url));
+        const fontsDir = join(here, '..', '..', 'assets', 'fonts');
+        const files = [
+            'IBMPlexSans-Regular.ttf',
+            'IBMPlexSans-Bold.ttf',
+            'JetBrainsMono-Regular.ttf',
+            'JetBrainsMono-Bold.ttf',
+        ]
+            .map((n) => join(fontsDir, n))
+            .filter((p) => existsSync(p));
+        if (files.length > 0) {
+            return { fontFiles: files, loadSystemFonts: false, defaultFontFamily: 'IBM Plex Sans' };
+        }
+        debug(TAG, `bundled fonts not found under ${fontsDir} — falling back to system fonts`);
+    }
+    catch (err) {
+        debug(TAG, `font path resolution failed (${err}) — falling back to system fonts`);
+    }
+    // Defense-in-depth: if bundled fonts are missing, still render text via the OS.
+    return { loadSystemFonts: true, defaultFontFamily: 'Helvetica Neue' };
+})();
+let Resvg = null;
+let resvgLoaded = false;
+async function loadResvg() {
+    if (resvgLoaded)
+        return Resvg;
+    resvgLoaded = true;
+    try {
+        const mod = await import('@resvg/resvg-js');
+        Resvg = mod.Resvg ?? mod.default?.Resvg;
+        debug(TAG, 'resvg-js loaded — SVG rendering enabled');
+        return Resvg;
+    }
+    catch {
+        debug(TAG, 'resvg-js not available — falling back to solid-color PNGs');
+        return null;
+    }
+}
+/** Initialize the renderer (call once at module start). */
+export async function initRenderer() {
+    await loadResvg();
+}
+export function isResvgLoaded() {
+    return Resvg !== null;
+}
+// --- SVG → 196×196 PNG rasterization ---
+function svgToPng(svg144) {
+    if (!Resvg)
+        return fallbackSolidPng(20, 20, 25); // dark fallback
+    // Wrap 144×144 SVG content into 196×196 viewport with auto-scaling
+    const inner = svg144.replace(/<\/?svg[^>]*>/g, '');
+    const wrapped = `<svg xmlns="http://www.w3.org/2000/svg" width="${ICON_SIZE}" height="${ICON_SIZE}" viewBox="0 0 144 144">${inner}</svg>`;
+    try {
+        const resvg = new Resvg(wrapped, {
+            fitTo: { mode: 'width', value: ICON_SIZE },
+            font: FONT_OPTS,
+        });
+        return Buffer.from(resvg.render().asPng());
+    }
+    catch (err) {
+        debug(TAG, `SVG rasterization failed: ${err}`);
+        return fallbackSolidPng(20, 20, 25);
+    }
+}
+/** Rasterize custom-sized SVG (e.g. 288×144 → 392×196 for merged slot). */
+function svgToPngWide(svg, width, height) {
+    if (!Resvg)
+        return fallbackSolidPng(20, 20, 25);
+    try {
+        const resvg = new Resvg(svg, {
+            fitTo: { mode: 'width', value: width },
+            font: FONT_OPTS,
+        });
+        return Buffer.from(resvg.render().asPng());
+    }
+    catch (err) {
+        debug(TAG, `Wide SVG rasterization failed: ${err}`);
+        return fallbackSolidPng(20, 20, 25);
+    }
+}
+// --- ZIP creation (reused from original, with boundary validation) ---
+function crc32(buf) {
+    let crc = 0xffffffff;
+    for (let i = 0; i < buf.length; i++) {
+        crc = crcTable[(crc ^ buf[i]) & 0xff] ^ (crc >>> 8);
+    }
+    return (crc ^ 0xffffffff) >>> 0;
+}
+const crcTable = new Uint32Array(256);
+for (let n = 0; n < 256; n++) {
+    let c = n;
+    for (let k = 0; k < 8; k++) {
+        c = (c & 1) ? (0xedb88320 ^ (c >>> 1)) : (c >>> 1);
+    }
+    crcTable[n] = c;
+}
+function normalizeExtraLength(length) {
+    if (length <= 0)
+        return 0;
+    return Math.max(4, length);
+}
+function makeZipExtraField(length) {
+    const normalized = normalizeExtraLength(length);
+    if (normalized === 0)
+        return Buffer.alloc(0);
+    const extra = Buffer.alloc(normalized, 0x41);
+    extra.writeUInt16LE(0x4141, 0);
+    extra.writeUInt16LE(Math.max(0, normalized - 4), 2);
+    return extra;
+}
+function firstInvalidZipBoundaryOffset(zipData) {
+    for (let i = 1016; i < zipData.length; i += 1024) {
+        if (zipData[i] === 0x00 || zipData[i] === 0x7c)
+            return i;
+    }
+    return null;
+}
+function createZipInMemory(files, extraLengths = []) {
+    const centralDir = [];
+    const localParts = [];
+    const layouts = [];
+    let offset = 0;
+    let index = 0;
+    for (const [name, data] of files) {
+        const nameBytes = Buffer.from(name, 'utf-8');
+        const crc = crc32(data);
+        const extraLen = normalizeExtraLength(extraLengths[index] ?? 0);
+        const extra = makeZipExtraField(extraLen);
+        const localExtraOffset = offset + 30 + nameBytes.length;
+        const local = Buffer.alloc(30 + nameBytes.length + extra.length);
+        local.writeUInt32LE(0x04034b50, 0);
+        local.writeUInt16LE(20, 4);
+        local.writeUInt16LE(0, 6);
+        local.writeUInt16LE(0, 8);
+        local.writeUInt16LE(0, 10);
+        local.writeUInt16LE(0, 12);
+        local.writeUInt32LE(crc, 14);
+        local.writeUInt32LE(data.length, 18);
+        local.writeUInt32LE(data.length, 22);
+        local.writeUInt16LE(nameBytes.length, 26);
+        local.writeUInt16LE(extra.length, 28);
+        nameBytes.copy(local, 30);
+        extra.copy(local, 30 + nameBytes.length);
+        const central = Buffer.alloc(46 + nameBytes.length + extra.length);
+        central.writeUInt32LE(0x02014b50, 0);
+        central.writeUInt16LE(20, 4);
+        central.writeUInt16LE(20, 6);
+        central.writeUInt16LE(0, 8);
+        central.writeUInt16LE(0, 10);
+        central.writeUInt16LE(0, 12);
+        central.writeUInt16LE(0, 14);
+        central.writeUInt32LE(crc, 16);
+        central.writeUInt32LE(data.length, 20);
+        central.writeUInt32LE(data.length, 24);
+        central.writeUInt16LE(nameBytes.length, 28);
+        central.writeUInt16LE(extra.length, 30);
+        central.writeUInt16LE(0, 32);
+        central.writeUInt16LE(0, 34);
+        central.writeUInt16LE(0, 36);
+        central.writeUInt32LE(0, 38);
+        central.writeUInt32LE(offset, 42);
+        nameBytes.copy(central, 46);
+        extra.copy(central, 46 + nameBytes.length);
+        localParts.push(local, data);
+        centralDir.push(central);
+        layouts.push({ extraInsertOffset: localExtraOffset });
+        offset += local.length + data.length;
+        index += 1;
+    }
+    const centralDirData = Buffer.concat(centralDir);
+    const eocd = Buffer.alloc(22);
+    eocd.writeUInt32LE(0x06054b50, 0);
+    eocd.writeUInt16LE(0, 4);
+    eocd.writeUInt16LE(0, 6);
+    eocd.writeUInt16LE(files.size, 8);
+    eocd.writeUInt16LE(files.size, 10);
+    eocd.writeUInt32LE(centralDirData.length, 12);
+    eocd.writeUInt32LE(offset, 16);
+    eocd.writeUInt16LE(0, 20);
+    return { zip: Buffer.concat([...localParts, centralDirData, eocd]), layouts };
+}
+// --- Fallback solid-color PNG (when resvg-js unavailable) ---
+function fallbackSolidPng(r, g, b) {
+    const w = ICON_SIZE, h = ICON_SIZE;
+    const ihdr = Buffer.alloc(13);
+    ihdr.writeUInt32BE(w, 0);
+    ihdr.writeUInt32BE(h, 4);
+    ihdr[8] = 8;
+    ihdr[9] = 2; // 8-bit RGB
+    const rowLen = 1 + w * 3;
+    const raw = Buffer.alloc(rowLen * h);
+    for (let y = 0; y < h; y++) {
+        const off = y * rowLen;
+        raw[off] = 0;
+        for (let x = 0; x < w; x++) {
+            const px = off + 1 + x * 3;
+            raw[px] = r;
+            raw[px + 1] = g;
+            raw[px + 2] = b;
+        }
+    }
+    const compressed = deflateSync(raw);
+    const sig = Buffer.from([137, 80, 78, 71, 13, 10, 26, 10]);
+    function pngChunk(type, data) {
+        const typeBytes = Buffer.from(type, 'ascii');
+        const len = Buffer.alloc(4);
+        len.writeUInt32BE(data.length, 0);
+        const crcData = Buffer.concat([typeBytes, data]);
+        const crc = Buffer.alloc(4);
+        crc.writeUInt32BE(crc32(crcData), 0);
+        return Buffer.concat([len, typeBytes, data, crc]);
+    }
+    return Buffer.concat([sig, pngChunk('IHDR', ihdr), pngChunk('IDAT', compressed), pngChunk('IEND', Buffer.alloc(0))]);
+}
+// --- Public API ---
+/**
+ * Render the full AgentDeck dashboard as a ZIP ready for SET_BUTTONS.
+ * Uses shared SVG renderers → resvg rasterization for SD+-quality output.
+ */
+export function renderDashboardZip(stateEvt) {
+    const state = parseState(stateEvt);
+    const layout = computeLayout(state);
+    const manifest = {};
+    const files = new Map();
+    for (let i = 0; i < layout.length; i++) {
+        const slot = layout[i];
+        const iconPath = `icons/btn${i}.png`;
+        const colRow = `${slot.col}_${slot.row}`;
+        const png = svgToPng(slot.svg);
+        files.set(iconPath, png);
+        manifest[colRow] = {
+            State: 0,
+            ViewParam: [{ Text: slot.label, Icon: iconPath }],
+        };
+    }
+    // Merged hardware slot (3_2) — 392×196 PNG with StreamDeck-style usage display
+    // No Action = device firmware clock overlay suppressed (solves clock overlap)
+    const wideUsageSvg = renderUsageWideSlot(state.fiveHourPercent, state.sevenDayPercent, state.usageKnown !== false);
+    const wideUsagePng = svgToPngWide(wideUsageSvg, 392, 196);
+    files.set('icons/usage-wide.png', wideUsagePng);
+    manifest['3_2'] = {
+        State: 0,
+        ViewParam: [{ Icon: 'icons/usage-wide.png', Text: '' }],
+    };
+    files.set('manifest.json', Buffer.from(JSON.stringify(manifest), 'utf-8'));
+    // Build ZIP with boundary validation
+    const orderedEntries = [...files.entries()];
+    const extraLengths = new Array(orderedEntries.length).fill(0);
+    for (let attempt = 0; attempt < 256; attempt++) {
+        const artifact = createZipInMemory(new Map(orderedEntries), extraLengths);
+        const invalidOffset = firstInvalidZipBoundaryOffset(artifact.zip);
+        if (invalidOffset == null)
+            return artifact.zip;
+        let targetIndex = -1;
+        for (let i = artifact.layouts.length - 1; i >= 0; i--) {
+            if (artifact.layouts[i].extraInsertOffset <= invalidOffset) {
+                targetIndex = i;
+                break;
+            }
+        }
+        if (targetIndex < 0)
+            return artifact.zip;
+        const currentExtra = extraLengths[targetIndex];
+        const extraInsertOffset = artifact.layouts[targetIndex].extraInsertOffset;
+        let shift = 1;
+        while (shift <= 512) {
+            if (invalidOffset < extraInsertOffset + currentExtra + shift)
+                break;
+            const candidate = artifact.zip[invalidOffset - shift];
+            if (candidate !== 0x00 && candidate !== 0x7c)
+                break;
+            shift += 1;
+        }
+        extraLengths[targetIndex] = normalizeExtraLength(extraLengths[targetIndex] + shift);
+        debug(TAG, `ZIP boundary invalid at ${invalidOffset}, shifting entry ${targetIndex} by ${shift} byte(s)`);
+    }
+    const fallback = createZipInMemory(new Map(orderedEntries), extraLengths).zip;
+    debug(TAG, `WARNING: ZIP boundary validation failed after search; stillValid=${validateZipBoundaries(fallback)}`);
+    return fallback;
+}
+/**
+ * Create a simple hash of the visual state for change detection.
+ */
+export function stateHash(stateEvt) {
+    const s = parseState(stateEvt);
+    const sessIds = s.allSessions.map(sess => sess.id).join(',');
+    return `${s.state}|${s.mode}|${s.projectName}|${s.modelName}|${s.fiveHourPercent}|${s.sevenDayPercent}|${s.totalTokens}|${s.totalCost}|${s.options.map(o => o.label).join(',')}|${s.currentTool}|${sessIds}`;
+}
+//# sourceMappingURL=image-renderer.js.map

package/dist/d200h/image-renderer.js.map

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

package/dist/daemon-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"daemon-server.d.ts","sourceRoot":"","sources":["../src/daemon-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,SAAS,MAAM,IAAI,CAAC;AAC3B,OAAO,EAAE,UAAU,EAA8B,MAAM,kBAAkB,CAAC;AAgH1E,OAAO,EAA8D,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AA8P/G;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,EAC5C,YAAY,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAClD,OAAO,CAST;AAkBD,iBAAS,iBAAiB,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,SAAS,GAAG,IAAI,CA+C1E;AAYD,iBAAS,yBAAyB,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI,CAStD;AAED,iBAAS,mBAAmB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAsBlE;AA6ED,gBAAgB;AAChB,wBAAgB,uBAAuB,CAAC,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAKzH;AACD,gBAAgB;AAChB,wBAAgB,wBAAwB,IAAI,IAAI,CAS/C;AACD,gBAAgB;AAChB,eAAO,MAAM,gBAAgB;;;;;CAK5B,CAAC;AAEF,iBAAe,mBAAmB,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA8F3H;AAoHD,iEAAiE;AACjE,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAsBtF;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,SAAS;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,EACnH,KAAK,EAAE,CAAC,GACP,CAAC,CAWH;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,aAAa,GAAG,WAAW,GAAG,UAAU,GAAG,aAAa,CAAA;CAAE,CAa3F;AAID,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AA+HD,wBAAsB,WAAW,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAgkIpE"}
+{"version":3,"file":"daemon-server.d.ts","sourceRoot":"","sources":["../src/daemon-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,SAAS,MAAM,IAAI,CAAC;AAC3B,OAAO,EAAE,UAAU,EAA8B,MAAM,kBAAkB,CAAC;AAgH1E,OAAO,EAA8D,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AA8P/G;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,EAC5C,YAAY,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAClD,OAAO,CAST;AAkBD,iBAAS,iBAAiB,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,SAAS,GAAG,IAAI,CA+C1E;AAYD,iBAAS,yBAAyB,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI,CAStD;AAED,iBAAS,mBAAmB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAsBlE;AA6ED,gBAAgB;AAChB,wBAAgB,uBAAuB,CAAC,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAKzH;AACD,gBAAgB;AAChB,wBAAgB,wBAAwB,IAAI,IAAI,CAS/C;AACD,gBAAgB;AAChB,eAAO,MAAM,gBAAgB;;;;;CAK5B,CAAC;AAEF,iBAAe,mBAAmB,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA8F3H;AAoHD,iEAAiE;AACjE,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAsBtF;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,SAAS;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,EACnH,KAAK,EAAE,CAAC,GACP,CAAC,CAWH;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,aAAa,GAAG,WAAW,GAAG,UAAU,GAAG,aAAa,CAAA;CAAE,CAa3F;AAID,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AA+HD,wBAAsB,WAAW,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA6mIpE"}

package/dist/daemon-server.js

@@ -1220,6 +1220,28 @@ export async function startDaemon(opts) {
             }));
             return;
         }
+        // Setup status — the ONE route a browser page may read cross-origin, and
+        // therefore the one route that must carry no secret. The Ulanzi Studio
+        // Property Inspector is a webview whose origin is not this daemon, so a
+        // plain fetch of /health is blocked by CORS and its setup stepper cannot
+        // tell "daemon down" from "daemon unreadable". `Access-Control-Allow-Origin`
+        // could NOT be added to /health to fix that: /health carries pairingToken,
+        // and ACAO there would hand the pairing token to any web page the user
+        // happens to visit (the request comes from their own machine, so it passes
+        // the local check). This payload is deliberately the public-health fields
+        // plus the session state word — no token, no modules, no session inventory.
+        if (req.method === 'GET' && pathname === '/setup-status') {
+            const snap = core.stateMachine.getSnapshot();
+            res.writeHead(200, {
+                'Content-Type': 'application/json',
+                'Cache-Control': 'no-store',
+                'Access-Control-Allow-Origin': '*',
+            });
+            res.end(JSON.stringify({
+                status: 'ok', mode: 'daemon', port, state: snap.state, isSwift: false,
+            }));
+            return;
+        }
         if (req.method === 'GET' && pathname === '/status') {
             const snap = core.stateMachine.getSnapshot();
             res.writeHead(200, { 'Content-Type': 'application/json' });
@@ -4551,6 +4573,17 @@ export async function startDaemon(opts) {
             let delivered = false;
             let via;
             let deliverReason;
+            if (!text || !sessionId) {
+                // The delivery block below (and its log) only runs when BOTH are
+                // present, so without this the whole turn vanished silently — the
+                // state the D200H reported as "voice does nothing". Both halves
+                // matter: an empty transcript, and a transcript with nowhere to go
+                // (no device session, no focused session).
+                const why = !text ? 'empty transcript' : 'no target session';
+                log(`[agentdeck] voice: ${why} from ${sink.describe()}`
+                    + ` (session ${sessionId.slice(0, 32) || 'none'},`
+                    + ` text ${text ? `"${text.slice(0, 40)}"` : 'none'}) — nothing delivered`);
+            }
             if (text && sessionId) {
                 if (sessionId === 'openclaw-gateway') {
                     // The gateway session has no bridge port: the generic
@@ -4686,7 +4719,20 @@ export async function startDaemon(opts) {
                 return;
             // Resolves the in-flight recordWithHelper below; a release that races
             // the max-duration stop is a harmless no-op.
-            void stopHelperRecording({ cancel: cmd.action === 'cancel' }).catch(() => { });
+            //
+            // Never swallow the rejection. When this leg silently failed, the capture
+            // ran to its 30s cap and transcribed mostly silence — the deck looked
+            // like it had ignored the key, and nothing anywhere said otherwise
+            // (2026-08-08: the helper's stdin read loop was blocked by an in-flight
+            // `generate`, so the stop line was not read for 25 s).
+            void stopHelperRecording({ cancel: cmd.action === 'cancel' })
+                .then((stopped) => {
+                if (!stopped)
+                    debug('voice', `host PTT ${cmd.action}: nothing was recording`);
+            })
+                .catch((err) => {
+                log(`[agentdeck] voice: host PTT ${cmd.action} failed: ${String(err).slice(0, 160)}`);
+            });
             return;
         }
         if (hostPttBusy)