@camstack/addon-pipeline 1.2.196 → 1.2.198

package/dist/{dist-mYDK58Jp.mjs → dist-oFIHnD88.mjs}

@@ -9087,17 +9087,29 @@ var HHMM = /^([01]\d|2[0-3]):[0-5]\d$/;
 /**
 * DERIVED per-camera storage summary — the single field cheap consumers read
 * (the viewer's status dot, the camera list) instead of walking `bands`:
-*  - `off`        — no band covers the camera (or it is disabled).
-*  - `events`     — every band records around triggers only.
-*  - `continuous` — at least one band records continuously.
-*
-* NEVER authored: the recorder stamps it from the authoritative `bands` on
-* every save (`activeModeForConfig`). Writing it has no effect.
+*  - `off`               — no band covers the camera (or it is disabled).
+*  - `events`            — every band records around triggers only.
+*  - `continuous`        — at least one band records continuously.
+*  - `on-device-decision`— the DEVICE decides: recording runs for as long as the
+*    camera raises its own `recording-signal` level (a robot that cleans). There
+*    is no schedule to author, because there is no hour to program — see
+*    {@link RecordingConfigSchema}`.deviceDecision`.
+*
+* NEVER authored: the recorder stamps it from the authoritative intent
+* (`bands` + `deviceDecision`) on every save (`activeModeForConfig`). Writing it
+* has no effect.
+*
+* `on-device-decision` is named for WHO decides, not for how the recording is
+* requested. `on-demand` was rejected: in this repo's vocabulary a "demand" is
+* something the operator makes (the live gate is the recorder's own "demand
+* window"), and a knob whose name suggests the operator starts it while the
+* device actually does is the D62 shape — a control nobody can predict.
 */
 var RecordingStorageModeSchema = _enum([
 	"off",
 	"events",
-	"continuous"
+	"continuous",
+	"on-device-decision"
 ]);
 /**
 * Le macro classi che possono aprire una finestra di registrazione — le stesse
@@ -9147,22 +9159,7 @@ var RecordingTriggersSchema = object({
 	* il livello: un contatto trovato già aperto al riavvio del runner non fa
 	* registrare.
 	*/
-	sensorDeviceIds: array(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: boolean().optional()
+	sensorDeviceIds: array(number().int().positive()).min(1).max(16).refine(noDuplicates, { message: "sensorDeviceIds must not repeat a device" }).optional()
 });
 /**
 * Mode of a single recording band — the recorder per-band vocabulary.
@@ -9192,6 +9189,24 @@ var RecordingBandSchema = object({
 	end: 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: number().min(0).optional(),
 	postBufferSec: number().min(0).optional()
 });
@@ -9209,29 +9224,56 @@ var RecordingBandSchema = object({
 * `postBufferSec` must therefore exceed one segment length plus the attach
 * latency (ffmpeg spawn + RTSP dial), or the window closes before the first
 * segment is ever finalized and the camera records nothing anyway. At the 10 s
-* default segment length, 30 s leaves room for two full segments. `preBufferSec`
-* is retroactive only — it costs nothing at record time, it merely keeps
-* already-written segments.
-*
-* ## Why `preBufferSec` is 15 and not one segment length
-*
-* It has to cover the broker's RECORDING pre-roll, which is media handed to the
-* writer from BEFORE the trigger (D192/D193). If this bound were narrower, the
-* keep gate would delete the very seconds the ring just supplied — two
-* authorities disagreeing about the same footage, which is the failure D191 was
-* written against. It is therefore set to `RECORDING_PRE_ROLL_MAX_MS` (15 s),
-* the widest window the broker can be configured to serve, so an operator
-* raising the cluster pre-roll can never walk past the gate silently. The
-* addon-side guard is
-* `packages/addon-pipeline/src/recorder/addon/__tests__/band-decision.spec.ts`.
-*
-* An EXPLICIT `0` is left alone: that is an operator statement, not an omission,
-* and it is excluded from that invariant by name.
-*/
-var DEFAULT_EVENTS_BAND_BUFFER_SEC = {
-	preBufferSec: 15,
-	postBufferSec: 30
-};
+* default segment length, 30 s leaves room for two full segments.
+*
+* ## There is no `preBufferSec` here any more (D381)
+*
+* There used to be, at 15 s, and its whole justification was that it had to
+* cover the widest pre-roll the broker could serve. A number whose only
+* correct value is another subsystem's ceiling is not a setting; it is that
+* ceiling, restated where it can drift. The keep bound is derived from the
+* prebuffer ceiling directly now, in `band-decision.ts`, so an operator
+* raising the prebuffer cannot walk past the gate at all rather than merely
+* being warned not to.
+*/
+var DEFAULT_EVENTS_BAND_BUFFER_SEC = { postBufferSec: 30 };
+/**
+* Drop the RETIRED band `preBufferSec` from a persisted recording config.
+*
+* Explicit, and it reports what it removed, because the alternative is a
+* silent strip: `RecordingBandSchema` is a plain `z.object`, so the key
+* survives a parse and disappears on the next save with no line anywhere. An
+* operator who had typed a number would find it gone and nothing would say
+* when or why.
+*
+* Nothing is carried forward: the value it held was always required to be at
+* least the broker's widest pre-roll, and the gate is now derived from exactly
+* that ceiling. Every configuration that was legal therefore keeps a keep-gate
+* at least as wide as the one it had — including an explicit `0`, which widens.
+* That is deliberate and it is the only behaviour change: a band that kept
+* nothing before its trigger now keeps up to the prebuffer ceiling of
+* already-written footage, which is media that exists either way.
+*/
+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
+	};
+}
 DEFAULT_EVENTS_BAND_BUFFER_SEC.postBufferSec * 1e3;
 /**
 * Per-device retention overrides. Every field is optional; an unset or `0`
@@ -9280,8 +9322,29 @@ var RecordingConfigSchema = object({
 	* "off" is the absence of a covering band, never a band value.
 	*/
 	bands: 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: 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"]
