@agentdeck/bridge 1.0.5 → 1.0.7

package/dist/trmnl/trmnl-settings.js

@@ -0,0 +1,177 @@
+/**
+ * TRMNL BYOS settings — reads/writes the `trmnl` block in
+ * ~/.agentdeck/settings.json, preserving all other keys (same pattern as
+ * pixoo-settings.ts).
+ *
+ * Shape:
+ *   "trmnl": {
+ *     "enabled": false,            // force the module on even with no device yet
+ *     "refreshRate": 180,          // seconds between device polls
+ *     "autoRegister": true,        // auto-enroll a device that hits /api/setup
+ *     "devices": [ { mac, apiKey, friendlyId, name? } ]
+ *   }
+ */
+import { readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+import { randomBytes } from 'crypto';
+// Resolve lazily so tests (and explicit pinning) can redirect via
+// AGENTDECK_DATA_DIR, matching apme/settings.ts and esp32-serial.ts.
+function settingsDir() {
+    return process.env.AGENTDECK_DATA_DIR || join(homedir(), '.agentdeck');
+}
+function settingsPath() {
+    return join(settingsDir(), 'settings.json');
+}
+export const TRMNL_DEFAULT_REFRESH = 180;
+/**
+ * Cadence used only while an agent is AWAITING the user. NOT used for "working":
+ * a battery e-ink panel deep-sleeps between polls and full-flashes the screen on
+ * every refresh, so we only tighten the loop when the user actually needs to act.
+ */
+export const TRMNL_DEFAULT_REFRESH_ACTIVE = 60;
+/** Floor on any cadence — too-frequent polls drain the panel battery + flash it. */
+export const TRMNL_MIN_REFRESH = 30;
+/**
+ * Seconds the firmware waits for the image download before giving up (its
+ * `image_url_timeout`). Generous so a slow/flaky WiFi link doesn't trip the
+ * device's "not responding" (WIFI_FAILED) screen. Firmware caps at ~65s, so we
+ * keep a healthy default (most "not responding" cycles are a lossy image GET
+ * timing out, not a server error — see docs/devices.md TRMNL section).
+ */
+export const TRMNL_DEFAULT_IMAGE_TIMEOUT = 50;
+/** Hard cap the firmware honors (it clamps `image_url_timeout` ~65s internally). */
+export const TRMNL_MAX_IMAGE_TIMEOUT = 65;
+/**
+ * RSSI (dBm) at or below which the panel's WiFi link is treated as weak/lossy.
+ * A weak link is the dominant real-world cause of "not responding" (WIFI_FAILED):
+ * the image download drops packets and times out. RSSI is sent by the firmware on
+ * every poll, so we can react per-poll. (-78 ≈ marginal; below it, retransmits
+ * stack up and the default window can be too tight.)
+ */
+export const TRMNL_WEAK_RSSI_DBM = -78;
+/** Image-download window served on a weak link — near the firmware cap. */
+export const TRMNL_WEAK_LINK_IMAGE_TIMEOUT = 60;
+/**
+ * Cadence for a poll. We only speed up for AWAITING (the user needs to act);
+ * "working" stays on the slow cadence because a deep-sleep e-ink panel can't be
+ * pushed and each wake full-flashes the screen + costs battery.
+ */
+export function effectiveRefreshRate(cfg, activity) {
+    return Math.max(TRMNL_MIN_REFRESH, activity.awaiting > 0 ? cfg.refreshActive : cfg.refreshRate);
+}
+/**
+ * Image-download timeout (seconds) for a single poll. Widens toward the firmware
+ * cap when the panel reports a weak WiFi signal, so a lossy image GET still has
+ * the maximum window to finish before the firmware shows "not responding"
+ * (WIFI_FAILED) — the #1 source of TRMNL flicker on a marginal link. A strong link
+ * keeps the lower default so a genuinely dead link doesn't hold the radio on
+ * (battery). RSSI absent (older firmware) ⇒ default; the default itself is already
+ * generous. Clamped to [5, firmware cap].
+ */
+export function effectiveImageTimeout(cfg, opts = {}) {
+    let t = cfg.imageUrlTimeout;
+    if (opts.rssi != null && Number.isFinite(opts.rssi) && opts.rssi <= TRMNL_WEAK_RSSI_DBM) {
+        t = Math.max(t, TRMNL_WEAK_LINK_IMAGE_TIMEOUT);
+    }
+    return Math.min(TRMNL_MAX_IMAGE_TIMEOUT, Math.max(5, Math.floor(t)));
+}
+function readSettings() {
+    try {
+        return JSON.parse(readFileSync(settingsPath(), 'utf-8'));
+    }
+    catch {
+        return {};
+    }
+}
+function writeSettings(settings) {
+    mkdirSync(settingsDir(), { recursive: true });
+    writeFileSync(settingsPath(), JSON.stringify(settings, null, 2) + '\n');
+}
+/** Load the trmnl config with defaults filled in. */
+export function loadTrmnlConfig() {
+    const raw = (readSettings().trmnl ?? {});
+    const refreshRate = typeof raw.refreshRate === 'number' && raw.refreshRate >= 5 ? Math.floor(raw.refreshRate) : TRMNL_DEFAULT_REFRESH;
+    const refreshActive = typeof raw.refreshActive === 'number' && raw.refreshActive >= 5
+        ? Math.floor(raw.refreshActive)
+        : TRMNL_DEFAULT_REFRESH_ACTIVE;
+    const imageUrlTimeout = typeof raw.imageUrlTimeout === 'number' && raw.imageUrlTimeout > 0
+        ? Math.min(TRMNL_MAX_IMAGE_TIMEOUT, Math.floor(raw.imageUrlTimeout))
+        : TRMNL_DEFAULT_IMAGE_TIMEOUT;
+    return {
+        enabled: raw.enabled === true,
+        refreshRate,
+        refreshActive,
+        imageUrlTimeout,
+        autoRegister: raw.autoRegister !== false, // default on
+        devices: Array.isArray(raw.devices) ? raw.devices.filter((d) => d && typeof d.mac === 'string') : [],
+    };
+}
+function saveTrmnlConfig(cfg) {
+    const settings = readSettings();
+    settings.trmnl = cfg;
+    writeSettings(settings);
+}
+/**
+ * Normalize a MAC to a stable identity key. A canonical 12-hex address becomes
+ * uppercase colon-separated pairs; any other id (some firmware/cloud setups
+ * report non-standard or punctuated identifiers) collapses to its bare uppercase
+ * hex digits. Returning the raw, untrimmed string for the odd case would orphan
+ * or duplicate a device whose punctuation varies between polls — so we always
+ * derive a deterministic key from the hex content.
+ */
+export function normalizeMac(mac) {
+    const hex = (mac || '').replace(/[^0-9a-fA-F]/g, '').toUpperCase();
+    if (hex.length === 12)
+        return hex.match(/.{2}/g).join(':');
+    return hex || (mac || '').trim().toUpperCase();
+}
+/** True when two MAC spellings resolve to the same canonical identity. */
+export function sameMac(a, b) {
+    return normalizeMac(a) === normalizeMac(b);
+}
+export function findDeviceByMac(mac) {
+    return loadTrmnlConfig().devices.find((d) => sameMac(d.mac, mac));
+}
+function genFriendlyId() {
+    // 6 chars from an unambiguous base32 alphabet (no 0/1/O/I).
+    const alphabet = 'ABCDEFGHJKLMNPQRSTUVWXYZ23456789';
+    const bytes = randomBytes(6);
+    let out = '';
+    for (let i = 0; i < 6; i++)
+        out += alphabet[bytes[i] % alphabet.length];
+    return out;
+}
+/**
+ * Find or create a device record for the given MAC. Returns the device and
+ * whether it was newly created. Respects `autoRegister`: when off, a new MAC
+ * is NOT persisted and `created` is false with `device` undefined.
+ */
+export function ensureDevice(mac, name) {
+    const cfg = loadTrmnlConfig();
+    const norm = normalizeMac(mac);
+    const existing = cfg.devices.find((d) => sameMac(d.mac, mac));
+    if (existing)
+        return { device: existing, created: false };
+    if (!cfg.autoRegister)
+        return { created: false };
+    const device = {
+        mac: norm,
+        apiKey: randomBytes(16).toString('hex'),
+        friendlyId: genFriendlyId(),
+        name,
+    };
+    cfg.devices.push(device);
+    saveTrmnlConfig(cfg);
+    return { device, created: true };
+}
+export function removeDevice(mac) {
+    const cfg = loadTrmnlConfig();
+    const filtered = cfg.devices.filter((d) => !sameMac(d.mac, mac));
+    if (filtered.length === cfg.devices.length)
+        return false;
+    cfg.devices = filtered;
+    saveTrmnlConfig(cfg);
+    return true;
+}
+//# sourceMappingURL=trmnl-settings.js.map

package/dist/trmnl/trmnl-settings.js.map

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

package/dist/trmnl/trmnl-telemetry.d.ts

@@ -0,0 +1,47 @@
+export interface DeviceTelemetry {
+    /** Normalized MAC identity (matches TrmnlDevice.mac). */
+    mac: string;
+    fwVersion: string;
+    batteryVoltage: number | null;
+    rssi: number | null;
+    width: number | null;
+    height: number | null;
+    /** Cadence the device says it's polling at (we still dictate it on response). */
+    refreshRate: number | null;
+    userAgent: string;
+    /** Epoch ms of the most recent poll. */
+    lastSeen: number;
+}
+export interface TelemetryInput {
+    fwVersion?: string;
+    batteryVoltage?: number | null;
+    rssi?: number | null;
+    width?: number | null;
+    height?: number | null;
+    refreshRate?: number | null;
+    userAgent?: string;
+}
+/**
+ * Upsert the last-seen telemetry for a device. `now` is injected at the daemon
+ * boundary (defaults to wall clock) so layout/render code stays clock-free.
+ * Returns the previous `lastSeen` (epoch ms) so callers can detect poll gaps.
+ */
+export declare function recordTelemetry(mac: string, t: TelemetryInput, now?: number): number | null;
+/** Snapshot of all known device telemetry, most-recently-seen first. */
+export declare function getTelemetry(): DeviceTelemetry[];
+/** Telemetry plus derived freshness — `secondsSinceSeen` and a `stale` flag. */
+export interface DeviceHealth extends DeviceTelemetry {
+    secondsSinceSeen: number;
+    /** True when the panel hasn't polled in over 2× its expected cadence. */
+    stale: boolean;
+}
+/**
+ * Telemetry annotated with health. A panel that hasn't polled within 2× its
+ * cadence is flagged `stale` so the dashboard can distinguish "panel stuck /
+ * offline" from "nothing changed". `now`/`refreshRate` are injected at the daemon
+ * boundary so this stays clock- and config-free.
+ */
+export declare function getTelemetryHealth(refreshRate: number, now?: number): DeviceHealth[];
+/** Test helper — clear the runtime map. */
+export declare function _resetTelemetry(): void;
+//# sourceMappingURL=trmnl-telemetry.d.ts.map

package/dist/trmnl/trmnl-telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trmnl-telemetry.d.ts","sourceRoot":"","sources":["../../src/trmnl/trmnl-telemetry.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,eAAe;IAC9B,yDAAyD;IACzD,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,iFAAiF;IACjF,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,cAAc,EAAE,GAAG,GAAE,MAAmB,GAAG,MAAM,GAAG,IAAI,CAgBvG;AAED,wEAAwE;AACxE,wBAAgB,YAAY,IAAI,eAAe,EAAE,CAEhD;AAED,gFAAgF;AAChF,MAAM,WAAW,YAAa,SAAQ,eAAe;IACnD,gBAAgB,EAAE,MAAM,CAAC;IACzB,yEAAyE;IACzE,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,GAAE,MAAmB,GAAG,YAAY,EAAE,CAMhG;AAED,2CAA2C;AAC3C,wBAAgB,eAAe,IAAI,IAAI,CAEtC"}

package/dist/trmnl/trmnl-telemetry.js

@@ -0,0 +1,56 @@
+/**
+ * TRMNL device telemetry — a runtime-only, per-MAC snapshot of the headers a
+ * BYOS panel reports on each /api/setup or /api/display poll (firmware version,
+ * battery voltage, WiFi signal, panel resolution). This is NOT persisted to
+ * settings.json: polls arrive every ~180s and writing the settings file on each
+ * one would thrash it and race the user's manual edits. The daemon status
+ * snapshot reads this map for diagnostics; it's lost on daemon restart, which is
+ * fine — the next poll repopulates it.
+ */
+import { normalizeMac } from './trmnl-settings.js';
+const telemetry = new Map();
+/**
+ * Upsert the last-seen telemetry for a device. `now` is injected at the daemon
+ * boundary (defaults to wall clock) so layout/render code stays clock-free.
+ * Returns the previous `lastSeen` (epoch ms) so callers can detect poll gaps.
+ */
+export function recordTelemetry(mac, t, now = Date.now()) {
+    const key = normalizeMac(mac);
+    if (!key)
+        return null;
+    const prevLastSeen = telemetry.get(key)?.lastSeen ?? null;
+    telemetry.set(key, {
+        mac: key,
+        fwVersion: t.fwVersion ?? '',
+        batteryVoltage: t.batteryVoltage ?? null,
+        rssi: t.rssi ?? null,
+        width: t.width ?? null,
+        height: t.height ?? null,
+        refreshRate: t.refreshRate ?? null,
+        userAgent: t.userAgent ?? '',
+        lastSeen: now,
+    });
+    return prevLastSeen;
+}
+/** Snapshot of all known device telemetry, most-recently-seen first. */
+export function getTelemetry() {
+    return [...telemetry.values()].sort((a, b) => b.lastSeen - a.lastSeen);
+}
+/**
+ * Telemetry annotated with health. A panel that hasn't polled within 2× its
+ * cadence is flagged `stale` so the dashboard can distinguish "panel stuck /
+ * offline" from "nothing changed". `now`/`refreshRate` are injected at the daemon
+ * boundary so this stays clock- and config-free.
+ */
+export function getTelemetryHealth(refreshRate, now = Date.now()) {
+    const staleAfterMs = Math.max(30, refreshRate) * 2 * 1000;
+    return getTelemetry().map((t) => {
+        const ageMs = now - t.lastSeen;
+        return { ...t, secondsSinceSeen: Math.round(ageMs / 1000), stale: ageMs > staleAfterMs };
+    });
+}
+/** Test helper — clear the runtime map. */
+export function _resetTelemetry() {
+    telemetry.clear();
+}
+//# sourceMappingURL=trmnl-telemetry.js.map

package/dist/trmnl/trmnl-telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trmnl-telemetry.js","sourceRoot":"","sources":["../../src/trmnl/trmnl-telemetry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AA2BnD,MAAM,SAAS,GAAG,IAAI,GAAG,EAA2B,CAAC;AAErD;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW,EAAE,CAAiB,EAAE,MAAc,IAAI,CAAC,GAAG,EAAE;IACtF,MAAM,GAAG,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,MAAM,YAAY,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,QAAQ,IAAI,IAAI,CAAC;IAC1D,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE;QACjB,GAAG,EAAE,GAAG;QACR,SAAS,EAAE,CAAC,CAAC,SAAS,IAAI,EAAE;QAC5B,cAAc,EAAE,CAAC,CAAC,cAAc,IAAI,IAAI;QACxC,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,IAAI;QACpB,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI;QACtB,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,IAAI;QACxB,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,IAAI;QAClC,SAAS,EAAE,CAAC,CAAC,SAAS,IAAI,EAAE;QAC5B,QAAQ,EAAE,GAAG;KACd,CAAC,CAAC;IACH,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,YAAY;IAC1B,OAAO,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;AACzE,CAAC;AASD;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,WAAmB,EAAE,MAAc,IAAI,CAAC,GAAG,EAAE;IAC9E,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,WAAW,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;IAC1D,OAAO,YAAY,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAC9B,MAAM,KAAK,GAAG,GAAG,GAAG,CAAC,CAAC,QAAQ,CAAC;QAC/B,OAAO,EAAE,GAAG,CAAC,EAAE,gBAAgB,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,GAAG,YAAY,EAAE,CAAC;IAC3F,CAAC,CAAC,CAAC;AACL,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,eAAe;IAC7B,SAAS,CAAC,KAAK,EAAE,CAAC;AACpB,CAAC"}

package/dist/whisper-server-manager.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Whisper-server singleton manager.
+ *
+ * Fixed port 9100 — one server shared across all agentdeck sessions.
+ * Info file at ~/.agentdeck/whisper-server.json for discovery.
+ * Last session to exit kills the server.
+ */
+export declare const WHISPER_SERVER_PORT = 9100;
+/**
+ * Ensure a whisper-server is running on the singleton port.
+ * Returns port on success, null if unavailable (binary missing, model missing, etc).
+ */
+export declare function ensureWhisperServer(serverBin: string, modelPath: string): Promise<number | null>;
+/**
+ * Release the whisper-server if no other sessions remain.
+ * Call AFTER deregisterSession() so the count is already decremented.
+ */
+export declare function releaseWhisperServer(): void;
+//# sourceMappingURL=whisper-server-manager.d.ts.map

package/dist/whisper-server-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whisper-server-manager.d.ts","sourceRoot":"","sources":["../src/whisper-server-manager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAaH,eAAO,MAAM,mBAAmB,OAAO,CAAC;AA2DxC;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA6ExB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAiB3C"}

package/dist/whisper-server-manager.js

@@ -0,0 +1,171 @@
+/**
+ * Whisper-server singleton manager.
+ *
+ * Fixed port 9100 — one server shared across all agentdeck sessions.
+ * Info file at ~/.agentdeck/whisper-server.json for discovery.
+ * Last session to exit kills the server.
+ */
+import { spawn } from 'child_process';
+import { readFileSync, writeFileSync, renameSync, unlinkSync, mkdirSync, existsSync, } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+import { randomUUID } from 'crypto';
+import { listActive } from './session-registry.js';
+import { debug } from './logger.js';
+export const WHISPER_SERVER_PORT = 9100;
+const INFO_DIR = join(homedir(), '.agentdeck');
+const INFO_FILE = join(INFO_DIR, 'whisper-server.json');
+function ensureDir() {
+    if (!existsSync(INFO_DIR)) {
+        mkdirSync(INFO_DIR, { recursive: true });
+    }
+}
+function readInfo() {
+    try {
+        return JSON.parse(readFileSync(INFO_FILE, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+function writeInfo(info) {
+    ensureDir();
+    const tmp = join(INFO_DIR, `.whisper-server.${randomUUID()}.tmp`);
+    writeFileSync(tmp, JSON.stringify(info, null, 2), 'utf-8');
+    renameSync(tmp, INFO_FILE);
+}
+function removeInfo() {
+    try {
+        unlinkSync(INFO_FILE);
+    }
+    catch { /* already gone */ }
+}
+function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function isServerResponding(port) {
+    try {
+        await fetch(`http://127.0.0.1:${port}`, { signal: AbortSignal.timeout(1000) });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function pollUntilReady(port, maxMs) {
+    const start = Date.now();
+    while (Date.now() - start < maxMs) {
+        if (await isServerResponding(port))
+            return true;
+        await new Promise((r) => setTimeout(r, 500));
+    }
+    return false;
+}
+/**
+ * Ensure a whisper-server is running on the singleton port.
+ * Returns port on success, null if unavailable (binary missing, model missing, etc).
+ */
+export async function ensureWhisperServer(serverBin, modelPath) {
+    if (!existsSync(serverBin)) {
+        debug('WhisperMgr', `whisper-server not found at ${serverBin}, skipping`);
+        return null;
+    }
+    // 1. Check existing info file
+    const info = readInfo();
+    if (info) {
+        if (isProcessAlive(info.pid)) {
+            // PID alive — check if server is responding
+            if (await isServerResponding(info.port)) {
+                debug('WhisperMgr', `Reusing existing server (pid=${info.pid}, port=${info.port})`);
+                return info.port;
+            }
+            // PID alive but not responding — model may still be loading, poll 30s
+            debug('WhisperMgr', `Server pid=${info.pid} alive but not responding, waiting for model load...`);
+            if (await pollUntilReady(info.port, 30_000)) {
+                debug('WhisperMgr', `Server became ready (pid=${info.pid}, port=${info.port})`);
+                return info.port;
+            }
+            // Still not responding after 30s — stale
+            debug('WhisperMgr', `Server pid=${info.pid} never responded, treating as stale`);
+        }
+        // PID dead or stale — clean up
+        removeInfo();
+    }
+    // 2. Spawn new server (detached so it survives parent exit)
+    debug('WhisperMgr', `Starting whisper-server on port ${WHISPER_SERVER_PORT}...`);
+    const args = [
+        '--model', modelPath,
+        '--port', String(WHISPER_SERVER_PORT),
+        '--host', '127.0.0.1',
+        '-l', 'auto',
+        '--no-timestamps',
+        '--convert',
+        '--prompt', 'coding, programming, Claude, terminal, git, function, component, API',
+    ];
+    const proc = spawn(serverBin, args, {
+        stdio: 'ignore',
+        detached: true,
+    });
+    proc.unref();
+    const pid = proc.pid;
+    if (!pid) {
+        debug('WhisperMgr', 'Failed to spawn whisper-server (no pid)');
+        return null;
+    }
+    // 3. Brief wait to detect immediate crash (e.g. port conflict)
+    await new Promise((r) => setTimeout(r, 200));
+    if (!isProcessAlive(pid)) {
+        debug('WhisperMgr', `whisper-server died immediately (pid=${pid}), checking for existing server...`);
+        // Another process may have won the port race — re-check info file
+        const otherInfo = readInfo();
+        if (otherInfo && isProcessAlive(otherInfo.pid) && await isServerResponding(otherInfo.port)) {
+            debug('WhisperMgr', `Found winner server (pid=${otherInfo.pid}, port=${otherInfo.port})`);
+            return otherInfo.port;
+        }
+        removeInfo();
+        return null;
+    }
+    // 4. Write info file
+    writeInfo({ pid, port: WHISPER_SERVER_PORT, modelPath, startedAt: new Date().toISOString() });
+    // 5. Poll until ready (up to 30s for model loading)
+    if (await pollUntilReady(WHISPER_SERVER_PORT, 30_000)) {
+        debug('WhisperMgr', `whisper-server ready on port ${WHISPER_SERVER_PORT} (pid=${pid})`);
+        return WHISPER_SERVER_PORT;
+    }
+    debug('WhisperMgr', 'whisper-server failed to become ready within 30s');
+    return null;
+}
+/**
+ * Release the whisper-server if no other sessions remain.
+ * Call AFTER deregisterSession() so the count is already decremented.
+ */
+export function releaseWhisperServer() {
+    const activeSessions = listActive();
+    if (activeSessions.length > 0) {
+        debug('WhisperMgr', `Keeping whisper-server alive (${activeSessions.length} session(s) remain)`);
+        return;
+    }
+    const info = readInfo();
+    if (!info)
+        return;
+    debug('WhisperMgr', `Killing whisper-server (pid=${info.pid})`);
+    try {
+        process.kill(info.pid, 'SIGTERM');
+    }
+    catch { /* already dead */ }
+    // Force kill after 3s
+    setTimeout(() => {
+        try {
+            process.kill(info.pid, 'SIGKILL');
+        }
+        catch { /* already dead */ }
+    }, 3000);
+    removeInfo();
+}
+//# sourceMappingURL=whisper-server-manager.js.map

package/dist/whisper-server-manager.js.map

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

package/fm-helper/Info.plist

@@ -0,0 +1,27 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<!--
+  Embedded (via `-sectcreate __TEXT __info_plist`) into the single-file
+  agentdeck-fm-helper binary, because TCC refuses to *prompt* for a
+  privacy-sensitive service unless the requesting code carries a usage
+  description — and "refuses" means SIGABRT, not an error return. Without this
+  the helper dies the first time it touches speech recognition or the mic on any
+  machine whose grant is not already on record, which is exactly what happened
+  once a rebuild changed the binary's cdhash and invalidated the old grant.
+
+  The identifier must match the `codesign --identifier` in
+  scripts/build-fm-helper.mjs: TCC keys an ad-hoc signed binary's grant on that
+  identifier, and a mismatch reads as a different app.
+-->
+<plist version="1.0">
+<dict>
+  <key>CFBundleIdentifier</key>
+  <string>bound.serendipity.agentdeck.fm-helper</string>
+  <key>CFBundleName</key>
+  <string>AgentDeck Voice Helper</string>
+  <key>NSMicrophoneUsageDescription</key>
+  <string>AgentDeck records a short push-to-talk clip so your spoken instruction can be transcribed on this Mac and sent to your coding agent.</string>
+  <key>NSSpeechRecognitionUsageDescription</key>
+  <string>AgentDeck transcribes your push-to-talk clip with Apple's on-device recognizer so your spoken instruction can be sent to your coding agent. The audio never leaves this Mac.</string>
+</dict>
+</plist>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentdeck/bridge",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "type": "module",
   "license": "MIT",
   "repository": {
@@ -24,18 +24,7 @@
   "bin": {
     "agentdeck": "./dist/cli.js"
   },
-  "scripts": {
-    "build": "tsc",
-    "build:fm-helper": "node scripts/build-fm-helper.mjs",
-    "prepack": "node scripts/build-fm-helper.mjs",
-    "dev": "tsc --watch",
-    "clean": "rm -rf dist",
-    "typecheck": "tsc --noEmit",
-    "start": "node dist/cli.js claude"
-  },
   "dependencies": {
-    "@agentdeck/hooks": "workspace:*",
-    "@agentdeck/shared": "workspace:*",
     "@anthropic-ai/sdk": "^0.111.0",
     "bonjour-service": "^1.3.0",
     "commander": "^14.0.3",
@@ -43,7 +32,9 @@
     "qrcode": "^1.5.4",
     "sharp": "^0.34.5",
     "strip-ansi": "^7.2.0",
-    "ws": "^8.20.0"
+    "ws": "^8.20.0",
+    "@agentdeck/hooks": "1.0.7",
+    "@agentdeck/shared": "1.0.7"
   },
   "optionalDependencies": {
     "@picovoice/porcupine-node": "^4.0.2",
@@ -59,5 +50,13 @@
     "@types/qrcode": "^1.5.6",
     "@types/ws": "^8.18.1",
     "typescript": "^6.0.3"
+  },
+  "scripts": {
+    "build": "tsc",
+    "build:fm-helper": "node scripts/build-fm-helper.mjs",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "start": "node dist/cli.js claude"
   }
-}
+}

package/scripts/build-fm-helper.mjs

@@ -1,14 +1,27 @@
 #!/usr/bin/env node
 import { execFileSync } from 'node:child_process';
-import { chmodSync, mkdirSync } from 'node:fs';
+import { chmodSync, existsSync, mkdirSync } from 'node:fs';
 import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
 const root = dirname(dirname(fileURLToPath(import.meta.url)));
 const source = join(root, 'fm-helper', 'AgentDeckFMHelper.swift');
-const out = join(root, 'assets', 'fm-helper', 'agentdeck-fm-helper');
+const plist = join(root, 'fm-helper', 'Info.plist');
+const defaultOut = join(root, 'assets', 'fm-helper', 'agentdeck-fm-helper');
 const arch = process.arch === 'arm64' ? 'arm64' : 'x86_64';
 const target = `${arch}-apple-macos26.0`;
+/** Must match CFBundleIdentifier in fm-helper/Info.plist — see the note there. */
+const signingIdentifier = 'bound.serendipity.agentdeck.fm-helper';
+
+// The daemon's source-compiled fallback (foundation-models-helper.ts) runs this
+// same script with --out so the plist embedding and the signature can't drift
+// between the packaged binary and a locally rebuilt one.
+const outFlag = process.argv.indexOf('--out');
+const out = outFlag >= 0 ? process.argv[outFlag + 1] : defaultOut;
+if (outFlag >= 0 && !out) {
+  console.error('[fm-helper] --out requires a path');
+  process.exit(1);
+}
 
 if (process.platform !== 'darwin') {
   console.log('[fm-helper] skipped: darwin only');
@@ -21,6 +34,25 @@ const swiftc = execFileSync('/usr/bin/xcrun', ['--find', 'swiftc'], { encoding:
 // stdlib can't be found ("unable to load standard library for target ..."). Pass
 // the SDK path explicitly so the build is reproducible from the npm lifecycle.
 const sdk = execFileSync('/usr/bin/xcrun', ['--sdk', 'macosx', '--show-sdk-path'], { encoding: 'utf8' }).trim();
-execFileSync(swiftc, ['-parse-as-library', '-sdk', sdk, '-target', target, source, '-o', out], { stdio: 'inherit' });
+const args = ['-parse-as-library', '-sdk', sdk, '-target', target, source, '-o', out];
+// A single-file tool has no bundle, so its usage descriptions have to live in an
+// __info_plist section: TCC aborts (SIGABRT, not an error return) the moment it
+// needs to prompt for the mic or speech recognition without one.
+if (existsSync(plist)) {
+  args.push('-Xlinker', '-sectcreate', '-Xlinker', '__TEXT', '-Xlinker', '__info_plist', '-Xlinker', plist);
+} else {
+  console.warn(`[fm-helper] WARNING: ${plist} missing — voice capture will crash under TCC`);
+}
+execFileSync(swiftc, args, { stdio: 'inherit' });
 chmodSync(out, 0o755);
+// Ad-hoc signing gives TCC a stable identity to hang the grant on. It is not
+// about trust: an unsigned binary's grant is keyed on the raw cdhash alone, so
+// the prompt cannot name the helper and the user sees a nameless request.
+try {
+  execFileSync('/usr/bin/codesign', [
+    '--force', '--sign', '-', '--identifier', signingIdentifier, out,
+  ], { stdio: ['ignore', 'ignore', 'pipe'] });
+} catch (err) {
+  console.warn(`[fm-helper] WARNING: ad-hoc codesign failed: ${String(err).slice(0, 160)}`);
+}
 console.log(`[fm-helper] built ${out}`);