@agentdeck/bridge 1.0.3 → 1.0.5

package/dist/weather.js

@@ -0,0 +1,206 @@
+/**
+ * Glance weather provider (Open-Meteo) — daemon-side module for the card-feed
+ * sleep dashboard. The device never fetches weather itself; the daemon fetches,
+ * caches, and pre-renders it into `CardFeedResponse.glance.weather`
+ * (shared/src/protocol.ts § Glance).
+ *
+ * Open-Meteo is key-less and free for non-commercial local use; one bounded
+ * request per cache window. Config comes from settings.json:
+ *
+ *   "weather": { "lat": 37.57, "lon": 126.98, "place": "Seoul" }
+ *
+ * No config → no weather in the glance (never a guess, never IP geolocation).
+ */
+import { GLANCE_RAIN_PROBABILITY_MIN } from '@agentdeck/shared';
+/** Serve from cache inside this window — weather cadence is slower than the
+ *  fastest pull cadence (900s), so a fresh fetch per pull would be waste. */
+export const WEATHER_CACHE_MS = 30 * 60 * 1000;
+/** After a fetch failure, keep serving the last good report up to this age —
+ *  a flaky WAN must degrade to slightly-old weather, not a blank panel. */
+export const WEATHER_STALE_SERVE_MS = 3 * 60 * 60 * 1000;
+/** External peer await — timeout is first-line, not optional. */
+export const WEATHER_FETCH_TIMEOUT_MS = 5000;
+export function parseWeatherSettings(settings) {
+    const w = settings?.weather;
+    if (!w || typeof w !== 'object')
+        return null;
+    const lat = Number(w.lat);
+    const lon = Number(w.lon);
+    if (!Number.isFinite(lat) || !Number.isFinite(lon))
+        return null;
+    if (Math.abs(lat) > 90 || Math.abs(lon) > 180)
+        return null;
+    return {
+        lat,
+        lon,
+        ...(typeof w.place === 'string' && w.place ? { place: w.place } : {}),
+    };
+}
+/** WMO weather interpretation code → one short summary word. Kept ASCII so
+ *  every panel font can draw it; codes ride alongside for icon-capable
+ *  clients. */
+export function wmoSummary(code) {
+    if (code === undefined || !Number.isFinite(code))
+        return '';
+    if (code === 0)
+        return 'Clear';
+    if (code <= 2)
+        return 'Fair';
+    if (code === 3)
+        return 'Cloudy';
+    if (code === 45 || code === 48)
+        return 'Fog';
+    if (code >= 51 && code <= 57)
+        return 'Drizzle';
+    if (code >= 61 && code <= 67)
+        return 'Rain';
+    if (code >= 71 && code <= 77)
+        return 'Snow';
+    if (code >= 80 && code <= 82)
+        return 'Showers';
+    if (code === 85 || code === 86)
+        return 'Snow';
+    if (code >= 95)
+        return 'Storm';
+    return 'Cloudy';
+}
+export function buildForecastUrl(cfg) {
+    const p = new URLSearchParams({
+        latitude: String(cfg.lat),
+        longitude: String(cfg.lon),
+        current: 'temperature_2m,weather_code',
+        hourly: 'precipitation_probability',
+        daily: 'weather_code,temperature_2m_min,temperature_2m_max,precipitation_probability_max',
+        timezone: 'auto',
+        forecast_days: '2',
+    });
+    return `https://api.open-meteo.com/v1/forecast?${p.toString()}`;
+}
+const hmOf = (iso) => iso.slice(11, 16);
+const dayOf = (iso) => iso.slice(0, 10);
+/** First remaining rain window today: contiguous hours ≥ the probability
+ *  floor, starting from the current hour. */
+export function findTodayRainWindow(hourly, now) {
+    const times = hourly?.time ?? [];
+    const probs = hourly?.precipitation_probability ?? [];
+    const today = `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, '0')}-${String(now.getDate()).padStart(2, '0')}`;
+    const nowHm = `${String(now.getHours()).padStart(2, '0')}:00`;
+    let start;
+    let end;
+    let peak = 0;
+    for (let i = 0; i < times.length && i < probs.length; i++) {
+        const t = times[i];
+        if (dayOf(t) !== today) {
+            if (start)
+                break; // window ran to midnight
+            continue;
+        }
+        const hm = hmOf(t);
+        if (hm < nowHm)
+            continue;
+        const p = probs[i];
+        if (typeof p === 'number' && p >= GLANCE_RAIN_PROBABILITY_MIN) {
+            if (!start)
+                start = hm;
+            end = hm;
+            if (p > peak)
+                peak = p;
+        }
+        else if (start) {
+            break; // window closed
+        }
+    }
+    if (!start)
+        return undefined;
+    const win = { startHm: start, probability: Math.round(peak) };
+    if (end && end !== start)
+        win.endHm = end;
+    return win;
+}
+export function toGlanceWeather(raw, cfg, now) {
+    const out = {};
+    if (cfg.place)
+        out.place = cfg.place;
+    const cur = raw.current;
+    if (cur && typeof cur.temperature_2m === 'number')
+        out.tempC = Math.round(cur.temperature_2m);
+    if (cur && typeof cur.weather_code === 'number') {
+        out.code = cur.weather_code;
+        out.summary = wmoSummary(cur.weather_code);
+    }
+    const d = raw.daily;
+    if (d?.time?.length) {
+        const todayMin = d.temperature_2m_min?.[0];
+        const todayMax = d.temperature_2m_max?.[0];
+        if (typeof todayMin === 'number')
+            out.todayMinC = Math.round(todayMin);
+        if (typeof todayMax === 'number')
+            out.todayMaxC = Math.round(todayMax);
+        if (d.time.length > 1) {
+            const t = { summary: wmoSummary(d.weather_code?.[1]) };
+            if (typeof d.weather_code?.[1] === 'number')
+                t.code = d.weather_code[1];
+            if (typeof d.temperature_2m_min?.[1] === 'number')
+                t.minC = Math.round(d.temperature_2m_min[1]);
+            if (typeof d.temperature_2m_max?.[1] === 'number')
+                t.maxC = Math.round(d.temperature_2m_max[1]);
+            if (typeof d.precipitation_probability_max?.[1] === 'number') {
+                t.rainProbability = Math.round(d.precipitation_probability_max[1]);
+            }
+            out.tomorrow = t;
+        }
+    }
+    const rain = findTodayRainWindow(raw.hourly, now);
+    if (rain)
+        out.rain = rain;
+    return out;
+}
+export class WeatherProvider {
+    fetchImpl;
+    log;
+    cache = null;
+    inflight = null;
+    constructor(fetchImpl = fetch, log = () => { }) {
+        this.fetchImpl = fetchImpl;
+        this.log = log;
+    }
+    /** Current weather for `cfg`, from cache when fresh. Resolves `undefined`
+     *  when unconfigured or when no report (fresh or stale-servable) exists —
+     *  the glance simply omits weather. Never throws. */
+    async get(cfg, now = Date.now()) {
+        if (!cfg)
+            return undefined;
+        const key = `${cfg.lat},${cfg.lon}`;
+        const cached = this.cache;
+        if (cached && cached.key === key && now - cached.at < WEATHER_CACHE_MS)
+            return cached.data;
+        if (this.inflight)
+            return this.inflight;
+        this.inflight = this.fetchFresh(cfg, key, now).finally(() => { this.inflight = null; });
+        return this.inflight;
+    }
+    async fetchFresh(cfg, key, now) {
+        const ctl = new AbortController();
+        const timer = setTimeout(() => ctl.abort(), WEATHER_FETCH_TIMEOUT_MS);
+        try {
+            const res = await this.fetchImpl(buildForecastUrl(cfg), { signal: ctl.signal });
+            if (!res.ok)
+                throw new Error(`open-meteo HTTP ${res.status}`);
+            const raw = (await res.json());
+            const data = toGlanceWeather(raw, cfg, new Date(now));
+            this.cache = { key, at: now, data };
+            return data;
+        }
+        catch (err) {
+            this.log(`[weather] fetch failed: ${err instanceof Error ? err.message : String(err)}`);
+            const cached = this.cache;
+            if (cached && cached.key === key && now - cached.at < WEATHER_STALE_SERVE_MS)
+                return cached.data;
+            return undefined;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}
+//# sourceMappingURL=weather.js.map

package/dist/weather.js.map

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

package/dist/windows-service.js

@@ -111,7 +111,7 @@ export function installWindowsTask() {
     writeFileSync(tmpFile, '' + xml, 'utf16le');
     try {
         // /F overwrites an existing task (idempotent; mirrors macOS unload-before-load).
-        execSync(`schtasks /Create /TN "${TASK_NAME}" /XML "${tmpFile}" /F`, { stdio: 'pipe' });
+        execSync(`schtasks /Create /TN "${TASK_NAME}" /XML "${tmpFile}" /F`, { stdio: 'pipe', windowsHide: true });
     }
     finally {
         try {
@@ -123,7 +123,7 @@ export function installWindowsTask() {
 /** True if the AgentDeckDaemon scheduled task is registered. */
 export function taskExists() {
     try {
-        execSync(`schtasks /Query /TN "${TASK_NAME}"`, { stdio: 'pipe' });
+        execSync(`schtasks /Query /TN "${TASK_NAME}"`, { stdio: 'pipe', windowsHide: true });
         return true;
     }
     catch {
@@ -132,14 +132,14 @@ export function taskExists() {
 }
 /** Start the registered task immediately (so no logout is required). */
 export function runWindowsTask() {
-    execSync(`schtasks /Run /TN "${TASK_NAME}"`, { stdio: 'pipe' });
+    execSync(`schtasks /Run /TN "${TASK_NAME}"`, { stdio: 'pipe', windowsHide: true });
 }
 /** Stop a running task instance (best-effort; ignores "not running"). */
 export function endWindowsTask() {
-    execSync(`schtasks /End /TN "${TASK_NAME}"`, { stdio: 'pipe' });
+    execSync(`schtasks /End /TN "${TASK_NAME}"`, { stdio: 'pipe', windowsHide: true });
 }
 /** Delete the registered task (/F suppresses the confirm prompt). */
 export function deleteWindowsTask() {
-    execSync(`schtasks /Delete /TN "${TASK_NAME}" /F`, { stdio: 'pipe' });
+    execSync(`schtasks /Delete /TN "${TASK_NAME}" /F`, { stdio: 'pipe', windowsHide: true });
 }
 //# sourceMappingURL=windows-service.js.map

package/dist/windows-service.js.map

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

package/fm-helper/AgentDeckFMHelper.swift

@@ -19,6 +19,8 @@ struct HelperRequest: Decodable {
     let text: String?
     let voice: String?
     let rate: Double?
+    /// `record`: hard cap on capture length; the reply arrives at stop or here.
+    let maxMs: Int?
 }
 
 @main
@@ -60,6 +62,20 @@ struct AgentDeckFMHelper {
             return
         }
 
+        if request.type == "record" {
+            // Recording spans an unknown PTT hold, and the stop arrives as a
+            // later stdin line — so this must not block the read loop.
+            Task.detached { await handleRecord(request) }
+            return
+        }
+
+        if request.type == "record_stop" || request.type == "record_cancel" {
+            let stopped = activeRecording.finish(
+                cancelled: request.type == "record_cancel", reason: "stopped")
+            write(["id": request.id, "stopped": stopped])
+            return
+        }
+
         guard let prompt = request.prompt, !prompt.isEmpty else {
             write(["id": request.id, "error": "bad_request", "reason": "missing prompt"])
             return
@@ -165,6 +181,111 @@ struct AgentDeckFMHelper {
         }
     }
 
+    // MARK: - Microphone capture
+
+    private static let activeRecording = RecordingBox()
+
+    /// Capture the host microphone into a 16 kHz mono PCM16 WAV. This is the
+    /// piece that retired the old Stream Deck Voice dial: capture used to mean
+    /// borrowing iTerm2's mic grant via AppleScript plus Homebrew `sox`. Here
+    /// the daemon's own bundled helper records, so the TCC grant belongs to
+    /// this process tree and there is nothing to install.
+    ///
+    /// The reply is deferred: it is written when `record_stop`/`record_cancel`
+    /// arrives on stdin or `maxMs` elapses, whichever comes first.
+    private static func handleRecord(_ request: HelperRequest) async {
+        guard let outPath = request.wav, !outPath.isEmpty else {
+            write(["id": request.id, "error": "bad_request", "reason": "missing wav output path"])
+            return
+        }
+        let granted = await ensureMicAuthorization()
+        guard granted else {
+            write([
+                "id": request.id,
+                "error": "unauthorized",
+                "reason": "microphone access not granted — grant it in System Settings › Privacy & Security › Microphone",
+            ])
+            return
+        }
+        let sampleRate = 16000.0
+        guard let outFormat = AVAudioFormat(commonFormat: .pcmFormatInt16,
+                                            sampleRate: sampleRate,
+                                            channels: 1,
+                                            interleaved: true) else {
+            write(["id": request.id, "error": "record_failed", "reason": "output format unavailable"])
+            return
+        }
+
+        let engine = AVAudioEngine()
+        let input = engine.inputNode
+        let inFormat = input.outputFormat(forBus: 0)
+        guard inFormat.sampleRate > 0, inFormat.channelCount > 0 else {
+            write(["id": request.id, "error": "record_failed", "reason": "no audio input device"])
+            return
+        }
+        let sink = PCMSink()
+        guard activeRecording.begin(requestId: request.id, engine: engine, sink: sink) else {
+            write(["id": request.id, "error": "busy", "reason": "a recording is already in progress"])
+            return
+        }
+        input.installTap(onBus: 0, bufferSize: 4096, format: inFormat) { buffer, _ in
+            sink.append(buffer, to: outFormat)
+        }
+        do {
+            try engine.start()
+        } catch {
+            activeRecording.clear()
+            input.removeTap(onBus: 0)
+            write(["id": request.id, "error": "record_failed", "reason": String(describing: error)])
+            return
+        }
+
+        let maxMs = max(1000, min(request.maxMs ?? 30_000, 120_000))
+        let outcome = await activeRecording.wait(maxMs: maxMs)
+        engine.stop()
+        input.removeTap(onBus: 0)
+
+        if outcome.cancelled {
+            write(["id": request.id, "cancelled": true])
+            return
+        }
+        if let failure = sink.failure {
+            write(["id": request.id, "error": "record_failed", "reason": failure])
+            return
+        }
+        let pcm = sink.pcm
+        guard pcm.count >= 2 else {
+            write(["id": request.id, "error": "record_failed", "reason": "no audio captured"])
+            return
+        }
+        do {
+            try wavData(pcm: pcm, sampleRate: Int(sampleRate)).write(to: URL(fileURLWithPath: outPath))
+        } catch {
+            write(["id": request.id, "error": "record_failed", "reason": String(describing: error)])
+            return
+        }
+        write([
+            "id": request.id,
+            "wav": outPath,
+            "sampleRate": Int(sampleRate),
+            "samples": pcm.count / 2,
+            "durationMs": Int(Double(pcm.count / 2) / sampleRate * 1000.0),
+            "stopReason": outcome.reason,
+        ])
+    }
+
+    private static func ensureMicAuthorization() async -> Bool {
+        switch AVCaptureDevice.authorizationStatus(for: .audio) {
+        case .authorized: return true
+        case .notDetermined:
+            return await withCheckedContinuation { continuation in
+                let box = ResumeOnce(continuation)
+                AVCaptureDevice.requestAccess(for: .audio) { box.resume($0) }
+            }
+        default: return false
+        }
+    }
+
     // MARK: - Text to speech
 
     /// Speak a reply through the host's audio output. Kept in the same helper
@@ -312,13 +433,92 @@ struct AgentDeckFMHelper {
 #endif
     }
 
+    /// stdout is shared by the serial request loop and the detached record
+    /// task; the lock keeps two replies from interleaving inside one line.
+    private static let writeLock = NSLock()
+
     private static func write(_ object: [String: Any]) {
         guard JSONSerialization.isValidJSONObject(object),
               let data = try? JSONSerialization.data(withJSONObject: object),
               let text = String(data: data, encoding: .utf8) else {
             return
         }
+        writeLock.lock()
         FileHandle.standardOutput.write(Data((text + "\n").utf8))
+        writeLock.unlock()
+    }
+}
+
+/// State for the single in-flight microphone capture. One at a time by design:
+/// the daemon models push-to-talk, and two overlapping engine taps on the same
+/// input device produce garbage anyway.
+private final class RecordingBox: @unchecked Sendable {
+    struct Outcome { let cancelled: Bool; let reason: String }
+
+    private let lock = NSLock()
+    private var requestId: Int?
+    private var engine: AVAudioEngine?
+    private var sink: PCMSink?
+    private var continuation: ResumeOnce<Outcome>?
+    /// Bumped per recording so a stale max-duration timer from a finished
+    /// capture cannot terminate the one that started after it.
+    private var generation = 0
+
+    func begin(requestId: Int, engine: AVAudioEngine, sink: PCMSink) -> Bool {
+        lock.lock(); defer { lock.unlock() }
+        guard self.requestId == nil else { return false }
+        self.requestId = requestId
+        self.engine = engine
+        self.sink = sink
+        generation += 1
+        return true
+    }
+
+    func wait(maxMs: Int) async -> Outcome {
+        let gen = currentGeneration()
+        let outcome: Outcome = await withCheckedContinuation { cont in
+            arm(ResumeOnce(cont))
+            DispatchQueue.global().asyncAfter(deadline: .now() + .milliseconds(maxMs)) { [weak self] in
+                guard let self, self.isLive(generation: gen) else { return }
+                _ = self.finish(cancelled: false, reason: "max_duration")
+            }
+        }
+        return outcome
+    }
+
+    private func currentGeneration() -> Int {
+        lock.lock(); defer { lock.unlock() }
+        return generation
+    }
+
+    private func arm(_ box: ResumeOnce<Outcome>) {
+        lock.lock(); defer { lock.unlock() }
+        continuation = box
+    }
+
+    private func isLive(generation gen: Int) -> Bool {
+        lock.lock(); defer { lock.unlock() }
+        return generation == gen && requestId != nil
+    }
+
+    /// Returns false when no recording is active — the stop raced a max-length
+    /// finish or arrived with nothing running.
+    func finish(cancelled: Bool, reason: String) -> Bool {
+        lock.lock()
+        let cont = continuation
+        let active = requestId != nil
+        continuation = nil
+        requestId = nil
+        engine = nil
+        sink = nil
+        lock.unlock()
+        guard active, let cont else { return false }
+        cont.resume(Outcome(cancelled: cancelled, reason: cancelled ? "cancelled" : reason))
+        return true
+    }
+
+    func clear() {
+        _ = finish(cancelled: true, reason: "cleared")
     }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentdeck/bridge",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "type": "module",
   "license": "MIT",
   "repository": {
@@ -14,22 +14,36 @@
     "assets/fonts",
     "assets/fm-helper",
     "fm-helper",
-    "scripts/build-fm-helper.mjs"
+    "scripts/build-fm-helper.mjs",
+    "python",
+    "src/idotmatrix/*.py",
+    "src/timebox/*.py",
+    "src/pysync/*.py"
   ],
   "main": "./dist/index.js",
   "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",
     "express": "^5.2.1",
     "qrcode": "^1.5.4",
+    "sharp": "^0.34.5",
     "strip-ansi": "^7.2.0",
-    "ws": "^8.20.0",
-    "@agentdeck/shared": "1.0.3",
-    "@agentdeck/hooks": "1.0.3"
+    "ws": "^8.20.0"
   },
   "optionalDependencies": {
     "@picovoice/porcupine-node": "^4.0.2",
@@ -45,13 +59,5 @@
     "@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/python/requirements-ble.txt

@@ -0,0 +1,5 @@
+# Optional runtime for terminal-managed iDotMatrix and Timebox Mini BLE clients.
+# Installed lazily by `agentdeck ble setup`; npm install itself stays PyPI-free.
+bleak>=2.1,<3
+Pillow>=12.0,<13
+idotmatrix==0.0.9

package/src/idotmatrix/brightness.py

@@ -0,0 +1,40 @@
+import asyncio
+import sys
+import argparse
+from idotmatrix import ConnectionManager
+from idotmatrix.modules.common import Common as IdmCommon
+
+async def set_brightness(address: str, brightness: int):
+    manager = ConnectionManager()
+    idm_common = IdmCommon()
+    idm_common.conn = manager
+    
+    try:
+        print(f"Connecting to iDotMatrix ({address})...")
+        await manager.connectByAddress(address)
+        print(f"Setting brightness to {brightness}%...")
+        await idm_common.setBrightness(brightness)
+        print("Brightness set successfully.")
+    except Exception as e:
+        print(f"ERROR: Failed to set brightness: {e}")
+        sys.exit(1)
+    finally:
+        try:
+            await manager.disconnect()
+        except Exception:
+            pass
+
+def main():
+    parser = argparse.ArgumentParser(description="Set iDotMatrix Brightness")
+    parser.add_argument("-a", "--address", required=True, help="BLE MAC/UUID Address")
+    parser.add_argument("-b", "--brightness", type=int, required=True, help="Brightness percent (5-100)")
+    args = parser.parse_args()
+    
+    if args.brightness not in range(5, 101):
+        print("ERROR: Brightness must be between 5 and 100 percent.")
+        sys.exit(1)
+        
+    asyncio.run(set_brightness(args.address, args.brightness))
+
+if __name__ == "__main__":
+    main()

package/src/idotmatrix/identity_generated.py

@@ -0,0 +1,50 @@
+# GENERATED FILE — DO NOT EDIT.
+# Source of truth: shared/src/idotmatrix-identity.ts
+# Regenerate: pnpm generate-idotmatrix-identity (drift gated by shared/src/__tests__/idotmatrix-identity.test.ts)
+"""Brand-independent identity of an iDotMatrix-protocol BLE panel.
+
+The same hardware advertises as 'IDM-...' (iDotMatrix) or 'iPixel-...', so a
+scan filters on the advertised service first and only falls back to the name
+families.
+"""
+
+IDOTMATRIX_SERVICE_UUID = "000000fa-0000-1000-8000-00805f9b34fb"
+IDOTMATRIX_WRITE_CHARACTERISTIC_UUID = "0000fa02-0000-1000-8000-00805f9b34fb"
+IDOTMATRIX_NAME_PREFIXES = ["IDM-", "IPIXEL"]
+
+_HEX = set("0123456789abcdef")
+
+
+def normalize_uuid(value):
+    """Expand a 16-bit ('fa02') or 32-bit ('000000fa') UUID to Bluetooth-base form.
+
+    Short forms are left-padded first: 'fa' and '00fa' are the same service.
+    """
+    s = (value or "").strip().lower()
+    if not s or not set(s) <= _HEX:
+        return s
+    if len(s) <= 4:
+        return "0000" + s.rjust(4, "0") + "-0000-1000-8000-00805f9b34fb"
+    if len(s) <= 8:
+        return s.rjust(8, "0") + "-0000-1000-8000-00805f9b34fb"
+    return s
+
+
+def matches_name(name, extra_prefixes=()):
+    """Whether an advertised local name belongs to a known panel family."""
+    n = (name or "").strip().upper()
+    if not n:
+        return False
+    for prefix in list(IDOTMATRIX_NAME_PREFIXES) + list(extra_prefixes or ()):
+        p = (prefix or "").strip().upper()
+        if p and n.startswith(p):
+            return True
+    return False
+
+
+def matches_advertisement(name, service_uuids, extra_prefixes=()):
+    """The discovery predicate: service UUID first, name families second."""
+    for uuid in service_uuids or ():
+        if normalize_uuid(uuid) == IDOTMATRIX_SERVICE_UUID:
+            return True
+    return matches_name(name, extra_prefixes)