@camstack/system 1.2.349 → 1.2.350

package/dist/addon-runner.js

@@ -1,12 +1,12 @@
 const require_chunk = require("./chunk-Cek0wNdY.js");
-const require_child_cap_dispatch = require("./child-cap-dispatch-DiDBYNY4.js");
+const require_child_cap_dispatch = require("./child-cap-dispatch-CYgHiMdj.js");
 const require_custom_action_registry = require("./custom-action-registry-acBY3mHA.js");
 let node_path = require("node:path");
 node_path = require_chunk.__toESM(node_path);
+let node_module = require("node:module");
 let node_url = require("node:url");
 let node_fs = require("node:fs");
 node_fs = require_chunk.__toESM(node_fs);
-let node_module = require("node:module");
 let _camstack_types_addon = require("@camstack/types/addon");
 //#region src/kernel/moleculer/child-addon-call-dispatch.ts
 function isRecord$1(value) {

package/dist/addon-runner.mjs

@@ -1,4 +1,4 @@
-import { Ft as installManifestNativeDeps, H as createUdsLoggerWithControl, It as resolveAddonClass, St as validateProviderRegistrations, Tn as emitHeapDiagnosticReport, U as LocalChildClient, _t as getWorkerNativeCapProvider, bt as setWorkerNativeCapsChangeListener, en as RUNNER_RSS_BUDGET_ENV, f as installManifestSystemDeps, g as createUdsAddonContext, i as killOwnRunnerGroupAfterParentLoss, n as createChildCapDispatch, p as installManifestPythonDeps, pn as startRunnerHeapWatch, u as startRunnerParentDeathWatchdog, vt as getWorkerNativeCapSnapshot } from "./child-cap-dispatch-Pkx_sEKR.mjs";
+import { Ft as installManifestNativeDeps, H as createUdsLoggerWithControl, It as resolveAddonClass, St as validateProviderRegistrations, Tn as emitHeapDiagnosticReport, U as LocalChildClient, _t as getWorkerNativeCapProvider, bt as setWorkerNativeCapsChangeListener, en as RUNNER_RSS_BUDGET_ENV, f as installManifestSystemDeps, g as createUdsAddonContext, i as killOwnRunnerGroupAfterParentLoss, n as createChildCapDispatch, p as installManifestPythonDeps, pn as startRunnerHeapWatch, u as startRunnerParentDeathWatchdog, vt as getWorkerNativeCapSnapshot } from "./child-cap-dispatch-zEt3rqy-.mjs";
 import { t as CustomActionRegistry } from "./custom-action-registry-B4Cf4O_X.mjs";
 import { register } from "node:module";
 import * as path$1 from "node:path";

package/dist/builtins/addon-pages-aggregator/addon-pages-aggregator.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-DvAczrLl.js");
+const require_dist = require("../../dist-DZKm2EOp.js");
 const require_settle_sources = require("../../settle-sources-Bhsy57y-.js");
 let node_crypto = require("node:crypto");
 let node_path = require("node:path");

package/dist/builtins/addon-pages-aggregator/addon-pages-aggregator.addon.mjs

@@ -1,4 +1,4 @@
-import { H as addonPagesCapability, Jn as errMsg, Yn as BaseAddon, br as EventCategory } from "../../dist-C6CPaa8G.mjs";
+import { H as addonPagesCapability, Jn as errMsg, Yn as BaseAddon, br as EventCategory } from "../../dist-Di0aX2zy.mjs";
 import { t as settleSourcesWithTimeout } from "../../settle-sources-CDtNC8ub.mjs";
 import { createHash, randomUUID } from "node:crypto";
 import * as path$1 from "node:path";

package/dist/builtins/addon-widgets-aggregator/addon-widgets-aggregator.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-DvAczrLl.js");
+const require_dist = require("../../dist-DZKm2EOp.js");
 const require_settle_sources = require("../../settle-sources-Bhsy57y-.js");
 let node_crypto = require("node:crypto");
 let node_path = require("node:path");

package/dist/builtins/addon-widgets-aggregator/addon-widgets-aggregator.addon.mjs

@@ -1,4 +1,4 @@
-import { Jn as errMsg, W as addonWidgetsCapability, Yn as BaseAddon, br as EventCategory } from "../../dist-C6CPaa8G.mjs";
+import { Jn as errMsg, W as addonWidgetsCapability, Yn as BaseAddon, br as EventCategory } from "../../dist-Di0aX2zy.mjs";
 import { t as settleSourcesWithTimeout } from "../../settle-sources-CDtNC8ub.mjs";
 import { createHash, randomUUID } from "node:crypto";
 import * as path$1 from "node:path";

package/dist/builtins/alerts/alerts.addon.d.ts

@@ -67,6 +67,14 @@ export declare class AlertCenterAddon extends BaseAddon<AlertCenterConfig> {
     private handleLivenessFailed;
     /** SystemLivenessRecovered — the invariant holds again; drop the alert. */
     private handleLivenessRecovered;
+    /**
+     * Stream offline — ONLY `stale-timeout` is an outage. Suspend / destroy /
+     * idle dial are deliberate and must not ring the bell (same gate NC uses).
+     */
+    private handleStreamOffline;
+    /** Stream online after an outage — drop the matching offline card. */
+    private handleStreamOnline;
+    private resolveDeviceName;
     private buildMessage;
     private emitAlert;
     private updateAlert;

package/dist/builtins/alerts/alerts.addon.js

@@ -3,7 +3,27 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-DvAczrLl.js");
+const require_dist = require("../../dist-DZKm2EOp.js");
+//#region src/builtins/alerts/device-label.ts
+/**
+* Operator-facing device label for alert messages.
+*
+* Prefer a real name; fall back to `Camera <id>` only when nothing else is
+* known. Never prefer the bare id when a name is present — "Camera 618"
+* next to a named "Cucina" is how the Recording-stopped alerts used to read.
+*/
+function deviceLabelFromEventData(data) {
+	const name = stringNonEmpty(data["name"]) ?? stringNonEmpty(data["deviceName"]);
+	if (name !== void 0) return name;
+	const id = data["deviceId"];
+	if (typeof id === "number" && Number.isFinite(id)) return `Camera ${String(id)}`;
+	if (typeof id === "string" && id.length > 0) return `Camera ${id}`;
+	return "unknown device";
+}
+function stringNonEmpty(value) {
+	return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
+}
+//#endregion
 //#region src/builtins/alerts/prune-policy.ts
 /**
 * Ids older than `cutoffMs`, oldest first.
@@ -33,6 +53,10 @@ var CATEGORY_MAPPINGS = {
 		severity: "error",
 		titleTemplate: "Addon crashed"
 	},
+	"addon.runner-failed": {
+		severity: "error",
+		titleTemplate: "Addon crash loop"
+	},
 	"addon.error": {
 		severity: "error",
 		titleTemplate: "Addon error"
@@ -53,30 +77,26 @@ var CATEGORY_MAPPINGS = {
 		severity: "error",
 		titleTemplate: "Notification failed"
 	},
-	"agent.online": {
-		severity: "info",
-		titleTemplate: "Agent connected"
-	},
 	"agent.offline": {
 		severity: "warning",
 		titleTemplate: "Agent disconnected"
 	},
-	"system.boot": {
-		severity: "info",
-		titleTemplate: "System boot"
-	},
 	"system.restarting": {
 		severity: "warning",
 		titleTemplate: "System restarting"
 	},
+	"system.restart-completed": {
+		severity: "info",
+		titleTemplate: "Node updated"
+	},
+	"update.available": {
+		severity: "info",
+		titleTemplate: "Update available"
+	},
 	"system.tls-cert-changed": {
 		severity: "warning",
 		titleTemplate: "TLS certificate changed"
 	},
-	"device.registered": {
-		severity: "info",
-		titleTemplate: "Device registered"
-	},
 	"device.unregistered": {
 		severity: "warning",
 		titleTemplate: "Device unregistered"
@@ -101,13 +121,9 @@ var CATEGORY_MAPPINGS = {
 		severity: "error",
 		titleTemplate: "Node liveness"
 	},
-	"addon.load-recovered": {
-		severity: "info",
-		titleTemplate: "Addon recovered"
-	},
-	"backup.completed": {
-		severity: "info",
-		titleTemplate: "Backup completed"
+	"stream.offline": {
+		severity: "warning",
+		titleTemplate: "Stream offline"
 	},
 	"backup.restored": {
 		severity: "info",
@@ -118,7 +134,17 @@ var CATEGORY_MAPPINGS = {
 		titleTemplate: "Model download"
 	}
 };
-var TRACKED_CATEGORIES = Object.keys(CATEGORY_MAPPINGS);
+/**
+* Subscribed for dismiss / merge side-effects only — never mint a card.
+* Must stay in the subscribe set even though they are absent from
+* {@link CATEGORY_MAPPINGS}.
+*/
+var SILENT_TRACKED_CATEGORIES = [
+	"addon.load-recovered",
+	"system.liveness-recovered",
+	"stream.online"
+];
+var TRACKED_CATEGORIES = [...Object.keys(CATEGORY_MAPPINGS), ...SILENT_TRACKED_CATEGORIES];
 /**
 * `[ALERT-CENTER-EVENTS]` — rate limiting. Events that fire thousands of
 * times a minute (flaky cam reconnecting, chatty integration, …) would
@@ -305,12 +331,26 @@ var AlertCenterAddon = class extends require_dist.BaseAddon {
 				await this.handleLivenessRecovered(event);
 				return;
 			}
+			if (category === require_dist.EventCategory.StreamOffline) {
+				await this.handleStreamOffline(event);
+				return;
+			}
+			if (category === require_dist.EventCategory.StreamOnline) {
+				await this.handleStreamOnline(event);
+				return;
+			}
 			const mapping = CATEGORY_MAPPINGS[category];
 			if (!mapping) return;
+			if (category === "addon.updated") {
+				const toVersion = event.data["toVersion"];
+				if (typeof toVersion !== "string" || toVersion.length === 0) return;
+			}
 			if (this.shouldSuppressByRate(category, event)) return;
 			const message = this.buildMessage(category, event.data, event.source ? String(event.source.id) : void 0);
+			const addonIdForKey = (typeof event.data["addonId"] === "string" ? event.data["addonId"] : void 0) ?? (event.source ? String(event.source.id) : void 0);
+			const toVersionForKey = typeof event.data["toVersion"] === "string" ? event.data["toVersion"] : void 0;
 			const alert = {
-				id: crypto.randomUUID(),
+				id: category === "addon.updated" && addonIdForKey !== void 0 && toVersionForKey !== void 0 ? `addon-updated:${addonIdForKey}:${toVersionForKey}` : crypto.randomUUID(),
 				category,
 				severity: mapping.severity,
 				title: mapping.titleTemplate,
@@ -543,32 +583,107 @@ var AlertCenterAddon = class extends require_dist.BaseAddon {
 			} });
 		}
 	}
+	/**
+	* Stream offline — ONLY `stale-timeout` is an outage. Suspend / destroy /
+	* idle dial are deliberate and must not ring the bell (same gate NC uses).
+	*/
+	async handleStreamOffline(event) {
+		const reason = event.data["reason"];
+		if (reason !== "stale-timeout") return;
+		const deviceId = event.data["deviceId"];
+		const camStreamId = event.data["camStreamId"];
+		if (typeof deviceId !== "number" || typeof camStreamId !== "string") return;
+		const name = await this.resolveDeviceName(deviceId);
+		const label = name ?? `Camera ${String(deviceId)}`;
+		const alert = {
+			id: `stream-offline:${String(deviceId)}:${camStreamId}`,
+			category: require_dist.EventCategory.StreamOffline,
+			severity: "warning",
+			title: "Stream offline",
+			message: `${label} — ${camStreamId} stopped sending video (stale timeout).`,
+			status: "active",
+			read: false,
+			createdAt: Date.now(),
+			updatedAt: Date.now(),
+			source: {
+				type: "device",
+				id: String(deviceId)
+			},
+			metadata: {
+				deviceId,
+				camStreamId,
+				reason,
+				...name !== void 0 ? { name } : {}
+			}
+		};
+		await this.emitAlert(alert);
+	}
+	/** Stream online after an outage — drop the matching offline card. */
+	async handleStreamOnline(event) {
+		const deviceId = event.data["deviceId"];
+		const camStreamId = event.data["camStreamId"];
+		if (typeof deviceId !== "number" || typeof camStreamId !== "string") return;
+		const stableId = `stream-offline:${String(deviceId)}:${camStreamId}`;
+		try {
+			await this.dismiss(stableId);
+		} catch (err) {
+			this.ctx.logger?.debug("StreamOnline: dismiss failed (likely already dismissed)", { meta: {
+				stableId,
+				error: require_dist.errMsg(err)
+			} });
+		}
+	}
+	async resolveDeviceName(deviceId) {
+		try {
+			const device = await this.ctx.api.deviceManager.getDevice.query({ deviceId });
+			if (device !== null && typeof device.name === "string" && device.name.trim().length > 0) return device.name.trim();
+		} catch (err) {
+			this.ctx.logger?.debug("resolveDeviceName failed", {
+				tags: { deviceId },
+				meta: { error: require_dist.errMsg(err) }
+			});
+		}
+	}
 	buildMessage(category, data, sourceId) {
 		const addonId = data.addonId ?? sourceId;
-		const deviceId = data.deviceId;
+		const device = deviceLabelFromEventData(data);
 		const error = data.error;
 		const processId = data.processId;
 		switch (category) {
 			case "addon.crashed": return `Addon "${addonId ?? "unknown"}" crashed${error ? `: ${error}` : ""}`;
+			case "addon.runner-failed": {
+				const runnerId = typeof data.runnerId === "string" ? data.runnerId : "unknown";
+				const addonIds = Array.isArray(data.addonIds) ? data.addonIds.filter((x) => typeof x === "string").join(", ") : "";
+				return `Runner "${runnerId}" gave up${addonIds.length > 0 ? ` (addons: ${addonIds})` : ""}`;
+			}
 			case "addon.error": return `Addon "${addonId ?? "unknown"}" error${error ? `: ${error}` : ""}`;
 			case "addon.installed": return `Addon "${addonId ?? "unknown"}" installed`;
 			case "addon.updated": {
 				const from = data.fromVersion;
 				const to = data.toVersion;
-				return `Addon "${addonId ?? "unknown"}" updated${from && to ? ` from ${from} to ${to}` : ""}`;
+				return `Addon "${typeof data.packageName === "string" && data.packageName.length > 0 ? data.packageName : addonId ?? "unknown"}" updated${from && to ? ` from ${from} to ${to}` : to ? ` to ${to}` : ""}`;
 			}
 			case "addon.uninstalled": return `Addon "${addonId ?? "unknown"}" uninstalled`;
-			case "device.registered": return `Device "${data.name ?? deviceId ?? "unknown"}" registered`;
-			case "device.unregistered": return `Device "${deviceId ?? "unknown"}" unregistered`;
-			case "agent.online": return `Agent "${data.agentId ?? data.nodeId ?? "unknown"}" connected`;
+			case "device.unregistered": return `Device "${device}" unregistered`;
 			case "agent.offline": return `Agent "${data.agentId ?? data.nodeId ?? "unknown"}" disconnected${data.reason ? `: ${String(data.reason)}` : ""}`;
-			case "backup.completed": return `Backup completed${data.targetId ? ` (${String(data.targetId)})` : ""}`;
 			case "backup.restored": return `Backup restored${data.source ? ` from ${String(data.source)}` : ""}`;
 			case "notification.failed": return `Notification failed${error ? `: ${error}` : ""}`;
 			case "system.restarting": return `System restarting${data.reason ? ` — ${String(data.reason)}` : ""}`;
-			case "recording.error": return `Recording error on device "${deviceId ?? "unknown"}"${error ? `: ${error}` : ""}`;
-			case "recording.storage.critical": return `Storage critical for device "${deviceId ?? "unknown"}"`;
-			case "system.boot": return `System booted in "${data.mode ?? "unknown"}" mode`;
+			case "system.restart-completed": {
+				const pkg = typeof data.packageName === "string" ? data.packageName : void 0;
+				const to = typeof data.toVersion === "string" ? data.toVersion : void 0;
+				const kind = typeof data.kind === "string" ? data.kind : "restart";
+				if (pkg !== void 0 && to !== void 0) return `${pkg} is now ${to}`;
+				return `Node restart completed (${kind})`;
+			}
+			case "update.available": {
+				const pkg = typeof data.packageName === "string" ? data.packageName : "package";
+				const latest = typeof data.latestVersion === "string" ? data.latestVersion : "?";
+				const node = typeof data.nodeId === "string" ? data.nodeId : void 0;
+				return `${pkg} ${latest} available${node !== void 0 ? ` on ${node}` : ""}`;
+			}
+			case "recording.error": return `Recording error on "${device}"${error ? `: ${error}` : ""}`;
+			case "recording.storage.critical": return `Storage critical for "${device}"`;
 			case "system.tls-cert-changed": return data.caRotated === true ? `TLS certificate reissued (${String(data.reason)}) — the local CA also changed. Re-install ${String(data.caCertPath)} on any device that trusted the old one.` : `TLS certificate reissued (${String(data.reason)}) — the local CA is unchanged, previously trusted devices keep working.`;
 			case "process.crashed": return `Process "${processId ?? "unknown"}" crashed`;
 			default: return `Event: ${category}`;

package/dist/builtins/alerts/alerts.addon.mjs

@@ -1,4 +1,24 @@
-import { G as alertsCapability, Jn as errMsg, Yn as BaseAddon, ar as createEvent, br as EventCategory, n as AlertSchema } from "../../dist-C6CPaa8G.mjs";
+import { G as alertsCapability, Jn as errMsg, Yn as BaseAddon, ar as createEvent, br as EventCategory, n as AlertSchema } from "../../dist-Di0aX2zy.mjs";
+//#region src/builtins/alerts/device-label.ts
+/**
+* Operator-facing device label for alert messages.
+*
+* Prefer a real name; fall back to `Camera <id>` only when nothing else is
+* known. Never prefer the bare id when a name is present — "Camera 618"
+* next to a named "Cucina" is how the Recording-stopped alerts used to read.
+*/
+function deviceLabelFromEventData(data) {
+	const name = stringNonEmpty(data["name"]) ?? stringNonEmpty(data["deviceName"]);
+	if (name !== void 0) return name;
+	const id = data["deviceId"];
+	if (typeof id === "number" && Number.isFinite(id)) return `Camera ${String(id)}`;
+	if (typeof id === "string" && id.length > 0) return `Camera ${id}`;
+	return "unknown device";
+}
+function stringNonEmpty(value) {
+	return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
+}
+//#endregion
 //#region src/builtins/alerts/prune-policy.ts
 /**
 * Ids older than `cutoffMs`, oldest first.
@@ -28,6 +48,10 @@ var CATEGORY_MAPPINGS = {
 		severity: "error",
 		titleTemplate: "Addon crashed"
 	},
+	"addon.runner-failed": {
+		severity: "error",
+		titleTemplate: "Addon crash loop"
+	},
 	"addon.error": {
 		severity: "error",
 		titleTemplate: "Addon error"
@@ -48,30 +72,26 @@ var CATEGORY_MAPPINGS = {
 		severity: "error",
 		titleTemplate: "Notification failed"
 	},
-	"agent.online": {
-		severity: "info",
-		titleTemplate: "Agent connected"
-	},
 	"agent.offline": {
 		severity: "warning",
 		titleTemplate: "Agent disconnected"
 	},
-	"system.boot": {
-		severity: "info",
-		titleTemplate: "System boot"
-	},
 	"system.restarting": {
 		severity: "warning",
 		titleTemplate: "System restarting"
 	},
+	"system.restart-completed": {
+		severity: "info",
+		titleTemplate: "Node updated"
+	},
+	"update.available": {
+		severity: "info",
+		titleTemplate: "Update available"
+	},
 	"system.tls-cert-changed": {
 		severity: "warning",
 		titleTemplate: "TLS certificate changed"
 	},
-	"device.registered": {
-		severity: "info",
-		titleTemplate: "Device registered"
-	},
 	"device.unregistered": {
 		severity: "warning",
 		titleTemplate: "Device unregistered"
@@ -96,13 +116,9 @@ var CATEGORY_MAPPINGS = {
 		severity: "error",
 		titleTemplate: "Node liveness"
 	},
-	"addon.load-recovered": {
-		severity: "info",
-		titleTemplate: "Addon recovered"
-	},
-	"backup.completed": {
-		severity: "info",
-		titleTemplate: "Backup completed"
+	"stream.offline": {
+		severity: "warning",
+		titleTemplate: "Stream offline"
 	},
 	"backup.restored": {
 		severity: "info",
@@ -113,7 +129,17 @@ var CATEGORY_MAPPINGS = {
 		titleTemplate: "Model download"
 	}
 };
-var TRACKED_CATEGORIES = Object.keys(CATEGORY_MAPPINGS);
+/**
+* Subscribed for dismiss / merge side-effects only — never mint a card.
+* Must stay in the subscribe set even though they are absent from
+* {@link CATEGORY_MAPPINGS}.
+*/
+var SILENT_TRACKED_CATEGORIES = [
+	"addon.load-recovered",
+	"system.liveness-recovered",
+	"stream.online"
+];
+var TRACKED_CATEGORIES = [...Object.keys(CATEGORY_MAPPINGS), ...SILENT_TRACKED_CATEGORIES];
 /**
 * `[ALERT-CENTER-EVENTS]` — rate limiting. Events that fire thousands of
 * times a minute (flaky cam reconnecting, chatty integration, …) would
@@ -300,12 +326,26 @@ var AlertCenterAddon = class extends BaseAddon {
 				await this.handleLivenessRecovered(event);
 				return;
 			}
+			if (category === EventCategory.StreamOffline) {
+				await this.handleStreamOffline(event);
+				return;
+			}
+			if (category === EventCategory.StreamOnline) {
+				await this.handleStreamOnline(event);
+				return;
+			}
 			const mapping = CATEGORY_MAPPINGS[category];
 			if (!mapping) return;
+			if (category === "addon.updated") {
+				const toVersion = event.data["toVersion"];
+				if (typeof toVersion !== "string" || toVersion.length === 0) return;
+			}
 			if (this.shouldSuppressByRate(category, event)) return;
 			const message = this.buildMessage(category, event.data, event.source ? String(event.source.id) : void 0);
+			const addonIdForKey = (typeof event.data["addonId"] === "string" ? event.data["addonId"] : void 0) ?? (event.source ? String(event.source.id) : void 0);
+			const toVersionForKey = typeof event.data["toVersion"] === "string" ? event.data["toVersion"] : void 0;
 			const alert = {
-				id: crypto.randomUUID(),
+				id: category === "addon.updated" && addonIdForKey !== void 0 && toVersionForKey !== void 0 ? `addon-updated:${addonIdForKey}:${toVersionForKey}` : crypto.randomUUID(),
 				category,
 				severity: mapping.severity,
 				title: mapping.titleTemplate,
@@ -538,32 +578,107 @@ var AlertCenterAddon = class extends BaseAddon {
 			} });
 		}
 	}
+	/**
+	* Stream offline — ONLY `stale-timeout` is an outage. Suspend / destroy /
+	* idle dial are deliberate and must not ring the bell (same gate NC uses).
+	*/
+	async handleStreamOffline(event) {
+		const reason = event.data["reason"];
+		if (reason !== "stale-timeout") return;
+		const deviceId = event.data["deviceId"];
+		const camStreamId = event.data["camStreamId"];
+		if (typeof deviceId !== "number" || typeof camStreamId !== "string") return;
+		const name = await this.resolveDeviceName(deviceId);
+		const label = name ?? `Camera ${String(deviceId)}`;
+		const alert = {
+			id: `stream-offline:${String(deviceId)}:${camStreamId}`,
+			category: EventCategory.StreamOffline,
+			severity: "warning",
+			title: "Stream offline",
+			message: `${label} — ${camStreamId} stopped sending video (stale timeout).`,
+			status: "active",
+			read: false,
+			createdAt: Date.now(),
+			updatedAt: Date.now(),
+			source: {
+				type: "device",
+				id: String(deviceId)
+			},
+			metadata: {
+				deviceId,
+				camStreamId,
+				reason,
+				...name !== void 0 ? { name } : {}
+			}
+		};
+		await this.emitAlert(alert);
+	}
+	/** Stream online after an outage — drop the matching offline card. */
+	async handleStreamOnline(event) {
+		const deviceId = event.data["deviceId"];
+		const camStreamId = event.data["camStreamId"];
+		if (typeof deviceId !== "number" || typeof camStreamId !== "string") return;
+		const stableId = `stream-offline:${String(deviceId)}:${camStreamId}`;
+		try {
+			await this.dismiss(stableId);
+		} catch (err) {
+			this.ctx.logger?.debug("StreamOnline: dismiss failed (likely already dismissed)", { meta: {
+				stableId,
+				error: errMsg(err)
+			} });
+		}
+	}
+	async resolveDeviceName(deviceId) {
+		try {
+			const device = await this.ctx.api.deviceManager.getDevice.query({ deviceId });
+			if (device !== null && typeof device.name === "string" && device.name.trim().length > 0) return device.name.trim();
+		} catch (err) {
+			this.ctx.logger?.debug("resolveDeviceName failed", {
+				tags: { deviceId },
+				meta: { error: errMsg(err) }
+			});
+		}
+	}
 	buildMessage(category, data, sourceId) {
 		const addonId = data.addonId ?? sourceId;
-		const deviceId = data.deviceId;
+		const device = deviceLabelFromEventData(data);
 		const error = data.error;
 		const processId = data.processId;
 		switch (category) {
 			case "addon.crashed": return `Addon "${addonId ?? "unknown"}" crashed${error ? `: ${error}` : ""}`;
+			case "addon.runner-failed": {
+				const runnerId = typeof data.runnerId === "string" ? data.runnerId : "unknown";
+				const addonIds = Array.isArray(data.addonIds) ? data.addonIds.filter((x) => typeof x === "string").join(", ") : "";
+				return `Runner "${runnerId}" gave up${addonIds.length > 0 ? ` (addons: ${addonIds})` : ""}`;
+			}
 			case "addon.error": return `Addon "${addonId ?? "unknown"}" error${error ? `: ${error}` : ""}`;
 			case "addon.installed": return `Addon "${addonId ?? "unknown"}" installed`;
 			case "addon.updated": {
 				const from = data.fromVersion;
 				const to = data.toVersion;
-				return `Addon "${addonId ?? "unknown"}" updated${from && to ? ` from ${from} to ${to}` : ""}`;
+				return `Addon "${typeof data.packageName === "string" && data.packageName.length > 0 ? data.packageName : addonId ?? "unknown"}" updated${from && to ? ` from ${from} to ${to}` : to ? ` to ${to}` : ""}`;
 			}
 			case "addon.uninstalled": return `Addon "${addonId ?? "unknown"}" uninstalled`;
-			case "device.registered": return `Device "${data.name ?? deviceId ?? "unknown"}" registered`;
-			case "device.unregistered": return `Device "${deviceId ?? "unknown"}" unregistered`;
-			case "agent.online": return `Agent "${data.agentId ?? data.nodeId ?? "unknown"}" connected`;
+			case "device.unregistered": return `Device "${device}" unregistered`;
 			case "agent.offline": return `Agent "${data.agentId ?? data.nodeId ?? "unknown"}" disconnected${data.reason ? `: ${String(data.reason)}` : ""}`;
-			case "backup.completed": return `Backup completed${data.targetId ? ` (${String(data.targetId)})` : ""}`;
 			case "backup.restored": return `Backup restored${data.source ? ` from ${String(data.source)}` : ""}`;
 			case "notification.failed": return `Notification failed${error ? `: ${error}` : ""}`;
 			case "system.restarting": return `System restarting${data.reason ? ` — ${String(data.reason)}` : ""}`;
-			case "recording.error": return `Recording error on device "${deviceId ?? "unknown"}"${error ? `: ${error}` : ""}`;
-			case "recording.storage.critical": return `Storage critical for device "${deviceId ?? "unknown"}"`;
-			case "system.boot": return `System booted in "${data.mode ?? "unknown"}" mode`;
+			case "system.restart-completed": {
+				const pkg = typeof data.packageName === "string" ? data.packageName : void 0;
+				const to = typeof data.toVersion === "string" ? data.toVersion : void 0;
+				const kind = typeof data.kind === "string" ? data.kind : "restart";
+				if (pkg !== void 0 && to !== void 0) return `${pkg} is now ${to}`;
+				return `Node restart completed (${kind})`;
+			}
+			case "update.available": {
+				const pkg = typeof data.packageName === "string" ? data.packageName : "package";
+				const latest = typeof data.latestVersion === "string" ? data.latestVersion : "?";
+				const node = typeof data.nodeId === "string" ? data.nodeId : void 0;
+				return `${pkg} ${latest} available${node !== void 0 ? ` on ${node}` : ""}`;
+			}
+			case "recording.error": return `Recording error on "${device}"${error ? `: ${error}` : ""}`;
+			case "recording.storage.critical": return `Storage critical for "${device}"`;
 			case "system.tls-cert-changed": return data.caRotated === true ? `TLS certificate reissued (${String(data.reason)}) — the local CA also changed. Re-install ${String(data.caCertPath)} on any device that trusted the old one.` : `TLS certificate reissued (${String(data.reason)}) — the local CA is unchanged, previously trusted devices keep working.`;
 			case "process.crashed": return `Process "${processId ?? "unknown"}" crashed`;
 			default: return `Event: ${category}`;

package/dist/builtins/alerts/device-label.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Operator-facing device label for alert messages.
+ *
+ * Prefer a real name; fall back to `Camera <id>` only when nothing else is
+ * known. Never prefer the bare id when a name is present — "Camera 618"
+ * next to a named "Cucina" is how the Recording-stopped alerts used to read.
+ */
+export declare function deviceLabelFromEventData(data: Readonly<Record<string, unknown>>): string;

package/dist/builtins/autotrack/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-DvAczrLl.js");
+const require_dist = require("../../dist-DZKm2EOp.js");
 //#region src/builtins/autotrack/autotrack-config.ts
 var DEFAULT_AUTOTRACK_LOOP_CONFIG = {
 	deadZoneFraction: .5,

package/dist/builtins/autotrack/index.mjs

@@ -1,4 +1,4 @@
-import { J as bareAddonId, Jn as errMsg, Yn as BaseAddon, br as EventCategory, dr as isEvent, on as ptzAutotrackCapability, x as FIRST_LEVEL_MACRO_CLASSES } from "../../dist-C6CPaa8G.mjs";
+import { J as bareAddonId, Jn as errMsg, Yn as BaseAddon, br as EventCategory, dr as isEvent, on as ptzAutotrackCapability, x as FIRST_LEVEL_MACRO_CLASSES } from "../../dist-Di0aX2zy.mjs";
 //#region src/builtins/autotrack/autotrack-config.ts
 var DEFAULT_AUTOTRACK_LOOP_CONFIG = {
 	deadZoneFraction: .5,

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

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-DvAczrLl.js");
+const require_dist = require("../../dist-DZKm2EOp.js");
 let node_crypto = require("node:crypto");
 let buffer = require("buffer");
 let node_fs_promises = require("node:fs/promises");

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

@@ -1,4 +1,4 @@
-import { Cn as storageOccupancyCapability, Yn as BaseAddon, br as EventCategory, fr as nodePin, h as DATABASE_SNAPSHOT_SUFFIX, q as backupCapability, qt as mayWriteToLocation, yr as toNodeId } from "../../dist-C6CPaa8G.mjs";
+import { Cn as storageOccupancyCapability, Yn as BaseAddon, br as EventCategory, fr as nodePin, h as DATABASE_SNAPSHOT_SUFFIX, q as backupCapability, qt as mayWriteToLocation, yr as toNodeId } from "../../dist-Di0aX2zy.mjs";
 import { randomBytes, randomUUID } from "node:crypto";
 import { Buffer as Buffer$1 } from "buffer";
 import * as fsp from "node:fs/promises";

package/dist/builtins/calendars/calendars.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-DvAczrLl.js");
+const require_dist = require("../../dist-DZKm2EOp.js");
 const require_settle_sources = require("../../settle-sources-Bhsy57y-.js");
 let zod = require("zod");
 //#region src/builtins/calendars/calendar-color.ts

package/dist/builtins/calendars/calendars.addon.mjs

@@ -1,4 +1,4 @@
-import { Q as calendarsCapability, Yn as BaseAddon, f as CalendarPreferencesSchema } from "../../dist-C6CPaa8G.mjs";
+import { Q as calendarsCapability, Yn as BaseAddon, f as CalendarPreferencesSchema } from "../../dist-Di0aX2zy.mjs";
 import { t as settleSourcesWithTimeout } from "../../settle-sources-CDtNC8ub.mjs";
 import { z } from "zod";
 //#region src/builtins/calendars/calendar-color.ts