+});
 /**
 * Derive the {@link RecordingStorageModeSchema} summary from the authoritative
 * bands: `continuous` when any band records continuously, `events` when a band
@@ -9294,7 +9357,9 @@ var RecordingConfigSchema = object({
 * bug this field was added to fix.
 */
 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";
 }
@@ -9322,6 +9387,85 @@ function resolveRecordingProfiles(assigned, override) {
 	const preferred = assigned.filter((profile) => DEFAULT_RECORDING_PROFILES.includes(profile));
 	return preferred.length > 0 ? preferred : [...assigned];
 }
+/** Trigger keys that survive D380 — a band carrying one of these is a real band. */
+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
+	};
+}
+/**
+* Turn a config stored under D371 (`bands[].triggers.deviceSignal: true`) into
+* a D380 one (`deviceDecision: true`, no bands). Pure, total and IDEMPOTENT —
+* a row with no legacy key comes back as the SAME reference, `migrated: false`.
+*
+* ## Why the schema cannot be left to do this
+*
+* `RecordingTriggersSchema` is a non-strict `z.object`, so the retired key is
+* SILENTLY STRIPPED on read. The camera whose only trigger it was would parse
+* cleanly into an `events` band that lists nothing — "enabled, and records
+* nothing, forever", the exact shape `eventsBandCanEverDemand` exists to shout
+* about, reached without a single line in the log. On the reference hub that is
+* camera 4374, the one camera an operator had configured by hand.
+*
+* `enabled` is carried through untouched: a camera the operator had switched
+* OFF comes out of a migration still off (D62).
+*/
+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
+	};
+}
 /**
 * Entity-relocation job state (storage entity-routing spec, Phase 4).
 *
@@ -23297,11 +23441,7 @@ var CameraAudioStatusSchema = object({
 });
 /** Recording block — null when no recording cap is active for this device. */
 var CameraRecordingStatusSchema = object({
-	mode: _enum([
-		"off",
-		"continuous",
-		"events"
-	]),
+	mode: RecordingStorageModeSchema,
 	active: boolean(),
 	storageBytes: number()
 });
@@ -29876,11 +30016,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
 var RecordingStatusSchema = object({
 	deviceId: number(),
 	enabled: boolean(),
-	activeMode: _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: string(),
 	storageBytes: number()
 });
@@ -42219,4 +42358,4 @@ function enumerateInferenceDevices(hw) {
 	return out;
 }
 //#endregion
