camstack 1.2.129 → 1.2.131

package/dist/{chunk-WZY4EJWR.js → chunk-FK6R4ZJQ.js}

@@ -28362,6 +28362,12 @@ var occupancyRecheckFramesField = {
   default: 4,
   step: 1
 };
+var preRollInferenceFramesField = {
+  min: 0,
+  max: 30,
+  default: 12,
+  step: 1
+};
 var MotionSourceEnum = external_exports.enum([
   "onboard",
   "analyzer",
@@ -28523,6 +28529,31 @@ var RunnerCameraConfigSchema = external_exports.object({
   * to every occupancy rule until something moved in front of it. The churn is
   * now paid on the interval instead — see `occupancyRecheckSecField`.
   */
+  /**
+  * Infer the session's PRE-ROLL — the retained history the restreamer replays
+  * at session open — instead of decoding it and throwing it away.
+  *
+  * DEFAULT `true`, and the default is the argument. This is not a new
+  * capability being offered cautiously: the pre-roll is ALREADY requested,
+  * already served, already decoded and already paid for on every on-motion
+  * detection session that asks for history. What shipped was a last-moment
+  * discard — `FrameSlot`'s throttle compares wall clocks, and ~4 s of media
+  * arriving inside a few hundred ms of wall clock looks to it like one frame's
+  * worth. Device 617, 2026-09-08: a re-run of the SAME model over the stored
+  * recording scored the subject `vehicle 0.5669` — above the 0.50 floor —
+  * 1.68 s BEFORE the live track was born, on a frame that was in the pre-roll,
+  * was decoded, and was freed.
+  *
+  * Shipping that as opt-in would ship the bug: an operator cannot discover a
+  * setting whose absence looks exactly like a camera that noticed the cyclist
+  * late. What makes ON safe is not a switch but the BOUND —
+  * `preRollInferenceFrames`, a wall-clock ceiling, and a lane that never takes
+  * the last inference permit — so the switch exists for the camera where the
+  * history is worthless (a doorbell whose subject is always already at the
+  * door), not as a hedge against the feature.
+  */
+  preRollInferenceEnabled: external_exports.boolean().default(true),
+  preRollInferenceFrames: external_exports.number().min(preRollInferenceFramesField.min).max(preRollInferenceFramesField.max).default(preRollInferenceFramesField.default),
   occupancyRecheckEnabled: external_exports.boolean().default(true),
   occupancyRecheckSec: external_exports.number().min(occupancyRecheckSecField.min).max(occupancyRecheckSecField.max).default(occupancyRecheckSecField.default),
   occupancyRecheckFrames: external_exports.number().min(occupancyRecheckFramesField.min).max(occupancyRecheckFramesField.max).default(occupancyRecheckFramesField.default),
@@ -28662,6 +28693,29 @@ var RunnerCameraDeviceUIFields = [
       includes: "onboard"
     }
   },
+  {
+    key: "preRollInferenceEnabled",
+    type: "boolean",
+    style: "checkbox",
+    label: "Detect in the pre-roll",
+    description: "Run detection over the few seconds of footage the camera had already buffered when motion fired, so a subject that was in view before the trigger is found at the moment it appeared rather than seconds later. The burst is bounded and never delays live detection.",
+    default: true
+  },
+  {
+    key: "preRollInferenceFrames",
+    type: "slider",
+    label: "Pre-roll frames",
+    description: "How many frames of buffered history may be detected on, per session. Higher samples the history more densely; 0 disables the pass.",
+    min: preRollInferenceFramesField.min,
+    max: preRollInferenceFramesField.max,
+    step: preRollInferenceFramesField.step,
+    default: preRollInferenceFramesField.default,
+    showValue: true,
+    showWhen: {
+      field: "preRollInferenceEnabled",
+      equals: true
+    }
+  },
   {
     key: "occupancyRecheckEnabled",
     type: "boolean",

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   runDiscover
-} from "./chunk-WZY4EJWR.js";
+} from "./chunk-FK6R4ZJQ.js";
 import "./chunk-LMMQX4CK.js";
 
 // src/cli.ts
@@ -38,7 +38,7 @@ async function runServe(args) {
     ...typeof values.data === "string" ? { data: values.data } : {}
   };
   Object.assign(process.env, buildServeEnv(opts));
-  await import("./launcher-JP2K4C4Y.js");
+  await import("./launcher-XH2NRTWF.js");
 }
 
 // src/commands/agent.ts
@@ -83,7 +83,7 @@ async function runAgent(args) {
     ...typeof values.port === "string" ? { port: values.port } : {}
   };
   Object.assign(process.env, buildAgentEnv(opts));
-  await import("./launcher-JP2K4C4Y.js");
+  await import("./launcher-XH2NRTWF.js");
 }
 
 // src/commands/setup.ts
