whipdesk 0.1.1 → 0.1.3

package/dist/agent.cjs

@@ -18909,7 +18909,7 @@ var require_view = __commonJS({
     var dirname3 = path.dirname;
     var basename2 = path.basename;
     var extname = path.extname;
-    var join10 = path.join;
+    var join11 = path.join;
     var resolve = path.resolve;
     module2.exports = View;
     function View(name, options) {
@@ -18971,12 +18971,12 @@ var require_view = __commonJS({
     };
     View.prototype.resolve = function resolve2(dir, file) {
       var ext = this.ext;
-      var path2 = join10(dir, file);
+      var path2 = join11(dir, file);
       var stat2 = tryStat(path2);
       if (stat2 && stat2.isFile()) {
         return path2;
       }
-      path2 = join10(dir, basename2(file, ext), "index" + ext);
+      path2 = join11(dir, basename2(file, ext), "index" + ext);
       stat2 = tryStat(path2);
       if (stat2 && stat2.isFile()) {
         return path2;
@@ -22802,7 +22802,7 @@ var require_send = __commonJS({
     var Stream = require("stream");
     var util = require("util");
     var extname = path.extname;
-    var join10 = path.join;
+    var join11 = path.join;
     var normalize = path.normalize;
     var resolve = path.resolve;
     var sep2 = path.sep;
@@ -22974,7 +22974,7 @@ var require_send = __commonJS({
           return res;
         }
         parts = path2.split(sep2);
-        path2 = normalize(join10(root, path2));
+        path2 = normalize(join11(root, path2));
       } else {
         if (UP_PATH_REGEXP.test(path2)) {
           debug('malicious path "%s"', path2);
@@ -23107,7 +23107,7 @@ var require_send = __commonJS({
           if (err) return self.onStatError(err);
           return self.error(404);
         }
-        var p = join10(path2, self._index[i]);
+        var p = join11(path2, self._index[i]);
         debug('stat "%s"', p);
         fs.stat(p, function(err2, stat2) {
           if (err2) return next(err2);
@@ -27641,7 +27641,7 @@ var require_websocket_server = __commonJS({
 
 // src/index.ts
 var import_node_readline2 = require("node:readline");
-var import_node_os8 = require("node:os");
+var import_node_os9 = require("node:os");
 
 // src/config.ts
 var import_node_crypto = require("node:crypto");
@@ -27693,7 +27693,7 @@ function isPackaged() {
 }
 
 // src/version.ts
-var AGENT_VERSION = "0.1.1";
+var AGENT_VERSION = "0.1.3";
 
 // src/config.ts
 var here = (0, import_node_path2.dirname)((0, import_node_url2.fileURLToPath)(__whipdesk_meta_url));
@@ -28274,12 +28274,20 @@ async function readNsScreens() {
     return null;
   }
 }
+function friendlyDisplayName(raw, index) {
+  const s = String(raw ?? "").trim();
+  if (!s) return `Display ${index + 1}`;
+  const m = /DISPLAY(\d+)/i.exec(s);
+  if (m) return `Display ${m[1]}`;
+  if (/^\\\\/.test(s)) return `Display ${index + 1}`;
+  return s;
+}
 async function listBaseDisplays() {
   try {
     const displays = await import_screenshot_desktop.default.listDisplays();
     return displays.map((d, index) => ({
       id: typeof d.id === "number" ? d.id : index,
-      name: String(d.name ?? `Display ${index + 1}`),
+      name: friendlyDisplayName(d.name, index),
       primary: Boolean(d.primary) || index === 0
     }));
   } catch (error) {
@@ -28446,7 +28454,7 @@ function buildWelcome(ctx) {
   return {
     type: "welcome",
     protocol: PROTOCOL_VERSION,
-    agent: { version: AGENT_VERSION, platform: (0, import_node_os2.platform)(), hostname: (0, import_node_os2.hostname)() },
+    agent: { version: AGENT_VERSION, platform: (0, import_node_os2.platform)(), hostname: (0, import_node_os2.hostname)(), hdr: ctx.hdrActive || void 0 },
     screen: ctx.screen,
     capture: { fps: ctx.config.fps, quality: ctx.config.quality, maxWidth: ctx.config.maxWidth },
     capabilities: {
@@ -28541,11 +28549,96 @@ async function dispatch(ctx, msg, controller) {
 }
 
 // src/capture/encoder.ts
-var import_node_child_process2 = require("node:child_process");
+var import_node_child_process3 = require("node:child_process");
 var import_node_dgram = require("node:dgram");
 var import_node_util2 = require("node:util");
 var import_ffmpeg_static = __toESM(require("ffmpeg-static"), 1);
-var exec2 = (0, import_node_util2.promisify)(import_node_child_process2.execFile);
+
+// src/capture/hdr-win.ts
+var import_node_child_process2 = require("node:child_process");
+var cached = null;
+var inflight = null;
+function invalidateHdrCache() {
+  cached = null;
+}
+async function windowsHdrState(maxAgeMs = 15e3) {
+  if (process.platform !== "win32") return null;
+  if (cached && Date.now() - cached.at < maxAgeMs) return cached.state;
+  if (inflight) return inflight;
+  inflight = probe().then((state) => {
+    if (state) cached = { state, at: Date.now() };
+    return state;
+  }).finally(() => {
+    inflight = null;
+  });
+  return inflight;
+}
+async function probe() {
+  return new Promise((resolve) => {
+    (0, import_node_child_process2.execFile)(
+      "powershell",
+      ["-NoProfile", "-NonInteractive", "-WindowStyle", "Hidden", "-Command", PROBE_PS],
+      { timeout: 8e3, windowsHide: true },
+      (err, stdout) => {
+        if (err) {
+          log.debug("hdr probe failed:", err.message);
+          return resolve(null);
+        }
+        let supported = false;
+        let active = false;
+        let sawAny = false;
+        for (const line of String(stdout).split(/\r?\n/)) {
+          const m = /^([01]) ([01])$/.exec(line.trim());
+          if (!m) continue;
+          sawAny = true;
+          if (m[1] === "1") supported = true;
+          if (m[2] === "1") active = true;
+        }
+        resolve(sawAny ? { supported, active } : null);
+      }
+    );
+  });
+}
+var PROBE_PS = `
+$src = @'
+using System;
+using System.Runtime.InteropServices;
+public static class WdHdr {
+  [StructLayout(LayoutKind.Sequential)] public struct LUID { public uint Low; public int High; }
+  [StructLayout(LayoutKind.Sequential)] public struct PATH_SOURCE { public LUID adapterId; public uint id; public uint modeInfoIdx; public uint statusFlags; }
+  [StructLayout(LayoutKind.Sequential)] public struct RATIONAL { public uint num; public uint den; }
+  [StructLayout(LayoutKind.Sequential)] public struct PATH_TARGET { public LUID adapterId; public uint id; public uint modeInfoIdx; public uint outputTechnology; public uint rotation; public uint scaling; public RATIONAL refreshRate; public uint scanLineOrdering; public int targetAvailable; public uint statusFlags; }
+  [StructLayout(LayoutKind.Sequential)] public struct PATH_INFO { public PATH_SOURCE sourceInfo; public PATH_TARGET targetInfo; public uint flags; }
+  [StructLayout(LayoutKind.Sequential, Size = 64)] public struct MODE_INFO { public uint infoType; public uint id; public LUID adapterId; }
+  [StructLayout(LayoutKind.Sequential)] public struct DEVICE_INFO_HEADER { public uint type; public uint size; public LUID adapterId; public uint id; }
+  [StructLayout(LayoutKind.Sequential)] public struct GET_ADVANCED_COLOR_INFO { public DEVICE_INFO_HEADER header; public uint value; public uint colorEncoding; public uint bitsPerColorChannel; }
+  [DllImport("user32.dll")] public static extern int GetDisplayConfigBufferSizes(uint flags, out uint numPaths, out uint numModes);
+  [DllImport("user32.dll")] public static extern int QueryDisplayConfig(uint flags, ref uint numPaths, [Out] PATH_INFO[] paths, ref uint numModes, [Out] MODE_INFO[] modes, IntPtr topologyId);
+  [DllImport("user32.dll")] public static extern int DisplayConfigGetDeviceInfo(ref GET_ADVANCED_COLOR_INFO info);
+  public static void Probe() {
+    uint np, nm;
+    if (GetDisplayConfigBufferSizes(2, out np, out nm) != 0) return;
+    var paths = new PATH_INFO[np];
+    var modes = new MODE_INFO[nm];
+    if (QueryDisplayConfig(2, ref np, paths, ref nm, modes, IntPtr.Zero) != 0) return;
+    for (int i = 0; i < np; i++) {
+      var q = new GET_ADVANCED_COLOR_INFO();
+      q.header.type = 9;
+      q.header.size = (uint)Marshal.SizeOf(typeof(GET_ADVANCED_COLOR_INFO));
+      q.header.adapterId = paths[i].targetInfo.adapterId;
+      q.header.id = paths[i].targetInfo.id;
+      if (DisplayConfigGetDeviceInfo(ref q) == 0)
+        Console.WriteLine(((q.value & 1) != 0 ? "1" : "0") + " " + ((q.value & 2) != 0 ? "1" : "0"));
+    }
+  }
+}
+'@
+Add-Type -TypeDefinition $src -Language CSharp
+[WdHdr]::Probe()
+`.trim();
+
+// src/capture/encoder.ts
+var exec2 = (0, import_node_util2.promisify)(import_node_child_process3.execFile);
 var VIDEO_PAYLOAD_TYPE = 96;
 var VIDEO_CLOCK_RATE = 9e4;
 var encoderName;
@@ -28597,29 +28690,55 @@ async function avScreenIndex(displayId) {
   const map = await avScreenMapPromise;
   return map.get(displayId) ?? map.get(0) ?? null;
 }
-async function captureDeviceFor(displayIndex, fps) {
+var HDR_TONEMAP = ",tonemap=tonemap=hable:desat=0:peak=10,zscale=tin=linear:pin=bt709:t=bt709:p=bt709:m=bt709:r=tv,format=yuv420p";
+async function captureDeviceFor(displayIndex, fps, winFallback) {
   const r = String(Math.max(1, Math.min(60, Math.round(fps))));
+  const ts2 = ["-fflags", "+genpts", "-use_wallclock_as_timestamps", "1"];
   if (process.platform === "darwin") {
     const idx = await avScreenIndex(displayIndex);
     if (idx == null) return null;
-    return ["-f", "avfoundation", "-capture_cursor", "1", "-pixel_format", "nv12", "-framerate", r, "-i", `${idx}:none`];
+    return {
+      inputArgs: [...ts2, "-f", "avfoundation", "-capture_cursor", "1", "-pixel_format", "nv12", "-framerate", r, "-i", `${idx}:none`],
+      hwPrefix: "",
+      postFilter: ""
+    };
   }
   if (process.platform === "win32") {
-    return ["-f", "gdigrab", "-framerate", r, "-i", "desktop"];
+    if (winFallback) {
+      return { inputArgs: [...ts2, "-f", "gdigrab", "-framerate", r, "-i", "desktop"], hwPrefix: "", postFilter: "" };
+    }
+    const idx = Math.max(0, Math.round(displayIndex));
+    const hdr = (await windowsHdrState())?.active === true;
+    if (hdr) {
+      return {
+        inputArgs: ["-f", "lavfi", "-i", `ddagrab=output_idx=${idx}:framerate=${r}:draw_mouse=1:output_fmt=rgbaf16`],
+        // gbrpf32le BEFORE the split/crop/scale: swscale handles planar-float scaling everywhere,
+        // while direct rgbaf16 scaling is spottier across builds. Tone-mapping itself stays
+        // per-branch AFTER the scale (postFilter) so the heavy math runs at ≤maxWidth, not 4K.
+        hwPrefix: "hwdownload,format=rgbaf16,format=gbrpf32le,",
+        postFilter: HDR_TONEMAP,
+        winHdr: true
+      };
+    }
+    return {
+      inputArgs: ["-f", "lavfi", "-i", `ddagrab=output_idx=${idx}:framerate=${r}:draw_mouse=1`],
+      hwPrefix: "hwdownload,format=bgra,",
+      postFilter: ""
+    };
   }
   if (process.platform === "linux") {
-    return ["-f", "x11grab", "-framerate", r, "-i", process.env.DISPLAY || ":0.0"];
+    return { inputArgs: [...ts2, "-f", "x11grab", "-framerate", r, "-i", process.env.DISPLAY || ":0.0"], hwPrefix: "", postFilter: "" };
   }
   return null;
 }
 function videoFilter(crop, maxWidth) {
-  const scale = `scale=min(${Math.round(maxWidth)}\\,iw):-2`;
+  const scale = `scale=trunc(min(${Math.round(maxWidth)}\\,iw)/2)*2:-2`;
   if (isFull(crop)) return scale;
   const c = crop;
   return `crop=iw*${c.w.toFixed(4)}:ih*${c.h.toFixed(4)}:iw*${c.x.toFixed(4)}:ih*${c.y.toFixed(4)},${scale}`;
 }
 function overviewFilter(ov) {
-  return `scale=min(${Math.round(ov.width)}\\,iw):-2,fps=${Math.max(1, Math.round(ov.fps))}`;
+  return `scale=trunc(min(${Math.round(ov.width)}\\,iw)/2)*2:-2,fps=${Math.max(1, Math.round(ov.fps))}`;
 }
 function sameCrop(a, b) {
   if (isFull(a) && isFull(b)) return true;
@@ -28650,12 +28769,21 @@ var ScreenCaptureSession = class _ScreenCaptureSession {
   spawnAt = 0;
   lastPacketAt = 0;
   everGotPacket = false;
+  /** Whether the CURRENT spawn has delivered any packet — distinguishes a capture that "went
+   * silent" from one that never started (the avfoundation zero-frame deadlock) in stall logs. */
+  spawnGotPacket = false;
+  /** Consecutive stall-restarts whose spawn never produced a frame (resets on any packet). */
+  framelessRestarts = 0;
+  /** Resolves the restart loop's bounded wait as soon as the current spawn's first packet lands. */
+  firstPacketWaiter = null;
   deadRestarts = 0;
   erroredOut = false;
   stopped = false;
   restarting = false;
   /** Config the running ffmpeg was built from; lets a restart detect that `cfg` moved during it. */
   appliedCfg = null;
+  /** Windows only: set once ddagrab fails to produce a frame, switching capture to gdigrab. */
+  winCaptureFallback = false;
   /** Don't declare a not-yet-producing capture dead until it's had this long to start up. */
   static FIRST_FRAME_GRACE_MS = 6e3;
   /** Once it HAS produced frames, restart if it goes silent this long (display sleep, etc.). */
@@ -28674,7 +28802,7 @@ var ScreenCaptureSession = class _ScreenCaptureSession {
     this.activeListener = cb;
   }
   async start() {
-    await this.spawn();
+    await this.restart();
   }
   /** Change the zoom crop or target display. A no-op when nothing changed, so a redundant viewport
    * echo never restarts ffmpeg. If a restart is already running (the controller settled a new zoom
@@ -28695,23 +28823,35 @@ var ScreenCaptureSession = class _ScreenCaptureSession {
     if (this.stopped) return false;
     const cfg = this.cfg;
     const enc = await pickH264Encoder();
-    const capture = await captureDeviceFor(cfg.displayIndex, cfg.fps);
+    const capture = await captureDeviceFor(cfg.displayIndex, cfg.fps, this.winCaptureFallback);
     if (!enc || !import_ffmpeg_static.default || !capture) {
       if (!capture) log.warn("no direct screen-capture device on this platform \u2014 screen sharing unavailable");
       this.fail();
       return false;
     }
     const ov = !isFull(cfg.crop) && cfg.overview ? cfg.overview : null;
-    let sock;
+    let sock = null;
     let sockOv = null;
     try {
       sock = await bindUdp();
-      if (ov) sockOv = await bindUdp();
+      if (ov) {
+        sockOv = await bindUdp();
+        for (let tries = 0; tries < 4; tries++) {
+          const p = sock.address().port;
+          const q = sockOv.address().port;
+          if (Math.abs(p - q) > 1) break;
+          const again = await bindUdp();
+          closeQuietly(sockOv);
+          sockOv = again;
+        }
+      }
     } catch {
+      if (sock) closeQuietly(sock);
       if (sockOv) closeQuietly(sockOv);
       this.fail();
       return false;
     }
+    if (!sock) return false;
     if (this.stopped) {
       closeQuietly(sock);
       if (sockOv) closeQuietly(sockOv);
@@ -28720,7 +28860,7 @@ var ScreenCaptureSession = class _ScreenCaptureSession {
     const port = sock.address().port;
     const portOv = sockOv ? sockOv.address().port : 0;
     const preset = enc === "libx264" ? ["-preset", "ultrafast", "-tune", "zerolatency"] : ["-realtime", "1"];
-    const input = ["-hide_banner", "-loglevel", "error", "-fflags", "+genpts", "-use_wallclock_as_timestamps", "1", ...capture, "-an"];
+    const input = ["-hide_banner", "-loglevel", "error", ...capture.inputArgs, "-an"];
     const h264Out = (kbps, gop, ssrc, outPort) => [
       "-fps_mode",
       "vfr",
@@ -28731,6 +28871,12 @@ var ScreenCaptureSession = class _ScreenCaptureSession {
       "yuv420p",
       "-g",
       String(gop),
+      // Also key on WALL-CLOCK time, not just frame count: with VFR a static screen yields few output
+      // frames, so a frames-based GOP can leave a lost IDR unrepaired "until something moves". Forcing
+      // a keyframe ~1s (by PTS, which advances via -use_wallclock_as_timestamps) guarantees the client
+      // can always re-sync within ~1s even with no PLI and a frozen desktop.
+      "-force_key_frames",
+      "expr:gte(t,n_forced*1)",
       "-b:v",
       kbpsArg(kbps),
       "-maxrate",
@@ -28741,26 +28887,30 @@ var ScreenCaptureSession = class _ScreenCaptureSession {
       String(VIDEO_PAYLOAD_TYPE),
       "-ssrc",
       ssrc,
+      // buffer_size = SO_SNDBUF: keyframe bursts must not overflow the send side either (the
+      // receive side is widened in bindUdp — see the black-bottom-of-keyframe note there).
       "-f",
       "rtp",
-      `rtp://127.0.0.1:${outPort}?pkt_size=1200`
+      `rtp://127.0.0.1:${outPort}?pkt_size=1200&buffer_size=1048576`
     ];
     const mainGop = Math.max(10, Math.round(cfg.fps));
     const args = ov ? [
       ...input,
       // The full captured frame fans into two encodes: [m] the sharp crop, [o] the small overview.
+      // hwPrefix (ddagrab) downloads once, before the split, so both branches get RAM frames.
+      // postFilter (HDR tone map) runs per-branch AFTER the scale — cheap at output size.
       "-filter_complex",
-      `[0:v]split=2[m][o];[m]${videoFilter(cfg.crop, cfg.maxWidth)}[mainout];[o]${overviewFilter(ov)}[ovout]`,
+      `[0:v]${capture.hwPrefix}split=2[m][o];[m]${videoFilter(cfg.crop, cfg.maxWidth)}${capture.postFilter}[mainout];[o]${overviewFilter(ov)}${capture.postFilter}[ovout]`,
       "-map",
       "[mainout]",
       ...h264Out(cfg.kbps, mainGop, "1", port),
       "-map",
       "[ovout]",
       ...h264Out(ov.kbps, Math.max(1, Math.round(ov.fps)), "2", portOv)
-    ] : [...input, "-vf", videoFilter(cfg.crop, cfg.maxWidth), ...h264Out(cfg.kbps, mainGop, "1", port)];
+    ] : [...input, "-vf", `${capture.hwPrefix}${videoFilter(cfg.crop, cfg.maxWidth)}${capture.postFilter}`, ...h264Out(cfg.kbps, mainGop, "1", port)];
     let proc;
     try {
-      proc = (0, import_node_child_process2.spawn)(import_ffmpeg_static.default, args, { stdio: ["ignore", "ignore", "pipe"] });
+      proc = (0, import_node_child_process3.spawn)(import_ffmpeg_static.default, args, { stdio: ["ignore", "ignore", "pipe"] });
     } catch (error) {
       log.warn("video encoder failed to start:", error.message);
       closeQuietly(sock);
@@ -28774,14 +28924,18 @@ var ScreenCaptureSession = class _ScreenCaptureSession {
     this.appliedCfg = cfg;
     this.spawnAt = Date.now();
     this.lastPacketAt = Date.now();
+    this.spawnGotPacket = false;
     const spawnCrop = cfg.crop;
     let firstPacket = true;
     sock.on("message", (msg) => {
       this.lastPacketAt = Date.now();
       this.everGotPacket = true;
+      this.spawnGotPacket = true;
       this.deadRestarts = 0;
       if (firstPacket) {
         firstPacket = false;
+        this.framelessRestarts = 0;
+        this.firstPacketWaiter?.();
         this.activeListener?.(spawnCrop);
       }
       this.listener?.(msg);
@@ -28797,13 +28951,26 @@ var ScreenCaptureSession = class _ScreenCaptureSession {
       for (const line of d.toString().split("\n")) {
         const t = line.trim();
         if (!t || /^objc\[|NSKVONotifying|not linked into application/.test(t)) continue;
+        if (process.platform === "win32" && /AcquireNextFrame failed|Output parameters changed|Requested output format unavailable/i.test(t)) {
+          invalidateHdrCache();
+        }
         log.debug("ffmpeg:", t.slice(0, 200));
       }
     });
     proc.on("error", (e) => log.warn("video encoder process error:", e.message));
+    proc.on("exit", (code, sig) => {
+      if (this.proc !== proc || this.stopped) return;
+      log.debug(`ffmpeg exited unexpectedly (${code ?? sig ?? "?"})`);
+      const delay2 = Date.now() - this.spawnAt < 2e3 ? 2e3 : 400;
+      const t = setTimeout(() => {
+        if (this.proc === proc && !this.stopped) void this.restart();
+      }, delay2);
+      t.unref?.();
+    });
     this.startHealthMonitor();
+    const cropDesc = isFull(cfg.crop) ? "full desktop" : `zoomed ${cfg.crop.x.toFixed(2)},${cfg.crop.y.toFixed(2)} ${cfg.crop.w.toFixed(2)}x${cfg.crop.h.toFixed(2)}`;
     log.debug(
-      `video: H.264 capture started (${enc}, ${kbpsArg(cfg.kbps)}@${cfg.fps}fps, ${cfg.crop ? "zoomed" : "full desktop"}${ov ? " + overview" : ""})`
+      `video: H.264 capture started (${enc}, ${kbpsArg(cfg.kbps)}@${cfg.fps}fps, ${cropDesc}${ov ? " + overview" : ""}${capture.winHdr ? ", HDR desktop tone-mapped to SDR" : ""})`
     );
     return true;
   }
@@ -28817,13 +28984,23 @@ var ScreenCaptureSession = class _ScreenCaptureSession {
       if (this.stopped || this.restarting || !this.proc) return;
       const now = Date.now();
       if (this.everGotPacket) {
-        if (now - this.lastPacketAt > _ScreenCaptureSession.STALL_MS) {
-          log.debug("screen capture stalled \u2014 restarting");
+        const stallMs = this.spawnGotPacket ? _ScreenCaptureSession.STALL_MS : Math.min(4e3 + this.framelessRestarts * 1500, 1e4);
+        if (now - this.lastPacketAt > stallMs) {
+          if (!this.spawnGotPacket) this.framelessRestarts += 1;
+          log.debug(
+            `screen capture stalled \u2014 restarting (${this.spawnGotPacket ? "went silent" : `spawn never produced a frame after ${Math.round(stallMs / 1e3)}s`})`
+          );
           void this.restart();
         }
         return;
       }
       if (now - this.spawnAt < _ScreenCaptureSession.FIRST_FRAME_GRACE_MS) return;
+      if (process.platform === "win32" && !this.winCaptureFallback) {
+        this.winCaptureFallback = true;
+        log.debug("screen capture: ddagrab produced no frame \u2014 falling back to gdigrab");
+        void this.restart();
+        return;
+      }
       if (++this.deadRestarts > _ScreenCaptureSession.MAX_DEAD_RESTARTS) {
         this.kill();
         this.fail();
@@ -28838,13 +29015,58 @@ var ScreenCaptureSession = class _ScreenCaptureSession {
     this.restarting = true;
     try {
       do {
-        this.kill();
+        await this.killAndWait();
         if (!await this.spawn()) break;
+        await this.waitForFirstPacket(3e3);
       } while (!this.stopped && this.appliedCfg !== null && !sameConfig(this.cfg, this.appliedCfg));
     } finally {
       this.restarting = false;
     }
   }
+  /**
+   * Kill the current ffmpeg and WAIT until it has actually EXITED — plus a short macOS beat for
+   * WindowServer to release its screen-capture session — before the caller spawns the next one.
+   *
+   * kill() alone is fire-and-forget: signal delivery and the OS-side capture teardown are both
+   * asynchronous, so under re-crop churn (pan swipe after swipe) the next ffmpeg starts while the
+   * old capture session is still registered — the documented avfoundation deadlock where BOTH
+   * captures yield zero frames. Worse, the health monitor's recovery restart repeats the same
+   * unserialized kill→spawn every 5s, re-triggering the overlap each time: the observed
+   * "stalled — restarting" loop with no "crop live" ever following, dead for tens of seconds.
+   * Serializing exit→settle→spawn removes the overlap entirely, at ~150ms per re-crop.
+   */
+  async killAndWait() {
+    const proc = this.proc;
+    const exited = proc && proc.exitCode === null && proc.signalCode === null ? new Promise((resolve) => {
+      const cap = setTimeout(resolve, 2500);
+      cap.unref?.();
+      proc.once("exit", () => {
+        clearTimeout(cap);
+        resolve();
+      });
+    }) : null;
+    this.kill();
+    if (exited) {
+      await exited;
+      if (process.platform === "darwin") await new Promise((r) => setTimeout(r, 150));
+    }
+  }
+  /** Bounded wait for the current spawn's first RTP packet (resolves immediately if it already
+   * produced, on stop, or at the cap). See the restart loop for why replacing a capture that
+   * hasn't produced yet is dangerous on macOS. */
+  waitForFirstPacket(capMs) {
+    if (this.spawnGotPacket || this.stopped) return Promise.resolve();
+    return new Promise((resolve) => {
+      const done = () => {
+        clearTimeout(cap);
+        if (this.firstPacketWaiter === done) this.firstPacketWaiter = null;
+        resolve();
+      };
+      const cap = setTimeout(done, capMs);
+      cap.unref?.();
+      this.firstPacketWaiter = done;
+    });
+  }
   fail() {
     if (this.erroredOut) return;
     this.erroredOut = true;
@@ -28858,11 +29080,22 @@ var ScreenCaptureSession = class _ScreenCaptureSession {
     }
     const proc = this.proc;
     this.proc = null;
-    if (proc) {
+    if (proc && proc.exitCode === null && proc.signalCode === null) {
       try {
-        proc.kill("SIGKILL");
+        proc.kill("SIGTERM");
       } catch {
       }
+      const hardKill = setTimeout(
+        () => {
+          try {
+            proc.kill("SIGKILL");
+          } catch {
+          }
+        },
+        this.spawnGotPacket ? 1500 : 700
+      );
+      hardKill.unref?.();
+      proc.once("exit", () => clearTimeout(hardKill));
     }
     if (this.sock) {
       closeQuietly(this.sock);
@@ -28880,6 +29113,10 @@ function bindUdp() {
     sock.once("error", reject);
     sock.bind(0, "127.0.0.1", () => {
       sock.removeListener("error", reject);
+      try {
+        sock.setRecvBufferSize(4 * 1024 * 1024);
+      } catch {
+      }
       resolve(sock);
     });
   });
@@ -28989,7 +29226,15 @@ var VideoHub = class {
       if (this.opts.onCropActive) session.onActive((crop) => this.opts.onCropActive(crop));
       await session.start();
       if (this.paused || this.sinks.size === 0 && this.overviewSinks.size === 0) session.stop();
-      else this.session = session;
+      else {
+        this.session = session;
+        void session.reconfigure({
+          displayIndex: this.opts.displayIndex(),
+          crop: this.crop,
+          kbps: this.kbps,
+          fps: this.fps
+        });
+      }
     })().finally(() => this.starting = null);
     return this.starting;
   }
@@ -29125,6 +29370,9 @@ async function answerWebRtcOffer(ctx, offerSdp, onClosed, opts = {}) {
   pc.connectionStateChange.subscribe((s) => {
     if (s === "failed" || s === "closed" || s === "disconnected") teardown();
   });
+  pc.iceConnectionStateChange.subscribe((s) => {
+    if (s === "failed" || s === "closed" || s === "disconnected") teardown();
+  });
   await pc.setRemoteDescription({ type: "offer", sdp: offerSdp });
   if (offerVideoCount > 0 && canSendVideo && ctx.video) {
     for (let i = 0; i < offerVideoCount; i++) {
@@ -29147,9 +29395,9 @@ async function answerWebRtcOffer(ctx, offerSdp, onClosed, opts = {}) {
           }
         };
         (isOverview ? overviewSinks : sinks).push(sink);
-        const run2 = () => void (isOverview ? ctx.video.attachOverview(sink) : ctx.video.attach(sink));
-        if (authenticated) run2();
-        else pendingAttach.push(run2);
+        const run3 = () => void (isOverview ? ctx.video.attachOverview(sink) : ctx.video.attach(sink));
+        if (authenticated) run3();
+        else pendingAttach.push(run3);
       } catch (error) {
         log.warn(`video track ${i} setup failed:`, error.message);
       }
@@ -29341,12 +29589,15 @@ function printSetupReminder() {
   console.log("  Setup / permissions:");
   for (const line of lines) console.log(line);
   console.log("");
+  console.log("  Troubleshooting: relaunch with --verbose (e.g. `whipdesk --verbose`) for detailed");
+  console.log("  capture/network logs \u2014 attach them when reporting an issue.");
+  console.log("");
 }
 
 // src/server.ts
 var import_node_http = require("node:http");
-var import_node_fs9 = require("node:fs");
-var import_node_path11 = require("node:path");
+var import_node_fs10 = require("node:fs");
+var import_node_path12 = require("node:path");
 var import_node_url3 = require("node:url");
 var import_express = __toESM(require_express2(), 1);
 
@@ -29405,12 +29656,12 @@ var ScreenCapturer = class {
 };
 
 // src/input/applescript.ts
-var import_node_child_process3 = require("node:child_process");
+var import_node_child_process4 = require("node:child_process");
 var import_node_util3 = require("node:util");
-var exec3 = (0, import_node_util3.promisify)(import_node_child_process3.execFile);
+var exec3 = (0, import_node_util3.promisify)(import_node_child_process4.execFile);
 async function createAppleScriptBackend() {
   if (process.platform !== "darwin") return null;
-  const run2 = (script) => exec3("osascript", ["-e", script]).then(() => void 0);
+  const run3 = (script) => exec3("osascript", ["-e", script]).then(() => void 0);
   return {
     name: "applescript (keyboard-only)",
     canMouse: false,
@@ -29431,17 +29682,17 @@ async function createAppleScriptBackend() {
     async scroll() {
     },
     async typeText(text, submit) {
-      if (text) await run2(`tell application "System Events" to keystroke ${asAppleString(text)}`);
-      if (submit) await run2(`tell application "System Events" to key code 36`);
+      if (text) await run3(`tell application "System Events" to keystroke ${asAppleString(text)}`);
+      if (submit) await run3(`tell application "System Events" to key code 36`);
     },
     async keyTap(name, modifiers = []) {
       const using = modifiers.map(modifierClause).filter((m) => m !== null).join(", ");
       const usingClause = using ? ` using {${using}}` : "";
       const code = KEY_CODES[name.toLowerCase()];
       if (code !== void 0) {
-        await run2(`tell application "System Events" to key code ${code}${usingClause}`);
+        await run3(`tell application "System Events" to key code ${code}${usingClause}`);
       } else if (name.length === 1) {
-        await run2(`tell application "System Events" to keystroke ${asAppleString(name)}${usingClause}`);
+        await run3(`tell application "System Events" to keystroke ${asAppleString(name)}${usingClause}`);
       }
     }
   };
@@ -29805,7 +30056,7 @@ function meanDiff(a, b) {
 }
 
 // src/presence.ts
-var import_node_child_process4 = require("node:child_process");
+var import_node_child_process5 = require("node:child_process");
 var Presence = class {
   watchers = 0;
   start() {
@@ -29815,7 +30066,7 @@ var Presence = class {
     if (process.platform !== "darwin") return;
     const escape2 = (s) => s.replace(/[\\"]/g, "\\$&");
     const script = `display notification "${escape2(body)}" with title "${escape2(title)}"`;
-    (0, import_node_child_process4.execFile)("osascript", ["-e", script], () => void 0);
+    (0, import_node_child_process5.execFile)("osascript", ["-e", script], () => void 0);
   }
   setTitle(text) {
     if (process.stdout.isTTY) process.stdout.write(`\x1B]2;${text}\x07`);
@@ -29847,7 +30098,7 @@ var Presence = class {
 };
 
 // src/power/keep-awake.ts
-var import_node_child_process5 = require("node:child_process");
+var import_node_child_process6 = require("node:child_process");
 var import_node_os4 = require("node:os");
 var KeepAwake = class {
   child = null;
@@ -29890,15 +30141,15 @@ var KeepAwake = class {
   spawnBlocker() {
     switch ((0, import_node_os4.platform)()) {
       case "darwin":
-        return (0, import_node_child_process5.spawn)("caffeinate", ["-i", "-w", String(process.pid)], { stdio: "ignore" });
+        return (0, import_node_child_process6.spawn)("caffeinate", ["-i", "-w", String(process.pid)], { stdio: "ignore" });
       case "win32":
-        return (0, import_node_child_process5.spawn)(
+        return (0, import_node_child_process6.spawn)(
           "powershell",
           ["-NoProfile", "-NonInteractive", "-WindowStyle", "Hidden", "-Command", WINDOWS_KEEP_AWAKE],
           { stdio: "ignore", windowsHide: true }
         );
       case "linux":
-        return (0, import_node_child_process5.spawn)(
+        return (0, import_node_child_process6.spawn)(
           "systemd-inhibit",
           [
             "--what=sleep:idle",
@@ -29923,7 +30174,7 @@ var WINDOWS_KEEP_AWAKE = [
 ].join(" ");
 
 // src/power/wake-display.ts
-var import_node_child_process6 = require("node:child_process");
+var import_node_child_process7 = require("node:child_process");
 var import_node_os5 = require("node:os");
 var DisplayWake = class {
   hold = null;
@@ -29944,21 +30195,22 @@ var DisplayWake = class {
       this.stopHold();
     }
   }
-  /** Turn the display on right now (best-effort, never throws). */
-  wake() {
+  /** Turn the display on right now (best-effort, never throws). `holdSeconds` keeps it on that
+   * long on macOS (scheduled actions need the panel up for the whole wake→click→type sequence). */
+  wake(holdSeconds = 5) {
     try {
       switch ((0, import_node_os5.platform)()) {
         case "darwin":
-          (0, import_node_child_process6.spawn)("caffeinate", ["-u", "-t", "5"], { stdio: "ignore" }).unref();
+          (0, import_node_child_process7.spawn)("caffeinate", ["-u", "-t", String(holdSeconds)], { stdio: "ignore" }).unref();
           break;
         case "win32":
-          (0, import_node_child_process6.spawn)("powershell", ["-NoProfile", "-NonInteractive", "-WindowStyle", "Hidden", "-Command", WINDOWS_WAKE], {
+          (0, import_node_child_process7.spawn)("powershell", ["-NoProfile", "-NonInteractive", "-WindowStyle", "Hidden", "-Command", WINDOWS_WAKE], {
             stdio: "ignore",
             windowsHide: true
           }).unref();
           break;
         case "linux":
-          (0, import_node_child_process6.spawn)("sh", ["-c", "xset s reset; xset dpms force on"], { stdio: "ignore" }).unref();
+          (0, import_node_child_process7.spawn)("sh", ["-c", "xset s reset; xset dpms force on"], { stdio: "ignore" }).unref();
           break;
       }
     } catch (e) {
@@ -29969,10 +30221,10 @@ var DisplayWake = class {
     try {
       switch ((0, import_node_os5.platform)()) {
         case "darwin":
-          this.hold = (0, import_node_child_process6.spawn)("caffeinate", ["-d", "-w", String(process.pid)], { stdio: "ignore" });
+          this.hold = (0, import_node_child_process7.spawn)("caffeinate", ["-d", "-w", String(process.pid)], { stdio: "ignore" });
           break;
         case "win32":
-          this.hold = (0, import_node_child_process6.spawn)(
+          this.hold = (0, import_node_child_process7.spawn)(
             "powershell",
             ["-NoProfile", "-NonInteractive", "-WindowStyle", "Hidden", "-Command", WINDOWS_HOLD],
             { stdio: "ignore", windowsHide: true }
@@ -30024,6 +30276,37 @@ var WINDOWS_HOLD = [
   "while ($true) { Start-Sleep -Seconds 3600 }"
 ].join(" ");
 
+// src/power/session-lock.ts
+var import_node_child_process8 = require("node:child_process");
+var import_node_os6 = require("node:os");
+async function isSessionLocked() {
+  try {
+    switch ((0, import_node_os6.platform)()) {
+      case "darwin": {
+        const out = await run("ioreg", ["-n", "Root", "-d1"]);
+        const m = /"IOConsoleLocked"\s*=\s*(Yes|No)/.exec(out);
+        return m ? m[1] === "Yes" : null;
+      }
+      case "win32": {
+        const out = await run("tasklist", ["/FI", "IMAGENAME eq LogonUI.exe", "/NH"]);
+        return /LogonUI\.exe/i.test(out);
+      }
+      default:
+        return null;
+    }
+  } catch {
+    return null;
+  }
+}
+function run(cmd, args) {
+  return new Promise((resolve, reject) => {
+    (0, import_node_child_process8.execFile)(cmd, args, { timeout: 4e3, windowsHide: true }, (err, stdout) => {
+      if (err) reject(err);
+      else resolve(String(stdout));
+    });
+  });
+}
+
 // src/security/setup.ts
 var import_node_readline = require("node:readline");
 
@@ -30073,9 +30356,9 @@ var PinGuard = class _PinGuard {
   get salt() {
     return this.record?.salt ?? "";
   }
-  /** Persist a new PIN (>= 4 chars). Stores only the stretched key. */
+  /** Persist a new PIN (>= 6 chars). Stores only the stretched key. */
   setPin(pin) {
-    if (pin.length < 4) throw new Error("PIN must be at least 4 characters");
+    if (pin.length < 6) throw new Error("PIN must be at least 6 characters");
     const salt = (0, import_node_crypto5.randomBytes)(16).toString("hex");
     const key = stretch(pin, salt, ITERATIONS);
     this.record = { salt, iterations: ITERATIONS, key };
@@ -30382,9 +30665,9 @@ var import_node_path9 = require("node:path");
 
 // src/monitor/agents.ts
 var import_node_fs7 = require("node:fs");
-var import_node_os6 = require("node:os");
+var import_node_os7 = require("node:os");
 var import_node_path7 = require("node:path");
-var home = (0, import_node_os6.homedir)();
+var home = (0, import_node_os7.homedir)();
 var has = (tokens, name) => tokens.includes(name);
 function claudeProjectDir(cwd) {
   return (0, import_node_path7.join)(home, ".claude", "projects", cwd.replace(/[/\\.]/g, "-"));
@@ -30445,8 +30728,8 @@ function readLastJsonlLine(path) {
 }
 function vsCodeUserDirs() {
   const variants = ["Code", "Code - Insiders", "VSCodium"];
-  if ((0, import_node_os6.platform)() === "darwin") return variants.map((v) => (0, import_node_path7.join)(home, "Library", "Application Support", v, "User"));
-  if ((0, import_node_os6.platform)() === "win32") {
+  if ((0, import_node_os7.platform)() === "darwin") return variants.map((v) => (0, import_node_path7.join)(home, "Library", "Application Support", v, "User"));
+  if ((0, import_node_os7.platform)() === "win32") {
     const appData = process.env.APPDATA || (0, import_node_path7.join)(home, "AppData", "Roaming");
     return variants.map((v) => (0, import_node_path7.join)(appData, v, "User"));
   }
@@ -30488,11 +30771,12 @@ function vsCodeCopilotInstalled() {
     } catch {
     }
   }
+  if (!value) value = vsCodeChatSessionDirs().length > 0;
   copilotInstalledCache = { value, at: now };
   return value;
 }
 function isVsCodeExtensionHost(cmd) {
-  return cmd.includes("--type=extensionhost") || cmd.includes("extensionhostprocess");
+  return cmd.includes("--type=extensionhost") || cmd.includes("extensionhostprocess") || cmd.includes("node.mojom.nodeservice") && cmd.includes("--inspect-port");
 }
 var AGENTS = [
   {
@@ -30575,11 +30859,11 @@ function agentLabel(kind) {
 }
 
 // src/monitor/processes.ts
-var import_node_child_process7 = require("node:child_process");
-var import_node_os7 = require("node:os");
-function run(cmd, args, timeoutMs = 5e3) {
+var import_node_child_process9 = require("node:child_process");
+var import_node_os8 = require("node:os");
+function run2(cmd, args, timeoutMs = 5e3) {
   return new Promise((resolve) => {
-    (0, import_node_child_process7.execFile)(cmd, args, { timeout: timeoutMs, maxBuffer: 16 * 1024 * 1024, windowsHide: true }, (err, stdout) => {
+    (0, import_node_child_process9.execFile)(cmd, args, { timeout: timeoutMs, maxBuffer: 16 * 1024 * 1024, windowsHide: true }, (err, stdout) => {
       resolve(err && !stdout ? "" : stdout.toString());
     });
   });
@@ -30594,7 +30878,7 @@ function tokenize(command) {
   return out;
 }
 async function listUnix() {
-  const out = await run("ps", ["-axww", "-o", "pid=,ppid=,pcpu=,tty=,command="]);
+  const out = await run2("ps", ["-axww", "-o", "pid=,ppid=,pcpu=,tty=,command="]);
   const procs = [];
   for (const line of out.split("\n")) {
     const m = line.match(/^\s*(\d+)\s+(\d+)\s+([\d.]+)\s+(\S+)\s+(.*)$/);
@@ -30614,7 +30898,7 @@ async function listUnix() {
 }
 async function listWindows() {
   const script = "Get-CimInstance Win32_Process | Select-Object ProcessId,ParentProcessId,CommandLine,Name | ConvertTo-Csv -NoTypeInformation";
-  const out = await run("powershell.exe", ["-NoProfile", "-NonInteractive", "-Command", script], 9e3);
+  const out = await run2("powershell.exe", ["-NoProfile", "-NonInteractive", "-Command", script], 9e3);
   const procs = [];
   for (const line of out.split(/\r?\n/)) {
     const m = line.match(/^"(\d+)","(\d*)",(.*)$/);
@@ -30638,16 +30922,16 @@ async function listWindows() {
   return procs;
 }
 function listProcesses() {
-  return (0, import_node_os7.platform)() === "win32" ? listWindows() : listUnix();
+  return (0, import_node_os8.platform)() === "win32" ? listWindows() : listUnix();
 }
 async function processCwd(pid) {
-  const os = (0, import_node_os7.platform)();
+  const os = (0, import_node_os8.platform)();
   if (os === "win32") return "";
   if (os === "linux") {
-    const out2 = await run("readlink", [`/proc/${pid}/cwd`], 2e3);
+    const out2 = await run2("readlink", [`/proc/${pid}/cwd`], 2e3);
     return out2.trim();
   }
-  const out = await run("lsof", ["-a", "-p", String(pid), "-d", "cwd", "-Fn"], 3e3);
+  const out = await run2("lsof", ["-a", "-p", String(pid), "-d", "cwd", "-Fn"], 3e3);
   for (const line of out.split("\n")) if (line.startsWith("n")) return line.slice(1).trim();
   return "";
 }
@@ -30824,8 +31108,8 @@ var SessionMonitor = class {
     this.timer.unref?.();
   }
   async cwdFor(pid) {
-    const cached = this.cwdCache.get(pid);
-    if (cached !== void 0) return cached;
+    const cached2 = this.cwdCache.get(pid);
+    if (cached2 !== void 0) return cached2;
     const cwd = await processCwd(pid).catch(() => "");
     this.cwdCache.set(pid, cwd);
     return cwd;
@@ -31036,6 +31320,30 @@ function saveAlwaysAgents(stateDir2, agents) {
   }
 }
 
+// src/timer-store.ts
+var import_node_fs9 = require("node:fs");
+var import_node_path11 = require("node:path");
+var FILE2 = "timers.json";
+function loadTimers(stateDir2) {
+  try {
+    const raw = (0, import_node_fs9.readFileSync)((0, import_node_path11.join)(stateDir2, FILE2), "utf8");
+    const parsed = JSON.parse(raw);
+    if (!Array.isArray(parsed.timers)) return [];
+    return parsed.timers.filter(
+      (t) => !!t && typeof t.id === "string" && typeof t.fireAtMs === "number"
+    );
+  } catch {
+    return [];
+  }
+}
+function saveTimers(stateDir2, timers) {
+  try {
+    (0, import_node_fs9.mkdirSync)(stateDir2, { recursive: true });
+    (0, import_node_fs9.writeFileSync)((0, import_node_path11.join)(stateDir2, FILE2), JSON.stringify({ timers }), { mode: 384 });
+  } catch {
+  }
+}
+
 // src/util/update-check.ts
 async function checkForUpdate(current) {
   try {
@@ -31078,8 +31386,8 @@ function announceUpdate(latest, current, notify) {
 }
 
 // src/server.ts
-var here2 = (0, import_node_path11.dirname)((0, import_node_url3.fileURLToPath)(__whipdesk_meta_url));
-var webDist = isPackaged() ? (0, import_node_path11.join)(here2, "mobile-web") : (0, import_node_path11.join)(here2, "..", "..", "mobile-web", "dist");
+var here2 = (0, import_node_path12.dirname)((0, import_node_url3.fileURLToPath)(__whipdesk_meta_url));
+var webDist = isPackaged() ? (0, import_node_path12.join)(here2, "mobile-web") : (0, import_node_path12.join)(here2, "..", "..", "mobile-web", "dist");
 async function startAgent() {
   const config = loadConfig();
   const capturer = new ScreenCapturer({ quality: config.quality, maxWidth: config.maxWidth });
@@ -31169,6 +31477,7 @@ async function startAgent() {
   let captureFailing = false;
   let viewport = { x: 0, y: 0, w: 1, h: 1 };
   const timers = /* @__PURE__ */ new Map();
+  const persistTimers = () => saveTimers(config.stateDir, [...timers.values()]);
   const listTimers = () => [...timers.values()].map((t) => ({ id: t.id, label: t.label, fireAtMs: t.fireAtMs, hasAction: !!t.action }));
   const broadcastTimers = () => {
     const msg = { type: "timers", timers: listTimers() };
@@ -31190,13 +31499,46 @@ async function startAgent() {
     const t = timers.get(id);
     if (!t) return;
     timers.delete(id);
+    persistTimers();
     broadcastTimers();
     const a = t.action;
     if (a) {
       try {
         log.info(`timer "${t.label || id}" firing${a.kind ? ` (${a.kind})` : ""}`);
+        displayWake.wake(30);
+        await delay(3e3);
+        const locked = await isSessionLocked();
+        if (locked === true) {
+          throw new Error(
+            "the screen is locked, so the input would go to the lock screen instead of your app. For unattended scheduled work, set the machine to not require a password immediately after display sleep."
+          );
+        }
         if (typeof a.x === "number" && typeof a.y === "number") {
-          await input.click(a.button ?? "left", false, a.x, a.y);
+          const pinnedId = t.displayId;
+          let restoreInput = null;
+          if (pinnedId !== void 0 && pinnedId !== activeDisplay) {
+            const pinned = displays.find((d) => d.id === pinnedId);
+            if (!pinned || pinned.width <= 0 || pinned.height <= 0) {
+              throw new Error(`the display it was scheduled on ([${pinnedId}]) is no longer connected`);
+            }
+            input.setActiveDisplay({
+              originX: pinned.originX,
+              originY: pinned.originY,
+              width: pinned.width,
+              height: pinned.height
+            });
+            restoreInput = () => {
+              const cur = displays.find((d) => d.id === activeDisplay);
+              input.setActiveDisplay(
+                cur && cur.width > 0 && cur.height > 0 ? { originX: cur.originX, originY: cur.originY, width: cur.width, height: cur.height } : null
+              );
+            };
+          }
+          try {
+            await input.click(a.button ?? "left", false, a.x, a.y);
+          } finally {
+            restoreInput?.();
+          }
           if (a.kind === "key" || a.kind === "text") await delay(250);
         }
         if (a.kind === "key" && a.key) await input.keyTap(a.key);
@@ -31205,8 +31547,8 @@ async function startAgent() {
         const message = error.message ?? String(error);
         log.warn("timer action failed:", message);
         hub.emit({
-          title: t.label || "WhipDesk timer",
-          body: `Timer reached zero, but its scheduled action failed: ${message.slice(0, 120)}`,
+          title: t.label || "Scheduled work",
+          body: `Time's up, but the scheduled action failed: ${message.slice(0, 120)}`,
           level: "error",
           source: "timer"
         });
@@ -31214,12 +31556,29 @@ async function startAgent() {
       }
     }
     hub.emit({
-      title: t.label || "WhipDesk timer",
-      body: a ? "Timer reached zero \u2014 scheduled action sent." : "Timer reached zero.",
+      title: t.label || "Scheduled work",
+      body: a ? "Time's up \u2014 scheduled action done." : "Time's up.",
       level: "success",
       source: "timer"
     });
   };
+  for (const t of loadTimers(config.stateDir)) {
+    if (t.fireAtMs <= Date.now()) {
+      hub.emit({
+        title: t.label || "Scheduled work",
+        body: "This came due while WhipDesk was not running \u2014 its action was NOT performed.",
+        level: "error",
+        source: "timer"
+      });
+    } else {
+      timers.set(t.id, t);
+    }
+  }
+  persistTimers();
+  if (timers.size > 0) {
+    ensureTimerTicker();
+    log.info(`restored ${timers.size} pending timer${timers.size === 1 ? "" : "s"} from disk`);
+  }
   const captureOnce = async () => {
     if (regionWatcher.count === 0) return "idle";
     try {
@@ -31279,6 +31638,7 @@ async function startAgent() {
     displays,
     videoAvailable,
     video,
+    hdrActive: false,
     get activeDisplay() {
       return activeDisplay;
     },
@@ -31286,6 +31646,7 @@ async function startAgent() {
     addController(controller) {
       controllers.add(controller);
       log.info(`controller connected (${controllers.size} active)`);
+      void windowsHdrState().then((s) => ctx.hdrActive = s?.active === true);
       displayWake.setActive(true);
       for (const c of controllers) c.send({ type: "presence", watchers: controllers.size });
       controller.send({ type: "watchers", regions: regionWatcher.list() });
@@ -31384,13 +31745,15 @@ async function startAgent() {
     addTimer(msg) {
       const fireInMs = Math.max(1e3, Math.min(msg.fireInMs, 7 * 24 * 36e5));
       const fireAtMs = Date.now() + fireInMs;
-      timers.set(msg.id, { id: msg.id, label: msg.label, fireAtMs, action: msg.action });
+      timers.set(msg.id, { id: msg.id, label: msg.label, fireAtMs, action: msg.action, displayId: activeDisplay });
+      persistTimers();
       ensureTimerTicker();
       broadcastTimers();
       log.info(`timer "${msg.label}" in ${Math.round(fireInMs / 1e3)}s${msg.action ? ` (+${msg.action.kind})` : ""}`);
     },
     removeTimer(id) {
       if (!timers.delete(id)) return;
+      persistTimers();
       broadcastTimers();
     },
     listTimers() {
@@ -31474,9 +31837,9 @@ async function startAgent() {
     }
     res.json({ ok: true });
   });
-  if ((0, import_node_fs9.existsSync)(webDist)) {
+  if ((0, import_node_fs10.existsSync)(webDist)) {
     app.use(import_express.default.static(webDist));
-    app.get("/*splat", (_req, res) => res.sendFile((0, import_node_path11.join)(webDist, "index.html")));
+    app.get("/*splat", (_req, res) => res.sendFile((0, import_node_path12.join)(webDist, "index.html")));
   } else {
     log.warn(`mobile-web build not found at ${webDist} \u2014 run "npm run build:web"`);
     app.get(
@@ -31499,6 +31862,14 @@ async function startAgent() {
   }
   log.info(`listening on :${config.port} (capture: ${capturer.backend}, input: ${input.name})`);
   log.info(pin.isSet ? "connection PIN: required" : "connection PIN: NONE (set one in a terminal)");
+  void windowsHdrState().then((s) => {
+    ctx.hdrActive = s?.active === true;
+    if (s?.active) {
+      log.warn(
+        "HDR is ON on this desktop \u2014 the remote stream is tone-mapped to SDR and colors may look washed out. Turn HDR off if it bothers you."
+      );
+    }
+  });
   return { server, config, presence, keepAwake, ctx };
 }
 function isLevel(value) {
@@ -31562,8 +31933,8 @@ async function main() {
       registry = await startDeviceRegistry({
         rtdb,
         identity,
-        name: (0, import_node_os8.hostname)(),
-        platform: (0, import_node_os8.platform)(),
+        name: (0, import_node_os9.hostname)(),
+        platform: (0, import_node_os9.platform)(),
         version: AGENT_VERSION,
         getLan: () => ({ ip: getLanIp(), port: config.port, token: config.token })
       });