-export { inferModelProvider as $, number as $t, addonWidgetsSourceCapability as A, invocationFromEncodeProfile as At, defaultDeviceFor as B, makeProfileBrokerId as Bt, RATE_CONTROL_RELAXED as C, streamBrokerCapability as Ct, RecordingSignalStatusSchema as D, AUDIO_PRESETS as Dt, RecordingConfigSchema as E, errMsg as Et, cameraStreamsCapability as F, DeviceFeature as Ft, detectionPipelineCapability as G, selectAssignedProfileSlots as Gt, deriveBatteryPresence as H, nodePin as Ht, createHwAccelCache as I, DeviceType as It, enumerateInferenceDevices as J, array as Jt, egressTranscodeSharingKey as K, sleep as Kt, createLogChannelsProvider as L, createEvent as Lt, audioAnalyzerCapability as M, BOOT_RECOVERY_BACKOFF_MS as Mt, audioKindId as N, BaseAddon as Nt, RingBuffer as O, Fmp4BoxSplitter as Ot, batteryCapability as P, CAM_PROFILE_ORDER as Pt, hfModelUrl as Q, literal as Qt, customAction as R, hydrateSchema as Rt, PoolMemoryWatchdog as S, storageEvictableCapability as St, RECORDING_EXPORT_MAX_READ_BYTES as T, webrtcSessionCapability as Tt, deriveDetailCropRect as U, parseJsonUnknown as Ut, defineCustomActions as V, makeSourceBrokerId as Vt, deriveRecordingMode as W, parseProfileBrokerId as Wt, evaluateZoneRules as X, discriminatedUnion as Xt, evaluateSensorEdge as Y, boolean as Yt, failureContributionCapability as Z, lazy as Zt, FailureCounters as _, resolveClusterStepModelId as _t, COCO_80_LABELS as a, motionDetectionCapability as at, NativeLeaseSettingsSchema as b, resolveRecordingProfiles as bt, DEFAULT_CLUSTER_STEP_MODELS as c, pickClusterStepModels as ct, DEFAULT_EVENTS_BAND_BUFFER_SEC as d, pickNativeLeaseOverride as dt, object as en, isFirstLevelMacroClass as et, DEFAULT_FIRST_SIGHTING_FRESHNESS_MS as f, pipelineExecutorCapability as ft, ExportRecordSchema as g, recordingSignalCapability as gt, EncodeProfileSchema as h, recordingExportCapability as ht, BatteryStatusSchema as i, EventCategory as in, maskUrlCredentials as it, audioAnalysisCapability as j, isSoftwareDecode as jt, YAMNET_TO_MACRO as k, buildFfmpegArgs as kt, DEFAULT_CLUSTER_STEP_SETTINGS as l, pickClusterStepSettings as lt, DEVICE_BACKEND_TO_FORMAT as m, recordingCapability as mt, AUDIO_BACKEND_CHOICES as n, string as nn, logChannelsCapability as nt, COCO_TO_MACRO as o, overlayClusterStepSettings as ot, DEFAULT_NATIVE_LEASE_SETTINGS as p, pipelineRunnerCapability as pt, egressTransportFromRequest as q, _enum as qt, AUDIO_MACRO_LABELS as r, union as rn, mapAudioLabelToMacro as rt, DEFAULT_AUDIO_ANALYZER_CONFIG as s, parseProcStatus as st, APPLE_SA_TO_MACRO as t, record as tn, loadContributionCapability as tt, DEFAULT_DETAIL_CROP_CONVENTION as u, pickDetailCropConvention as ut, HF_BASE_URL as v, resolveEgressDecodeHwAccel as vt, RATE_CONTROL_TIGHT as w, supportedRuntimes as wt, OpsLogEntrySchema as x, runtimeDevices as xt, NativeLeaseAdmissionSchema as y, resolvePoolMemoryPolicy as yt, declareLogChannel as z, isEvent as zt };
+export { inferModelProvider as $, lazy as $t, addonWidgetsSourceCapability as A, Fmp4BoxSplitter as At, defaultDeviceFor as B, hydrateSchema as Bt, RATE_CONTROL_RELAXED as C, storageEvictableCapability as Ct, RecordingSignalStatusSchema as D, webrtcSessionCapability as Dt, RecordingConfigSchema as E, supportedRuntimes as Et, cameraStreamsCapability as F, BaseAddon as Ft, detectionPipelineCapability as G, parseJsonUnknown as Gt, deriveBatteryPresence as H, makeProfileBrokerId as Ht, createHwAccelCache as I, CAM_PROFILE_ORDER as It, enumerateInferenceDevices as J, sleep as Jt, egressTranscodeSharingKey as K, parseProfileBrokerId as Kt, createLogChannelsProvider as L, DeviceFeature as Lt, audioAnalyzerCapability as M, invocationFromEncodeProfile as Mt, audioKindId as N, isSoftwareDecode as Nt, RingBuffer as O, errMsg as Ot, batteryCapability as P, BOOT_RECOVERY_BACKOFF_MS as Pt, hfModelUrl as Q, discriminatedUnion as Qt, customAction as R, DeviceType as Rt, PoolMemoryWatchdog as S, runtimeDevices as St, RECORDING_EXPORT_MAX_READ_BYTES as T, stripRetiredBandPreBufferSec as Tt, deriveDetailCropRect as U, makeSourceBrokerId as Ut, defineCustomActions as V, isEvent as Vt, deriveRecordingMode as W, nodePin as Wt, evaluateZoneRules as X, array as Xt, evaluateSensorEdge as Y, _enum as Yt, failureContributionCapability as Z, boolean as Zt, FailureCounters as _, recordingSignalCapability as _t, COCO_80_LABELS as a, string as an, migrateLegacyDeviceSignalConfig as at, NativeLeaseSettingsSchema as b, resolvePoolMemoryPolicy as bt, DEFAULT_CLUSTER_STEP_MODELS as c, parseProcStatus as ct, DEFAULT_EVENTS_BAND_BUFFER_SEC as d, pickDetailCropConvention as dt, literal as en, isFirstLevelMacroClass as et, DEFAULT_FIRST_SIGHTING_FRESHNESS_MS as f, pickNativeLeaseOverride as ft, ExportRecordSchema as g, recordingExportCapability as gt, EncodeProfileSchema as h, recordingCapability as ht, BatteryStatusSchema as i, record as in, maskUrlCredentials as it, audioAnalysisCapability as j, buildFfmpegArgs as jt, YAMNET_TO_MACRO as k, AUDIO_PRESETS as kt, DEFAULT_CLUSTER_STEP_SETTINGS as l, pickClusterStepModels as lt, DEVICE_BACKEND_TO_FORMAT as m, pipelineRunnerCapability as mt, AUDIO_BACKEND_CHOICES as n, object as nn, logChannelsCapability as nt, COCO_TO_MACRO as o, union as on, motionDetectionCapability as ot, DEFAULT_NATIVE_LEASE_SETTINGS as p, pipelineExecutorCapability as pt, egressTransportFromRequest as q, selectAssignedProfileSlots as qt, AUDIO_MACRO_LABELS as r, preprocess as rn, mapAudioLabelToMacro as rt, DEFAULT_AUDIO_ANALYZER_CONFIG as s, EventCategory as sn, overlayClusterStepSettings as st, APPLE_SA_TO_MACRO as t, number as tn, loadContributionCapability as tt, DEFAULT_DETAIL_CROP_CONVENTION as u, pickClusterStepSettings as ut, HF_BASE_URL as v, resolveClusterStepModelId as vt, RATE_CONTROL_TIGHT as w, streamBrokerCapability as wt, OpsLogEntrySchema as x, resolveRecordingProfiles as xt, NativeLeaseAdmissionSchema as y, resolveEgressDecodeHwAccel as yt, declareLogChannel as z, createEvent as zt };

