@camstack/types 1.2.71 → 1.2.73

package/dist/notification/audio-condition.d.ts

@@ -45,8 +45,16 @@ export declare const NC_AUDIO_DB_STEP = 3;
  * an absent `dbThreshold` means "any level" and stays absent until asked for,
  * and a stepper seeded at the -96 floor would need thirty taps to reach a
  * threshold that can actually fire.
+ *
+ * **It was -30 and -30 is a trap.** dBFS is negative-going, so a HIGHER number
+ * is a NARROWER filter, and the sounds this hub is actually asked about are not
+ * loud: measured on the live installation, real crying sits between -55 and
+ * -26 dBFS. A floor at -30 therefore rejects most of the very sound the
+ * operator turned the filter on for, and the rule looks broken rather than
+ * mis-seeded. The offered floor is the QUIET end of that measured band; the
+ * editor says which way the number runs rather than leaving it to be inferred.
  */
-export declare const NC_AUDIO_DB_OFFERED = -30;
+export declare const NC_AUDIO_DB_OFFERED = -55;
 export declare const NC_AUDIO_HIT_PERCENT_MIN = 1;
 export declare const NC_AUDIO_HIT_PERCENT_MAX = 100;
 export declare const NC_AUDIO_SAMPLING_MIN_SEC = 1;
@@ -55,6 +63,34 @@ export declare const NC_AUDIO_SAMPLING_MAX_SEC = 300;
 export declare const NC_AUDIO_DEFAULTS: NcAudioCondition;
 /** What an editor SHOWS for an unset condition — without authoring it. */
 export declare function audioOrDefaults(value: NcAudioCondition | undefined): NcAudioCondition;
+/**
+ * The two EXCLUSIVE ways an audio rule works (operator decision, 2026-08-14 —
+ * see `docs/decisions/D157-audio-rule-label-mode.md`).
+ *
+ *  - `label` — the rule NAMES SOUNDS. It fires on the FIRST frame the
+ *    classifier labels with one of them (above the analyzer's own per-device
+ *    confidence floor). No window, no hit percentage: the rule's cooldown is
+ *    the only brake.
+ *  - `level` — the rule NAMES A LEVEL. The sampling window is the whole point:
+ *    `hitPercent`% of the samples over `samplingSeconds` must clear
+ *    `dbThreshold`.
+ */
+export type NcAudioMode = 'label' | 'level';
+/**
+ * Which mode this condition is in — the ONE place that question is answered.
+ *
+ * The mode is NOT a stored field, deliberately. It is which filter the rule
+ * carries, so every rule authored before the modes existed migrates for free
+ * and there is no second switch that can disagree with the first (the failure
+ * this repo has shipped twice). `null` = neither filter, which the engine
+ * refuses (see {@link audioIsFailClosed}).
+ *
+ * A LEGACY rule carrying BOTH resolves to `label`: it is the mode that fires,
+ * and the alternative is silently keeping a window the operator can no longer
+ * see in the editor. Nothing new can reach this branch — {@link patchAudio}
+ * clears the other filter on every write.
+ */
+export declare function audioModeOf(value: NcAudioCondition | undefined): NcAudioMode | null;
 /**
  * True when the condition names NEITHER a level floor NOR any label. The engine
  * refuses such a rule (every sample is a hit, so the window fires on silence) —
@@ -68,8 +104,12 @@ export declare function audioIsFailClosed(value: NcAudioCondition | undefined):
 /**
  * A patch over the composite condition. A key present with `undefined` CLEARS
  * the (optional) filter; an absent key leaves it alone.
+ *
+ * `mode` is the explicit switch an editor's mode picker sends. It is not
+ * stored — {@link patchAudio} turns it into which filter survives.
  */
 export interface NcAudioPatch {
+    readonly mode?: NcAudioMode;
     readonly labels?: readonly string[] | undefined;
     readonly dbThreshold?: number | undefined;
     readonly hitPercent?: number;
@@ -80,6 +120,18 @@ export interface NcAudioPatch {
  * The result is always in-bounds for `NcAudioConditionSchema`, and a cleared
  * filter is OMITTED rather than written as an explicit `undefined` (which
  * survives a merge patch as a deliberate erase and reads as authored).
+ *
+ * **The two modes are exclusive here, structurally.** Writing labels drops any
+ * stored `dbThreshold`; writing a `dbThreshold` drops the labels. The schema
+ * cannot say "exactly one of" without becoming a ZodEffects the cap path would
+ * have to special-case, so the exclusivity lives in the ONE function every
+ * editor writes through — which also means a legacy both-filters rule is
+ * normalized the first time it is touched, onto the mode {@link audioModeOf}
+ * already reads it as.
+ *
+ * Switching to `level` with nothing stored seeds {@link NC_AUDIO_DB_OFFERED}:
+ * a level rule with no floor is fail-closed, and handing the operator a mode
+ * that cannot fire is the trap this whole change exists to remove.
  */
 export declare function patchAudio(current: NcAudioCondition | undefined, patch: NcAudioPatch): NcAudioCondition;
 /**

package/dist/{sleep-DbVrpKVz.js → sleep-B-mRsuDp.js}

@@ -3273,6 +3273,7 @@ function createDeviceProxy(api, binding, opts) {
 			captureReference: (input) => dispatch("scene-monitor", "sceneMonitor", "captureReference", "mutation", input),
 			deleteReference: (input) => dispatch("scene-monitor", "sceneMonitor", "deleteReference", "mutation", input),
 			recheckNow: (input) => dispatch("scene-monitor", "sceneMonitor", "recheckNow", "mutation", input),
+			resetScene: (input) => dispatch("scene-monitor", "sceneMonitor", "resetScene", "mutation", input),
 			getStatus: (input) => dispatch("scene-monitor", "sceneMonitor", "getStatus", "query", input)
 		},
 		scriptRunner: {

package/dist/{sleep-CTgUmjYq.mjs → sleep-CQayd2Su.mjs}

@@ -3273,6 +3273,7 @@ function createDeviceProxy(api, binding, opts) {
 			captureReference: (input) => dispatch("scene-monitor", "sceneMonitor", "captureReference", "mutation", input),
 			deleteReference: (input) => dispatch("scene-monitor", "sceneMonitor", "deleteReference", "mutation", input),
 			recheckNow: (input) => dispatch("scene-monitor", "sceneMonitor", "recheckNow", "mutation", input),
+			resetScene: (input) => dispatch("scene-monitor", "sceneMonitor", "resetScene", "mutation", input),
 			getStatus: (input) => dispatch("scene-monitor", "sceneMonitor", "getStatus", "query", input)
 		},
 		scriptRunner: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/types",
-  "version": "1.2.71",
+  "version": "1.2.73",
   "description": "Shared types, interfaces, and model catalogs for the CamStack detection ecosystem",
   "keywords": [
     "camstack",