camstack 1.2.104 → 1.2.105

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

@@ -14522,7 +14522,7 @@ function date4(params) {
 // ../../node_modules/zod/v4/classic/external.js
 config(en_default());
 
-// ../types/dist/sleep-CoV00zX3.mjs
+// ../types/dist/sleep-IaOr7P-z.mjs
 var WELL_KNOWN_TABS = [
   {
     id: "overview",
@@ -14742,6 +14742,21 @@ var CameraStreamSchema = external_exports.object({
   */
   autoEligible: external_exports.boolean().optional(),
   /**
+  * The profile slot the PUBLISHER says this stream is: `low` for a stream
+  * whose only sensible role is the low-bandwidth one, `high` for a main
+  * stream. Consulted by the broker's automatic ranking
+  * (`rankInitialAssignment`) BEFORE the pixel-count heuristic, and only there:
+  * an operator's manual assignment still wins, and an absent hint is the
+  * pixel-ranked default every camera had before this field existed.
+  *
+  * Why it exists: a camera with ONE stream ranked to `mid` — the slot no
+  * storage class is written for on its own (`recordings` is high|mid,
+  * `recordingsLow` is low) and the one profile scrub does not read. The robot
+  * camera's single 720p relay is a `low` in every respect except the slot the
+  * heuristic put it in.
+  */
+  profileHint: CamProfileSchema.optional(),
+  /**
   * Transport-specific opaque metadata. The broker passes it through to
   * the source reader without inspecting it. Currently used by
   * `pull-rfc4571` streams to carry the upstream SDP (so the reader can
@@ -15715,7 +15730,22 @@ 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()
+  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()
 });
 var RecordingBandModeSchema = external_exports.enum(["continuous", "events"]);
 var RecordingBandTriggersSchema = RecordingTriggersSchema;
@@ -18723,6 +18753,8 @@ var streamBrokerCapability = {
       label: external_exports.string().optional(),
       deviceFeatures: external_exports.array(external_exports.string()).optional(),
       autoEligible: external_exports.boolean().optional(),
+      /** The slot the publisher says this stream IS — see `CameraStreamSchema.profileHint`. */
+      profileHint: CamProfileSchema.optional(),
       metadata: external_exports.record(external_exports.string(), external_exports.unknown()).optional(),
       /** Required when kind === 'derived' — the source camStreamId the
       *  derived broker reads its encoded plane from.
@@ -37817,6 +37849,50 @@ var recordingExportCapability = {
     })
   }
 };
+var RecordingSignalStatusSchema = external_exports.object({
+  /** True while the device asks to be recorded. */
+  active: external_exports.boolean(),
+  /**
+  * Why, in the provider's own vocabulary (a vacuum's `cleaning` / `docked`,
+  * …). Free text for the log line and the UI badge; the recorder never
+  * branches on it.
+  */
+  reason: external_exports.string(),
+  /** Ms epoch of the last `active` transition. 0 if never observed. */
+  lastChangedAt: external_exports.number()
+});
+var RecordingSignalRuntimeStateSchema = RecordingSignalStatusSchema.extend({ lastFetchedAt: external_exports.number() });
+var recordingSignalCapability = {
+  name: "recording-signal",
+  scope: "device",
+  deviceNative: true,
+  mode: "singleton",
+  deviceTypes: [DeviceType.Camera],
+  methods: {
+    /** The current level, straight from the slice the provider keeps fresh. */
+    getStatus: method(external_exports.object({ deviceId: external_exports.number() }), RecordingSignalStatusSchema)
+  },
+  status: {
+    schema: RecordingSignalStatusSchema,
+    kind: "push",
+    empty: {
+      active: false,
+      reason: "unknown",
+      lastChangedAt: 0
+    }
+  },
+  runtimeState: RecordingSignalRuntimeStateSchema,
+  /**
+  * Runtime-state durability: **session** — a restored `active: true` from
+  * before a restart is exactly the stale level the recorder's reconcile bound
+  * exists to end, and the provider re-derives the true level on activation
+  * anyway. Nothing is lost by forgetting it; a lie is avoided.
+  *
+  * See `RuntimeStateDurability`. Enforced by
+  * `scripts/check-runtime-state-durability.ts`.
+  */
+  durability: "session"
+};
 var SceneConditionSchema = external_exports.string();
 var SceneUncoveredPolicySchema = external_exports.enum(["skip", "judge-anyway"]);
 var SceneVerdictSchema = external_exports.enum([
@@ -38185,6 +38261,8 @@ var CamStreamDescriptorSchema = external_exports.object({
   deviceFeatures: external_exports.array(external_exports.string()).optional(),
   /** Eligible for automatic profile assignment. Absent = `true`. */
   autoEligible: external_exports.boolean().optional(),
+  /** The slot the publisher says this stream IS — see `CameraStreamSchema.profileHint`. */
+  profileHint: CamProfileSchema.optional(),
   /** Transport-specific opaque metadata (e.g. rfc4571 SDP). */
   metadata: external_exports.record(external_exports.string(), external_exports.unknown()).optional()
 });
@@ -44420,6 +44498,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
     addonId: null,
     access: "view"
   },
+  "recordingSignal.getStatus": {
+    capName: "recording-signal",
+    capScope: "device",
+    addonId: null,
+    access: "view"
+  },
   "sceneMonitor.captureReference": {
     capName: "scene-monitor",
     capScope: "device",
@@ -47412,6 +47496,11 @@ var METHOD_DEVICE_SELECTORS = Object.freeze({
     form: "single",
     optional: true
   }],
+  "recordingSignal.getStatus": [{
+    name: "deviceId",
+    form: "single",
+    optional: false
+  }],
   "sceneMonitor.captureReference": [{
     name: "deviceId",
     form: "single",

package/dist/cli.js

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

package/dist/{discover-MXRAOHEZ.js → discover-MHBOYSVK.js}

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

package/dist/{launcher-Z3ZWTZS5.js → launcher-P5VZSWZR.js}

@@ -23633,9 +23633,9 @@ var require_zod = __commonJS({
   }
 });
 
-// ../system/dist/dist-Qnc3kuba.js
-var require_dist_Qnc3kuba = __commonJS({
-  "../system/dist/dist-Qnc3kuba.js"(exports) {
+// ../system/dist/dist-BNaW68aZ.js
+var require_dist_BNaW68aZ = __commonJS({
+  "../system/dist/dist-BNaW68aZ.js"(exports) {
     "use strict";
     var zod = require_zod();
     var EventCategory = /* @__PURE__ */ (function(EventCategory2) {
@@ -24732,6 +24732,21 @@ var require_dist_Qnc3kuba = __commonJS({
       */
       autoEligible: zod.z.boolean().optional(),
       /**
+      * The profile slot the PUBLISHER says this stream is: `low` for a stream
+      * whose only sensible role is the low-bandwidth one, `high` for a main
+      * stream. Consulted by the broker's automatic ranking
+      * (`rankInitialAssignment`) BEFORE the pixel-count heuristic, and only there:
+      * an operator's manual assignment still wins, and an absent hint is the
+      * pixel-ranked default every camera had before this field existed.
+      *
+      * Why it exists: a camera with ONE stream ranked to `mid` — the slot no
+      * storage class is written for on its own (`recordings` is high|mid,
+      * `recordingsLow` is low) and the one profile scrub does not read. The robot
+      * camera's single 720p relay is a `low` in every respect except the slot the
+      * heuristic put it in.
+      */
+      profileHint: CamProfileSchema.optional(),
+      /**
       * Transport-specific opaque metadata. The broker passes it through to
       * the source reader without inspecting it. Currently used by
       * `pull-rfc4571` streams to carry the upstream SDP (so the reader can
@@ -26214,7 +26229,22 @@ var require_dist_Qnc3kuba = __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()
+      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()
     });
     var RecordingBandModeSchema = zod.z.enum(["continuous", "events"]);
     var RecordingBandTriggersSchema = RecordingTriggersSchema;
@@ -29337,6 +29367,8 @@ var require_dist_Qnc3kuba = __commonJS({
           label: zod.z.string().optional(),
           deviceFeatures: zod.z.array(zod.z.string()).optional(),
           autoEligible: zod.z.boolean().optional(),
+          /** The slot the publisher says this stream IS — see `CameraStreamSchema.profileHint`. */
+          profileHint: CamProfileSchema.optional(),
           metadata: zod.z.record(zod.z.string(), zod.z.unknown()).optional(),
           /** Required when kind === 'derived' — the source camStreamId the
           *  derived broker reads its encoded plane from.
@@ -48375,6 +48407,50 @@ var require_dist_Qnc3kuba = __commonJS({
         })
       }
     };
+    var RecordingSignalStatusSchema = zod.z.object({
+      /** True while the device asks to be recorded. */
+      active: zod.z.boolean(),
+      /**
+      * Why, in the provider's own vocabulary (a vacuum's `cleaning` / `docked`,
+      * …). Free text for the log line and the UI badge; the recorder never
+      * branches on it.
+      */
+      reason: zod.z.string(),
+      /** Ms epoch of the last `active` transition. 0 if never observed. */
+      lastChangedAt: zod.z.number()
+    });
+    var RecordingSignalRuntimeStateSchema = RecordingSignalStatusSchema.extend({ lastFetchedAt: zod.z.number() });
+    var recordingSignalCapability = {
+      name: "recording-signal",
+      scope: "device",
+      deviceNative: true,
+      mode: "singleton",
+      deviceTypes: [DeviceType.Camera],
+      methods: {
+        /** The current level, straight from the slice the provider keeps fresh. */
+        getStatus: method(zod.z.object({ deviceId: zod.z.number() }), RecordingSignalStatusSchema)
+      },
+      status: {
+        schema: RecordingSignalStatusSchema,
+        kind: "push",
+        empty: {
+          active: false,
+          reason: "unknown",
+          lastChangedAt: 0
+        }
+      },
+      runtimeState: RecordingSignalRuntimeStateSchema,
+      /**
+      * Runtime-state durability: **session** — a restored `active: true` from
+      * before a restart is exactly the stale level the recorder's reconcile bound
+      * exists to end, and the provider re-derives the true level on activation
+      * anyway. Nothing is lost by forgetting it; a lie is avoided.
+      *
+      * See `RuntimeStateDurability`. Enforced by
+      * `scripts/check-runtime-state-durability.ts`.
+      */
+      durability: "session"
+    };
     var SceneConditionSchema = zod.z.string();
     var SceneUncoveredPolicySchema = zod.z.enum(["skip", "judge-anyway"]);
     var SceneVerdictSchema = zod.z.enum([
@@ -48742,6 +48818,8 @@ var require_dist_Qnc3kuba = __commonJS({
       deviceFeatures: zod.z.array(zod.z.string()).optional(),
       /** Eligible for automatic profile assignment. Absent = `true`. */
       autoEligible: zod.z.boolean().optional(),
+      /** The slot the publisher says this stream IS — see `CameraStreamSchema.profileHint`. */
+      profileHint: CamProfileSchema.optional(),
       /** Transport-specific opaque metadata (e.g. rfc4571 SDP). */
       metadata: zod.z.record(zod.z.string(), zod.z.unknown()).optional()
     });
@@ -50995,6 +51073,7 @@ var require_dist_Qnc3kuba = __commonJS({
       "ptz",
       "ptz-autotrack",
       "recording",
+      "recording-signal",
       "scene-monitor",
       "script-runner",
       "smoke",
@@ -51128,6 +51207,7 @@ var require_dist_Qnc3kuba = __commonJS({
       rebootCapability,
       recordingCapability,
       recordingExportCapability,
+      recordingSignalCapability,
       sceneMonitorCapability,
       scriptRunnerCapability,
       serverManagementCapability,
@@ -55805,6 +55885,12 @@ var require_dist_Qnc3kuba = __commonJS({
         addonId: null,
         access: "view"
       },
+      "recordingSignal.getStatus": {
+        capName: "recording-signal",
+        capScope: "device",
+        addonId: null,
+        access: "view"
+      },
       "sceneMonitor.captureReference": {
         capName: "scene-monitor",
         capScope: "device",
@@ -58797,6 +58883,11 @@ var require_dist_Qnc3kuba = __commonJS({
         form: "single",
         optional: true
       }],
+      "recordingSignal.getStatus": [{
+        name: "deviceId",
+        form: "single",
+        optional: false
+      }],
       "sceneMonitor.captureReference": [{
         name: "deviceId",
         form: "single",
@@ -59345,6 +59436,10 @@ var require_dist_Qnc3kuba = __commonJS({
         durability: "session",
         volatileFields: []
       },
+      "recording-signal": {
+        durability: "session",
+        volatileFields: []
+      },
       "scene-monitor": {
         durability: "session",
         volatileFields: []
@@ -60563,7 +60658,7 @@ var require_alerts_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_Qnc3kuba();
+    var require_dist10 = require_dist_BNaW68aZ();
     function selectExpired(alerts, cutoffMs) {
       return alerts.filter((a) => a.createdAt < cutoffMs).sort((a, b) => a.createdAt - b.createdAt).map((a) => a.id);
     }
@@ -61382,7 +61477,7 @@ var require_console_logging = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_Qnc3kuba();
+    var require_dist10 = require_dist_BNaW68aZ();
     var require_formatter = require_formatter_DqAKDlvN();
     var LEVEL_RANK = {
       debug: 0,
@@ -61476,7 +61571,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_Qnc3kuba();
+    var require_dist10 = require_dist_BNaW68aZ();
     var node_crypto = __require("crypto");
     var node_fs_promises = __require("fs/promises");
     node_fs_promises = require_chunk.__toESM(node_fs_promises);
@@ -62373,11 +62468,11 @@ var require_core_blocks = __commonJS({
   }
 });
 
-// ../system/dist/retired-settings-keys-C_h6HXZi.js
-var require_retired_settings_keys_C_h6HXZi = __commonJS({
-  "../system/dist/retired-settings-keys-C_h6HXZi.js"(exports) {
+// ../system/dist/retired-settings-keys-FwgzdSHJ.js
+var require_retired_settings_keys_FwgzdSHJ = __commonJS({
+  "../system/dist/retired-settings-keys-FwgzdSHJ.js"(exports) {
     "use strict";
-    var require_dist10 = require_dist_Qnc3kuba();
+    var require_dist10 = require_dist_BNaW68aZ();
     function settingsStoreIsAuthoritativeHere(env) {
       const raw = (env["CAMSTACK_ROLE"] ?? "").trim().toLowerCase();
       return raw === "" || raw === "hub";
@@ -64591,8 +64686,8 @@ var require_device_manager_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_Qnc3kuba();
-    var require_retired_settings_keys = require_retired_settings_keys_C_h6HXZi();
+    var require_dist10 = require_dist_BNaW68aZ();
+    var require_retired_settings_keys = require_retired_settings_keys_FwgzdSHJ();
     var node_crypto = __require("crypto");
     var _camstack_types_node = require_node();
     var JOB_HISTORY = 20;
@@ -70107,7 +70202,7 @@ var require_hub_forwarder = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_Qnc3kuba();
+    var require_dist10 = require_dist_BNaW68aZ();
     var require_formatter = require_formatter_DqAKDlvN();
     var DEFAULT_OUTBOUND_BUFFER_SIZE = 500;
     var HubForwarderDestination = class {
@@ -70244,7 +70339,7 @@ var require_liveness_monitor_addon = __commonJS({
     "use strict";
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_Qnc3kuba();
+    var require_dist10 = require_dist_BNaW68aZ();
     var NO_DEVICES = "liveness:no-devices";
     var ALL_OFFLINE = "liveness:all-devices-offline";
     var NO_FOOTAGE_PREFIX = "liveness:no-footage:";
@@ -70440,7 +70535,7 @@ var require_local_auth_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_Qnc3kuba();
+    var require_dist10 = require_dist_BNaW68aZ();
     var node_crypto = __require("crypto");
     node_crypto = require_chunk.__toESM(node_crypto);
     var crypto$1 = __require("crypto");
@@ -78253,7 +78348,7 @@ var require_loki_logging = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_Qnc3kuba();
+    var require_dist10 = require_dist_BNaW68aZ();
     function sanitizeLabelName(raw) {
       const replaced = raw.replaceAll(/[^a-zA-Z0-9_]/g, "_");
       return /^[a-zA-Z_]/.test(replaced) ? replaced : `_${replaced}`;
@@ -78818,7 +78913,7 @@ var require_native_metrics_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_Qnc3kuba();
+    var require_dist10 = require_dist_BNaW68aZ();
     var node_fs_promises = __require("fs/promises");
     var node_child_process = __require("child_process");
     var node_util = __require("util");
@@ -81402,7 +81497,7 @@ var require_filesystem_storage_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_Qnc3kuba();
+    var require_dist10 = require_dist_BNaW68aZ();
     var node_crypto = __require("crypto");
     var node_fs_promises = __require("fs/promises");
     var node_path = __require("path");
@@ -82518,8 +82613,8 @@ var require_sqlite_settings_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_Qnc3kuba();
-    var require_retired_settings_keys = require_retired_settings_keys_C_h6HXZi();
+    var require_dist10 = require_dist_BNaW68aZ();
+    var require_retired_settings_keys = require_retired_settings_keys_FwgzdSHJ();
     var node_crypto = __require("crypto");
     var node_fs = __require("fs");
     var node_module = __require("module");
@@ -85009,7 +85104,7 @@ var require_storage_orchestrator_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_Qnc3kuba();
+    var require_dist10 = require_dist_BNaW68aZ();
     var require_hub_cap_forward = require_hub_cap_forward_DmHNjbB0();
     var zod = require_zod();
     var node_crypto = __require("crypto");
@@ -87960,7 +88055,7 @@ var require_system_config_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_Qnc3kuba();
+    var require_dist10 = require_dist_BNaW68aZ();
     var SECTION_TITLES = {
       server: "Server",
       auth: "Authentication"
@@ -106021,7 +106116,7 @@ var require_winston_logging = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_Qnc3kuba();
+    var require_dist10 = require_dist_BNaW68aZ();
     var require_formatter = require_formatter_DqAKDlvN();
     var node_path = __require("path");
     node_path = require_chunk.__toESM(node_path);
@@ -107965,9 +108060,9 @@ var require_event_category_b8kBSOTT = __commonJS({
   }
 });
 
-// ../types/dist/sleep-QEBby1J6.js
-var require_sleep_QEBby1J6 = __commonJS({
-  "../types/dist/sleep-QEBby1J6.js"(exports) {
+// ../types/dist/sleep-BGiOgxye.js
+var require_sleep_BGiOgxye = __commonJS({
+  "../types/dist/sleep-BGiOgxye.js"(exports) {
     "use strict";
     var require_event_category = require_event_category_b8kBSOTT();
     var zod = require_zod();
@@ -109025,6 +109120,21 @@ var require_sleep_QEBby1J6 = __commonJS({
       */
       autoEligible: zod.z.boolean().optional(),
       /**
+      * The profile slot the PUBLISHER says this stream is: `low` for a stream
+      * whose only sensible role is the low-bandwidth one, `high` for a main
+      * stream. Consulted by the broker's automatic ranking
+      * (`rankInitialAssignment`) BEFORE the pixel-count heuristic, and only there:
+      * an operator's manual assignment still wins, and an absent hint is the
+      * pixel-ranked default every camera had before this field existed.
+      *
+      * Why it exists: a camera with ONE stream ranked to `mid` — the slot no
+      * storage class is written for on its own (`recordings` is high|mid,
+      * `recordingsLow` is low) and the one profile scrub does not read. The robot
+      * camera's single 720p relay is a `low` in every respect except the slot the
+      * heuristic put it in.
+      */
+      profileHint: CamProfileSchema.optional(),
+      /**
       * Transport-specific opaque metadata. The broker passes it through to
       * the source reader without inspecting it. Currently used by
       * `pull-rfc4571` streams to carry the upstream SDP (so the reader can
@@ -110378,6 +110488,7 @@ var require_sleep_QEBby1J6 = __commonJS({
           pressureSensor: createSliceHandle(stateSource, binding.deviceId, "pressure-sensor"),
           privacyMask: createSliceHandle(stateSource, binding.deviceId, "privacy-mask"),
           ptzAutotrack: createSliceHandle(stateSource, binding.deviceId, "ptz-autotrack"),
+          recordingSignal: createSliceHandle(stateSource, binding.deviceId, "recording-signal"),
           sceneMonitor: createSliceHandle(stateSource, binding.deviceId, "scene-monitor"),
           scriptRunner: createSliceHandle(stateSource, binding.deviceId, "script-runner"),
           smoke: createSliceHandle(stateSource, binding.deviceId, "smoke"),
@@ -110757,6 +110868,7 @@ var require_sleep_QEBby1J6 = __commonJS({
           setSettings: (input) => dispatch("ptz-autotrack", "ptzAutotrack", "setSettings", "mutation", input)
         },
         reboot: { reboot: (input) => dispatch("reboot", "reboot", "reboot", "mutation", input) },
+        recordingSignal: { getStatus: (input) => dispatch("recording-signal", "recordingSignal", "getStatus", "query", input) },
         sceneMonitor: {
           listScenes: (input) => dispatch("scene-monitor", "sceneMonitor", "listScenes", "query", input),
           listScenesBatch: (input) => dispatch("scene-monitor", "sceneMonitor", "listScenesBatch", "query", input),
@@ -111681,7 +111793,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_QEBby1J6();
+    var require_sleep = require_sleep_BGiOgxye();
     var require_err_msg = require_err_msg_COpsHMw2();
     var CAP_INPUT_DEFAULTS = Object.freeze({
       "addons": { "getLogs": { "limit": 100 } },
@@ -130641,7 +130753,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_Qnc3kuba();
+    var require_dist10 = require_dist_BNaW68aZ();
     var require_builtins_alerts_alerts_addon = require_alerts_addon();
     require_alerts();
     var require_formatter = require_formatter_DqAKDlvN();
@@ -211758,7 +211870,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_QEBby1J6();
+    var require_sleep = require_sleep_BGiOgxye();
     var require_canonical_hash = require_canonical_hash_DNV8S5ET();
     var require_enums2 = require_enums();
     var require_err_msg = require_err_msg_COpsHMw2();
@@ -213013,7 +213125,22 @@ 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()
+      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()
     });
     var RecordingBandModeSchema = zod.z.enum(["continuous", "events"]);
     var RecordingBandTriggersSchema = RecordingTriggersSchema;
@@ -217210,6 +217337,8 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
           label: zod.z.string().optional(),
           deviceFeatures: zod.z.array(zod.z.string()).optional(),
           autoEligible: zod.z.boolean().optional(),
+          /** The slot the publisher says this stream IS — see `CameraStreamSchema.profileHint`. */
+          profileHint: require_sleep.CamProfileSchema.optional(),
           metadata: zod.z.record(zod.z.string(), zod.z.unknown()).optional(),
           /** Required when kind === 'derived' — the source camStreamId the
           *  derived broker reads its encoded plane from.
@@ -237490,6 +237619,50 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
         })
       }
     };
+    var RecordingSignalStatusSchema = zod.z.object({
+      /** True while the device asks to be recorded. */
+      active: zod.z.boolean(),
+      /**
+      * Why, in the provider's own vocabulary (a vacuum's `cleaning` / `docked`,
+      * …). Free text for the log line and the UI badge; the recorder never
+      * branches on it.
+      */
+      reason: zod.z.string(),
+      /** Ms epoch of the last `active` transition. 0 if never observed. */
+      lastChangedAt: zod.z.number()
+    });
+    var RecordingSignalRuntimeStateSchema = RecordingSignalStatusSchema.extend({ lastFetchedAt: zod.z.number() });
+    var recordingSignalCapability = {
+      name: "recording-signal",
+      scope: "device",
+      deviceNative: true,
+      mode: "singleton",
+      deviceTypes: [require_sleep.DeviceType.Camera],
+      methods: {
+        /** The current level, straight from the slice the provider keeps fresh. */
+        getStatus: require_sleep.method(zod.z.object({ deviceId: zod.z.number() }), RecordingSignalStatusSchema)
+      },
+      status: {
+        schema: RecordingSignalStatusSchema,
+        kind: "push",
+        empty: {
+          active: false,
+          reason: "unknown",
+          lastChangedAt: 0
+        }
+      },
+      runtimeState: RecordingSignalRuntimeStateSchema,
+      /**
+      * Runtime-state durability: **session** — a restored `active: true` from
+      * before a restart is exactly the stale level the recorder's reconcile bound
+      * exists to end, and the provider re-derives the true level on activation
+      * anyway. Nothing is lost by forgetting it; a lie is avoided.
+      *
+      * See `RuntimeStateDurability`. Enforced by
+      * `scripts/check-runtime-state-durability.ts`.
+      */
+      durability: "session"
+    };
     var SceneConditionSchema = zod.z.string();
     var SCENE_CONDITIONS = [
       "day",
@@ -237871,6 +238044,8 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
       deviceFeatures: zod.z.array(zod.z.string()).optional(),
       /** Eligible for automatic profile assignment. Absent = `true`. */
       autoEligible: zod.z.boolean().optional(),
+      /** The slot the publisher says this stream IS — see `CameraStreamSchema.profileHint`. */
+      profileHint: require_sleep.CamProfileSchema.optional(),
       /** Transport-specific opaque metadata (e.g. rfc4571 SDP). */
       metadata: zod.z.record(zod.z.string(), zod.z.unknown()).optional()
     });
@@ -240154,6 +240329,7 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
       pressureSensor: pressureSensorCapability,
       privacyMask: privacyMaskCapability,
       ptzAutotrack: ptzAutotrackCapability,
+      recordingSignal: recordingSignalCapability,
       sceneMonitor: sceneMonitorCapability,
       scriptRunner: scriptRunnerCapability,
       smoke: smokeCapability,
@@ -242638,6 +242814,7 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
       "ptz",
       "ptz-autotrack",
       "recording",
+      "recording-signal",
       "scene-monitor",
       "script-runner",
       "smoke",
@@ -242771,6 +242948,7 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
       reboot: "reboot",
       recording: "recording",
       recordingExport: "recording-export",
+      recordingSignal: "recording-signal",
       sceneMonitor: "scene-monitor",
       scriptRunner: "script-runner",
       serverManagement: "server-management",
@@ -243278,6 +243456,10 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
         key: "recordingExport",
         name: "recording-export"
       },
+      {
+        key: "recordingSignal",
+        name: "recording-signal"
+      },
       {
         key: "sceneMonitor",
         name: "scene-monitor"
@@ -243545,6 +243727,7 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
       rebootCapability,
       recordingCapability,
       recordingExportCapability,
+      recordingSignalCapability,
       sceneMonitorCapability,
       scriptRunnerCapability,
       serverManagementCapability,
@@ -248222,6 +248405,12 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
         addonId: null,
         access: "view"
       },
+      "recordingSignal.getStatus": {
+        capName: "recording-signal",
+        capScope: "device",
+        addonId: null,
+        access: "view"
+      },
       "sceneMonitor.captureReference": {
         capName: "scene-monitor",
         capScope: "device",
@@ -249795,6 +249984,7 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
       "reboot",
       "recording",
       "recording-export",
+      "recording-signal",
       "scene-monitor",
       "script-runner",
       "server-management",
@@ -249869,6 +250059,7 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
       "ptz",
       "ptz-autotrack",
       "reboot",
+      "recording-signal",
       "scene-monitor",
       "script-runner",
       "snapshot",
@@ -251474,6 +251665,11 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
         form: "single",
         optional: true
       }],
+      "recordingSignal.getStatus": [{
+        name: "deviceId",
+        form: "single",
+        optional: false
+      }],
       "sceneMonitor.captureReference": [{
         name: "deviceId",
         form: "single",
@@ -252172,6 +252368,10 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
         durability: "session",
         volatileFields: []
       },
+      "recording-signal": {
+        durability: "session",
+        volatileFields: []
+      },
       "scene-monitor": {
         durability: "session",
         volatileFields: []
@@ -256430,6 +256630,8 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
     exports.RecordingRebalanceSkipReasonSchema = RecordingRebalanceSkipReasonSchema;
     exports.RecordingRebalanceSkipSchema = RecordingRebalanceSkipSchema;
     exports.RecordingRetentionSchema = RecordingRetentionSchema;
+    exports.RecordingSignalRuntimeStateSchema = RecordingSignalRuntimeStateSchema;
+    exports.RecordingSignalStatusSchema = RecordingSignalStatusSchema;
     exports.RecordingStatusSchema = RecordingStatusSchema;
     exports.RecordingStorageModeSchema = RecordingStorageModeSchema;
     exports.RecordingStorageUsageSchema = RecordingStorageUsageSchema;
@@ -257033,6 +257235,7 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
     exports.rebootCapability = rebootCapability;
     exports.recordingCapability = recordingCapability;
     exports.recordingExportCapability = recordingExportCapability;
+    exports.recordingSignalCapability = recordingSignalCapability;
     exports.rectsToCells = rectsToCells;
     exports.reducePoints = reducePoints;
     exports.requiresPython = requiresPython;

package/package.json

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