@@ -1130,7 +1130,7 @@ function isUnknown(_value) {
   return true;
 }
 async function resolveServerInteractive(presetNamespace) {
-  const { discoverNodes, resolveHubFromDiscovered, filterHubNodes, DEFAULT_HUB_HTTPS_PORT } = await import("./discover-VXR5SN5P.js");
+  const { discoverNodes, resolveHubFromDiscovered, filterHubNodes, DEFAULT_HUB_HTTPS_PORT } = await import("./discover-Q75B3UUE.js");
   if (presetNamespace) {
     const spinner4 = clack.spinner();
     spinner4.start(`Discovering hub on LAN (namespace "${presetNamespace}")`);

package/dist/{discover-VXR5SN5P.js → discover-Q75B3UUE.js}

@@ -5,7 +5,7 @@ import {
   filterHubNodes,
   resolveHubFromDiscovered,
   runDiscover
-} from "./chunk-WZY4EJWR.js";
+} from "./chunk-FK6R4ZJQ.js";
 import "./chunk-LMMQX4CK.js";
 export {
   DEFAULT_HUB_HTTPS_PORT,

package/dist/{launcher-JP2K4C4Y.js → launcher-XH2NRTWF.js}

@@ -23633,9 +23633,9 @@ var require_zod = __commonJS({
   }
 });
 
-// ../system/dist/dist-WLsoGpyn.js
-var require_dist_WLsoGpyn = __commonJS({
-  "../system/dist/dist-WLsoGpyn.js"(exports) {
+// ../system/dist/dist-9GQQ9F3s.js
+var require_dist_9GQQ9F3s = __commonJS({
+  "../system/dist/dist-9GQQ9F3s.js"(exports) {
     "use strict";
     var zod = require_zod();
     var EventCategory = /* @__PURE__ */ (function(EventCategory2) {
@@ -39131,6 +39131,12 @@ var require_dist_WLsoGpyn = __commonJS({
       default: 4,
       step: 1
     };
+    var preRollInferenceFramesField = {
+      min: 0,
+      max: 30,
+      default: 12,
+      step: 1
+    };
     var MotionSourceEnum = zod.z.enum([
       "onboard",
       "analyzer",
@@ -39292,6 +39298,31 @@ var require_dist_WLsoGpyn = __commonJS({
       * to every occupancy rule until something moved in front of it. The churn is
       * now paid on the interval instead — see `occupancyRecheckSecField`.
       */
+      /**
+      * Infer the session's PRE-ROLL — the retained history the restreamer replays
+      * at session open — instead of decoding it and throwing it away.
+      *
+      * DEFAULT `true`, and the default is the argument. This is not a new
+      * capability being offered cautiously: the pre-roll is ALREADY requested,
+      * already served, already decoded and already paid for on every on-motion
+      * detection session that asks for history. What shipped was a last-moment
+      * discard — `FrameSlot`'s throttle compares wall clocks, and ~4 s of media
+      * arriving inside a few hundred ms of wall clock looks to it like one frame's
+      * worth. Device 617, 2026-09-08: a re-run of the SAME model over the stored
+      * recording scored the subject `vehicle 0.5669` — above the 0.50 floor —
+      * 1.68 s BEFORE the live track was born, on a frame that was in the pre-roll,
+      * was decoded, and was freed.
+      *
+      * Shipping that as opt-in would ship the bug: an operator cannot discover a
+      * setting whose absence looks exactly like a camera that noticed the cyclist
+      * late. What makes ON safe is not a switch but the BOUND —
+      * `preRollInferenceFrames`, a wall-clock ceiling, and a lane that never takes
+      * the last inference permit — so the switch exists for the camera where the
+      * history is worthless (a doorbell whose subject is always already at the
+      * door), not as a hedge against the feature.
+      */
+      preRollInferenceEnabled: zod.z.boolean().default(true),
+      preRollInferenceFrames: zod.z.number().min(preRollInferenceFramesField.min).max(preRollInferenceFramesField.max).default(preRollInferenceFramesField.default),
       occupancyRecheckEnabled: zod.z.boolean().default(true),
       occupancyRecheckSec: zod.z.number().min(occupancyRecheckSecField.min).max(occupancyRecheckSecField.max).default(occupancyRecheckSecField.default),
       occupancyRecheckFrames: zod.z.number().min(occupancyRecheckFramesField.min).max(occupancyRecheckFramesField.max).default(occupancyRecheckFramesField.default),
@@ -39320,7 +39351,7 @@ var require_dist_WLsoGpyn = __commonJS({
       */
       inferenceDevices: zod.z.array(RunnerInferenceDeviceSchema).readonly().optional()
     });
-    motionFpsField.min, motionFpsField.max, motionFpsField.step, motionFpsField.default, detectionFpsField.min, detectionFpsField.max, detectionFpsField.step, detectionFpsField.default, motionCooldownMsField.min, motionCooldownMsField.max, motionCooldownMsField.step, motionCooldownMsField.default, maxSessionHoldMsField.min, maxSessionHoldMsField.max, maxSessionHoldMsField.step, maxSessionHoldMsField.default, audioMotionWindowMsField.min, audioMotionWindowMsField.max, audioMotionWindowMsField.step, audioMotionWindowMsField.default, occupancyRecheckSecField.min, occupancyRecheckSecField.max, occupancyRecheckSecField.step, occupancyRecheckSecField.default, occupancyRecheckFramesField.min, occupancyRecheckFramesField.max, occupancyRecheckFramesField.step, occupancyRecheckFramesField.default;
+    motionFpsField.min, motionFpsField.max, motionFpsField.step, motionFpsField.default, detectionFpsField.min, detectionFpsField.max, detectionFpsField.step, detectionFpsField.default, motionCooldownMsField.min, motionCooldownMsField.max, motionCooldownMsField.step, motionCooldownMsField.default, maxSessionHoldMsField.min, maxSessionHoldMsField.max, maxSessionHoldMsField.step, maxSessionHoldMsField.default, audioMotionWindowMsField.min, audioMotionWindowMsField.max, audioMotionWindowMsField.step, audioMotionWindowMsField.default, preRollInferenceFramesField.min, preRollInferenceFramesField.max, preRollInferenceFramesField.step, preRollInferenceFramesField.default, occupancyRecheckSecField.min, occupancyRecheckSecField.max, occupancyRecheckSecField.step, occupancyRecheckSecField.default, occupancyRecheckFramesField.min, occupancyRecheckFramesField.max, occupancyRecheckFramesField.step, occupancyRecheckFramesField.default;
     var RunnerLocalLoadSchema = zod.z.object({
       /** Moleculer node id of this runner instance. */
       nodeId: zod.z.string(),
@@ -61277,7 +61308,7 @@ var require_alerts_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_WLsoGpyn();
+    var require_dist10 = require_dist_9GQQ9F3s();
     function selectExpired(alerts, cutoffMs) {
       return alerts.filter((a) => a.createdAt < cutoffMs).sort((a, b) => a.createdAt - b.createdAt).map((a) => a.id);
     }
@@ -62096,7 +62127,7 @@ var require_console_logging = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_WLsoGpyn();
+    var require_dist10 = require_dist_9GQQ9F3s();
     var require_formatter = require_formatter_DqAKDlvN();
     var LEVEL_RANK = {
       debug: 0,
@@ -62190,7 +62221,7 @@ var require_core_blocks_addon = __commonJS({
     "use strict";
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_WLsoGpyn();
+    var require_dist10 = require_dist_9GQQ9F3s();
     var node_crypto = __require("crypto");
     var node_fs_promises = __require("fs/promises");
     node_fs_promises = require_chunk.__toESM(node_fs_promises);
@@ -63087,11 +63118,11 @@ var require_core_blocks = __commonJS({
   }
 });
 
-// ../system/dist/retired-settings-keys-WShMmPM4.js
-var require_retired_settings_keys_WShMmPM4 = __commonJS({
-  "../system/dist/retired-settings-keys-WShMmPM4.js"(exports) {
+// ../system/dist/retired-settings-keys-DfdSH46H.js
+var require_retired_settings_keys_DfdSH46H = __commonJS({
+  "../system/dist/retired-settings-keys-DfdSH46H.js"(exports) {
     "use strict";
-    var require_dist10 = require_dist_WLsoGpyn();
+    var require_dist10 = require_dist_9GQQ9F3s();
     function settingsStoreIsAuthoritativeHere(env) {
       const raw = (env["CAMSTACK_ROLE"] ?? "").trim().toLowerCase();
       return raw === "" || raw === "hub";
@@ -65326,8 +65357,8 @@ var require_device_manager_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_WLsoGpyn();
-    var require_retired_settings_keys = require_retired_settings_keys_WShMmPM4();
+    var require_dist10 = require_dist_9GQQ9F3s();
+    var require_retired_settings_keys = require_retired_settings_keys_DfdSH46H();
     var node_crypto = __require("crypto");
     var _camstack_types_node = require_node();
     var JOB_HISTORY = 20;
@@ -70952,7 +70983,7 @@ var require_hub_forwarder = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_WLsoGpyn();
+    var require_dist10 = require_dist_9GQQ9F3s();
     var require_formatter = require_formatter_DqAKDlvN();
     var DEFAULT_OUTBOUND_BUFFER_SIZE = 500;
     var HubForwarderDestination = class {
@@ -71089,7 +71120,7 @@ var require_liveness_monitor_addon = __commonJS({
     "use strict";
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_WLsoGpyn();
+    var require_dist10 = require_dist_9GQQ9F3s();
     var NO_DEVICES = "liveness:no-devices";
     var ALL_OFFLINE = "liveness:all-devices-offline";
     var NO_FOOTAGE_PREFIX = "liveness:no-footage:";
@@ -71285,7 +71316,7 @@ var require_local_auth_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_WLsoGpyn();
+    var require_dist10 = require_dist_9GQQ9F3s();
     var node_crypto = __require("crypto");
     node_crypto = require_chunk.__toESM(node_crypto);
     var crypto$1 = __require("crypto");
@@ -79098,7 +79129,7 @@ var require_loki_logging = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_WLsoGpyn();
+    var require_dist10 = require_dist_9GQQ9F3s();
     function sanitizeLabelName(raw) {
       const replaced = raw.replaceAll(/[^a-zA-Z0-9_]/g, "_");
       return /^[a-zA-Z_]/.test(replaced) ? replaced : `_${replaced}`;
@@ -79663,7 +79694,7 @@ var require_native_metrics_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_WLsoGpyn();
+    var require_dist10 = require_dist_9GQQ9F3s();
     var node_fs_promises = __require("fs/promises");
     var node_child_process = __require("child_process");
     var node_util = __require("util");
@@ -82247,7 +82278,7 @@ var require_filesystem_storage_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_WLsoGpyn();
+    var require_dist10 = require_dist_9GQQ9F3s();
     var node_crypto = __require("crypto");
     var node_fs_promises = __require("fs/promises");
     var node_path = __require("path");
@@ -83363,8 +83394,8 @@ var require_sqlite_settings_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_WLsoGpyn();
-    var require_retired_settings_keys = require_retired_settings_keys_WShMmPM4();
+    var require_dist10 = require_dist_9GQQ9F3s();
+    var require_retired_settings_keys = require_retired_settings_keys_DfdSH46H();
     var node_crypto = __require("crypto");
     var node_fs = __require("fs");
     var node_module = __require("module");
@@ -85868,7 +85899,7 @@ var require_storage_orchestrator_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_WLsoGpyn();
+    var require_dist10 = require_dist_9GQQ9F3s();
     var require_hub_cap_forward = require_hub_cap_forward_DmHNjbB0();
     var zod = require_zod();
     var node_crypto = __require("crypto");
@@ -89518,7 +89549,7 @@ var require_system_config_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_WLsoGpyn();
+    var require_dist10 = require_dist_9GQQ9F3s();
     var SECTION_TITLES = {
       server: "Server",
       auth: "Authentication"
@@ -107579,7 +107610,7 @@ var require_winston_logging = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_WLsoGpyn();
+    var require_dist10 = require_dist_9GQQ9F3s();
     var require_formatter = require_formatter_DqAKDlvN();
     var node_path = __require("path");
     node_path = require_chunk.__toESM(node_path);
@@ -107716,9 +107747,9 @@ var require_winston_logging = __commonJS({
   }
 });
 
-// ../system/dist/file-data-plane-DO8KbxCe.js
-var require_file_data_plane_DO8KbxCe = __commonJS({
-  "../system/dist/file-data-plane-DO8KbxCe.js"(exports) {
+// ../system/dist/event-loop-stall-monitor-DM9OAzy8.js
+var require_event_loop_stall_monitor_DM9OAzy8 = __commonJS({
+  "../system/dist/event-loop-stall-monitor-DM9OAzy8.js"(exports) {
     "use strict";
     var require_chunk = require_chunk_Cek0wNdY();
     var node_crypto = __require("crypto");
@@ -107729,6 +107760,7 @@ var require_file_data_plane_DO8KbxCe = __commonJS({
     node_fs = require_chunk.__toESM(node_fs);
     var node_http = __require("http");
     var node_zlib = __require("zlib");
+    var node_perf_hooks = __require("perf_hooks");
     function isNonEmptyFile(filePath) {
       return node_fs.existsSync(filePath) && node_fs.statSync(filePath).size > 0;
     }
@@ -108516,12 +108548,98 @@ var require_file_data_plane_DO8KbxCe = __commonJS({
         (0, node_fs.createReadStream)(absPath).pipe(res);
       };
     }
+    var STALL_TICK_MS = 1e3;
+    var STALL_REPORT_MS = 2e3;
+    function attributeStall(stallMs, gcMs, gcCount, longestGcMs) {
+      const share = stallMs > 0 ? gcMs / stallMs : 0;
+      return {
+        stallMs,
+        gcMs,
+        gcCount,
+        longestGcMs,
+        cause: share >= 0.7 ? "gc" : share <= 0.2 ? "synchronous-block" : "mixed"
+      };
+    }
+    function startEventLoopStallMonitor(logger, reportThresholdMs = STALL_REPORT_MS) {
+      let gc = {
+        totalMs: 0,
+        count: 0,
+        longestMs: 0
+      };
+      let observer = null;
+      try {
+        observer = new node_perf_hooks.PerformanceObserver((list) => {
+          for (const entry of list.getEntries()) {
+            gc.totalMs += entry.duration;
+            gc.count += 1;
+            if (entry.duration > gc.longestMs) gc.longestMs = entry.duration;
+          }
+        });
+        observer.observe({ entryTypes: ["gc"] });
+      } catch {
+        observer = null;
+      }
+      let expected = Date.now() + STALL_TICK_MS;
+      const timer = setInterval(() => {
+        const now = Date.now();
+        const lateBy = now - expected;
+        const window2 = gc;
+        gc = {
+          totalMs: 0,
+          count: 0,
+          longestMs: 0
+        };
+        expected = now + STALL_TICK_MS;
+        if (lateBy < reportThresholdMs) return;
+        const verdict = attributeStall(lateBy, Math.round(window2.totalMs), window2.count, Math.round(window2.longestMs));
+        const mem = process.memoryUsage();
+        logger.warn("event loop stalled", { meta: {
+          stallMs: verdict.stallMs,
+          cause: verdict.cause,
+          gcMs: verdict.gcMs,
+          gcCount: verdict.gcCount,
+          longestGcMs: verdict.longestGcMs,
+          gcObserved: observer !== null,
+          heapUsedMb: Math.round(mem.heapUsed / 1e6),
+          heapTotalMb: Math.round(mem.heapTotal / 1e6),
+          rssMb: Math.round(mem.rss / 1e6),
+          externalMb: Math.round(mem.external / 1e6),
+          arrayBuffersMb: Math.round(mem.arrayBuffers / 1e6)
+        } });
+      }, STALL_TICK_MS);
+      timer.unref?.();
+      let stopped = false;
+      return () => {
+        if (stopped) return;
+        stopped = true;
+        clearInterval(timer);
+        observer?.disconnect();
+      };
+    }
     Object.defineProperty(exports, "ModelDownloadService", {
       enumerable: true,
       get: function() {
         return ModelDownloadService;
       }
     });
+    Object.defineProperty(exports, "STALL_REPORT_MS", {
+      enumerable: true,
+      get: function() {
+        return STALL_REPORT_MS;
+      }
+    });
+    Object.defineProperty(exports, "STALL_TICK_MS", {
+      enumerable: true,
+      get: function() {
+        return STALL_TICK_MS;
+      }
+    });
+    Object.defineProperty(exports, "attributeStall", {
+      enumerable: true,
+      get: function() {
+        return attributeStall;
+      }
+    });
     Object.defineProperty(exports, "collectModelFiles", {
       enumerable: true,
       get: function() {
@@ -108606,6 +108724,12 @@ var require_file_data_plane_DO8KbxCe = __commonJS({
         return resolveFilePath;
       }
     });
+    Object.defineProperty(exports, "startEventLoopStallMonitor", {
+      enumerable: true,
+      get: function() {
+        return startEventLoopStallMonitor;
+      }
+    });
   }
 });
 
@@ -113393,6 +113517,8 @@ var require_addon = __commonJS({
           "pipelineEnabled": true,
           "zones": [],
           "onboardMotionDrivesAnalyzer": true,
+          "preRollInferenceEnabled": true,
+          "preRollInferenceFrames": 12,
           "occupancyRecheckEnabled": true,
           "occupancyRecheckSec": 300,
           "occupancyRecheckFrames": 4,
@@ -132191,7 +132317,7 @@ var require_dist3 = __commonJS({
     "use strict";
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_WLsoGpyn();
+    var require_dist10 = require_dist_9GQQ9F3s();
     var require_builtins_alerts_alerts_addon = require_alerts_addon();
     require_alerts();
     var require_formatter = require_formatter_DqAKDlvN();
@@ -132216,7 +132342,7 @@ var require_dist3 = __commonJS({
     var require_builtins_system_config_system_config_addon = require_system_config_addon();
     require_system_config();
     var require_builtins_winston_logging_index = require_winston_logging();
-    var require_file_data_plane = require_file_data_plane_DO8KbxCe();
+    var require_event_loop_stall_monitor = require_event_loop_stall_monitor_DM9OAzy8();
     var require_tls$1 = require_tls_BxQlomxd();
     var require_manifest_system_deps = require_manifest_system_deps_DvY1bY_n();
     var require_resource_monitor = require_resource_monitor_CdnzxBLP();
@@ -212986,7 +213112,7 @@ globstar while`, t, d, e, f, m), this.matchOne(t.slice(d), e.slice(f), s)) retur
     exports.LokiLoggingAddon = require_builtins_loki_logging_index.LokiLoggingAddon$1;
     exports.MAX_LEAF_VALIDITY_DAYS = require_tls$1.MAX_LEAF_VALIDITY_DAYS;
     exports.METHOD_ACCESS_MAP = require_dist10.METHOD_ACCESS_MAP;
-    exports.ModelDownloadService = require_file_data_plane.ModelDownloadService;
+    exports.ModelDownloadService = require_event_loop_stall_monitor.ModelDownloadService;
     exports.NATIVE_PROVIDER_SERVICE_INFIX = require_manifest_system_deps.NATIVE_PROVIDER_SERVICE_INFIX;
     exports.NATIVE_SCAN_DEPTH = NATIVE_SCAN_DEPTH;
     exports.NativeMetricsAddon = require_builtins_native_metrics_native_metrics_addon.default;
@@ -213016,6 +213142,8 @@ globstar while`, t, d, e, f, m), this.matchOne(t.slice(d), e.slice(f), s)) retur
     exports.RingBuffer = RingBuffer;
     exports.SERVER_AUTH_OID = require_tls$1.SERVER_AUTH_OID;
     exports.SOCKET_PLANE_TOP_N = require_manifest_system_deps.SOCKET_PLANE_TOP_N;
+    exports.STALL_REPORT_MS = require_event_loop_stall_monitor.STALL_REPORT_MS;
+    exports.STALL_TICK_MS = require_event_loop_stall_monitor.STALL_TICK_MS;
     exports.ScopedLogger = ScopedLogger;
     exports.ScopedTokenManager = require_builtins_local_auth_local_auth_addon.ScopedTokenManager;
     exports.SocketChannel = require_manifest_system_deps.SocketChannel;
@@ -213043,6 +213171,7 @@ globstar while`, t, d, e, f, m), this.matchOne(t.slice(d), e.slice(f), s)) retur
     exports.addonSettingsCapability = require_dist10.addonSettingsCapability;
     exports.allFamiliesListenHost = require_tls$1.allFamiliesListenHost;
     exports.applyLanHttp = require_tls$1.applyLanHttp;
+    exports.attributeStall = require_event_loop_stall_monitor.attributeStall;
     exports.bindPendingLanHttp = require_tls$1.bindPendingLanHttp;
     exports.bootstrapSchema = bootstrapSchema;
     exports.brokerCallForCap = require_manifest_system_deps.brokerCallForCap;
@@ -213075,14 +213204,14 @@ globstar while`, t, d, e, f, m), this.matchOne(t.slice(d), e.slice(f), s)) retur
     exports.clusterEventTopic = require_manifest_system_deps.clusterEventTopic;
     exports.clusterSecretMatches = clusterSecretMatches;
     exports.collectCertIdentity = require_tls$1.collectCertIdentity;
-    exports.collectModelFiles = require_file_data_plane.collectModelFiles;
-    exports.contentTypeFor = require_file_data_plane.contentTypeFor;
+    exports.collectModelFiles = require_event_loop_stall_monitor.collectModelFiles;
+    exports.contentTypeFor = require_event_loop_stall_monitor.contentTypeFor;
     exports.copyDirRecursive = copyDirRecursive;
     exports.copyExtraFileDirs = copyExtraFileDirs;
     exports.createAddonContext = require_manifest_system_deps.createAddonContext;
     exports.createAddonDataPlaneFacility = require_manifest_system_deps.createAddonDataPlaneFacility;
     exports.createAddonService = require_manifest_system_deps.createAddonService;
-    exports.createAuthenticatedFileServer = require_file_data_plane.createAuthenticatedFileServer;
+    exports.createAuthenticatedFileServer = require_event_loop_stall_monitor.createAuthenticatedFileServer;
     exports.createBroker = createBroker2;
     exports.createBrokerDeviceManagerApi = require_manifest_system_deps.createBrokerDeviceManagerApi;
     exports.createCoreCapService = createCoreCapService;
@@ -213090,7 +213219,7 @@ globstar while`, t, d, e, f, m), this.matchOne(t.slice(d), e.slice(f), s)) retur
     exports.createDoorSettingsView = createDoorSettingsView;
     exports.createEventPlaneMeter = require_manifest_system_deps.createEventPlaneMeter;
     exports.createEventPlaneReader = require_manifest_system_deps.createEventPlaneReader;
-    exports.createFileDataPlaneHandler = require_file_data_plane.createFileDataPlaneHandler;
+    exports.createFileDataPlaneHandler = require_event_loop_stall_monitor.createFileDataPlaneHandler;
     exports.createHubCapForwardService = require_hub_cap_forward.createHubCapForwardService;
     exports.createHubService = createHubService;
     exports.createKernelHwAccel = require_manifest_system_deps.createKernelHwAccel;
@@ -213111,7 +213240,7 @@ globstar while`, t, d, e, f, m), this.matchOne(t.slice(d), e.slice(f), s)) retur
     exports.createUdsLogger = require_manifest_system_deps.createUdsLogger;
     exports.createUdsLoggerWithControl = require_manifest_system_deps.createUdsLoggerWithControl;
     exports.createV8Reclaimer = require_manifest_system_deps.createV8Reclaimer;
-    exports.deleteModelFromDisk = require_file_data_plane.deleteModelFromDisk;
+    exports.deleteModelFromDisk = require_event_loop_stall_monitor.deleteModelFromDisk;
     exports.deriveAgentListenPort = deriveAgentListenPort;
     exports.describeProviderKindDrift = describeProviderKindDrift;
     exports.describeRss = require_manifest_system_deps.describeRss;
@@ -213124,8 +213253,8 @@ globstar while`, t, d, e, f, m), this.matchOne(t.slice(d), e.slice(f), s)) retur
         return _camstack_types_node.downloadBinary;
       }
     });
-    exports.downloadFile = require_file_data_plane.downloadFile;
-    exports.downloadModel = require_file_data_plane.downloadModel;
+    exports.downloadFile = require_event_loop_stall_monitor.downloadFile;
+    exports.downloadModel = require_event_loop_stall_monitor.downloadModel;
     exports.emitDownForOwnedCaps = require_dist10.emitDownForOwnedCaps;
     exports.emitHeapDiagnosticReport = require_manifest_system_deps.emitHeapDiagnosticReport;
     exports.encodeFrame = require_manifest_system_deps.encodeFrame;
@@ -213144,7 +213273,7 @@ globstar while`, t, d, e, f, m), this.matchOne(t.slice(d), e.slice(f), s)) retur
       }
     });
     exports.ensureLibraryBuilt = ensureLibraryBuilt;
-    exports.ensureModel = require_file_data_plane.ensureModel;
+    exports.ensureModel = require_event_loop_stall_monitor.ensureModel;
     exports.ensureNativePrebuilds = ensureNativePrebuilds;
     Object.defineProperty(exports, "ensurePython", {
       enumerable: true,
@@ -213155,7 +213284,7 @@ globstar while`, t, d, e, f, m), this.matchOne(t.slice(d), e.slice(f), s)) retur
     exports.ensureTlsCert = require_tls$1.ensureTlsCert;
     exports.evaluateExistingCert = require_tls$1.evaluateExistingCert;
     exports.expandCapMethods = require_dist10.expandCapMethods;
-    exports.fetchJson = require_file_data_plane.fetchJson;
+    exports.fetchJson = require_event_loop_stall_monitor.fetchJson;
     Object.defineProperty(exports, "findInPath", {
       enumerable: true,
       get: function() {
@@ -213175,7 +213304,7 @@ globstar while`, t, d, e, f, m), this.matchOne(t.slice(d), e.slice(f), s)) retur
       }
     });
     exports.getLoggingGate = getLoggingGate;
-    exports.getModelFilePath = require_file_data_plane.getModelFilePath;
+    exports.getModelFilePath = require_event_loop_stall_monitor.getModelFilePath;
     exports.getMoleculerEventStats = require_manifest_system_deps.getMoleculerEventStats;
     exports.getOrInitReadinessRegistry = require_manifest_system_deps.getOrInitReadinessRegistry;
     exports.getOrInitReadinessRegistryForClient = require_manifest_system_deps.getOrInitReadinessRegistryForClient;
@@ -213221,7 +213350,7 @@ globstar while`, t, d, e, f, m), this.matchOne(t.slice(d), e.slice(f), s)) retur
     exports.isClusterSecretMismatchError = isClusterSecretMismatchError;
     exports.isCollectionArrayMethod = require_dist10.isCollectionArrayMethod;
     exports.isInfraCapability = isInfraCapability;
-    exports.isModelDownloaded = require_file_data_plane.isModelDownloaded;
+    exports.isModelDownloaded = require_event_loop_stall_monitor.isModelDownloaded;
     exports.isSourceNewer = isSourceNewer;
     exports.isolatedBuiltinPhase = isolatedBuiltinPhase;
     exports.loadTlsCert = require_tls$1.loadTlsCert;
@@ -213230,9 +213359,9 @@ globstar while`, t, d, e, f, m), this.matchOne(t.slice(d), e.slice(f), s)) retur
     exports.mountNativeCapService = require_manifest_system_deps.mountNativeCapService;
     exports.nextRssBudgetState = require_manifest_system_deps.nextRssBudgetState;
     exports.parseCapAction = require_manifest_system_deps.parseCapAction;
-    exports.parseRangeHeader = require_file_data_plane.parseRangeHeader;
+    exports.parseRangeHeader = require_event_loop_stall_monitor.parseRangeHeader;
     exports.parseRssBudgetMb = require_manifest_system_deps.parseRssBudgetMb;
-    exports.parseTokenizedUrl = require_file_data_plane.parseTokenizedUrl;
+    exports.parseTokenizedUrl = require_event_loop_stall_monitor.parseTokenizedUrl;
     exports.partitionIsolatedBuiltinIds = partitionIsolatedBuiltinIds;
     exports.proxyToUpstream = proxyToUpstream;
     exports.quarantineAddonResidue = quarantineAddonResidue;
@@ -213249,7 +213378,7 @@ globstar while`, t, d, e, f, m), this.matchOne(t.slice(d), e.slice(f), s)) retur
     exports.registerEventBusService = require_manifest_system_deps.registerEventBusService;
     exports.registerLanHttpHandler = require_tls$1.registerLanHttpHandler;
     exports.reissueTlsLeaf = require_tls$1.reissueTlsLeaf;
-    exports.resolveFilePath = require_file_data_plane.resolveFilePath;
+    exports.resolveFilePath = require_event_loop_stall_monitor.resolveFilePath;
     exports.resolveHwAccel = require_manifest_system_deps.resolveHwAccel;
     exports.resolveNpmInvocation = require_manifest_system_deps.resolveNpmInvocation;
     exports.runHubAddonBoot = runHubAddonBoot;
@@ -213267,6 +213396,7 @@ globstar while`, t, d, e, f, m), this.matchOne(t.slice(d), e.slice(f), s)) retur
     exports.shouldReclaim = require_manifest_system_deps.shouldReclaim;
     exports.socketDirectionBytes = require_manifest_system_deps.socketDirectionBytes;
     exports.socketDirectionMessages = require_manifest_system_deps.socketDirectionMessages;
+    exports.startEventLoopStallMonitor = require_event_loop_stall_monitor.startEventLoopStallMonitor;
     exports.startHeapWatch = require_manifest_system_deps.startHeapWatch;
     exports.startRunnerHeapWatch = require_manifest_system_deps.startRunnerHeapWatch;
     exports.strandedMb = require_manifest_system_deps.strandedMb;
@@ -229552,6 +229682,12 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
       default: 4,
       step: 1
     };
+    var preRollInferenceFramesField = {
+      min: 0,
+      max: 30,
+      default: 12,
+      step: 1
+    };
     var MotionSourceEnum = zod.z.enum([
       "onboard",
       "analyzer",
@@ -229713,6 +229849,31 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
       * to every occupancy rule until something moved in front of it. The churn is
       * now paid on the interval instead — see `occupancyRecheckSecField`.
       */
+      /**
+      * Infer the session's PRE-ROLL — the retained history the restreamer replays
+      * at session open — instead of decoding it and throwing it away.
+      *
+      * DEFAULT `true`, and the default is the argument. This is not a new
+      * capability being offered cautiously: the pre-roll is ALREADY requested,
+      * already served, already decoded and already paid for on every on-motion
+      * detection session that asks for history. What shipped was a last-moment
+      * discard — `FrameSlot`'s throttle compares wall clocks, and ~4 s of media
+      * arriving inside a few hundred ms of wall clock looks to it like one frame's
+      * worth. Device 617, 2026-09-08: a re-run of the SAME model over the stored
+      * recording scored the subject `vehicle 0.5669` — above the 0.50 floor —
+      * 1.68 s BEFORE the live track was born, on a frame that was in the pre-roll,
+      * was decoded, and was freed.
+      *
+      * Shipping that as opt-in would ship the bug: an operator cannot discover a
+      * setting whose absence looks exactly like a camera that noticed the cyclist
+      * late. What makes ON safe is not a switch but the BOUND —
+      * `preRollInferenceFrames`, a wall-clock ceiling, and a lane that never takes
+      * the last inference permit — so the switch exists for the camera where the
+      * history is worthless (a doorbell whose subject is always already at the
+      * door), not as a hedge against the feature.
+      */
+      preRollInferenceEnabled: zod.z.boolean().default(true),
+      preRollInferenceFrames: zod.z.number().min(preRollInferenceFramesField.min).max(preRollInferenceFramesField.max).default(preRollInferenceFramesField.default),
       occupancyRecheckEnabled: zod.z.boolean().default(true),
       occupancyRecheckSec: zod.z.number().min(occupancyRecheckSecField.min).max(occupancyRecheckSecField.max).default(occupancyRecheckSecField.default),
       occupancyRecheckFrames: zod.z.number().min(occupancyRecheckFramesField.min).max(occupancyRecheckFramesField.max).default(occupancyRecheckFramesField.default),
@@ -229852,6 +230013,29 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
           includes: "onboard"
         }
       },
+      {
+        key: "preRollInferenceEnabled",
+        type: "boolean",
+        style: "checkbox",
+        label: "Detect in the pre-roll",
+        description: "Run detection over the few seconds of footage the camera had already buffered when motion fired, so a subject that was in view before the trigger is found at the moment it appeared rather than seconds later. The burst is bounded and never delays live detection.",
+        default: true
+      },
+      {
+        key: "preRollInferenceFrames",
+        type: "slider",
+        label: "Pre-roll frames",
+        description: "How many frames of buffered history may be detected on, per session. Higher samples the history more densely; 0 disables the pass.",
+        min: preRollInferenceFramesField.min,
+        max: preRollInferenceFramesField.max,
+        step: preRollInferenceFramesField.step,
+        default: preRollInferenceFramesField.default,
+        showValue: true,
+        showWhen: {
+          field: "preRollInferenceEnabled",
+          equals: true
+        }
+      },
       {
         key: "occupancyRecheckEnabled",
         type: "boolean",
@@ -432047,6 +432231,8 @@ var require_main4 = __commonJS({
           heapWatchLogger.warn(line);
         }
       });
+      const stallLogger = loggingService.createLogger("event-loop");
+      (0, system_1.startEventLoopStallMonitor)(stallLogger);
       const addonRouteRegistry = new system_1.AddonRouteRegistry();
       const dataPlaneRegistry = new system_1.DataPlaneRegistry();
       const { NotificationServiceWrapper } = await Promise.resolve().then(() => __importStar(require_notification_wrapper_service()));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "camstack",
-  "version": "1.2.129",
+  "version": "1.2.131",
   "description": "CLI tool for managing and running CamStack server",
   "keywords": [
     "camstack",