@camstack/types 1.2.404 → 1.2.406

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

package/dist/expression/builtins.d.ts

@@ -16,7 +16,7 @@
  * closed rather than emitting a garbage value.
  */
 import type { ExpressionValue } from './ast.js';
-import type { CountCallState, RoseCallState, StatefulExpressionMemory } from './expression-source.js';
+import type { CountCallState, DwellCallState, LatchedAtCallState, RoseCallState, StatefulExpressionMemory } from './expression-source.js';
 /** Optional runtime hooks the evaluator threads through to builtins. */
 export interface ExpressionEvalHooks {
     /** Convert `value` from unit `from` to unit `to`; `null` when the pair is
@@ -41,7 +41,7 @@ export interface ExpressionBuiltin {
     readonly maxArgs: number;
     readonly apply: (args: readonly ExpressionValue[], hooks: ExpressionEvalHooks) => ExpressionValue;
 }
-export type StatefulExpressionBuiltin = 'rose' | 'count';
+export type StatefulExpressionBuiltin = 'rose' | 'count' | 'dwell' | 'latchedAt';
 export declare function isStatefulBuiltin(name: string): name is StatefulExpressionBuiltin;
 export declare function evaluateRose(level: unknown, changedAt: unknown, debounceMs: unknown, call: RoseCallState, field: StatefulExpressionMemory, env: {
     readonly currentOutput: number | null;
@@ -51,23 +51,12 @@ export declare function evaluateRose(level: unknown, changedAt: unknown, debounc
 /** Next evaluation of every `rose` call baselines without rising. */
 export declare function disarmRoseMemory(memory: StatefulExpressionMemory): void;
 /**
- * `count(x)`: how many times `x` strictly advanced (D670). It starts on the
- * first ANSWERED read of `x`:
- *  - an answered `null` ("never happened") primes it with no high-water, so the
- *    next finite value is a real advance and counts 1;
- *  - an answered finite value primes it with that value as the high-water and
- *    no increment — it is history, not an event;
- *  - anything else (a read that did not answer reaches here as neither) does
- *    NOT prime it (D393: unknown is not null).
- * An unavailable binding never reaches this function at all: the field is
- * judged unavailable before the expression runs.
- *
- * Edge case, accepted: an input that answers `null` and LATER reports a
- * historical value (a sensor's `lastChangedAt` that was null until its first
- * report) counts that value once. For the doorbell it cannot happen — its
- * 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.
+ * `dwell(active, onForMs, offForMs)`: unknown until a delay elapses, then holds
+ * the latched boolean through gaps shorter than the opposing delay (D933).
  */
+export declare function evaluateDwell(activeRaw: unknown, onForMsRaw: unknown, offForMsRaw: unknown, call: DwellCallState, nowMs: number, hooks?: ExpressionEvalHooks): boolean | null;
+/** `latchedAt(value)`: epoch ms when `value` last changed; null clears the stamp. */
+export declare function evaluateLatchedAt(value: unknown, call: LatchedAtCallState, nowMs: number): number | null;
 export declare function evaluateCount(input: unknown, call: CountCallState, currentOutput: unknown): number;
 /** Frozen, null-prototype builtin table. */
 export declare const EXPRESSION_BUILTINS: Readonly<Record<string, ExpressionBuiltin>>;

package/dist/expression/expression-source.d.ts

@@ -9,6 +9,7 @@
  * positions (derive a value, gate a trigger, compute an argument).
  */
 import type { ExpressionValue } from './ast.js';
+import { type ExpressionEvalHooks } from './builtins.js';
 import { type ExpressionEvalOptions, type StatefulCallInvocation } from './evaluator.js';
 export interface RoseCallState {
     readonly kind: 'rose';
@@ -27,7 +28,18 @@ export interface CountCallState {
     /** Whether a read has ANSWERED yet (a finite value or `null`); `highWater` means nothing before. */
     primed: boolean;
 }
-export type StatefulCallState = RoseCallState | CountCallState;
+export interface DwellCallState {
+    readonly kind: 'dwell';
+    pendingSince: number | null;
+    latched: boolean | null;
+    seenSince: number | null;
+}
+export interface LatchedAtCallState {
+    readonly kind: 'latchedAt';
+    last: ExpressionValue | undefined;
+    at: number | null;
+}
+export type StatefulCallState = RoseCallState | CountCallState | DwellCallState | LatchedAtCallState;
 export interface StatefulExpressionMemory {
     readonly calls: Map<string, StatefulCallState>;
     acceptedEdgeAt: number | null;
@@ -44,7 +56,7 @@ export interface StatefulExpressionEnvironment {
     readonly startedAtMs: number;
     readonly nowMs: number;
 }
-export declare function evaluateStatefulExpressionCall(invocation: StatefulCallInvocation, memory: StatefulExpressionMemory, env: StatefulExpressionEnvironment): ExpressionValue;
+export declare function evaluateStatefulExpressionCall(invocation: StatefulCallInvocation, memory: StatefulExpressionMemory, env: StatefulExpressionEnvironment, hooks?: ExpressionEvalHooks): ExpressionValue;
 /** The `now` epoch-ms binding is auto-injected into every evaluation and is a
  *  reserved binding name (authors may not rebind it). */
 export declare const EXPRESSION_INJECTED_NOW = "now";

package/dist/generated/addon-api.d.ts

@@ -8541,6 +8541,20 @@ export type AppRouter = TrpcCoreRouter<{
             meta: object;
         }>;
     }>>;
+    runningState: TRPCBuiltRouter<{
+        ctx: TrpcContext;
+        meta: object;
+        errorShape: AugmentedErrorShape;
+        transformer: true;
+    }, TRPCDecorateCreateRouterOptions<{
+        getStatus: TRPCQueryProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof DEVICE_STATUS_METHOD.getStatus.input>;
+            output: z.infer<typeof DEVICE_STATUS_METHOD.getStatus.output>;
+            meta: object;
+        }>;
+    }>>;
     sceneMonitor: TRPCBuiltRouter<{
         ctx: TrpcContext;
         meta: object;

package/dist/generated/addon-cap-facts.d.ts

@@ -5,7 +5,7 @@
  * `ALL_CAPABILITY_DEFINITIONS` (the whole Zod schema graph, ~+100 MB heap per
  * runner). See docs/decisions/adr-0028.md.
  *
- * Coverage: 1 advance-derived caps, 73 caps with 363 state leaves.
+ * Coverage: 1 advance-derived caps, 74 caps with 367 state leaves.
  */
 /** A bindable scalar in a capability's runtime state. */
 export interface CapStateLeaf {

package/dist/generated/cap-status-types.d.ts

@@ -59,6 +59,7 @@ import type { PtzAutotrackStatusSchema } from '../capabilities/ptz-autotrack.cap
 import type { recordingArchiveCapability } from '../capabilities/recording-archive.cap.js';
 import type { RecordingOnboardStatusSchema } from '../capabilities/recording-onboard.cap.js';
 import type { RecordingSignalStatusSchema } from '../capabilities/recording-signal.cap.js';
+import type { RunningStateStatusSchema } from '../capabilities/running-state.cap.js';
 import type { SceneMonitorStatusSchema } from '../capabilities/scene-monitor.cap.js';
 import type { ScriptRunnerStatusSchema } from '../capabilities/script-runner.cap.js';
 import type { SmokeStatusSchema } from '../capabilities/smoke.cap.js';
@@ -139,6 +140,7 @@ export type CapStatusTypeMap = {
     readonly 'recording-archive': z.infer<(typeof recordingArchiveCapability)['status']['schema']>;
     readonly 'recording-onboard': z.infer<typeof RecordingOnboardStatusSchema>;
     readonly 'recording-signal': z.infer<typeof RecordingSignalStatusSchema>;
+    readonly 'running-state': z.infer<typeof RunningStateStatusSchema>;
     readonly 'scene-monitor': z.infer<typeof SceneMonitorStatusSchema>;
     readonly 'script-runner': z.infer<typeof ScriptRunnerStatusSchema>;
     readonly 'smoke': z.infer<typeof SmokeStatusSchema>;
@@ -161,4 +163,4 @@ export type CapNameWithStatus = keyof CapStatusTypeMap;
  * aggregator to enumerate caps whose `status` should be polled +
  * streamed via `subscribeDeviceStatusAggregate`.
  */
-export declare const CAP_NAMES_WITH_STATUS: readonly ["accessories", "air-quality-sensor", "alarm-panel", "ambient-light-sensor", "automation-control", "battery", "binary", "brightness", "broker", "camera-credentials", "carbon-monoxide", "climate-control", "color", "connectivity", "consumables", "contact", "control", "cover", "day-night", "device-adoption", "device-discovery", "device-export", "device-status", "dishwasher", "doorbell", "enum-sensor", "event-emitter", "fan-control", "feature-probe", "flood", "gas", "heating-valve", "humidifier", "humidity-sensor", "image", "image-settings", "intercom", "lawn-mower-control", "lock-control", "media-player", "motion", "motion-trigger", "motion-zones", "mqtt-broker", "native-object-detection", "navigation", "network-link", "notifier", "numeric-sensor", "osd", "pet-feeder", "power-meter", "presence", "pressure-sensor", "privacy-mask", "ptz", "ptz-autotrack", "recording-archive", "recording-onboard", "recording-signal", "scene-monitor", "script-runner", "smoke", "snapshot", "stream-params", "switch", "tamper", "temperature-sensor", "update", "vacuum-control", "valve", "vibration", "water-heater", "weather"];
+export declare const CAP_NAMES_WITH_STATUS: readonly ["accessories", "air-quality-sensor", "alarm-panel", "ambient-light-sensor", "automation-control", "battery", "binary", "brightness", "broker", "camera-credentials", "carbon-monoxide", "climate-control", "color", "connectivity", "consumables", "contact", "control", "cover", "day-night", "device-adoption", "device-discovery", "device-export", "device-status", "dishwasher", "doorbell", "enum-sensor", "event-emitter", "fan-control", "feature-probe", "flood", "gas", "heating-valve", "humidifier", "humidity-sensor", "image", "image-settings", "intercom", "lawn-mower-control", "lock-control", "media-player", "motion", "motion-trigger", "motion-zones", "mqtt-broker", "native-object-detection", "navigation", "network-link", "notifier", "numeric-sensor", "osd", "pet-feeder", "power-meter", "presence", "pressure-sensor", "privacy-mask", "ptz", "ptz-autotrack", "recording-archive", "recording-onboard", "recording-signal", "running-state", "scene-monitor", "script-runner", "smoke", "snapshot", "stream-params", "switch", "tamper", "temperature-sensor", "update", "vacuum-control", "valve", "vibration", "water-heater", "weather"];

package/dist/generated/capability-router-map.d.ts

@@ -135,6 +135,7 @@ export { recordingExportCapability } from '../capabilities/recording-export.cap.
 export { recordingOnboardCapability } from '../capabilities/recording-onboard.cap.js';
 export { recordingSignalCapability } from '../capabilities/recording-signal.cap.js';
 export { recordsCapability } from '../capabilities/records.cap.js';
+export { runningStateCapability } from '../capabilities/running-state.cap.js';
 export { sceneMonitorCapability } from '../capabilities/scene-monitor.cap.js';
 export { scriptRunnerCapability } from '../capabilities/script-runner.cap.js';
 export { serverManagementCapability } from '../capabilities/server-management.cap.js';
@@ -315,6 +316,7 @@ export declare const CAPABILITY_NAMES: {
     readonly recordingOnboard: 'recording-onboard';
     readonly recordingSignal: 'recording-signal';
     readonly records: 'records';
+    readonly runningState: 'running-state';
     readonly sceneMonitor: 'scene-monitor';
     readonly scriptRunner: 'script-runner';
     readonly serverManagement: 'server-management';
@@ -508,6 +510,7 @@ export interface CapabilityRouterMap<TRouter = unknown> {
     readonly recordingOnboard: TRouter;
     readonly recordingSignal: TRouter;
     readonly records: TRouter;
+    readonly runningState: TRouter;
     readonly sceneMonitor: TRouter;
     readonly scriptRunner: TRouter;
     readonly serverManagement: TRouter;
@@ -551,8 +554,8 @@ export interface CapabilityRouterMap<TRouter = unknown> {
     readonly zoneRules: TRouter;
     readonly zones: TRouter;
 }
-/** Capability names whose mode is `singleton` (144 caps). */
-export declare const SINGLETON_CAPABILITY_NAMES: readonly ['accessories', 'addon-pages', 'addon-settings', 'addon-widgets', 'addons', 'admin-ui', 'air-quality-sensor', 'alarm-panel', 'alerts', 'ambient-light-sensor', 'audio-analysis', 'audio-analyzer', 'audio-codec', 'audio-metrics', 'automation-control', 'backup', 'battery', 'binary', 'brightness', 'button', 'calendars', 'camera-credentials', 'camera-grid-layout', 'camera-pipeline-config', 'camera-streams', 'carbon-monoxide', 'climate-control', 'color', 'composer', 'connectivity', 'consumables', 'contact', 'control', 'core-blocks', 'cover', 'database-snapshot', 'day-night', 'decoder', 'detection-pipeline', 'device-admin-link', 'device-credentials', 'device-discovery', 'device-history', 'device-manager', 'device-ops', 'device-state', 'device-status', 'dishwasher', 'doorbell', 'enum-sensor', 'event-emitter', 'face-gallery', 'fan-control', 'feature-probe', 'filesystem-browse', 'flood', 'gas', 'heating-valve', 'humidifier', 'humidity-sensor', 'image', 'image-settings', 'integrations', 'intercom', 'keychain', 'keychain-admin', 'lawn-mower-control', 'llm-runtime', 'local-network', 'lock-control', 'media-player', 'metrics-provider', 'model-convert', 'model-distributor', 'motion', 'motion-detection', 'motion-trigger', 'motion-zones', 'native-object-detection', 'navigation', 'network-link', 'network-quality', 'node-certificates', 'nodes', 'notification-rules', 'notifier', 'numeric-sensor', 'oidc-connections', 'osd', 'osd-manager', 'pet-feeder', 'pipeline-analytics', 'pipeline-executor', 'pipeline-orchestrator', 'pipeline-runner', 'plate-gallery', 'platform-probe', 'power-meter', 'presence', 'pressure-sensor', 'privacy-mask', 'ptz', 'ptz-autotrack', 'reboot', 'record-entries', 'recording-archive', 'recording-export', 'recording-onboard', 'recording-signal', 'records', 'scene-monitor', 'script-runner', 'server-management', 'settings-store', 'smoke', 'snapshot', 'sso-bridge', 'storage', 'storage-admin', 'storage-migration', 'stream-broker', 'stream-catalog', 'stream-params', 'stream-signals', 'switch', 'system', 'tamper', 'temperature-sensor', 'terminal-session', 'toast', 'training', 'update', 'user-management', 'vacuum-control', 'valve', 'vector-store', 'vibration', 'viewer-ui', 'water-heater', 'weather', 'webrtc-session', 'zone-analytics', 'zone-rules', 'zones'];
+/** Capability names whose mode is `singleton` (145 caps). */
+export declare const SINGLETON_CAPABILITY_NAMES: readonly ['accessories', 'addon-pages', 'addon-settings', 'addon-widgets', 'addons', 'admin-ui', 'air-quality-sensor', 'alarm-panel', 'alerts', 'ambient-light-sensor', 'audio-analysis', 'audio-analyzer', 'audio-codec', 'audio-metrics', 'automation-control', 'backup', 'battery', 'binary', 'brightness', 'button', 'calendars', 'camera-credentials', 'camera-grid-layout', 'camera-pipeline-config', 'camera-streams', 'carbon-monoxide', 'climate-control', 'color', 'composer', 'connectivity', 'consumables', 'contact', 'control', 'core-blocks', 'cover', 'database-snapshot', 'day-night', 'decoder', 'detection-pipeline', 'device-admin-link', 'device-credentials', 'device-discovery', 'device-history', 'device-manager', 'device-ops', 'device-state', 'device-status', 'dishwasher', 'doorbell', 'enum-sensor', 'event-emitter', 'face-gallery', 'fan-control', 'feature-probe', 'filesystem-browse', 'flood', 'gas', 'heating-valve', 'humidifier', 'humidity-sensor', 'image', 'image-settings', 'integrations', 'intercom', 'keychain', 'keychain-admin', 'lawn-mower-control', 'llm-runtime', 'local-network', 'lock-control', 'media-player', 'metrics-provider', 'model-convert', 'model-distributor', 'motion', 'motion-detection', 'motion-trigger', 'motion-zones', 'native-object-detection', 'navigation', 'network-link', 'network-quality', 'node-certificates', 'nodes', 'notification-rules', 'notifier', 'numeric-sensor', 'oidc-connections', 'osd', 'osd-manager', 'pet-feeder', 'pipeline-analytics', 'pipeline-executor', 'pipeline-orchestrator', 'pipeline-runner', 'plate-gallery', 'platform-probe', 'power-meter', 'presence', 'pressure-sensor', 'privacy-mask', 'ptz', 'ptz-autotrack', 'reboot', 'record-entries', 'recording-archive', 'recording-export', 'recording-onboard', 'recording-signal', 'records', 'running-state', 'scene-monitor', 'script-runner', 'server-management', 'settings-store', 'smoke', 'snapshot', 'sso-bridge', 'storage', 'storage-admin', 'storage-migration', 'stream-broker', 'stream-catalog', 'stream-params', 'stream-signals', 'switch', 'system', 'tamper', 'temperature-sensor', 'terminal-session', 'toast', 'training', 'update', 'user-management', 'vacuum-control', 'valve', 'vector-store', 'vibration', 'viewer-ui', 'water-heater', 'weather', 'webrtc-session', 'zone-analytics', 'zone-rules', 'zones'];
 /** Union of singleton capability names (literal string union). */
 export type SingletonCapabilityName = typeof SINGLETON_CAPABILITY_NAMES[number];
 /** Capability names whose mode is `collection` (35 caps). */

package/dist/generated/device-local-state.d.ts

@@ -52,6 +52,7 @@ import { privacyMaskCapability } from '../capabilities/privacy-mask.cap.js';
 import { ptzAutotrackCapability } from '../capabilities/ptz-autotrack.cap.js';
 import { recordingOnboardCapability } from '../capabilities/recording-onboard.cap.js';
 import { recordingSignalCapability } from '../capabilities/recording-signal.cap.js';
+import { runningStateCapability } from '../capabilities/running-state.cap.js';
 import { sceneMonitorCapability } from '../capabilities/scene-monitor.cap.js';
 import { scriptRunnerCapability } from '../capabilities/script-runner.cap.js';
 import { smokeCapability } from '../capabilities/smoke.cap.js';
@@ -135,6 +136,7 @@ export interface DeviceLocalState {
     ptzAutotrack: InferRuntimeState<typeof ptzAutotrackCapability>;
     recordingOnboard: InferRuntimeState<typeof recordingOnboardCapability>;
     recordingSignal: InferRuntimeState<typeof recordingSignalCapability>;
+    runningState: InferRuntimeState<typeof runningStateCapability>;
     sceneMonitor: InferRuntimeState<typeof sceneMonitorCapability>;
     scriptRunner: InferRuntimeState<typeof scriptRunnerCapability>;
     smoke: InferRuntimeState<typeof smokeCapability>;
@@ -228,6 +230,7 @@ export interface CapNameToRuntimeStateMap {
     'ptz-autotrack': InferRuntimeState<typeof ptzAutotrackCapability>;
     'recording-onboard': InferRuntimeState<typeof recordingOnboardCapability>;
     'recording-signal': InferRuntimeState<typeof recordingSignalCapability>;
+    'running-state': InferRuntimeState<typeof runningStateCapability>;
     'scene-monitor': InferRuntimeState<typeof sceneMonitorCapability>;
     'script-runner': InferRuntimeState<typeof scriptRunnerCapability>;
     'smoke': InferRuntimeState<typeof smokeCapability>;

package/dist/generated/device-proxy.d.ts

@@ -71,6 +71,7 @@ import type { rebootCapability } from '../capabilities/reboot.cap.js';
 import type { recordingCapability } from '../capabilities/recording.cap.js';
 import type { recordingOnboardCapability } from '../capabilities/recording-onboard.cap.js';
 import type { recordingSignalCapability } from '../capabilities/recording-signal.cap.js';
+import type { runningStateCapability } from '../capabilities/running-state.cap.js';
 import type { sceneMonitorCapability } from '../capabilities/scene-monitor.cap.js';
 import type { scriptRunnerCapability } from '../capabilities/script-runner.cap.js';
 import type { smokeCapability } from '../capabilities/smoke.cap.js';
@@ -169,6 +170,7 @@ export interface DeviceProxyState {
     readonly ptzAutotrack: SliceHandle<InferRuntimeState<typeof ptzAutotrackCapability>>;
     readonly recordingOnboard: SliceHandle<InferRuntimeState<typeof recordingOnboardCapability>>;
     readonly recordingSignal: SliceHandle<InferRuntimeState<typeof recordingSignalCapability>>;
+    readonly runningState: SliceHandle<InferRuntimeState<typeof runningStateCapability>>;
     readonly sceneMonitor: SliceHandle<InferRuntimeState<typeof sceneMonitorCapability>>;
     readonly scriptRunner: SliceHandle<InferRuntimeState<typeof scriptRunnerCapability>>;
     readonly smoke: SliceHandle<InferRuntimeState<typeof smokeCapability>>;
@@ -275,6 +277,7 @@ export interface DeviceProxy {
     readonly recording?: InferDeviceProxyCap<typeof recordingCapability>;
     readonly recordingOnboard?: InferDeviceProxyCap<typeof recordingOnboardCapability>;
     readonly recordingSignal?: InferDeviceProxyCap<typeof recordingSignalCapability>;
+    readonly runningState?: InferDeviceProxyCap<typeof runningStateCapability>;
     readonly sceneMonitor?: InferDeviceProxyCap<typeof sceneMonitorCapability>;
     readonly scriptRunner?: InferDeviceProxyCap<typeof scriptRunnerCapability>;
     readonly smoke?: InferDeviceProxyCap<typeof smokeCapability>;

package/dist/generated/device-scoped-caps.d.ts

@@ -5,7 +5,7 @@
  * can answer "may a rule actuate this?" without importing the schema barrel
  * (~144MB RSS per runner, D28).
  *
- * Coverage: 90 device-scoped capabilities.
+ * Coverage: 91 device-scoped capabilities.
  */
 export declare const DEVICE_SCOPED_CAPS: ReadonlySet<string>;
 /**

package/dist/generated/history-catalog.d.ts

@@ -1,7 +1,7 @@
 import type { CapabilityHistoryField, CapabilityHistoryItems } from '../capabilities/capability-definition.js';
 /**
  * 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).
  */
 export declare const HISTORY_CATALOG: Readonly<Record<string, Readonly<Record<string, CapabilityHistoryField>>>>;

package/dist/generated/method-access-map.d.ts

@@ -6,7 +6,7 @@
  * scope+access check inside `protectedProcedure` (see
  * `server/backend/src/api/trpc/trpc.middleware.ts`).
  *
- * Coverage: 1378 method paths across 179 capabilities.
+ * Coverage: 1379 method paths across 180 capabilities.
  */
 import type { MethodRole } from '../auth/viewer-access.js';
 import type { CapabilityMethodAccess } from '../capabilities/capability-definition.js';

package/dist/generated/method-device-selectors.d.ts

@@ -6,7 +6,7 @@
  * system-scope cap that takes a deviceId was previously never device-filtered
  * — see the generator header).
  *
- * Coverage: 545 methods carry a device reference, of which
+ * Coverage: 546 methods carry a device reference, of which
  * 174 are on SYSTEM-scope caps.
  *
  * Top-level fields, number arrays, and one-level arrays of objects carrying

package/dist/generated/runtime-state-durability.d.ts

@@ -11,7 +11,7 @@ export interface RuntimeStatePolicy {
 }
 /**
  * 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.

package/dist/index.d.ts

@@ -164,6 +164,9 @@ export type { AutomationAction, AutomationCondition, AutomationConditionAll, Aut
 export { AutomationActionSchema, AutomationConditionOperatorSchema, AutomationConditionSchema, AutomationRecipeSchema, AutomationTriggerSchema, conditionDepth, countConditionLeaves, generateAutomationBlock, MAX_CONDITION_DEPTH, MAX_CONDITION_LEAVES, validateRecipeBounds, } from './automation/index.js';
 export * from './cap-call-context.js';
 export * from './capabilities/index.js';
+export * from './running-state/assignment.js';
+export * from './running-state/defaults.js';
+export * from './running-state/from-operation.js';
 export * from './clips/clip-event-labels.js';
 export * from './device-extension/index.js';
 export * from './composition/index.js';
@@ -303,6 +306,7 @@ export { diffStepSettings, effectiveStepSettings, fieldsPinnedAtValueBelow, fiel
 export * from './pipeline/auto-tune/index.js';
 export * from './pipeline/load-balancing/index.js';
 export * from './pipeline/node-benchmark/index.js';
+export * from './pipeline/second-pass/index.js';
 export { deriveRootFaceRefineRect, ROOT_FACE_REFINE_INPUT_PX, ROOT_FACE_REFINE_SCALE, } from './pipeline/root-face-crop.js';
 export { DEFAULT_DETAIL_CROP_CONVENTION, DETAIL_CROP_PADDING_FIELD, DETAIL_CROP_PADDING_KEY, DETAIL_CROP_SECTION_ID, DETAIL_CROP_SQUARE_KEY, type DetailCropConvention, DetailCropConventionSchema, type DetailCropRect, deriveDetailCropRect, FULL_IMAGE_BBOX, type HydratedSettingsSection, type HydratedSettingsView, pickDetailCropConvention, readDetailCropConvention, } from './pipeline/detail-crop.js';
 export { FACE_RESCORE_INTERVAL_FIELD, FACE_RESCORE_INTERVAL_KEY, FACE_RESCORE_INTERVAL_MIN_RUNNING, FACE_RESCORE_SECTION_ID, type FaceRescoreSettingsView, pickFaceRescoreIntervalMinutes, readFaceRescoreIntervalMinutes, } from './pipeline/face-rescore-schedule.js';