@camstack/system 1.2.30 → 1.2.32

package/dist/builtins/backup-orchestrator/backup-orchestrator.addon.mjs

@@ -1,4 +1,4 @@
-import { Mt as EventCategory, ot as BaseAddon, y as backupCapability } from "../../dist-Dr_P0DOB.mjs";
+import { Mt as EventCategory, ot as BaseAddon, y as backupCapability } from "../../dist-BL_FHWPP.mjs";
 import * as fs from "node:fs";
 import Kt from "node:fs";
 import * as path$1 from "node:path";
@@ -4189,8 +4189,8 @@ function previewNextRuns(cron, count, after) {
 }
 //#endregion
 //#region src/builtins/backup-orchestrator/destination-policy.ts
-var TABLE_NAME$1 = "backup_destination_policies";
-var BACKUP_DESTINATION_POLICIES_SCHEMA = { columns: [
+var BACKUP_DESTINATION_POLICIES = "backup_destination_policies";
+var BACKUP_DESTINATION_POLICIES_COLUMNS = [
 	{
 		name: "location_id",
 		type: "TEXT",
@@ -4220,64 +4220,81 @@ var BACKUP_DESTINATION_POLICIES_SCHEMA = { columns: [
 		name: "last_run_at",
 		type: "INTEGER"
 	}
-] };
+];
 var BackupDestinationPolicyService = class {
-	backend;
-	tableEnsured = false;
-	constructor(backend) {
-		this.backend = backend;
+	store;
+	declared = false;
+	constructor(store) {
+		this.store = store;
 	}
 	/**
-	* Lazy `ensureTable` — called from every read/write path. The
-	* settings backend's own `ensureTable` is idempotent (additive
-	* migration), so repeated calls collapse to a no-op after the first.
-	* This keeps the constructor synchronous and avoids a separate
-	* `initialize()` step that callers could forget.
+	* Lazy `declareCollection` — called from every read/write path.
+	* `declareCollection` is idempotent, so repeated calls collapse to a no-op
+	* after the first. This keeps the constructor synchronous and avoids a
+	* separate `initialize()` step that callers could forget.
 	*/
 	async initialize() {
-		await this.ensureTable();
+		await this.ensureDeclared();
 	}
-	async ensureTable() {
-		if (this.tableEnsured) return;
-		if (!this.backend.ensureTable) throw new Error("BackupDestinationPolicyService: settings backend does not implement ensureTable — expected the SQLite settings backend, got a backend without structured-table support");
-		await this.backend.ensureTable(TABLE_NAME$1, BACKUP_DESTINATION_POLICIES_SCHEMA);
-		this.tableEnsured = true;
+	async ensureDeclared() {
+		if (this.declared) return;
+		await this.store.declareCollection({
+			collection: BACKUP_DESTINATION_POLICIES,
+			columns: BACKUP_DESTINATION_POLICIES_COLUMNS
+		});
+		this.declared = true;
 	}
 	async list() {
-		await this.ensureTable();
-		if (!this.backend.tableQuery) return [];
-		const rows = await this.backend.tableQuery(TABLE_NAME$1, { orderBy: {
-			field: "location_id",
-			direction: "asc"
-		} });
+		await this.ensureDeclared();
+		const rows = await this.store.query({
+			collection: BACKUP_DESTINATION_POLICIES,
+			filter: { orderBy: {
+				field: "location_id",
+				direction: "asc"
+			} }
+		});
 		const out = [];
 		for (const row of rows) {
-			const mapped = mapRowToPolicy(row);
+			const mapped = mapRowToPolicy(row.data);
 			if (mapped) out.push(mapped);
 		}
 		return out;
 	}
 	async get(locationId) {
-		await this.ensureTable();
-		if (!this.backend.tableGet) return null;
-		const row = await this.backend.tableGet(TABLE_NAME$1, { location_id: locationId });
-		return row ? mapRowToPolicy(row) : null;
+		await this.ensureDeclared();
+		const rows = await this.store.query({
+			collection: BACKUP_DESTINATION_POLICIES,
+			filter: {
+				where: { location_id: locationId },
+				limit: 1
+			}
+		});
+		return rows[0] ? mapRowToPolicy(rows[0].data) : null;
 	}
 	/**
-	* Replace-or-insert. Implemented as `delete` + `insert` (mirrors the
-	* `SqliteLocationStore` contract) so backends that don't surface
-	* `tableUpdate` still work.
+	* Replace-or-insert. Implemented as delete + insert, mirroring the
+	* `SqliteLocationStore` contract.
 	*/
 	async upsert(p) {
-		await this.ensureTable();
-		if (!this.backend.tableDelete || !this.backend.tableInsert) throw new Error("BackupDestinationPolicyService: backend missing tableDelete/tableInsert");
-		await this.backend.tableDelete(TABLE_NAME$1, { location_id: p.locationId });
-		await this.backend.tableInsert(TABLE_NAME$1, mapPolicyToRow(p));
+		await this.ensureDeclared();
+		await this.store.deleteWhere({
+			collection: BACKUP_DESTINATION_POLICIES,
+			filter: { where: { location_id: p.locationId } }
+		});
+		await this.store.insert({
+			collection: BACKUP_DESTINATION_POLICIES,
+			record: {
+				id: p.locationId,
+				data: mapPolicyToRow(p)
+			}
+		});
 	}
 	async delete(locationId) {
-		await this.ensureTable();
-		if (!this.backend.tableDelete) throw new Error("BackupDestinationPolicyService: backend missing tableDelete");
-		await this.backend.tableDelete(TABLE_NAME$1, { location_id: locationId });
+		await this.ensureDeclared();
+		await this.store.deleteWhere({
+			collection: BACKUP_DESTINATION_POLICIES,
+			filter: { where: { location_id: locationId } }
+		});
 	}
 	/**
 	* Auto-create a default policy for a `backups` location seen for the
@@ -4558,8 +4575,8 @@ var LocationManifestLock = class {
 };
 //#endregion
 //#region src/builtins/backup-orchestrator/schedule-store.ts
-var TABLE_NAME = "backup_schedules";
-var BACKUP_SCHEDULES_SCHEMA = { columns: [
+var BACKUP_SCHEDULES = "backup_schedules";
+var BACKUP_SCHEDULES_COLUMNS = [
 	{
 		name: "id",
 		type: "TEXT",
@@ -4585,7 +4602,7 @@ var BACKUP_SCHEDULES_SCHEMA = { columns: [
 	},
 	{
 		name: "location_ids",
-		type: "TEXT",
+		type: "JSON",
 		notNull: true,
 		defaultValue: "[]"
 	},
@@ -4597,59 +4614,78 @@ var BACKUP_SCHEDULES_SCHEMA = { columns: [
 	},
 	{
 		name: "data_sources",
-		type: "TEXT"
+		type: "JSON"
 	},
 	{
 		name: "last_run_at",
 		type: "INTEGER"
 	}
-] };
+];
 var BackupScheduleService = class {
-	backend;
-	tableEnsured = false;
-	constructor(backend) {
-		this.backend = backend;
+	store;
+	declared = false;
+	constructor(store) {
+		this.store = store;
 	}
 	async initialize() {
-		await this.ensureTable();
+		await this.ensureDeclared();
 	}
-	async ensureTable() {
-		if (this.tableEnsured) return;
-		if (!this.backend.ensureTable) throw new Error("BackupScheduleService: settings backend does not implement ensureTable — expected the SQLite settings backend, got a backend without structured-table support");
-		await this.backend.ensureTable(TABLE_NAME, BACKUP_SCHEDULES_SCHEMA);
-		this.tableEnsured = true;
+	async ensureDeclared() {
+		if (this.declared) return;
+		await this.store.declareCollection({
+			collection: BACKUP_SCHEDULES,
+			columns: BACKUP_SCHEDULES_COLUMNS
+		});
+		this.declared = true;
 	}
 	async list() {
-		await this.ensureTable();
-		if (!this.backend.tableQuery) return [];
-		const rows = await this.backend.tableQuery(TABLE_NAME, { orderBy: {
-			field: "id",
-			direction: "asc"
-		} });
+		await this.ensureDeclared();
+		const rows = await this.store.query({
+			collection: BACKUP_SCHEDULES,
+			filter: { orderBy: {
+				field: "id",
+				direction: "asc"
+			} }
+		});
 		const out = [];
 		for (const row of rows) {
-			const mapped = mapRowToSchedule(row);
+			const mapped = mapRowToSchedule(row.data);
 			if (mapped) out.push(mapped);
 		}
 		return out;
 	}
 	async get(id) {
-		await this.ensureTable();
-		if (!this.backend.tableGet) return null;
-		const row = await this.backend.tableGet(TABLE_NAME, { id });
-		return row ? mapRowToSchedule(row) : null;
+		await this.ensureDeclared();
+		const rows = await this.store.query({
+			collection: BACKUP_SCHEDULES,
+			filter: {
+				where: { id },
+				limit: 1
+			}
+		});
+		return rows[0] ? mapRowToSchedule(rows[0].data) : null;
 	}
 	/** Replace-or-insert (delete + insert — mirrors the policy store). */
 	async upsert(s) {
-		await this.ensureTable();
-		if (!this.backend.tableDelete || !this.backend.tableInsert) throw new Error("BackupScheduleService: backend missing tableDelete/tableInsert");
-		await this.backend.tableDelete(TABLE_NAME, { id: s.id });
-		await this.backend.tableInsert(TABLE_NAME, mapScheduleToRow(s));
+		await this.ensureDeclared();
+		await this.store.deleteWhere({
+			collection: BACKUP_SCHEDULES,
+			filter: { where: { id: s.id } }
+		});
+		await this.store.insert({
+			collection: BACKUP_SCHEDULES,
+			record: {
+				id: s.id,
+				data: mapScheduleToRow(s)
+			}
+		});
 	}
 	async delete(id) {
-		await this.ensureTable();
-		if (!this.backend.tableDelete) throw new Error("BackupScheduleService: backend missing tableDelete");
-		await this.backend.tableDelete(TABLE_NAME, { id });
+		await this.ensureDeclared();
+		await this.store.deleteWhere({
+			collection: BACKUP_SCHEDULES,
+			filter: { where: { id } }
+		});
 	}
 };
 function mapScheduleToRow(s) {
@@ -4658,27 +4694,36 @@ function mapScheduleToRow(s) {
 		label: s.label,
 		cron: s.cron,
 		enabled: s.enabled ? 1 : 0,
-		location_ids: JSON.stringify([...s.locationIds]),
+		location_ids: [...s.locationIds],
 		retention_count: s.retentionCount,
-		data_sources: s.dataSources ? JSON.stringify([...s.dataSources]) : null,
+		data_sources: s.dataSources ? [...s.dataSources] : null,
 		last_run_at: s.lastRunAt ?? null
 	};
 }
+/**
+* `location_ids` / `data_sources` are `JSON` columns, so the surface hands
+* back real arrays. A STRING still arrives for rows an older build wrote and
+* nothing has rewritten since — a schedule whose fan-out set silently read as
+* empty would back up to nowhere, so both shapes are accepted.
+*/
 function parseStringArray(raw) {
-	if (typeof raw !== "string" || raw.length === 0) return [];
+	const value = typeof raw === "string" ? tryParseJson(raw) : raw;
+	if (!Array.isArray(value)) return [];
+	return value.filter((v) => typeof v === "string");
+}
+function tryParseJson(raw) {
+	if (raw.length === 0) return null;
 	try {
-		const parsed = JSON.parse(raw);
-		if (!Array.isArray(parsed)) return [];
-		return parsed.filter((v) => typeof v === "string");
+		return JSON.parse(raw);
 	} catch {
-		return [];
+		return null;
 	}
 }
 function mapRowToSchedule(row) {
 	const id = String(row["id"] ?? "");
 	if (!id) return null;
 	const dataSourcesRaw = row["data_sources"];
-	const dataSources = typeof dataSourcesRaw === "string" && dataSourcesRaw.length > 0 ? parseStringArray(dataSourcesRaw) : void 0;
+	const dataSources = dataSourcesRaw === null || dataSourcesRaw === void 0 ? void 0 : parseStringArray(dataSourcesRaw);
 	const lastRunRaw = row["last_run_at"];
 	const lastRunAt = typeof lastRunRaw === "number" && lastRunRaw > 0 ? lastRunRaw : void 0;
 	return {
@@ -5436,24 +5481,22 @@ var BackupOrchestratorAddon = class extends BaseAddon {
 	resolveScheduleService() {
 		const reg = this.ctx.kernel.capabilityRegistry;
 		if (!reg) return null;
-		const backend = reg.getSingleton("settings-store");
-		if (!backend) return null;
-		if (!backend.ensureTable || !backend.tableInsert) return null;
-		return new BackupScheduleService(backend);
+		const store = reg.getSingleton("settings-store");
+		if (!store) {
+			this.ctx.logger.warn("backup-orchestrator: no settings-store provider — backup schedules will not persist");
+			return null;
+		}
+		return new BackupScheduleService(store);
 	}
 	resolvePolicyService() {
 		const reg = this.ctx.kernel.capabilityRegistry;
 		if (!reg) return null;
-		const backend = reg.getSingleton("settings-store");
-		if (!backend) {
+		const store = reg.getSingleton("settings-store");
+		if (!store) {
 			this.ctx.logger.warn("backup-orchestrator: no settings-store provider — destination policies will not persist");
 			return null;
 		}
-		if (!backend.ensureTable || !backend.tableInsert) {
-			this.ctx.logger.warn("backup-orchestrator: settings backend lacks structured-table support — destination policies will not persist");
-			return null;
-		}
-		return new BackupDestinationPolicyService(backend);
+		return new BackupDestinationPolicyService(store);
 	}
 	/**
 	* Narrow `ctx.api.storage` to the subset the manifest helpers need.

package/dist/builtins/backup-orchestrator/destination-policy.d.ts

@@ -1,4 +1,4 @@
-import { ISettingsBackend, TableSchema } from '@camstack/types';
+import { CollectionColumn, ISettingsStoreProvider } from '@camstack/types';
 /**
  * Per-`backups`-location policy. `locationId` is the foreign-key into
  * the storage orchestrator's `storage_locations` table.
@@ -30,26 +30,24 @@ export interface BackupDestinationPolicy {
     /** ms-epoch of the last successful backup completion to this destination. */
     readonly lastRunAt?: number;
 }
-export declare const BACKUP_DESTINATION_POLICIES_SCHEMA: TableSchema;
+export declare const BACKUP_DESTINATION_POLICIES_COLUMNS: readonly CollectionColumn[];
 export declare class BackupDestinationPolicyService {
-    private readonly backend;
-    private tableEnsured;
-    constructor(backend: ISettingsBackend);
+    private readonly store;
+    private declared;
+    constructor(store: ISettingsStoreProvider);
     /**
-     * Lazy `ensureTable` — called from every read/write path. The
-     * settings backend's own `ensureTable` is idempotent (additive
-     * migration), so repeated calls collapse to a no-op after the first.
-     * This keeps the constructor synchronous and avoids a separate
-     * `initialize()` step that callers could forget.
+     * Lazy `declareCollection` — called from every read/write path.
+     * `declareCollection` is idempotent, so repeated calls collapse to a no-op
+     * after the first. This keeps the constructor synchronous and avoids a
+     * separate `initialize()` step that callers could forget.
      */
     initialize(): Promise<void>;
-    private ensureTable;
+    private ensureDeclared;
     list(): Promise<readonly BackupDestinationPolicy[]>;
     get(locationId: string): Promise<BackupDestinationPolicy | null>;
     /**
-     * Replace-or-insert. Implemented as `delete` + `insert` (mirrors the
-     * `SqliteLocationStore` contract) so backends that don't surface
-     * `tableUpdate` still work.
+     * Replace-or-insert. Implemented as delete + insert, mirroring the
+     * `SqliteLocationStore` contract.
      */
     upsert(p: BackupDestinationPolicy): Promise<void>;
     delete(locationId: string): Promise<void>;

package/dist/builtins/backup-orchestrator/schedule-store.d.ts

@@ -1,4 +1,4 @@
-import { ISettingsBackend, TableSchema } from '@camstack/types';
+import { CollectionColumn, ISettingsStoreProvider } from '@camstack/types';
 /**
  * A backup schedule row.
  *
@@ -18,13 +18,13 @@ export interface BackupSchedule {
     /** ms-epoch of the last successful run. */
     readonly lastRunAt?: number;
 }
-export declare const BACKUP_SCHEDULES_SCHEMA: TableSchema;
+export declare const BACKUP_SCHEDULES_COLUMNS: readonly CollectionColumn[];
 export declare class BackupScheduleService {
-    private readonly backend;
-    private tableEnsured;
-    constructor(backend: ISettingsBackend);
+    private readonly store;
+    private declared;
+    constructor(store: ISettingsStoreProvider);
     initialize(): Promise<void>;
-    private ensureTable;
+    private ensureDeclared;
     list(): Promise<readonly BackupSchedule[]>;
     get(id: string): Promise<BackupSchedule | null>;
     /** Replace-or-insert (delete + insert — mirrors the policy store). */

package/dist/builtins/console-logging/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-VIwdvws5.js");
+const require_dist = require("../../dist-CSs1A90r.js");
 const require_formatter = require("../../formatter-DqAKDlvN.js");
 //#region src/builtins/console-logging/console-destination.ts
 var LEVEL_RANK = {

package/dist/builtins/console-logging/index.mjs

@@ -1,4 +1,4 @@
-import { B as logDestinationCapability, ot as BaseAddon } from "../../dist-Dr_P0DOB.mjs";
+import { B as logDestinationCapability, ot as BaseAddon } from "../../dist-BL_FHWPP.mjs";
 import { t as formatLogLine } from "../../formatter-B7qW8bPJ.mjs";
 //#region src/builtins/console-logging/console-destination.ts
 var LEVEL_RANK = {

package/dist/builtins/device-manager/device-manager.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-VIwdvws5.js");
+const require_dist = require("../../dist-CSs1A90r.js");
 let _camstack_types_node = require("@camstack/types/node");
 let zod = require("zod");
 let node_crypto = require("node:crypto");

package/dist/builtins/device-manager/device-manager.addon.mjs

@@ -1,4 +1,4 @@
-import { C as deviceStateCapability, D as enumerateItemArrayFields, K as parseStreamParamsFormPatch, M as getByPath, Mt as EventCategory, O as enumerateSchemaFields, S as deviceManagerCapability, W as normalizeUnit, X as setByPath, _ as applyTransform, a as CAP_NAMES_WITH_STATUS, at as errMsg, b as buildStreamParamsConfigSchema, dt as DeviceRole, ft as DeviceType, ht as WELL_KNOWN_TAB_MAP, it as validateExpressionSource, jt as sleep, k as evaluateLinkExpression, l as STREAM_PROFILE_META, nt as toExpressionValue, o as DeviceStatusSchema, ot as BaseAddon, t as ALL_CAPABILITY_DEFINITIONS, ut as DeviceFeature, w as deviceStatusCapability, wt as isDeviceConfigCap } from "../../dist-Dr_P0DOB.mjs";
+import { C as deviceStateCapability, D as enumerateItemArrayFields, K as parseStreamParamsFormPatch, M as getByPath, Mt as EventCategory, O as enumerateSchemaFields, S as deviceManagerCapability, W as normalizeUnit, X as setByPath, _ as applyTransform, a as CAP_NAMES_WITH_STATUS, at as errMsg, b as buildStreamParamsConfigSchema, dt as DeviceRole, ft as DeviceType, ht as WELL_KNOWN_TAB_MAP, it as validateExpressionSource, jt as sleep, k as evaluateLinkExpression, l as STREAM_PROFILE_META, nt as toExpressionValue, o as DeviceStatusSchema, ot as BaseAddon, t as ALL_CAPABILITY_DEFINITIONS, ut as DeviceFeature, w as deviceStatusCapability, wt as isDeviceConfigCap } from "../../dist-BL_FHWPP.mjs";
 import { canonicalDeviceFingerprint } from "@camstack/types/node";
 import { z } from "zod";
 import { randomUUID } from "node:crypto";

package/dist/builtins/doorbell/virtual-doorbell.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-VIwdvws5.js");
+const require_dist = require("../../dist-CSs1A90r.js");
 //#region src/builtins/doorbell/trigger-engine.ts
 /**
 * Pure trigger logic for the virtual-doorbell builtin — edge detection over

package/dist/builtins/doorbell/virtual-doorbell.addon.mjs

@@ -1,4 +1,4 @@
-import { Mt as EventCategory, T as doorbellCapability, at as errMsg, ft as DeviceType, ot as BaseAddon, yt as createEvent } from "../../dist-Dr_P0DOB.mjs";
+import { Mt as EventCategory, T as doorbellCapability, at as errMsg, ft as DeviceType, ot as BaseAddon, yt as createEvent } from "../../dist-BL_FHWPP.mjs";
 //#region src/builtins/doorbell/trigger-engine.ts
 /**
 * Pure trigger logic for the virtual-doorbell builtin — edge detection over

package/dist/builtins/hub-forwarder/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-VIwdvws5.js");
+const require_dist = require("../../dist-CSs1A90r.js");
 const require_formatter = require("../../formatter-DqAKDlvN.js");
 //#region src/builtins/hub-forwarder/hub-forwarder-destination.ts
 var DEFAULT_OUTBOUND_BUFFER_SIZE = 500;

package/dist/builtins/hub-forwarder/index.mjs

@@ -1,4 +1,4 @@
-import { B as logDestinationCapability, ot as BaseAddon } from "../../dist-Dr_P0DOB.mjs";
+import { B as logDestinationCapability, ot as BaseAddon } from "../../dist-BL_FHWPP.mjs";
 import { t as formatLogLine } from "../../formatter-B7qW8bPJ.mjs";
 //#region src/builtins/hub-forwarder/hub-forwarder-destination.ts
 var DEFAULT_OUTBOUND_BUFFER_SIZE = 500;

package/dist/builtins/liveness-monitor/index.d.ts

@@ -0,0 +1,2 @@
+export { LivenessMonitorAddon } from './liveness-monitor.addon.js';
+export { evaluateLiveness, isLivenessFindingId, type CameraFootage, type LivenessFacts, type LivenessFinding, } from './liveness-checks.js';

package/dist/builtins/liveness-monitor/index.js

@@ -0,0 +1,6 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../../chunk-Cek0wNdY.js");
+const require_builtins_liveness_monitor_liveness_monitor_addon = require("./liveness-monitor.addon.js");
+exports.LivenessMonitorAddon = require_builtins_liveness_monitor_liveness_monitor_addon.LivenessMonitorAddon;
+exports.evaluateLiveness = require_builtins_liveness_monitor_liveness_monitor_addon.evaluateLiveness;
+exports.isLivenessFindingId = require_builtins_liveness_monitor_liveness_monitor_addon.isLivenessFindingId;

package/dist/builtins/liveness-monitor/index.mjs

@@ -0,0 +1,2 @@
+import { LivenessMonitorAddon, n as isLivenessFindingId, t as evaluateLiveness } from "./liveness-monitor.addon.mjs";
+export { LivenessMonitorAddon, evaluateLiveness, isLivenessFindingId };

package/dist/builtins/liveness-monitor/liveness-checks.d.ts

@@ -0,0 +1,67 @@
+/**
+ * The liveness invariants, as pure functions.
+ *
+ * On 2026-08-03 the hub ran for four hours with zero devices, zero published
+ * streams and zero recordings, and nothing said a word. Three separate defects
+ * caused it — optional chaining that no-oped, an `if` with no `else`, a JSON
+ * parse that returned `{}` — and each was silent at the point of failure. All
+ * three were fixed and a log line added at each. This module exists for the
+ * CLASS rather than the instances: assert what must be true of a working node,
+ * and report when it is not.
+ *
+ * **Every check here is unambiguous, on purpose.** An alert that fires on a
+ * quiet night is one an operator learns to ignore, and an ignored alert is
+ * worse than no alert. So "the pipeline emitted no tracks recently" is NOT a
+ * check — a camera can legitimately see nothing for hours — while "a camera
+ * that has been recording all day stopped producing segments" is: continuous
+ * recording produces segments whether or not anything moves.
+ *
+ * I/O lives in the addon; everything here is a function of facts, so the
+ * outage can be replayed in a test.
+ */
+/** What the monitor learned about one camera this tick. */
+export interface CameraFootage {
+    readonly deviceId: number;
+    readonly online: boolean;
+    /**
+     * ms-epoch of the newest recorded segment within the lookback window, or
+     * `null` when the camera has produced NO footage in it.
+     *
+     * `null` means "this camera does not record" and is deliberately not a
+     * finding — it is what makes the check self-calibrating. Nothing has to be
+     * told which cameras are supposed to record: a camera that was recording and
+     * stopped is a fault, a camera that never records is a configuration.
+     */
+    readonly lastSegmentMs: number | null;
+}
+export interface LivenessFacts {
+    readonly nowMs: number;
+    /** Every device the node knows about, cameras and accessories alike. */
+    readonly deviceCount: number;
+    readonly cameras: readonly CameraFootage[];
+    /** How long a recording camera may stay silent before it is a fault. */
+    readonly staleAfterMs: number;
+}
+export interface LivenessFinding {
+    /**
+     * Stable across ticks, so an ongoing fault UPDATES one alert instead of
+     * producing a new one every minute. Same contract as the kernel's
+     * `addon-load-failed:<packageName>` ids.
+     */
+    readonly id: string;
+    readonly severity: 'error' | 'warning';
+    readonly title: string;
+    readonly message: string;
+    /** Present on per-camera findings. Always the numeric id. */
+    readonly deviceId?: number;
+}
+/**
+ * Evaluate every invariant against one tick's facts.
+ *
+ * Ordered most-fundamental first, and it STOPS at "no devices": when the node
+ * has nothing, every camera is also silent, and reporting twelve consequences
+ * of one cause is how an operator ends up reading none of them.
+ */
+export declare function evaluateLiveness(facts: LivenessFacts): readonly LivenessFinding[];
+/** Every finding id this module can produce, for the recovery sweep. */
+export declare function isLivenessFindingId(id: string): boolean;

package/dist/builtins/liveness-monitor/liveness-monitor.addon.d.ts

@@ -0,0 +1,32 @@
+import { BaseAddon, ProviderRegistration } from '@camstack/types';
+import { LivenessFinding } from './liveness-checks.js';
+interface LivenessMonitorConfig extends Record<string, unknown> {
+    readonly staleAfterMs?: number;
+}
+export declare class LivenessMonitorAddon extends BaseAddon<LivenessMonitorConfig> {
+    private tickTimer;
+    private startedAtMs;
+    /** Finding ids currently reported, so recovery can be detected and announced. */
+    private active;
+    constructor();
+    protected onInitialize(): Promise<ProviderRegistration[]>;
+    protected onShutdown(): Promise<void>;
+    /**
+     * One evaluation. Public so a test or an operator-facing action can force it
+     * without waiting out the interval.
+     */
+    tick(): Promise<readonly LivenessFinding[]>;
+    /** Read the facts through the cap surface. Changes nothing. */
+    private gather;
+    /**
+     * Newest segment for a camera, or null when it has produced none in a day.
+     *
+     * Two steps on purpose: the healthy case asks only for the recent window,
+     * which is a handful of ranges, and only a camera that looks silent pays for
+     * the 24-hour lookback that decides whether it records at all.
+     */
+    private lastSegmentMs;
+    /** Announce new faults and recoveries; say nothing about an unchanged fault. */
+    private report;
+}
+export {};