camstack 1.2.129 → 1.2.130

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-O4PI5LJI.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-O4PI5LJI.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-O4PI5LJI.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);
@@ -113393,6 +113424,8 @@ var require_addon = __commonJS({
           "pipelineEnabled": true,
           "zones": [],
           "onboardMotionDrivesAnalyzer": true,
+          "preRollInferenceEnabled": true,
+          "preRollInferenceFrames": 12,
           "occupancyRecheckEnabled": true,
           "occupancyRecheckSec": 300,
           "occupancyRecheckFrames": 4,
@@ -132191,7 +132224,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();
@@ -229552,6 +229585,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 +229752,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 +229916,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",

package/package.json

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