@camstack/types 1.2.405 → 1.2.406

package/dist/client.js

@@ -22259,9 +22259,6 @@ var NcSystemEventKindSchema = zod.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",
@@ -22308,13 +22305,14 @@ var NcSystemEventKindSchema = zod.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.
 *
@@ -23491,18 +23489,11 @@ var NcRuleSchema = NcRuleInputSchema.extend({
 	*/
 	disabledTargetIds: zod.z.array(zod.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 = zod.z.enum([
 	"device-state",
 	"streams",
 	"battery",
 	"consumables",
-	"tanks",
 	"detection-blind",
 	"nodes",
 	"addons",
@@ -26520,6 +26511,7 @@ function createDeviceProxy(api, binding, opts) {
 		getStatus: (input) => dispatch("recording-onboard", "recordingOnboard", "getStatus", "query", input)
 	};
 	const recordingSignalInterface = { getStatus: (input) => dispatch("recording-signal", "recordingSignal", "getStatus", "query", input) };
+	const runningStateInterface = { getStatus: (input) => dispatch("running-state", "runningState", "getStatus", "query", input) };
 	const sceneMonitorInterface = {
 		listScenes: (input) => dispatch("scene-monitor", "sceneMonitor", "listScenes", "query", input),
 		listScenesBatch: (input) => dispatch("scene-monitor", "sceneMonitor", "listScenesBatch", "query", input),
@@ -26846,6 +26838,7 @@ function createDeviceProxy(api, binding, opts) {
 			ptzAutotrack: createSliceHandle(stateSource, binding.deviceId, "ptz-autotrack"),
 			recordingOnboard: createSliceHandle(stateSource, binding.deviceId, "recording-onboard"),
 			recordingSignal: createSliceHandle(stateSource, binding.deviceId, "recording-signal"),
+			runningState: createSliceHandle(stateSource, binding.deviceId, "running-state"),
 			sceneMonitor: createSliceHandle(stateSource, binding.deviceId, "scene-monitor"),
 			scriptRunner: createSliceHandle(stateSource, binding.deviceId, "script-runner"),
 			smoke: createSliceHandle(stateSource, binding.deviceId, "smoke"),
@@ -26934,6 +26927,7 @@ function createDeviceProxy(api, binding, opts) {
 		...bound("recording") ? { recording: recordingInterface } : {},
 		...bound("recording-onboard") ? { recordingOnboard: recordingOnboardInterface } : {},
 		...bound("recording-signal") ? { recordingSignal: recordingSignalInterface } : {},
+		...bound("running-state") ? { runningState: runningStateInterface } : {},
 		...bound("scene-monitor") ? { sceneMonitor: sceneMonitorInterface } : {},
 		...bound("script-runner") ? { scriptRunner: scriptRunnerInterface } : {},
 		...bound("smoke") ? { smoke: smokeInterface } : {},
@@ -28736,6 +28730,7 @@ new Set(["devices", "classes"]);
 * 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).
 */
+var LEGACY_KINDS_WITHOUT_FILTERS = new Set(NC_LEGACY_SYSTEM_EVENT_KINDS);
 /**
 * Every filter, for the callers that must cover all of them (guards, tests).
 *
@@ -28759,6 +28754,7 @@ var NC_SYSTEM_EVENT_FILTER_KEYS = [
 * ignores it and an editor hides its input. It never means "excluded".
 */
 function systemEventFilterApplies(kind, filter) {
+	if (LEGACY_KINDS_WITHOUT_FILTERS.has(kind)) return false;
 	switch (filter) {
 		case "deviceIds": return kind.startsWith("device-") || kind.startsWith("stream-") || kind === "detection-blind" || kind.startsWith("motion-") || kind.startsWith("recording-") || kind === "alarm-triggered";
 		case "deviceTypes": return kind.startsWith("device-") || kind === "detection-blind" || kind.startsWith("motion-");
@@ -28813,9 +28809,6 @@ var NC_SYSTEM_EVENT_FAMILY = {
 	"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",
@@ -28910,16 +28903,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",
@@ -29893,11 +29876,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",
@@ -29929,7 +29907,6 @@ var DEVICE_EVENTS = [
 	"device-enabled",
 	...BATTERY,
 	...CONSUMABLE,
-	...TANK,
 	"stream-online",
 	"stream-offline",
 	"detection-blind",
@@ -29975,12 +29952,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",
@@ -30389,18 +30360,7 @@ var NC_TEMPLATE_VARS = [
 		families: ["rule"],
 		fields: [...RULE_TEXT],
 		kinds: ["system"],
-		systemEventKinds: [...CONSUMABLE, ...TANK]
-	},
-	{
-		name: "tank",
-		label: "Tank",
-		description: "Which tank, as a stable token: cleanWater, dirtyWater, detergent, dustBin, or the device key of any other supply (salt, rinse aid).",
-		example: "clean water",
-		group: "system",
-		families: ["rule"],
-		fields: [...RULE_TEXT],
-		kinds: ["system"],
-		systemEventKinds: [...TANK]
+		systemEventKinds: [...CONSUMABLE]
 	},
 	{
 		name: "profile",
@@ -31051,9 +31011,6 @@ var NC_TEMPLATE_VARS = [
 * delete it from here then, and the served catalog names it again.
 */
 var NC_TEMPLATE_HELD_BACK_SYSTEM_EVENT_KINDS = [
-	"device-tank-low",
-	"device-tank-full",
-	"device-tank-normal",
 	"node-restarting",
 	"node-updating",
 	"alert-critical",
@@ -31166,15 +31123,6 @@ var NC_SYSTEM_EVENT_CLASS_SPECS = [
 		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",

package/dist/client.mjs

@@ -22258,9 +22258,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",
@@ -22307,13 +22304,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.
 *
@@ -23490,18 +23488,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",
@@ -26519,6 +26510,7 @@ function createDeviceProxy(api, binding, opts) {
 		getStatus: (input) => dispatch("recording-onboard", "recordingOnboard", "getStatus", "query", input)
 	};
 	const recordingSignalInterface = { getStatus: (input) => dispatch("recording-signal", "recordingSignal", "getStatus", "query", input) };
+	const runningStateInterface = { getStatus: (input) => dispatch("running-state", "runningState", "getStatus", "query", input) };
 	const sceneMonitorInterface = {
 		listScenes: (input) => dispatch("scene-monitor", "sceneMonitor", "listScenes", "query", input),
 		listScenesBatch: (input) => dispatch("scene-monitor", "sceneMonitor", "listScenesBatch", "query", input),
@@ -26845,6 +26837,7 @@ function createDeviceProxy(api, binding, opts) {
 			ptzAutotrack: createSliceHandle(stateSource, binding.deviceId, "ptz-autotrack"),
 			recordingOnboard: createSliceHandle(stateSource, binding.deviceId, "recording-onboard"),
 			recordingSignal: createSliceHandle(stateSource, binding.deviceId, "recording-signal"),
+			runningState: createSliceHandle(stateSource, binding.deviceId, "running-state"),
 			sceneMonitor: createSliceHandle(stateSource, binding.deviceId, "scene-monitor"),
 			scriptRunner: createSliceHandle(stateSource, binding.deviceId, "script-runner"),
 			smoke: createSliceHandle(stateSource, binding.deviceId, "smoke"),
@@ -26933,6 +26926,7 @@ function createDeviceProxy(api, binding, opts) {
 		...bound("recording") ? { recording: recordingInterface } : {},
 		...bound("recording-onboard") ? { recordingOnboard: recordingOnboardInterface } : {},
 		...bound("recording-signal") ? { recordingSignal: recordingSignalInterface } : {},
+		...bound("running-state") ? { runningState: runningStateInterface } : {},
 		...bound("scene-monitor") ? { sceneMonitor: sceneMonitorInterface } : {},
 		...bound("script-runner") ? { scriptRunner: scriptRunnerInterface } : {},
 		...bound("smoke") ? { smoke: smokeInterface } : {},
@@ -28735,6 +28729,7 @@ new Set(["devices", "classes"]);
 * 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).
 */
+var LEGACY_KINDS_WITHOUT_FILTERS = new Set(NC_LEGACY_SYSTEM_EVENT_KINDS);
 /**
 * Every filter, for the callers that must cover all of them (guards, tests).
 *
@@ -28758,6 +28753,7 @@ var NC_SYSTEM_EVENT_FILTER_KEYS = [
 * ignores it and an editor hides its input. It never means "excluded".
 */
 function systemEventFilterApplies(kind, filter) {
+	if (LEGACY_KINDS_WITHOUT_FILTERS.has(kind)) return false;
 	switch (filter) {
 		case "deviceIds": return kind.startsWith("device-") || kind.startsWith("stream-") || kind === "detection-blind" || kind.startsWith("motion-") || kind.startsWith("recording-") || kind === "alarm-triggered";
 		case "deviceTypes": return kind.startsWith("device-") || kind === "detection-blind" || kind.startsWith("motion-");
@@ -28812,9 +28808,6 @@ var NC_SYSTEM_EVENT_FAMILY = {
 	"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",
@@ -28909,16 +28902,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",
@@ -29892,11 +29875,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",
@@ -29928,7 +29906,6 @@ var DEVICE_EVENTS = [
 	"device-enabled",
 	...BATTERY,
 	...CONSUMABLE,
-	...TANK,
 	"stream-online",
 	"stream-offline",
 	"detection-blind",
@@ -29974,12 +29951,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",
@@ -30388,18 +30359,7 @@ var NC_TEMPLATE_VARS = [
 		families: ["rule"],
 		fields: [...RULE_TEXT],
 		kinds: ["system"],
-		systemEventKinds: [...CONSUMABLE, ...TANK]
-	},
-	{
-		name: "tank",
-		label: "Tank",
-		description: "Which tank, as a stable token: cleanWater, dirtyWater, detergent, dustBin, or the device key of any other supply (salt, rinse aid).",
-		example: "clean water",
-		group: "system",
-		families: ["rule"],
-		fields: [...RULE_TEXT],
-		kinds: ["system"],
-		systemEventKinds: [...TANK]
+		systemEventKinds: [...CONSUMABLE]
 	},
 	{
 		name: "profile",
@@ -31050,9 +31010,6 @@ var NC_TEMPLATE_VARS = [
 * delete it from here then, and the served catalog names it again.
 */
 var NC_TEMPLATE_HELD_BACK_SYSTEM_EVENT_KINDS = [
-	"device-tank-low",
-	"device-tank-full",
-	"device-tank-normal",
 	"node-restarting",
 	"node-updating",
 	"alert-critical",
@@ -31165,15 +31122,6 @@ var NC_SYSTEM_EVENT_CLASS_SPECS = [
 		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",

package/dist/{composition-eoYYVfOp.js → composition-RmnnN39T.js}

@@ -1138,7 +1138,7 @@ var ExpressionEvalError = class extends Error {
 //#endregion
 //#region src/expression/builtins.ts
 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`);
@@ -1229,6 +1229,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) {
@@ -1398,6 +1449,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. */
@@ -1975,7 +2040,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": {
@@ -1997,6 +2062,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);
+		}
 	}
 }
 /** The `now` epoch-ms binding is auto-injected into every evaluation and is a

package/dist/{composition-CB6PMT9p.mjs → composition-xz-ud5EQ.mjs}

@@ -1138,7 +1138,7 @@ var ExpressionEvalError = class extends Error {
 //#endregion
 //#region src/expression/builtins.ts
 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`);
@@ -1229,6 +1229,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) {
@@ -1398,6 +1449,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. */
@@ -1975,7 +2040,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": {
@@ -1997,6 +2062,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);
+		}
 	}
 }
 /** The `now` epoch-ms binding is auto-injected into every evaluation and is a

package/dist/device/cap-vocabulary/entries/appliances.d.ts

@@ -1,5 +1,5 @@
 import type { CapVocabularySlice } from '../types.js';
-type ApplianceCap = 'vacuum-control' | 'lawn-mower-control' | 'dishwasher' | 'pet-feeder' | 'media-player' | 'consumables' | 'navigation' | 'script-runner' | 'automation-control' | 'notifier' | 'update';
+type ApplianceCap = 'vacuum-control' | 'lawn-mower-control' | 'dishwasher' | 'pet-feeder' | 'media-player' | 'consumables' | 'running-state' | 'navigation' | 'script-runner' | 'automation-control' | 'notifier' | 'update';
 /** The appliance family of the vocabulary. */
 export declare const APPLIANCE_CAP_VOCABULARY: CapVocabularySlice<ApplianceCap>;
 export {};

package/dist/enums/event-category.d.ts

@@ -469,6 +469,10 @@ export declare enum EventCategory {
      * on the device detail page.
      */
     DoorbellOnPressed = "doorbell.onPressed",
+    /** Mirrors `runningStateCapability.events.onStarted`. */
+    RunningStarted = "running.started",
+    /** Mirrors `runningStateCapability.events.onFinished`. */
+    RunningFinished = "running.finished",
     /**
      * Cap event fired by every device that registers the `event-emitter`
      * capability. Mirrors `eventEmitterCapability.events.onEvent`. Carries

package/dist/enums.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_event_category = require("./event-category-CXrwjC3e.js");
+const require_event_category = require("./event-category-DG6Vir8Z.js");
 //#region src/enums/event-source-type.ts
 var EventSourceType = /* @__PURE__ */ function(EventSourceType) {
 	EventSourceType["Addon"] = "addon";

package/dist/enums.mjs

@@ -1,4 +1,4 @@
-import { t as EventCategory } from "./event-category-fDPduoeC.mjs";
+import { t as EventCategory } from "./event-category-Ceif8n-v.mjs";
 //#region src/enums/event-source-type.ts
 var EventSourceType = /* @__PURE__ */ function(EventSourceType) {
 	EventSourceType["Addon"] = "addon";

package/dist/{event-category-fDPduoeC.mjs → event-category-Ceif8n-v.mjs}

@@ -470,6 +470,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

package/dist/{event-category-CXrwjC3e.js → event-category-DG6Vir8Z.js}

@@ -470,6 +470,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