camstack 1.2.108 → 1.2.110

package/dist/{chunk-OLHRHGNY.js → chunk-YK6NE5VI.js}

@@ -14522,7 +14522,7 @@ function date4(params) {
 // ../../node_modules/zod/v4/classic/external.js
 config(en_default());
 
-// ../types/dist/sleep-IaOr7P-z.mjs
+// ../types/dist/sleep-Cfij6Jj9.mjs
 var WELL_KNOWN_TABS = [
   {
     id: "overview",
@@ -15693,7 +15693,8 @@ var HHMM = /^([01]\d|2[0-3]):[0-5]\d$/;
 var RecordingStorageModeSchema = external_exports.enum([
   "off",
   "events",
-  "continuous"
+  "continuous",
+  "on-device-decision"
 ]);
 var RecordingObjectTriggerClassSchema = external_exports.enum(FIRST_LEVEL_MACRO_CLASSES);
 var noDuplicates = (values) => new Set(values).size === values.length;
@@ -15730,22 +15731,7 @@ var RecordingTriggersSchema = external_exports.object({
   * il livello: un contatto trovato già aperto al riavvio del runner non fa
   * registrare.
   */
-  sensorDeviceIds: external_exports.array(external_exports.number().int().positive()).min(1).max(16).refine(noDuplicates, { message: "sensorDeviceIds must not repeat a device" }).optional(),
-  /**
-  * La camera registra per tutta la durata del SEGNALE che lei stessa
-  * pubblica — la cap `recording-signal` (`active: true` mentre il device è in
-  * funzione: un robot che pulisce). È un LIVELLO, non un fronte: la finestra
-  * resta aperta finché il segnale è alto e si chiude `postBufferSec` dopo la
-  * caduta, così una pulizia di quaranta minuti è UNA clip.
-  *
-  * Non nomina un device: il segnale è della camera stessa, tenuto fresco dal
-  * suo provider (D224); il recorder lo ascolta su `DeviceStateChanged` e lo
-  * riconcilia leggendo la slice via RPC, con un tetto oltre il quale un
-  * segnale mai abbassato (un evento perso) non può tenere aperta una
-  * registrazione (D11). Vedi `recorder/addon/band-decision.ts`
-  * (`holdTrigger` / `releaseTrigger`).
-  */
-  deviceSignal: external_exports.boolean().optional()
+  sensorDeviceIds: external_exports.array(external_exports.number().int().positive()).min(1).max(16).refine(noDuplicates, { message: "sensorDeviceIds must not repeat a device" }).optional()
 });
 var RecordingBandModeSchema = external_exports.enum(["continuous", "events"]);
 var RecordingBandTriggersSchema = RecordingTriggersSchema;
@@ -15755,13 +15741,28 @@ var RecordingBandSchema = external_exports.object({
   end: external_exports.string().regex(HHMM),
   mode: RecordingBandModeSchema,
   triggers: RecordingBandTriggersSchema.optional(),
+  /**
+  * RETIRED (D381). A band no longer carries a pre-buffer of its own.
+  *
+  * It was the retroactive KEEP bound — which already-written segments survive
+  * a trigger — and it had to be at least as wide as the widest pre-roll the
+  * broker could serve, or the gate would delete the seconds the ring had just
+  * handed the writer. That "at least as wide as" is the tell: it was a second
+  * expression of the broker's retention, in different units, in a different
+  * addon, with an invariant the operator had to maintain by hand. The keep
+  * bound is now derived from the one prebuffer ceiling and there is nothing
+  * left to configure here.
+  *
+  * The key survives in the SHAPE so a config written before that record still
+  * parses and can be migrated deliberately — `RecordingBandSchema` is not
+  * strict, so simply deleting it would strip an operator's value in silence on
+  * the next save (the failure D380 came one commit from shipping). Nothing
+  * reads it: {@link stripRetiredBandPreBufferSec} removes it on load.
+  */
   preBufferSec: external_exports.number().min(0).optional(),
   postBufferSec: external_exports.number().min(0).optional()
 });
-var DEFAULT_EVENTS_BAND_BUFFER_SEC = {
-  preBufferSec: 15,
-  postBufferSec: 30
-};
+var DEFAULT_EVENTS_BAND_BUFFER_SEC = { postBufferSec: 30 };
 var VISIT_MERGE_GAP_MS = DEFAULT_EVENTS_BAND_BUFFER_SEC.postBufferSec * 1e3;
 var RecordingRetentionSchema = external_exports.object({
   maxAgeDays: external_exports.number().min(0).optional(),
@@ -15786,8 +15787,29 @@ var RecordingConfigSchema = external_exports.object({
   * "off" is the absence of a covering band, never a band value.
   */
   bands: external_exports.array(RecordingBandSchema).default([]),
+  /**
+  * THE device-decided intent: record for as long as the camera itself raises
+  * `recording-signal` (`active: true` while the device is in function — a
+  * robot that cleans). AUTHORED, unlike `mode`, and the only authored
+  * recording intent that is not a band.
+  *
+  * It carries NO schedule on purpose. A band is an HOUR, and this feature has
+  * no hour to program: the device decides. What it costs the operator is one
+  * flag — "this camera can record on its own" — and what it buys is the same
+  * hold/release the recorder already implements (D371, `holdTrigger` /
+  * `releaseTrigger`): the window opens on the rise, stays open for the whole
+  * job however long it is, and closes one pad after the fall.
+  *
+  * EXCLUSIVE with `bands` (below): two authorities deciding when the same
+  * camera records is the D62 failure. `off` remains `enabled: false`, so an
+  * operator switching this camera off is REPORTED off, never as broken.
+  */
+  deviceDecision: external_exports.boolean().optional(),
   retention: RecordingRetentionSchema.optional()
-}).strict();
+}).strict().refine((config2) => config2.deviceDecision !== true || config2.bands.length === 0, {
+  message: "deviceDecision is a whole-config mode and carries no schedule: it cannot be combined with bands",
+  path: ["bands"]
+});
 var RelocateJobStateSchema = external_exports.enum([
   "queued",
   "running",
@@ -28844,11 +28866,7 @@ var CameraAudioStatusSchema = external_exports.object({
   nodeId: external_exports.string(),
   enabled: external_exports.boolean()
 });
-var CameraRecordingModeSchema = external_exports.enum([
-  "off",
-  "continuous",
-  "events"
-]);
+var CameraRecordingModeSchema = RecordingStorageModeSchema;
 var CameraRecordingStatusSchema = external_exports.object({
   mode: CameraRecordingModeSchema,
   active: external_exports.boolean(),
@@ -37153,11 +37171,10 @@ var rebootCapability = {
 var RecordingStatusSchema = external_exports.object({
   deviceId: external_exports.number(),
   enabled: external_exports.boolean(),
-  activeMode: external_exports.enum([
-    "off",
-    "continuous",
-    "events"
-  ]),
+  /** THE derived storage mode, from the one definition
+  *  (`deriveRecordingMode`) — never a second enum. A duplicated list is how
+  *  `on-device-decision` could have reached the recorder and not the status. */
+  activeMode: RecordingStorageModeSchema,
   nodeId: external_exports.string(),
   storageBytes: external_exports.number()
 });

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   runDiscover
-} from "./chunk-OLHRHGNY.js";
+} from "./chunk-YK6NE5VI.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-4UETVHGT.js");
+  await import("./launcher-YBWRBM2B.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-4UETVHGT.js");
+  await import("./launcher-YBWRBM2B.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-MHBOYSVK.js");
+  const { discoverNodes, resolveHubFromDiscovered, filterHubNodes, DEFAULT_HUB_HTTPS_PORT } = await import("./discover-6YJTDHZO.js");
   if (presetNamespace) {
     const spinner4 = clack.spinner();
     spinner4.start(`Discovering hub on LAN (namespace "${presetNamespace}")`);

package/dist/{discover-MHBOYSVK.js → discover-6YJTDHZO.js}

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

package/dist/{launcher-4UETVHGT.js → launcher-YBWRBM2B.js}

@@ -23633,9 +23633,9 @@ var require_zod = __commonJS({
   }
 });
 
-// ../system/dist/dist-BNaW68aZ.js
-var require_dist_BNaW68aZ = __commonJS({
-  "../system/dist/dist-BNaW68aZ.js"(exports) {
+// ../system/dist/dist-KQ5D2wqr.js
+var require_dist_KQ5D2wqr = __commonJS({
+  "../system/dist/dist-KQ5D2wqr.js"(exports) {
     "use strict";
     var zod = require_zod();
     var EventCategory = /* @__PURE__ */ (function(EventCategory2) {
@@ -26036,21 +26036,21 @@ var require_dist_BNaW68aZ = __commonJS({
       for (const section of sectionsOf(schema)) for (const field of fieldsOf(section)) walkField(field, keys);
       return keys;
     }
-    function isRecord$2(value) {
+    function isRecord$3(value) {
       return typeof value === "object" && value !== null && !Array.isArray(value);
     }
     function sectionsOf(schema) {
-      if (!isRecord$2(schema)) return [];
+      if (!isRecord$3(schema)) return [];
       const sections = schema["sections"];
       return Array.isArray(sections) ? sections : [];
     }
     function fieldsOf(node) {
-      if (!isRecord$2(node)) return [];
+      if (!isRecord$3(node)) return [];
       const fields = node["fields"];
       return Array.isArray(fields) ? fields : [];
     }
     function walkField(field, out) {
-      if (!isRecord$2(field)) return;
+      if (!isRecord$3(field)) return;
       const type = field["type"];
       const key = field["key"];
       if ((type === "password" || field["secret"] === true) && typeof key === "string" && key.length > 0) out.add(key);
@@ -26192,7 +26192,8 @@ var require_dist_BNaW68aZ = __commonJS({
     var RecordingStorageModeSchema = zod.z.enum([
       "off",
       "events",
-      "continuous"
+      "continuous",
+      "on-device-decision"
     ]);
     var RecordingObjectTriggerClassSchema = zod.z.enum(FIRST_LEVEL_MACRO_CLASSES);
     var noDuplicates = (values) => new Set(values).size === values.length;
@@ -26229,22 +26230,7 @@ var require_dist_BNaW68aZ = __commonJS({
       * il livello: un contatto trovato già aperto al riavvio del runner non fa
       * registrare.
       */
-      sensorDeviceIds: zod.z.array(zod.z.number().int().positive()).min(1).max(16).refine(noDuplicates, { message: "sensorDeviceIds must not repeat a device" }).optional(),
-      /**
-      * La camera registra per tutta la durata del SEGNALE che lei stessa
-      * pubblica — la cap `recording-signal` (`active: true` mentre il device è in
-      * funzione: un robot che pulisce). È un LIVELLO, non un fronte: la finestra
-      * resta aperta finché il segnale è alto e si chiude `postBufferSec` dopo la
-      * caduta, così una pulizia di quaranta minuti è UNA clip.
-      *
-      * Non nomina un device: il segnale è della camera stessa, tenuto fresco dal
-      * suo provider (D224); il recorder lo ascolta su `DeviceStateChanged` e lo
-      * riconcilia leggendo la slice via RPC, con un tetto oltre il quale un
-      * segnale mai abbassato (un evento perso) non può tenere aperta una
-      * registrazione (D11). Vedi `recorder/addon/band-decision.ts`
-      * (`holdTrigger` / `releaseTrigger`).
-      */
-      deviceSignal: zod.z.boolean().optional()
+      sensorDeviceIds: zod.z.array(zod.z.number().int().positive()).min(1).max(16).refine(noDuplicates, { message: "sensorDeviceIds must not repeat a device" }).optional()
     });
     var RecordingBandModeSchema = zod.z.enum(["continuous", "events"]);
     var RecordingBandTriggersSchema = RecordingTriggersSchema;
@@ -26254,13 +26240,28 @@ var require_dist_BNaW68aZ = __commonJS({
       end: zod.z.string().regex(HHMM),
       mode: RecordingBandModeSchema,
       triggers: RecordingBandTriggersSchema.optional(),
+      /**
+      * RETIRED (D381). A band no longer carries a pre-buffer of its own.
+      *
+      * It was the retroactive KEEP bound — which already-written segments survive
+      * a trigger — and it had to be at least as wide as the widest pre-roll the
+      * broker could serve, or the gate would delete the seconds the ring had just
+      * handed the writer. That "at least as wide as" is the tell: it was a second
+      * expression of the broker's retention, in different units, in a different
+      * addon, with an invariant the operator had to maintain by hand. The keep
+      * bound is now derived from the one prebuffer ceiling and there is nothing
+      * left to configure here.
+      *
+      * The key survives in the SHAPE so a config written before that record still
+      * parses and can be migrated deliberately — `RecordingBandSchema` is not
+      * strict, so simply deleting it would strip an operator's value in silence on
+      * the next save (the failure D380 came one commit from shipping). Nothing
+      * reads it: {@link stripRetiredBandPreBufferSec} removes it on load.
+      */
       preBufferSec: zod.z.number().min(0).optional(),
       postBufferSec: zod.z.number().min(0).optional()
     });
-    ({
-      preBufferSec: 15,
-      postBufferSec: 30
-    }).postBufferSec * 1e3;
+    ({ postBufferSec: 30 }).postBufferSec * 1e3;
     var RecordingRetentionSchema = zod.z.object({
       maxAgeDays: zod.z.number().min(0).optional(),
       maxSizeGb: zod.z.number().min(0).optional()
@@ -26284,8 +26285,29 @@ var require_dist_BNaW68aZ = __commonJS({
       * "off" is the absence of a covering band, never a band value.
       */
       bands: zod.z.array(RecordingBandSchema).default([]),
+      /**
+      * THE device-decided intent: record for as long as the camera itself raises
+      * `recording-signal` (`active: true` while the device is in function — a
+      * robot that cleans). AUTHORED, unlike `mode`, and the only authored
+      * recording intent that is not a band.
+      *
+      * It carries NO schedule on purpose. A band is an HOUR, and this feature has
+      * no hour to program: the device decides. What it costs the operator is one
+      * flag — "this camera can record on its own" — and what it buys is the same
+      * hold/release the recorder already implements (D371, `holdTrigger` /
+      * `releaseTrigger`): the window opens on the rise, stays open for the whole
+      * job however long it is, and closes one pad after the fall.
+      *
+      * EXCLUSIVE with `bands` (below): two authorities deciding when the same
+      * camera records is the D62 failure. `off` remains `enabled: false`, so an
+      * operator switching this camera off is REPORTED off, never as broken.
+      */
+      deviceDecision: zod.z.boolean().optional(),
       retention: RecordingRetentionSchema.optional()
-    }).strict();
+    }).strict().refine((config) => config.deviceDecision !== true || config.bands.length === 0, {
+      message: "deviceDecision is a whole-config mode and carries no schedule: it cannot be combined with bands",
+      path: ["bands"]
+    });
     var RelocateJobStateSchema = zod.z.enum([
       "queued",
       "running",
@@ -39407,11 +39429,7 @@ var require_dist_BNaW68aZ = __commonJS({
       nodeId: zod.z.string(),
       enabled: zod.z.boolean()
     });
-    var CameraRecordingModeSchema = zod.z.enum([
-      "off",
-      "continuous",
-      "events"
-    ]);
+    var CameraRecordingModeSchema = RecordingStorageModeSchema;
     var CameraRecordingStatusSchema = zod.z.object({
       mode: CameraRecordingModeSchema,
       active: zod.z.boolean(),
@@ -47712,11 +47730,10 @@ var require_dist_BNaW68aZ = __commonJS({
     var RecordingStatusSchema = zod.z.object({
       deviceId: zod.z.number(),
       enabled: zod.z.boolean(),
-      activeMode: zod.z.enum([
-        "off",
-        "continuous",
-        "events"
-      ]),
+      /** THE derived storage mode, from the one definition
+      *  (`deriveRecordingMode`) — never a second enum. A duplicated list is how
+      *  `on-device-decision` could have reached the recorder and not the status. */
+      activeMode: RecordingStorageModeSchema,
       nodeId: zod.z.string(),
       storageBytes: zod.z.number()
     });
@@ -60658,7 +60675,7 @@ var require_alerts_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_BNaW68aZ();
+    var require_dist10 = require_dist_KQ5D2wqr();
     function selectExpired(alerts, cutoffMs) {
       return alerts.filter((a) => a.createdAt < cutoffMs).sort((a, b) => a.createdAt - b.createdAt).map((a) => a.id);
     }
@@ -61477,7 +61494,7 @@ var require_console_logging = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_BNaW68aZ();
+    var require_dist10 = require_dist_KQ5D2wqr();
     var require_formatter = require_formatter_DqAKDlvN();
     var LEVEL_RANK = {
       debug: 0,
@@ -61571,7 +61588,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_BNaW68aZ();
+    var require_dist10 = require_dist_KQ5D2wqr();
     var node_crypto = __require("crypto");
     var node_fs_promises = __require("fs/promises");
     node_fs_promises = require_chunk.__toESM(node_fs_promises);
@@ -62468,11 +62485,11 @@ var require_core_blocks = __commonJS({
   }
 });
 
-// ../system/dist/retired-settings-keys-FwgzdSHJ.js
-var require_retired_settings_keys_FwgzdSHJ = __commonJS({
-  "../system/dist/retired-settings-keys-FwgzdSHJ.js"(exports) {
+// ../system/dist/retired-settings-keys-2lWk7OeU.js
+var require_retired_settings_keys_2lWk7OeU = __commonJS({
+  "../system/dist/retired-settings-keys-2lWk7OeU.js"(exports) {
     "use strict";
-    var require_dist10 = require_dist_BNaW68aZ();
+    var require_dist10 = require_dist_KQ5D2wqr();
     function settingsStoreIsAuthoritativeHere(env) {
       const raw = (env["CAMSTACK_ROLE"] ?? "").trim().toLowerCase();
       return raw === "" || raw === "hub";
@@ -64686,8 +64703,8 @@ var require_device_manager_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_BNaW68aZ();
-    var require_retired_settings_keys = require_retired_settings_keys_FwgzdSHJ();
+    var require_dist10 = require_dist_KQ5D2wqr();
+    var require_retired_settings_keys = require_retired_settings_keys_2lWk7OeU();
     var node_crypto = __require("crypto");
     var _camstack_types_node = require_node();
     var JOB_HISTORY = 20;
@@ -70312,7 +70329,7 @@ var require_hub_forwarder = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_BNaW68aZ();
+    var require_dist10 = require_dist_KQ5D2wqr();
     var require_formatter = require_formatter_DqAKDlvN();
     var DEFAULT_OUTBOUND_BUFFER_SIZE = 500;
     var HubForwarderDestination = class {
@@ -70449,7 +70466,7 @@ var require_liveness_monitor_addon = __commonJS({
     "use strict";
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_BNaW68aZ();
+    var require_dist10 = require_dist_KQ5D2wqr();
     var NO_DEVICES = "liveness:no-devices";
     var ALL_OFFLINE = "liveness:all-devices-offline";
     var NO_FOOTAGE_PREFIX = "liveness:no-footage:";
@@ -70645,7 +70662,7 @@ var require_local_auth_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_BNaW68aZ();
+    var require_dist10 = require_dist_KQ5D2wqr();
     var node_crypto = __require("crypto");
     node_crypto = require_chunk.__toESM(node_crypto);
     var crypto$1 = __require("crypto");
@@ -78458,7 +78475,7 @@ var require_loki_logging = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_BNaW68aZ();
+    var require_dist10 = require_dist_KQ5D2wqr();
     function sanitizeLabelName(raw) {
       const replaced = raw.replaceAll(/[^a-zA-Z0-9_]/g, "_");
       return /^[a-zA-Z_]/.test(replaced) ? replaced : `_${replaced}`;
@@ -79023,7 +79040,7 @@ var require_native_metrics_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_BNaW68aZ();
+    var require_dist10 = require_dist_KQ5D2wqr();
     var node_fs_promises = __require("fs/promises");
     var node_child_process = __require("child_process");
     var node_util = __require("util");
@@ -81607,7 +81624,7 @@ var require_filesystem_storage_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_BNaW68aZ();
+    var require_dist10 = require_dist_KQ5D2wqr();
     var node_crypto = __require("crypto");
     var node_fs_promises = __require("fs/promises");
     var node_path = __require("path");
@@ -82723,8 +82740,8 @@ var require_sqlite_settings_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_BNaW68aZ();
-    var require_retired_settings_keys = require_retired_settings_keys_FwgzdSHJ();
+    var require_dist10 = require_dist_KQ5D2wqr();
+    var require_retired_settings_keys = require_retired_settings_keys_2lWk7OeU();
     var node_crypto = __require("crypto");
     var node_fs = __require("fs");
     var node_module = __require("module");
@@ -85214,7 +85231,7 @@ var require_storage_orchestrator_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_BNaW68aZ();
+    var require_dist10 = require_dist_KQ5D2wqr();
     var require_hub_cap_forward = require_hub_cap_forward_DmHNjbB0();
     var zod = require_zod();
     var node_crypto = __require("crypto");
@@ -88165,7 +88182,7 @@ var require_system_config_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_BNaW68aZ();
+    var require_dist10 = require_dist_KQ5D2wqr();
     var SECTION_TITLES = {
       server: "Server",
       auth: "Authentication"
@@ -106226,7 +106243,7 @@ var require_winston_logging = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_BNaW68aZ();
+    var require_dist10 = require_dist_KQ5D2wqr();
     var require_formatter = require_formatter_DqAKDlvN();
     var node_path = __require("path");
     node_path = require_chunk.__toESM(node_path);
@@ -108170,9 +108187,9 @@ var require_event_category_b8kBSOTT = __commonJS({
   }
 });
 
-// ../types/dist/sleep-BGiOgxye.js
-var require_sleep_BGiOgxye = __commonJS({
-  "../types/dist/sleep-BGiOgxye.js"(exports) {
+// ../types/dist/sleep-DDIFZGbc.js
+var require_sleep_DDIFZGbc = __commonJS({
+  "../types/dist/sleep-DDIFZGbc.js"(exports) {
     "use strict";
     var require_event_category = require_event_category_b8kBSOTT();
     var zod = require_zod();
@@ -111299,6 +111316,7 @@ var require_sleep_BGiOgxye = __commonJS({
       "ptz",
       "ptz-autotrack",
       "reboot",
+      "recording-signal",
       "scene-monitor",
       "script-runner",
       "smoke",
@@ -111903,7 +111921,7 @@ var require_addon = __commonJS({
     "use strict";
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
     var require_event_category = require_event_category_b8kBSOTT();
-    var require_sleep = require_sleep_BGiOgxye();
+    var require_sleep = require_sleep_DDIFZGbc();
     var require_err_msg = require_err_msg_COpsHMw2();
     var CAP_INPUT_DEFAULTS = Object.freeze({
       "addons": { "getLogs": { "limit": 100 } },
@@ -130863,7 +130881,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_BNaW68aZ();
+    var require_dist10 = require_dist_KQ5D2wqr();
     var require_builtins_alerts_alerts_addon = require_alerts_addon();
     require_alerts();
     var require_formatter = require_formatter_DqAKDlvN();
@@ -211980,7 +211998,7 @@ var require_dist4 = __commonJS({
     "use strict";
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
     var require_event_category = require_event_category_b8kBSOTT();
-    var require_sleep = require_sleep_BGiOgxye();
+    var require_sleep = require_sleep_DDIFZGbc();
     var require_canonical_hash = require_canonical_hash_DNV8S5ET();
     var require_enums2 = require_enums();
     var require_err_msg = require_err_msg_COpsHMw2();
@@ -212705,21 +212723,21 @@ var require_dist4 = __commonJS({
       for (const section of sectionsOf(schema)) if (fieldsOf(section).length > 0) return true;
       return false;
     }
-    function isRecord$2(value) {
+    function isRecord$3(value) {
       return typeof value === "object" && value !== null && !Array.isArray(value);
     }
     function sectionsOf(schema) {
-      if (!isRecord$2(schema)) return [];
+      if (!isRecord$3(schema)) return [];
       const sections = schema["sections"];
       return Array.isArray(sections) ? sections : [];
     }
     function fieldsOf(node) {
-      if (!isRecord$2(node)) return [];
+      if (!isRecord$3(node)) return [];
       const fields = node["fields"];
       return Array.isArray(fields) ? fields : [];
     }
     function walkField(field, out) {
-      if (!isRecord$2(field)) return;
+      if (!isRecord$3(field)) return;
       const type = field["type"];
       const key = field["key"];
       if ((type === "password" || field["secret"] === true) && typeof key === "string" && key.length > 0) out.add(key);
@@ -212787,12 +212805,12 @@ var require_dist4 = __commonJS({
     function isString2(v) {
       return typeof v === "string";
     }
-    function isRecord$1(v) {
+    function isRecord$2(v) {
       return typeof v === "object" && v !== null && !Array.isArray(v);
     }
     function parseStreamEntry(v) {
       if (isString2(v) && v.trim()) return { url: v };
-      if (isRecord$1(v) && isString2(v["url"]) && v["url"].trim()) return {
+      if (isRecord$2(v) && isString2(v["url"]) && v["url"].trim()) return {
         url: v["url"],
         label: isString2(v["label"]) ? v["label"] : void 0
       };
@@ -213197,7 +213215,8 @@ var require_dist4 = __commonJS({
     var RecordingStorageModeSchema = zod.z.enum([
       "off",
       "events",
-      "continuous"
+      "continuous",
+      "on-device-decision"
     ]);
     var RecordingObjectTriggerClassSchema = zod.z.enum(FIRST_LEVEL_MACRO_CLASSES);
     var noDuplicates = (values) => new Set(values).size === values.length;
@@ -213235,22 +213254,7 @@ var require_dist4 = __commonJS({
       * il livello: un contatto trovato già aperto al riavvio del runner non fa
       * registrare.
       */
-      sensorDeviceIds: zod.z.array(zod.z.number().int().positive()).min(1).max(16).refine(noDuplicates, { message: "sensorDeviceIds must not repeat a device" }).optional(),
-      /**
-      * La camera registra per tutta la durata del SEGNALE che lei stessa
-      * pubblica — la cap `recording-signal` (`active: true` mentre il device è in
-      * funzione: un robot che pulisce). È un LIVELLO, non un fronte: la finestra
-      * resta aperta finché il segnale è alto e si chiude `postBufferSec` dopo la
-      * caduta, così una pulizia di quaranta minuti è UNA clip.
-      *
-      * Non nomina un device: il segnale è della camera stessa, tenuto fresco dal
-      * suo provider (D224); il recorder lo ascolta su `DeviceStateChanged` e lo
-      * riconcilia leggendo la slice via RPC, con un tetto oltre il quale un
-      * segnale mai abbassato (un evento perso) non può tenere aperta una
-      * registrazione (D11). Vedi `recorder/addon/band-decision.ts`
-      * (`holdTrigger` / `releaseTrigger`).
-      */
-      deviceSignal: zod.z.boolean().optional()
+      sensorDeviceIds: zod.z.array(zod.z.number().int().positive()).min(1).max(16).refine(noDuplicates, { message: "sensorDeviceIds must not repeat a device" }).optional()
     });
     var RecordingBandModeSchema = zod.z.enum(["continuous", "events"]);
     var RecordingBandTriggersSchema = RecordingTriggersSchema;
@@ -213260,13 +213264,48 @@ var require_dist4 = __commonJS({
       end: zod.z.string().regex(HHMM),
       mode: RecordingBandModeSchema,
       triggers: RecordingBandTriggersSchema.optional(),
+      /**
+      * RETIRED (D381). A band no longer carries a pre-buffer of its own.
+      *
+      * It was the retroactive KEEP bound — which already-written segments survive
+      * a trigger — and it had to be at least as wide as the widest pre-roll the
+      * broker could serve, or the gate would delete the seconds the ring had just
+      * handed the writer. That "at least as wide as" is the tell: it was a second
+      * expression of the broker's retention, in different units, in a different
+      * addon, with an invariant the operator had to maintain by hand. The keep
+      * bound is now derived from the one prebuffer ceiling and there is nothing
+      * left to configure here.
+      *
+      * The key survives in the SHAPE so a config written before that record still
+      * parses and can be migrated deliberately — `RecordingBandSchema` is not
+      * strict, so simply deleting it would strip an operator's value in silence on
+      * the next save (the failure D380 came one commit from shipping). Nothing
+      * reads it: {@link stripRetiredBandPreBufferSec} removes it on load.
+      */
       preBufferSec: zod.z.number().min(0).optional(),
       postBufferSec: zod.z.number().min(0).optional()
     });
-    var DEFAULT_EVENTS_BAND_BUFFER_SEC = {
-      preBufferSec: 15,
-      postBufferSec: 30
-    };
+    var DEFAULT_EVENTS_BAND_BUFFER_SEC = { postBufferSec: 30 };
+    function stripRetiredBandPreBufferSec(config) {
+      const strippedBands = [];
+      const bands = config.bands.map((band, index) => {
+        if (band.preBufferSec === void 0) return band;
+        strippedBands.push(index);
+        const { preBufferSec: _retired, ...rest } = band;
+        return rest;
+      });
+      if (strippedBands.length === 0) return {
+        config,
+        strippedBands
+      };
+      return {
+        config: {
+          ...config,
+          bands
+        },
+        strippedBands
+      };
+    }
     var VISIT_MERGE_GAP_MS = DEFAULT_EVENTS_BAND_BUFFER_SEC.postBufferSec * 1e3;
     var RecordingRetentionSchema = zod.z.object({
       maxAgeDays: zod.z.number().min(0).optional(),
@@ -213291,10 +213330,33 @@ var require_dist4 = __commonJS({
       * "off" is the absence of a covering band, never a band value.
       */
       bands: zod.z.array(RecordingBandSchema).default([]),
+      /**
+      * THE device-decided intent: record for as long as the camera itself raises
+      * `recording-signal` (`active: true` while the device is in function — a
+      * robot that cleans). AUTHORED, unlike `mode`, and the only authored
+      * recording intent that is not a band.
+      *
+      * It carries NO schedule on purpose. A band is an HOUR, and this feature has
+      * no hour to program: the device decides. What it costs the operator is one
+      * flag — "this camera can record on its own" — and what it buys is the same
+      * hold/release the recorder already implements (D371, `holdTrigger` /
+      * `releaseTrigger`): the window opens on the rise, stays open for the whole
+      * job however long it is, and closes one pad after the fall.
+      *
+      * EXCLUSIVE with `bands` (below): two authorities deciding when the same
+      * camera records is the D62 failure. `off` remains `enabled: false`, so an
+      * operator switching this camera off is REPORTED off, never as broken.
+      */
+      deviceDecision: zod.z.boolean().optional(),
       retention: RecordingRetentionSchema.optional()
-    }).strict();
+    }).strict().refine((config) => config.deviceDecision !== true || config.bands.length === 0, {
+      message: "deviceDecision is a whole-config mode and carries no schedule: it cannot be combined with bands",
+      path: ["bands"]
+    });
     function deriveRecordingMode(config) {
-      if (!config.enabled || config.bands.length === 0) return "off";
+      if (!config.enabled) return "off";
+      if (config.deviceDecision === true) return "on-device-decision";
+      if (config.bands.length === 0) return "off";
       if (config.bands.some((band) => band.mode === "continuous")) return "continuous";
       return "events";
     }
@@ -213307,6 +213369,67 @@ var require_dist4 = __commonJS({
       const preferred = assigned.filter((profile) => DEFAULT_RECORDING_PROFILES.includes(profile));
       return preferred.length > 0 ? preferred : [...assigned];
     }
+    var SURVIVING_TRIGGER_KEYS = [
+      "motion",
+      "audioThresholdDbfs",
+      "objectClasses",
+      "sensorDeviceIds"
+    ];
+    function isRecord$1(value) {
+      return typeof value === "object" && value !== null && !Array.isArray(value);
+    }
+    function listensToLegacySignal(band) {
+      return isRecord$1(band) && isRecord$1(band.triggers) && band.triggers.deviceSignal === true;
+    }
+    function hasSurvivingTrigger(band) {
+      const triggers = band.triggers;
+      if (!isRecord$1(triggers)) return false;
+      return SURVIVING_TRIGGER_KEYS.some((key) => triggers[key] !== void 0);
+    }
+    function withoutLegacySignal(band) {
+      const triggers = band.triggers;
+      if (!isRecord$1(triggers)) return band;
+      const { deviceSignal: _retired, ...rest } = triggers;
+      return {
+        ...band,
+        triggers: rest
+      };
+    }
+    function migrateLegacyDeviceSignalConfig(raw) {
+      const unchanged = {
+        value: raw,
+        migrated: false,
+        strippedOnly: false
+      };
+      if (!isRecord$1(raw) || !Array.isArray(raw.bands)) return unchanged;
+      if (!raw.bands.some(listensToLegacySignal)) return unchanged;
+      const kept = [];
+      for (const band of raw.bands) {
+        if (!listensToLegacySignal(band) || !isRecord$1(band)) {
+          kept.push(band);
+          continue;
+        }
+        if (hasSurvivingTrigger(band)) kept.push(withoutLegacySignal(band));
+      }
+      if (kept.length > 0) return {
+        value: {
+          ...raw,
+          bands: kept
+        },
+        migrated: false,
+        strippedOnly: true
+      };
+      const { mode: _derived, ...rest } = raw;
+      return {
+        value: {
+          ...rest,
+          bands: [],
+          deviceDecision: true
+        },
+        migrated: true,
+        strippedOnly: false
+      };
+    }
     var RelocateJobStateSchema = zod.z.enum([
       "queued",
       "running",
@@ -228556,11 +228679,7 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
       nodeId: zod.z.string(),
       enabled: zod.z.boolean()
     });
-    var CameraRecordingModeSchema = zod.z.enum([
-      "off",
-      "continuous",
-      "events"
-    ]);
+    var CameraRecordingModeSchema = RecordingStorageModeSchema;
     var CameraRecordingStatusSchema = zod.z.object({
       mode: CameraRecordingModeSchema,
       active: zod.z.boolean(),
@@ -237030,11 +237149,10 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
     var RecordingStatusSchema = zod.z.object({
       deviceId: zod.z.number(),
       enabled: zod.z.boolean(),
-      activeMode: zod.z.enum([
-        "off",
-        "continuous",
-        "events"
-      ]),
+      /** THE derived storage mode, from the one definition
+      *  (`deriveRecordingMode`) — never a second enum. A duplicated list is how
+      *  `on-device-decision` could have reached the recorder and not the status. */
+      activeMode: RecordingStorageModeSchema,
       nodeId: zod.z.string(),
       storageBytes: zod.z.number()
     });
@@ -257320,6 +257438,7 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
     exports.method = require_sleep.method;
     exports.methodAccessForHttpMethod = methodAccessForHttpMethod;
     exports.metricsProviderCapability = metricsProviderCapability;
+    exports.migrateLegacyDeviceSignalConfig = migrateLegacyDeviceSignalConfig;
     exports.modelConvertCapability = modelConvertCapability;
     exports.modelDistributorCapability = modelDistributorCapability;
     exports.modelFormatForRuntime = modelFormatForRuntime;
@@ -257467,6 +257586,7 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
     exports.streamParamsCapability = streamParamsCapability;
     exports.streamPixels = streamPixels;
     exports.streamQualityLabel = streamQualityLabel;
+    exports.stripRetiredBandPreBufferSec = stripRetiredBandPreBufferSec;
     exports.subKindsOf = subKindsOf;
     exports.summarisePrivacyAudio = summarisePrivacyAudio;
     exports.summarizeEffectiveScope = summarizeEffectiveScope;

package/package.json

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