@camstack/system 1.2.473 → 1.2.474

package/dist/{dist-C9lbdBL5.mjs → dist-BugavoVR.mjs}

@@ -1,6 +1,6 @@
 import { z } from "zod";
 import "node:crypto";
-//#region ../types/dist/event-category-fDPduoeC.mjs
+//#region ../types/dist/event-category-Ceif8n-v.mjs
 var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["SystemBoot"] = "system.boot";
 	EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -472,6 +472,10 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	* on the device detail page.
 	*/
 	EventCategory["DoorbellOnPressed"] = "doorbell.onPressed";
+	/** Mirrors `runningStateCapability.events.onStarted`. */
+	EventCategory["RunningStarted"] = "running.started";
+	/** Mirrors `runningStateCapability.events.onFinished`. */
+	EventCategory["RunningFinished"] = "running.finished";
 	/**
 	* Cap event fired by every device that registers the `event-emitter`
 	* capability. Mirrors `eventEmitterCapability.events.onEvent`. Carries
@@ -761,7 +765,7 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	return EventCategory;
 }({});
 //#endregion
-//#region ../types/dist/sleep-CHIEEJkY.mjs
+//#region ../types/dist/sleep-CYfIZzGv.mjs
 /**
 * The audio chunk plane's byte format, and the ONE expansion from a coded
 * window to float samples (D455).
@@ -1152,7 +1156,7 @@ var WELL_KNOWN_TAB_MAP = Object.fromEntries([
 * `hydrateSchema` to skip the `value` injection for structural-only fields.
 */
 function isValuelessField(field) {
-	return field.type === "separator" || field.type === "info" || field.type === "qr-code" || field.type === "button" || field.type === "object-array" || field.type === "widget" || field.type === "addon-action-button" || field.type === "device-action-button";
+	return field.type === "separator" || field.type === "info" || field.type === "qr-code" || field.type === "button" || field.type === "object-array" || field.type === "widget" || field.type === "addon-action-button" || field.type === "device-action-button" || field.type === "account-sign-in" || field.type === "secret-presence";
 }
 function hydrateSchema(schema, values, options = {}) {
 	return {
@@ -5480,7 +5484,7 @@ function errMsg(err) {
 	return String(err);
 }
 //#endregion
-//#region ../types/dist/composition-CB6PMT9p.mjs
+//#region ../types/dist/composition-xz-ud5EQ.mjs
 var AUDIO_ENCODER_BY_CODEC = {
 	opus: "libopus",
 	aac: "aac",
@@ -6011,7 +6015,7 @@ var ExpressionEvalError = class extends Error {
 	}
 };
 function isStatefulBuiltin(name) {
-	return name === "rose" || name === "count";
+	return name === "rose" || name === "count" || name === "dwell" || name === "latchedAt";
 }
 function asFiniteNumber(value, name, index) {
 	if (typeof value !== "number" || !Number.isFinite(value)) throw new ExpressionEvalError(`${name}: argument ${index + 1} must be a finite number`);
@@ -6102,6 +6106,57 @@ function disarmRoseMemory(memory) {
 * input is its own `lastPressedAt`, which only advances on a `rose` edge that
 * also emits the press — but an external input can overcount by one.
 */
+function asNonNegativeMs(value, name, index) {
+	const ms = asFiniteNumber(value, name, index);
+	if (ms < 0) throw new ExpressionEvalError(`${name}: delay must be a non-negative finite number`);
+	return ms;
+}
+/**
+* `dwell(active, onForMs, offForMs)`: unknown until a delay elapses, then holds
+* the latched boolean through gaps shorter than the opposing delay (D933).
+*/
+function evaluateDwell(activeRaw, onForMsRaw, offForMsRaw, call, nowMs, hooks) {
+	const active = asBoolean(activeRaw, "dwell", 0);
+	const onForMs = asNonNegativeMs(onForMsRaw, "dwell", 1);
+	const offForMs = asNonNegativeMs(offForMsRaw, "dwell", 2);
+	if (call.latched === null) {
+		if (call.seenSince === null) call.seenSince = nowMs;
+		const delay = active ? onForMs : offForMs;
+		if (nowMs - call.seenSince >= delay) {
+			call.latched = active;
+			return call.latched;
+		}
+		hooks?.noteDeadline?.(call.seenSince + delay);
+		return null;
+	}
+	if (active === call.latched) {
+		call.pendingSince = null;
+		return call.latched;
+	}
+	if (call.pendingSince === null) call.pendingSince = nowMs;
+	const delay = active ? onForMs : offForMs;
+	if (nowMs - call.pendingSince >= delay) {
+		call.latched = active;
+		call.pendingSince = null;
+		return call.latched;
+	}
+	hooks?.noteDeadline?.(call.pendingSince + delay);
+	return call.latched;
+}
+/** `latchedAt(value)`: epoch ms when `value` last changed; null clears the stamp. */
+function evaluateLatchedAt(value, call, nowMs) {
+	if (value === null) {
+		call.last = null;
+		call.at = null;
+		return null;
+	}
+	if (typeof value !== "boolean" && typeof value !== "number" && typeof value !== "string") return call.at;
+	if (call.last !== value) {
+		call.last = value;
+		call.at = nowMs;
+	}
+	return call.at;
+}
 function evaluateCount(input, call, currentOutput) {
 	const currentCount = typeof currentOutput === "number" && Number.isFinite(currentOutput) && currentOutput >= 0 ? currentOutput : 0;
 	if (input === null) {
@@ -6271,6 +6326,20 @@ var table = {
 		apply: () => {
 			throw new ExpressionEvalError("count: stateful evaluation context is required");
 		}
+	},
+	dwell: {
+		minArgs: 3,
+		maxArgs: 3,
+		apply: () => {
+			throw new ExpressionEvalError("dwell: stateful evaluation context is required");
+		}
+	},
+	latchedAt: {
+		minArgs: 1,
+		maxArgs: 1,
+		apply: () => {
+			throw new ExpressionEvalError("latchedAt: stateful evaluation context is required");
+		}
 	}
 };
 /** Frozen, null-prototype builtin table. */
@@ -6816,7 +6885,7 @@ function cloneStatefulExpressionMemory(memory) {
 		disarmRoseNext: memory.disarmRoseNext
 	};
 }
-function evaluateStatefulExpressionCall(invocation, memory, env) {
+function evaluateStatefulExpressionCall(invocation, memory, env, hooks) {
 	const existing = memory.calls.get(invocation.path);
 	switch (invocation.name) {
 		case "rose": {
@@ -6838,6 +6907,25 @@ function evaluateStatefulExpressionCall(invocation, memory, env) {
 			memory.calls.set(invocation.path, call);
 			return evaluateCount(invocation.args[0], call, env.currentOutput);
 		}
+		case "dwell": {
+			const call = existing?.kind === "dwell" ? existing : {
+				kind: "dwell",
+				pendingSince: null,
+				latched: null,
+				seenSince: null
+			};
+			memory.calls.set(invocation.path, call);
+			return evaluateDwell(invocation.args[0], invocation.args[1], invocation.args[2], call, env.nowMs, hooks);
+		}
+		case "latchedAt": {
+			const call = existing?.kind === "latchedAt" ? existing : {
+				kind: "latchedAt",
+				last: void 0,
+				at: null
+			};
+			memory.calls.set(invocation.path, call);
+			return evaluateLatchedAt(invocation.args[0], call, env.nowMs);
+		}
 	}
 }
 /**
@@ -15531,7 +15619,15 @@ var BUILTIN_RESULT_KINDS = Object.freeze({
 		kind: "fixed",
 		result: ["number", "null"]
 	},
-	count: NUMBER
+	count: NUMBER,
+	dwell: {
+		kind: "fixed",
+		result: ["boolean", "null"]
+	},
+	latchedAt: {
+		kind: "fixed",
+		result: ["number", "null"]
+	}
 });
 var KindInferenceError = class extends Error {};
 function kindOfValue(value) {
@@ -45183,9 +45279,6 @@ var NcSystemEventKindSchema = z.enum([
 	"device-battery-normal",
 	"device-consumable-low",
 	"device-consumable-normal",
-	"device-tank-low",
-	"device-tank-full",
-	"device-tank-normal",
 	"stream-online",
 	"stream-offline",
 	"node-online",
@@ -45232,13 +45325,14 @@ var NcSystemEventKindSchema = z.enum([
 	"camera-enabled"
 ]);
 /** The legacy tail of {@link NcSystemEventKindSchema} — see its docblock. */
-var NC_LEGACY_SYSTEM_EVENT_KINDS = new Set([
+var NC_LEGACY_SYSTEM_EVENT_KINDS = [
 	"camera-online",
 	"camera-offline",
 	"camera-disabled",
 	"camera-enabled"
-]);
-NcSystemEventKindSchema.options.filter((kind) => !NC_LEGACY_SYSTEM_EVENT_KINDS.has(kind));
+];
+var NC_LEGACY_SYSTEM_EVENT_KIND_SET = new Set(NC_LEGACY_SYSTEM_EVENT_KINDS);
+NcSystemEventKindSchema.options.filter((kind) => !NC_LEGACY_SYSTEM_EVENT_KIND_SET.has(kind));
 /**
 * The panel's transitions, as ONE list.
 *
@@ -46368,18 +46462,11 @@ var NcRuleSchema = NcRuleInputSchema.extend({
 	*/
 	disabledTargetIds: z.array(z.string()).default([])
 });
-/**
-* The state-summary SECTIONS (D647 / D698 / D708): the D637 kind groups that
-* report a still-true state. `addons` is the crash-looped addons only and
-* `addon-updates` the addons that are behind (D708 split them). `backups-exports` and `alarm` are not sections — a completed
-* job is not an open state, and the alarm stays instant.
-*/
 var NcStateSummarySectionIdSchema = z.enum([
 	"device-state",
 	"streams",
 	"battery",
 	"consumables",
-	"tanks",
 	"detection-blind",
 	"nodes",
 	"addons",
@@ -68115,6 +68202,41 @@ var ptzAutotrackCapability = {
 	*/
 	history: "none"
 };
+var RunningStateSourceSchema = z.enum(["native", "assigned"]);
+var RunningStateStatusSchema = z.object({
+	/** null = unknown — never coerced to false (D393). */
+	running: z.boolean().nullable(),
+	/** Epoch ms the current boolean began; null while `running` is null. */
+	since: z.number().nullable(),
+	source: RunningStateSourceSchema,
+	phase: z.string().nullable(),
+	lastFetchedAt: z.number()
+});
+var RunningFlipEventDataSchema = z.object({
+	deviceId: z.number(),
+	since: z.number().nullable(),
+	phase: z.string().nullable()
+});
+var runningStateCapability = {
+	name: "running-state",
+	scope: "device",
+	deviceNative: true,
+	mode: "singleton",
+	deviceTypes: Object.values(DeviceType),
+	methods: {},
+	events: {
+		onStarted: { data: RunningFlipEventDataSchema },
+		onFinished: { data: RunningFlipEventDataSchema }
+	},
+	status: {
+		schema: RunningStateStatusSchema,
+		kind: "push"
+	},
+	runtimeState: RunningStateStatusSchema,
+	durability: "restored",
+	history: { fields: { running: { kind: "boolean" } } },
+	volatileStateFields: ["lastFetchedAt"]
+};
 /**
 * reboot — device-scoped capability for "soft" device reboots (firmware
 * reboot via vendor protocol; cameras, NVRs, doorbells). Surfaces a
@@ -74167,11 +74289,12 @@ function expressionOutcome(source, read, now, stateful) {
 		return unavailable;
 	}
 	const deadlines = [];
+	const hooks = {
+		noteDeadline: (at) => deadlines.push(at),
+		convert: (value, from, to) => tryConvertUnit(value, normalizeUnit(from) ?? from, normalizeUnit(to) ?? to) ?? null
+	};
 	const result = evaluateExpressionSource(source.expr, values, now, {
-		hooks: {
-			noteDeadline: (at) => deadlines.push(at),
-			convert: (value, from, to) => tryConvertUnit(value, normalizeUnit(from) ?? from, normalizeUnit(to) ?? to) ?? null
-		},
+		hooks,
 		...stateful === void 0 ? {} : { invokeStateful: (invocation) => evaluateStatefulExpressionCall(stateful.callPathPrefix === void 0 ? invocation : {
 			...invocation,
 			path: `${stateful.callPathPrefix}@${invocation.path}`
@@ -74179,7 +74302,7 @@ function expressionOutcome(source, read, now, stateful) {
 			currentOutput: stateful.currentOutput,
 			startedAtMs: stateful.startedAtMs,
 			nowMs: now
-		}) }
+		}, hooks) }
 	});
 	if (!result.ok) return {
 		state: "unavailable",
@@ -74561,6 +74684,7 @@ var DEVICE_LOCAL_STATE_CAPS = {
 	ptzAutotrack: ptzAutotrackCapability,
 	recordingOnboard: recordingOnboardCapability,
 	recordingSignal: recordingSignalCapability,
+	runningState: runningStateCapability,
 	sceneMonitor: sceneMonitorCapability,
 	scriptRunner: scriptRunnerCapability,
 	smoke: smokeCapability,
@@ -83081,6 +83205,13 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		access: "create",
 		role: "admin"
 	},
+	"runningState.getStatus": {
+		capName: "running-state",
+		capScope: "device",
+		addonId: null,
+		access: "view",
+		role: "viewer"
+	},
 	"sceneMonitor.captureReference": {
 		capName: "scene-monitor",
 		capScope: "device",
@@ -87795,6 +87926,32 @@ var APPLIANCE_CAP_VOCABULARY = {
 		}],
 		events: { onSent: { notOperatorFacing: "a delivery receipt of a send this system made — not a fact about the world" } }
 	},
+	"running-state": {
+		scope: "device",
+		noun: t("Running", "In funzione"),
+		state: [{
+			kind: "boolean",
+			field: "running",
+			label: t("Running", "In funzione"),
+			whenTrue: t("When {device} starts", "Quando {device} inizia"),
+			whenFalse: t("When {device} finishes", "Quando {device} finisce"),
+			icon: "play"
+		}],
+		events: {
+			onStarted: {
+				category: EventCategory.RunningStarted,
+				label: t("Started running", "Ha iniziato a funzionare"),
+				phrase: t("When {device} starts running", "Quando {device} inizia a funzionare"),
+				icon: "play"
+			},
+			onFinished: {
+				category: EventCategory.RunningFinished,
+				label: t("Finished", "Ha finito"),
+				phrase: t("When {device} finishes", "Quando {device} finisce"),
+				icon: "square"
+			}
+		}
+	},
 	update: {
 		scope: "device",
 		noun: t("Firmware update", "Aggiornamento firmware"),
@@ -89130,6 +89287,7 @@ var CAP_NAMES_WITH_STATUS = [
 	"recording-archive",
 	"recording-onboard",
 	"recording-signal",
+	"running-state",
 	"scene-monitor",
 	"script-runner",
 	"smoke",
@@ -89292,6 +89450,7 @@ var ALL_CAPABILITY_DEFINITIONS = [
 	recordingOnboardCapability,
 	recordingSignalCapability,
 	recordsCapability,
+	runningStateCapability,
 	sceneMonitorCapability,
 	scriptRunnerCapability,
 	serverManagementCapability,
@@ -91606,6 +91765,11 @@ Object.freeze({
 		form: "single",
 		optional: true
 	}],
+	"runningState.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"sceneMonitor.captureReference": [{
 		name: "deviceId",
 		form: "single",
@@ -92105,7 +92269,7 @@ Object.freeze({
 });
 /**
 * Per-cap runtime-state policy, projected from every `*.cap.ts` that declares
-* `runtimeState`. 71 caps: 37 `restored`, 34 `session`.
+* `runtimeState`. 72 caps: 38 `restored`, 34 `session`.
 *
 * A cap absent from this map has no runtime-state slice at all. A cap PRESENT
 * with `durability: 'session'` has one and has decided not to keep it.
@@ -92323,6 +92487,10 @@ var RUNTIME_STATE_POLICY = {
 		durability: "session",
 		volatileFields: []
 	},
+	"running-state": {
+		durability: "restored",
+		volatileFields: ["lastFetchedAt"]
+	},
 	"scene-monitor": {
 		durability: "session",
 		volatileFields: []
@@ -92413,7 +92581,7 @@ var SESSION_ONLY_POLICY = {
 };
 /**
 * Cap history catalog, projected from every `*.cap.ts` `history` block.
-* 40 caps with series (73 series), 30 caps answered `'none'`.
+* 41 caps with series (74 series), 30 caps answered `'none'`.
 * Field keys are `runtimeState` paths (`a.b` into fixed objects only).
 */
 var HISTORY_CATALOG = {
@@ -92690,6 +92858,7 @@ var HISTORY_CATALOG = {
 		unit: "hPa",
 		deadband: .1
 	} },
+	"running-state": { "running": { kind: "boolean" } },
 	"smoke": { "detected": { kind: "boolean" } },
 	"stream-params": {
 		"main.bitrate": {
@@ -92849,40 +93018,7 @@ var NC_AUDIO_DEFAULTS = {
 	samplingSeconds: 10
 };
 new Set(["devices", "classes"]);
-/**
-* WHICH narrowing filter speaks about WHICH system-event kind — one predicate,
-* consumed by the rule ENGINE and by every rule EDITOR.
-*
-* ── The failure this file exists for ───────────────────────────────────────
-* `NcSystemEventConditionSchema` carries four optional narrowing lists
-* (`deviceIds`, `deviceTypes`, `nodeIds`, `packageNames`) beside a required
-* `kinds` gate. They are not four filters over one vocabulary: each belongs to
-* a FAMILY of kinds and is meaningless outside it. A node going away has no
-* device type; a completed export has no package; `stream-offline` deliberately
-* carries no device type at all (a stream belongs to a camera by construction).
-*
-* The engine applied all four to every kind, so a filter from one family failed
-* a kind from another family CLOSED. The operator's live rule "Eventi di
-* sistema" selected eleven kinds and set `deviceTypes: ['camera']` — the only
-* way to say "only my cameras" about the two liveness kinds — and NINE of the
-* eleven silently stopped being deliverable. Four days of history contained
-* `device-online` and `device-offline` and nothing else, across a window in
-* which agents were restarted and addons were updated.
-*
-* Both editors already computed this scoping, to decide which filter boxes to
-* render; the cap's own docblock already promised it ("Narrow a `device-*` kind
-* to these device TYPES"). Only the engine disagreed, and it disagreed in the
-* destructive direction. So the rule is stated ONCE, here, and the engine and
-* the editors are readers of it rather than three independent authors.
-*
-* ── The direction ─────────────────────────────────────────────────────────
-* Out of family ⇒ the filter is IGNORED, never fail-closed. An editor that
-* hides a box has already told the operator this filter does not speak about
-* these kinds, so honouring it as an exclusion contradicts the only
-* explanation the operator was ever given. Inside its family the filter still
-* narrows, and still fails CLOSED on a subject that cannot produce the identity
-* it tests (a device the mirror cannot name is not evidence of a camera).
-*/
+new Set(NC_LEGACY_SYSTEM_EVENT_KINDS);
 /**
 * Every filter, for the callers that must cover all of them (guards, tests).
 *
@@ -92908,9 +93044,6 @@ new Map(Object.entries({
 	"device-battery-normal": "device-events",
 	"device-consumable-low": "device-events",
 	"device-consumable-normal": "device-events",
-	"device-tank-low": "device-events",
-	"device-tank-full": "device-events",
-	"device-tank-normal": "device-events",
 	"stream-online": "device-events",
 	"stream-offline": "device-events",
 	"detection-blind": "device-events",
@@ -92987,16 +93120,6 @@ var NC_SYSTEM_EVENT_KIND_GROUP_SPECS = [
 		label: "Consumables",
 		kinds: ["device-consumable-low", "device-consumable-normal"]
 	},
-	{
-		id: "tanks",
-		family: "device-events",
-		label: "Tanks",
-		kinds: [
-			"device-tank-low",
-			"device-tank-full",
-			"device-tank-normal"
-		]
-	},
 	{
 		id: "detection-blind",
 		family: "device-events",
@@ -93196,11 +93319,6 @@ var RULE_BODY_ONLY = ["body"];
 var RULE_TEXT = ["title", "body"];
 var BATTERY = ["device-battery-low", "device-battery-normal"];
 var CONSUMABLE = ["device-consumable-low", "device-consumable-normal"];
-var TANK = [
-	"device-tank-low",
-	"device-tank-full",
-	"device-tank-normal"
-];
 var ALERT_EPISODE = [
 	"alert-critical",
 	"alert-error",
@@ -93232,7 +93350,6 @@ var DEVICE_EVENTS = [
 	"device-enabled",
 	...BATTERY,
 	...CONSUMABLE,
-	...TANK,
 	"stream-online",
 	"stream-offline",
 	"detection-blind",
@@ -93278,12 +93395,6 @@ var STATE_SUMMARY_SECTION_VARS = [
 		example: "Robot — filter 10 %",
 		kinds: CONSUMABLE
 	},
-	{
-		name: "summaryTanks",
-		label: "Summary: tanks",
-		example: "Robot — clean water low",
-		kinds: TANK
-	},
 	{
 		name: "summaryDetection",
 		label: "Summary: cameras detecting nothing",
@@ -93399,8 +93510,7 @@ var STATE_SUMMARY_VARS = [
 	([...RULE_TEXT], [...COMBINED_ALARM]),
 	([...RULE_TEXT], [...DEVICE_EVENTS]),
 	([...RULE_TEXT], [...BATTERY, ...CONSUMABLE]),
-	([...RULE_TEXT], [...CONSUMABLE, ...TANK]),
-	([...RULE_TEXT], [...TANK]),
+	([...RULE_TEXT], [...CONSUMABLE]),
 	[...RULE_TEXT],
 	([...RULE_TEXT], [...UPDATES, ...ALERT_EPISODE]),
 	([...RULE_TEXT], [...UPDATES, ...ALERT_EPISODE]),
@@ -93504,15 +93614,6 @@ new Map([
 		snapshotLabel: "Consumables low now",
 		snapshotSection: "consumables"
 	},
-	{
-		id: "tanks",
-		family: "device-events",
-		label: "Tanks (low or full / back to normal)",
-		bad: ["device-tank-low", "device-tank-full"],
-		recovery: ["device-tank-normal"],
-		snapshotLabel: "Tanks low or full now",
-		snapshotSection: "tanks"
-	},
 	{
 		id: "motion-noise",
 		family: "device-events",