package/dist/{lazy-sharp-DmAwZ0s9.js → lazy-sharp-VKOG3WW4.js}

@@ -1,4 +1,4 @@
-const require_dist = require("./dist-HG5geL9t.js");
+const require_dist = require("./dist-BxP0SvPz.js");
 let node_path = require("node:path");
 node_path = require_dist.__toESM(node_path);
 let node_url = require("node:url");

package/dist/motion-wasm/index.js

@@ -2,8 +2,8 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_dist = require("../dist-HG5geL9t.js");
-const require_lazy_sharp = require("../lazy-sharp-DmAwZ0s9.js");
+const require_dist = require("../dist-BxP0SvPz.js");
+const require_lazy_sharp = require("../lazy-sharp-VKOG3WW4.js");
 let node_fs = require("node:fs");
 let node_path = require("node:path");
 //#region src/motion-wasm/wasm-motion-detector.ts

package/dist/motion-wasm/index.mjs

@@ -1,4 +1,4 @@
-import { It as DeviceType, Nt as BaseAddon, Rt as hydrateSchema, X as evaluateZoneRules, at as motionDetectionCapability } from "../dist-mYDK58Jp.mjs";
+import { Bt as hydrateSchema, Ft as BaseAddon, Rt as DeviceType, X as evaluateZoneRules, ot as motionDetectionCapability } from "../dist-oFIHnD88.mjs";
 import { t as getSharp } from "../lazy-sharp-DXsqwpph.mjs";
 import { readFileSync } from "node:fs";
 import { join } from "node:path";

package/dist/{node-xRsaPwBa.mjs → node-B4zETsJ9.mjs}

@@ -1,4 +1,4 @@
-import { Et as errMsg, Ot as Fmp4BoxSplitter, jt as isSoftwareDecode, kt as buildFfmpegArgs } from "./dist-mYDK58Jp.mjs";
+import { At as Fmp4BoxSplitter, Nt as isSoftwareDecode, Ot as errMsg, jt as buildFfmpegArgs } from "./dist-oFIHnD88.mjs";
 import { randomUUID } from "node:crypto";
 import "node:fs";
 import "node:path";

package/dist/{node--my8JTOW.js → node-BIKrNEtS.js}

@@ -1,4 +1,4 @@
-const require_dist = require("./dist-HG5geL9t.js");
+const require_dist = require("./dist-BxP0SvPz.js");
 let node_crypto = require("node:crypto");
 let node_fs = require("node:fs");
 node_fs = require_dist.__toESM(node_fs, 1);