@camstack/addon-post-analysis 1.2.603 → 1.2.608

package/dist/{clip-model-registry-D0-VNIW5.js → clip-model-registry-B11yS32V.js}

@@ -30,7 +30,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 }) : target, mod));
 //#endregion
 let node_crypto = require("node:crypto");
-//#region ../types/dist/event-category-BvOFi6PY.mjs
+//#region ../types/dist/event-category-DOl51-Ij.mjs
 var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["SystemBoot"] = "system.boot";
 	EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -109,9 +109,18 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	/**
 	* The node's one-shot runner boot check (D877): planned runners against the
 	* process service, `degraded` when any is failed, refused or missing. The
-	* alert centre turns it into one alert and a direct critical push.
+	* alert centre turns it into one critical alert.
 	*/
 	EventCategory["SystemRunnerCheck"] = "system.runner-check";
+	/**
+	* An alert EPISODE opened or closed, emitted by the alert centre for alerts
+	* of severity `critical` or `error` (`AlertEpisodePayload`). The alert
+	* centre sends no notification of its own: Notification Center turns this
+	* into the `alert-critical` / `alert-error` / `alert-critical-resolved`
+	* system-event kinds, and reconciles from the alerts store because a bus
+	* event may be dropped (D8, D11).
+	*/
+	EventCategory["AlertEpisode"] = "alert.episode";
 	EventCategory["AddonError"] = "addon.error";
 	EventCategory["AddonPageReady"] = "addon.page-ready";
 	EventCategory["AddonWidgetReady"] = "addon.widget-ready";
@@ -5634,7 +5643,7 @@ var ZodIssueCode = {
 var ZodFirstPartyTypeKind;
 ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
 //#endregion
-//#region ../types/dist/sleep-BOjuyoPC.mjs
+//#region ../types/dist/sleep-BxjU_fJM.mjs
 /**
 * The audio chunk plane's byte format, and the ONE expansion from a coded
 * window to float samples (D455).
@@ -12826,6 +12835,41 @@ var StorageCleanupJobSchema = object({
 });
 var StorageCleanupStatusInputSchema = object({ jobId: string().optional() });
 /**
+* Start a mover only when no single-location repoint holds an overlapping
+* physical root. Asks BEFORE (cheap refusal, no job) and AFTER registering the
+* job: the repoint announces its claim and then lists movers, so a mover that
+* registers first is seen by it and one that registers second sees the claim —
+* neither side can miss the other (2026-10-20: a repoint and a relocate job
+* moved and deleted the same event media with no lock between them).
+*
+* Fail CLOSED: a clearance that cannot be asked refuses the start.
+*/
+async function startMoverUnderClearance(deps) {
+	const refuse = (detail) => {
+		throw new Error(`mover refused: ${detail}`);
+	};
+	const ask = async () => {
+		try {
+			return await deps.clearance(deps.locationIds);
+		} catch (err) {
+			return refuse(`the storage orchestrator could not be asked (${err instanceof Error ? err.message : String(err)})`);
+		}
+	};
+	const blocked = (answer) => `a re-point of "${answer.repointLocationId ?? "a location"}" holds an overlapping storage root`;
+	const before = await ask();
+	if (!before.clear) return refuse(blocked(before));
+	const jobId = deps.start();
+	const after = await ask().catch((err) => {
+		deps.cancel(jobId);
+		throw err;
+	});
+	if (!after.clear) {
+		deps.cancel(jobId);
+		return refuse(blocked(after));
+	}
+	return jobId;
+}
+/**
 * The storage-location STATE MODEL (D385) — one typed state, one policy module.
 *
 * A location's state used to be split across two authorities: the typed
@@ -14669,7 +14713,14 @@ var AlertSeveritySchema = _enum([
 ]);
 var AlertActionSchema = object({
 	label: string(),
-	href: string().optional()
+	href: string().optional(),
+	/**
+	* How `href` is followed. Absent / `app`: an admin-ui route (client-side).
+	* `server`: a route the HUB serves (an addon HTTP route such as an OAuth
+	* start) — the browser must leave the SPA with a full navigation, because
+	* the SPA has no such route and would bounce to the home page.
+	*/
+	navigation: _enum(["app", "server"]).optional()
 });
 var AlertStatusSchema = _enum([
 	"active",
@@ -19061,7 +19112,11 @@ var deviceDiscoveryCapability = {
 };
 /**
 * `device-adoption` — generic discovery + adoption surface,
-* system-scoped singleton. The de-HA-ified successor to `ha-discovery`:
+* system-scoped collection (one provider per integration addon), routed
+* by explicit `{ addonId }` on direct `deviceAdoption.*` calls — the same
+* pin model as `connection-test`. The admin UI keeps using
+* `deviceManager.adoption*` (which already threads `addonId`). The de-HA-ified
+* successor to `ha-discovery`:
 * keyed by `integrationId` (the addon resolves integrationId → broker
 * internally) rather than a connection-specific `brokerId`, and it
 * REUSES the shared `DiscoveredChildDevice` candidate type from
@@ -43539,6 +43594,9 @@ var NcSystemEventKindSchema = _enum([
 	"server-updated",
 	"export-completed",
 	"backup-completed",
+	"alert-critical",
+	"alert-error",
+	"alert-critical-resolved",
 	"camera-online",
 	"camera-offline",
 	"camera-disabled",
@@ -45104,6 +45162,18 @@ var NC_CONDITION_CATALOG = [
 				value: "backup-completed",
 				label: "Backup completed"
 			},
+			{
+				value: "alert-critical",
+				label: "Critical alert raised"
+			},
+			{
+				value: "alert-error",
+				label: "Error alert raised"
+			},
+			{
+				value: "alert-critical-resolved",
+				label: "Critical alert resolved"
+			},
 			{
 				value: "alarm-arm-refused",
 				label: "Alarm arm refused"
@@ -54407,7 +54477,10 @@ method(StorageMigrationInputSchema, StorageMigrationPlanSchema, { auth: "admin"
 }), method(object({ jobId: string().optional() }), StorageMigrationJobSchema.nullable(), { auth: "admin" }), method(object({ jobId: string() }), object({ cancelled: boolean() }), {
 	kind: "mutation",
 	auth: "admin"
-}), method(object({}), array(StorageMigrationMoverSchema).readonly(), { auth: "admin" }), method(object({}), array(StorageMigrationResidueSchema).readonly(), { auth: "admin" }), method(StorageMigrationDrainInputSchema, object({ jobId: string() }), {
+}), method(object({}), array(StorageMigrationMoverSchema).readonly(), { auth: "admin" }), method(object({ locationIds: array(string()).readonly() }), object({
+	clear: boolean(),
+	repointLocationId: string().optional()
+}), { auth: "admin" }), method(object({}), array(StorageMigrationResidueSchema).readonly(), { auth: "admin" }), method(StorageMigrationDrainInputSchema, object({ jobId: string() }), {
 	kind: "mutation",
 	auth: "admin"
 }), method(StorageCleanupInputSchema, object({ jobId: string() }), {
@@ -58746,6 +58819,11 @@ onStatusChanged: { data: object({
 *
 * `kind: 'poll'` — cloud REST APIs typically have no push channel; the
 * provider refreshes the slice on an interval and eagerly after commands.
+*
+* UNKNOWN IS NOT OFF. Every field the appliance reports separately is
+* nullable: `null` means "not known right now" (the appliance has not said,
+* the link is down, or the description does not carry it) and is never
+* rendered or exported as `false` / `0`. `availability` says why.
 */
 var DishwasherStateSchema = _enum([
 	"idle",
@@ -58755,35 +58833,155 @@ var DishwasherStateSchema = _enum([
 	"error",
 	"unavailable"
 ]);
+/**
+* The appliance's own operation state, uncollapsed. `state` above is the coarse
+* view for compact surfaces; this is what the appliance said.
+*/
+var DishwasherOperationStateSchema = _enum([
+	"Inactive",
+	"Ready",
+	"DelayedStart",
+	"Run",
+	"Pause",
+	"ActionRequired",
+	"Finished",
+	"Error",
+	"Aborting"
+]);
+/**
+* Why fields may be `null`:
+*  - `available`           — the link is up and the description is loaded;
+*  - `offline`             — the local link is down (values are unknown, not last-known);
+*  - `description-missing` — the link is up but the appliance's description could not
+*                            be loaded, so its values cannot be decoded.
+*/
+var DishwasherAvailabilitySchema = _enum([
+	"available",
+	"offline",
+	"description-missing"
+]);
 var DishwasherConsumableLevelSchema = _enum([
 	"ok",
 	"low",
 	"empty"
 ]);
 var DishwasherStatusSchema = object({
+	availability: DishwasherAvailabilitySchema,
+	/** Coarse state for compact surfaces; `unavailable` whenever the appliance state is not known. */
 	state: DishwasherStateSchema,
-	/** Active program id/name, or null when none selected / unknown. */
+	/** The appliance's operation state as reported; null when not known. */
+	operationState: DishwasherOperationStateSchema.nullable(),
+	/** Feature key of the ACTIVE (running) program, or null when none runs / not known. */
 	program: string().nullable(),
-	/** Program tokens the hardware accepts — drives the UI selector. */
+	/** Feature key of the SELECTED program (what Start would run), or null when none / not known. */
+	selectedProgram: string().nullable(),
+	/** Feature keys of the programs the appliance currently offers — drives the UI selector. */
 	availablePrograms: array(string()),
-	/** Minutes remaining on the active cycle, or null when not running. */
-	remainingMinutes: number().int().nonnegative().nullable(),
+	/** Seconds remaining on the active cycle, or null when not running / not known. */
+	remainingSeconds: number().int().nonnegative().nullable(),
+	/** Seconds the delayed start is set to (time until the cycle starts), or null. */
+	delayedStartSeconds: number().int().nonnegative().nullable(),
 	/** Cycle completion 0..100, or null when not applicable. */
 	progressPercent: number().min(0).max(100).nullable(),
-	/** True when the door is reported open. */
-	doorOpen: boolean(),
-	/** True when remote start is allowed (door closed, power on, etc.). */
-	remoteStartAllowed: boolean(),
-	/** Main power / switched-on state. */
-	powerOn: boolean(),
+	/** True when the door is reported open; null when the door state is not known. */
+	doorOpen: boolean().nullable(),
+	/** True when the door is latched (locked) during a cycle; null when not reported. */
+	doorLocked: boolean().nullable(),
+	/** True when remote start is allowed (door closed, power on, etc.); null when not known. */
+	remoteStartAllowed: boolean().nullable(),
+	/** True when the appliance accepts remote control now; null when not known. */
+	remoteControlActive: boolean().nullable(),
+	/** True while somebody operates the appliance at its panel; null when not reported. */
+	localControlActive: boolean().nullable(),
+	/** Main power / switched-on state; null when not known. */
+	powerOn: boolean().nullable(),
+	/** The raw power state (`On`, `Off`, `Standby`, …); null when not known. */
+	powerState: string().nullable(),
 	saltLevel: DishwasherConsumableLevelSchema.nullable(),
 	rinseAidLevel: DishwasherConsumableLevelSchema.nullable(),
-	halfLoad: boolean(),
-	hygienePlus: boolean(),
+	/** Option states: null when the appliance does not expose the option or has not said. */
+	halfLoad: boolean().nullable(),
+	hygienePlus: boolean().nullable(),
+	/** Extra dry option when the appliance exposes it. */
+	extraDry: boolean().nullable(),
+	/** Intensive zone (lower basket) when the appliance exposes it. */
+	intensiveZone: boolean().nullable(),
+	/** VarioSpeed / VarioSpeed+ when the appliance exposes it. */
+	varioSpeedPlus: boolean().nullable(),
+	/** Child lock (controls disabled on the appliance); null when not known. */
+	childLock: boolean().nullable(),
+	/** Feature keys of the events currently raised (salt low, rinse aid low, program finished, …). */
+	activeEvents: array(string()),
+	/** Numeric error code when the appliance reports one; null otherwise. */
 	errorCode: number().nullable(),
+	/** Name of the raised alert-level event while the appliance is in error; null otherwise. */
 	errorLabel: string().nullable(),
+	/** Ms epoch of the last value received from the appliance; 0 = never. */
 	lastFetchedAt: number()
 });
+var DeviceIdSchema = number().int().nonnegative();
+/** A value a program option or setting can take. */
+var DishwasherValueSchema = union([
+	boolean(),
+	string(),
+	number()
+]);
+var DishwasherAccessSchema = _enum([
+	"none",
+	"read",
+	"readWrite",
+	"writeOnly",
+	"readStatic"
+]);
+/**
+* One option or setting the appliance declares, with the constraints its description
+* gives. A `readWrite` descriptor that is `available` is what `setOption` accepts.
+*/
+var DishwasherOptionDescriptorSchema = object({
+	/** Feature key (`Dishcare.Dishwasher.Option.ExtraDry`). */
+	key: string(),
+	/** Last segment of the key, for display. */
+	name: string(),
+	type: _enum([
+		"boolean",
+		"number",
+		"enum",
+		"string"
+	]),
+	access: DishwasherAccessSchema,
+	/** The appliance reports this entity as currently available. */
+	available: boolean(),
+	/** Unit the description declares for a number; null when it declares none. */
+	unit: string().nullable(),
+	min: number().nullable(),
+	max: number().nullable(),
+	step: number().nullable(),
+	/** Allowed members of an enum; null for other types. */
+	enumValues: array(string()).nullable(),
+	defaultValue: DishwasherValueSchema.nullable()
+});
+var DishwasherProgramSchema = object({
+	/** Feature key (`Dishcare.Dishwasher.Program.Eco50`) — what `setProgram` / `start` take. */
+	key: string(),
+	name: string(),
+	/** The appliance currently offers this program. */
+	available: boolean(),
+	/** The options this program lists, with the program-level access / availability / default. */
+	options: array(DishwasherOptionDescriptorSchema)
+});
+var DishwasherOptionsSchema = object({
+	availability: DishwasherAvailabilitySchema,
+	/** What the appliance can be told to do, from the commands its description declares. */
+	supportsStart: boolean(),
+	supportsPause: boolean(),
+	supportsResume: boolean(),
+	supportsStop: boolean(),
+	supportsPower: boolean(),
+	/** Every program the description lists, with its options. */
+	programs: array(DishwasherProgramSchema),
+	/** Every option and setting entity the description lists (programs reference these by key). */
+	options: array(DishwasherOptionDescriptorSchema)
+});
 var dishwasherCapability = {
 	name: "dishwasher",
 	scope: "device",
@@ -58791,58 +58989,102 @@ var dishwasherCapability = {
 	mode: "singleton",
 	deviceTypes: [DeviceType.Dishwasher],
 	methods: {
-		start: method(object({ deviceId: number().int().nonnegative() }), _void(), {
+		/**
+		* Start a program. Without `program` the selected one starts. `options` are
+		* option feature keys; each is checked against the program's constraints.
+		*/
+		start: method(object({
+			deviceId: DeviceIdSchema,
+			program: string().min(1).optional(),
+			options: record(string(), DishwasherValueSchema).optional()
+		}), _void(), {
 			kind: "mutation",
 			auth: "protected"
 		}),
-		pause: method(object({ deviceId: number().int().nonnegative() }), _void(), {
+		pause: method(object({ deviceId: DeviceIdSchema }), _void(), {
 			kind: "mutation",
 			auth: "protected"
 		}),
-		stop: method(object({ deviceId: number().int().nonnegative() }), _void(), {
+		resume: method(object({ deviceId: DeviceIdSchema }), _void(), {
 			kind: "mutation",
 			auth: "protected"
 		}),
+		stop: method(object({ deviceId: DeviceIdSchema }), _void(), {
+			kind: "mutation",
+			auth: "protected"
+		}),
+		/** Select (not start) a program; refused when the appliance does not offer it. */
 		setProgram: method(object({
-			deviceId: number().int().nonnegative(),
+			deviceId: DeviceIdSchema,
 			program: string().min(1)
 		}), _void(), {
 			kind: "mutation",
 			auth: "protected"
 		}),
 		setPower: method(object({
-			deviceId: number().int().nonnegative(),
+			deviceId: DeviceIdSchema,
 			on: boolean()
 		}), _void(), {
 			kind: "mutation",
 			auth: "protected"
 		}),
 		setHalfLoad: method(object({
-			deviceId: number().int().nonnegative(),
+			deviceId: DeviceIdSchema,
 			on: boolean()
 		}), _void(), {
 			kind: "mutation",
 			auth: "protected"
 		}),
 		setHygienePlus: method(object({
-			deviceId: number().int().nonnegative(),
+			deviceId: DeviceIdSchema,
+			on: boolean()
+		}), _void(), {
+			kind: "mutation",
+			auth: "protected"
+		}),
+		setExtraDry: method(object({
+			deviceId: DeviceIdSchema,
 			on: boolean()
 		}), _void(), {
 			kind: "mutation",
 			auth: "protected"
 		}),
+		setIntensiveZone: method(object({
+			deviceId: DeviceIdSchema,
+			on: boolean()
+		}), _void(), {
+			kind: "mutation",
+			auth: "protected"
+		}),
+		setVarioSpeedPlus: method(object({
+			deviceId: DeviceIdSchema,
+			on: boolean()
+		}), _void(), {
+			kind: "mutation",
+			auth: "protected"
+		}),
+		setChildLock: method(object({
+			deviceId: DeviceIdSchema,
+			on: boolean()
+		}), _void(), {
+			kind: "mutation",
+			auth: "protected"
+		}),
+		/**
+		* Write any option or setting by feature key. Refused when the description does
+		* not list it, it is not writable or not available now, or the value is outside
+		* its declared range / members.
+		*/
 		setOption: method(object({
-			deviceId: number().int().nonnegative(),
+			deviceId: DeviceIdSchema,
 			key: string().min(1),
-			value: union([
-				boolean(),
-				string(),
-				number()
-			])
+			value: DishwasherValueSchema
 		}), _void(), {
 			kind: "mutation",
 			auth: "protected"
-		})
+		}),
+		/** What this appliance can do, from its own description — the UI is derived from it. */
+		getOptions: method(object({ deviceId: DeviceIdSchema }), DishwasherOptionsSchema, { auth: "protected" })
 	},
 	status: {
 		schema: DishwasherStatusSchema,
@@ -72530,6 +72772,12 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"dishwasher.getOptions": {
+		capName: "dishwasher",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
 	"dishwasher.getStatus": {
 		capName: "dishwasher",
 		capScope: "device",
@@ -72542,6 +72790,24 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"dishwasher.resume": {
+		capName: "dishwasher",
+		capScope: "device",
+		addonId: null,
+		access: "create"
+	},
+	"dishwasher.setChildLock": {
+		capName: "dishwasher",
+		capScope: "device",
+		addonId: null,
+		access: "create"
+	},
+	"dishwasher.setExtraDry": {
+		capName: "dishwasher",
+		capScope: "device",
+		addonId: null,
+		access: "create"
+	},
 	"dishwasher.setHalfLoad": {
 		capName: "dishwasher",
 		capScope: "device",
@@ -72554,6 +72820,12 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"dishwasher.setIntensiveZone": {
+		capName: "dishwasher",
+		capScope: "device",
+		addonId: null,
+		access: "create"
+	},
 	"dishwasher.setOption": {
 		capName: "dishwasher",
 		capScope: "device",
@@ -72572,6 +72844,12 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"dishwasher.setVarioSpeedPlus": {
+		capName: "dishwasher",
+		capScope: "device",
+		addonId: null,
+		access: "create"
+	},
 	"dishwasher.start": {
 		capName: "dishwasher",
 		capScope: "device",
@@ -77018,6 +77296,12 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"storageMigration.moverClearance": {
+		capName: "storage-migration",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"storageMigration.movers": {
 		capName: "storage-migration",
 		capScope: "system",
@@ -79211,6 +79495,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"dishwasher.getOptions": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"dishwasher.getStatus": [{
 		name: "deviceId",
 		form: "single",
@@ -79221,6 +79510,21 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"dishwasher.resume": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"dishwasher.setChildLock": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"dishwasher.setExtraDry": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"dishwasher.setHalfLoad": [{
 		name: "deviceId",
 		form: "single",
@@ -79231,6 +79535,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"dishwasher.setIntensiveZone": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"dishwasher.setOption": [{
 		name: "deviceId",
 		form: "single",
@@ -79246,6 +79555,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"dishwasher.setVarioSpeedPlus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"dishwasher.start": [{
 		name: "deviceId",
 		form: "single",
@@ -81398,7 +81712,7 @@ function systemEventFilterApplies(kind, filter) {
 	switch (filter) {
 		case "deviceIds": return kind.startsWith("device-") || kind.startsWith("stream-") || kind === "detection-blind" || kind.startsWith("recording-") || kind === "alarm-triggered";
 		case "deviceTypes": return kind.startsWith("device-") || kind === "detection-blind";
-		case "nodeIds": return kind.startsWith("node-") || kind === "addon-crash-loop" || kind === "addon-update-available" || kind === "addon-updated" || kind === "server-update-available" || kind === "wrapper-update-available" || kind === "server-updated" || kind.startsWith("storage-location-");
+		case "nodeIds": return kind.startsWith("node-") || kind === "addon-crash-loop" || kind === "addon-update-available" || kind === "addon-updated" || kind === "server-update-available" || kind === "wrapper-update-available" || kind === "server-updated" || kind.startsWith("storage-location-") || kind.startsWith("alert-");
 		case "packageNames": return kind.endsWith("update-available") || kind === "addon-updated" || kind === "node-updating" || kind === "server-updated";
 		case "consumableLowPercent": return NC_CONSUMABLE_SYSTEM_EVENT_KINDS.includes(kind);
 	}
@@ -81458,6 +81772,9 @@ var NC_SYSTEM_EVENT_FAMILY = {
 	"wrapper-update-available": "system",
 	"backup-completed": "system",
 	"export-completed": "system",
+	"alert-critical": "system",
+	"alert-error": "system",
+	"alert-critical-resolved": "system",
 	"storage-location-low": "system",
 	"storage-location-critical": "system",
 	"storage-location-ok": "system",
@@ -81600,6 +81917,16 @@ var NC_SYSTEM_EVENT_KIND_GROUP_SPECS = [
 			"storage-location-ok"
 		]
 	},
+	{
+		id: "alerts",
+		family: "system",
+		label: "Alerts",
+		kinds: [
+			"alert-critical",
+			"alert-error",
+			"alert-critical-resolved"
+		]
+	},
 	{
 		id: "alarm",
 		family: "alarm",
@@ -82411,6 +82738,96 @@ function sensorRaisedOf(kind, value) {
 	const raw = Object.entries(value).find(([key]) => key === field)?.[1];
 	return typeof raw === "boolean" ? raw : void 0;
 }
+/**
+* An alert EPISODE as a notification subject.
+*
+* The alert centre sends nothing of its own. A critical or error alert reaches
+* the operator through Notification Center system-event rules, and this file is
+* the one vocabulary the two sides share: the alert centre mints the episode
+* identity and announces its two edges on the bus (`alert.episode`), and
+* Notification Center derives the same identity when it RECONCILES from the
+* alerts store, because a bus event may be dropped (D8, D11).
+*
+* ## Episode identity
+*
+* `metadata.episodeId`, minted by the alert centre when an alert opens (new, or
+* re-opened after it was completed/dismissed, or its emitter changed
+* `metadata.episodeKey`) and kept through every re-emit while it stays open. An
+* alert row written before the alert centre minted ids has none: its episode is
+* `<id>@<createdAt>`, derived here so both sides agree.
+*/
+/** The bus payload of `EventCategory.AlertEpisode`. */
+var AlertEpisodePayloadSchema = object({
+	phase: _enum(["raised", "resolved"]),
+	episodeId: string().min(1),
+	alertId: string().min(1),
+	severity: AlertSeveritySchema,
+	category: string(),
+	title: string(),
+	message: string(),
+	sourceType: string().optional(),
+	sourceId: string().optional(),
+	nodeId: string().optional(),
+	/** The alert's own action link (where the operator acts on it), when it has one. */
+	actionUrl: string().optional(),
+	at: number()
+});
+/** The payload of an `alert.episode` event's `data`, or `null` when it is not one. */
+function parseAlertEpisodePayload(data) {
+	const parsed = AlertEpisodePayloadSchema.safeParse(data);
+	return parsed.success ? parsed.data : null;
+}
+/** An episode is closed once its alert is completed or dismissed. */
+function isAlertEpisodeOpen(status) {
+	return status !== "completed" && status !== "dismissed";
+}
+/** Only these severities are ever announced. */
+function isAlertEpisodeSeverity(severity) {
+	return severity === "critical" || severity === "error";
+}
+function alertEpisodeId(alert) {
+	const minted = alert.metadata?.["episodeId"];
+	return typeof minted === "string" && minted.length > 0 ? minted : `${alert.id}@${String(alert.createdAt)}`;
+}
+/** The node an alert is about, from the places emitters put it. */
+function alertNodeId(alert) {
+	const direct = alert.metadata?.["nodeId"];
+	if (typeof direct === "string") return direct;
+	const runner = alert.metadata?.["runner"];
+	if (typeof runner === "object" && runner !== null && "nodeId" in runner) {
+		const id = runner.nodeId;
+		if (typeof id === "string") return id;
+	}
+	return alert.source?.type === "node" ? alert.source.id : void 0;
+}
+/**
+* The system-event kind of an episode edge, or `null` when none is announced
+* (an `error` episode announces its opening only).
+*/
+function alertEpisodeKind(severity, phase) {
+	if (severity === "critical") return phase === "raised" ? "alert-critical" : "alert-critical-resolved";
+	if (severity === "error" && phase === "raised") return "alert-error";
+	return null;
+}
+function alertEpisodePayload(alert, phase, at) {
+	const nodeId = alertNodeId(alert);
+	return {
+		phase,
+		episodeId: alertEpisodeId(alert),
+		alertId: alert.id,
+		severity: alert.severity,
+		category: alert.category,
+		title: alert.title,
+		message: alert.message,
+		...alert.source !== void 0 ? {
+			sourceType: alert.source.type,
+			sourceId: alert.source.id
+		} : {},
+		...nodeId !== void 0 ? { nodeId } : {},
+		...alert.action?.href !== void 0 ? { actionUrl: alert.action.href } : {},
+		at
+	};
+}
 var RULE_BODY_ONLY = ["body"];
 var RULE_TEXT = ["title", "body"];
 var BATTERY = ["device-battery-low", "device-battery-normal"];
@@ -82420,6 +82837,11 @@ var TANK = [
 	"device-tank-full",
 	"device-tank-normal"
 ];
+var ALERT_EPISODE = [
+	"alert-critical",
+	"alert-error",
+	"alert-critical-resolved"
+];
 var UPDATES = [
 	"addon-update-available",
 	"server-update-available",
@@ -82944,7 +83366,8 @@ var NC_TEMPLATE_VARS = [
 			"server-updated",
 			"storage-location-low",
 			"storage-location-critical",
-			"storage-location-ok"
+			"storage-location-ok",
+			...ALERT_EPISODE
 		]
 	},
 	{
@@ -82966,7 +83389,8 @@ var NC_TEMPLATE_VARS = [
 			"server-updated",
 			"storage-location-low",
 			"storage-location-critical",
-			"storage-location-ok"
+			"storage-location-ok",
+			...ALERT_EPISODE
 		]
 	},
 	{
@@ -83033,7 +83457,7 @@ var NC_TEMPLATE_VARS = [
 		families: ["rule"],
 		fields: [...RULE_TEXT],
 		kinds: ["system"],
-		systemEventKinds: ["recording-degraded"]
+		systemEventKinds: ["recording-degraded", ...ALERT_EPISODE]
 	},
 	{
 		name: "locationName",
@@ -83230,13 +83654,53 @@ var NC_TEMPLATE_VARS = [
 	},
 	{
 		name: "title",
-		label: "Export title",
+		label: "Export or alert title",
 		example: "Ingresso 08:00",
 		group: "system",
 		families: ["rule"],
 		fields: [...RULE_TEXT],
 		kinds: ["system"],
-		systemEventKinds: ["export-completed"]
+		systemEventKinds: ["export-completed", ...ALERT_EPISODE]
+	},
+	{
+		name: "severity",
+		label: "Alert severity",
+		example: "critical",
+		group: "system",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["system"],
+		systemEventKinds: [...ALERT_EPISODE]
+	},
+	{
+		name: "category",
+		label: "Alert category",
+		example: "addon.runner-failed",
+		group: "system",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["system"],
+		systemEventKinds: [...ALERT_EPISODE]
+	},
+	{
+		name: "source",
+		label: "Alert source (addon, node or runner)",
+		example: "recorder",
+		group: "system",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["system"],
+		systemEventKinds: [...ALERT_EPISODE]
+	},
+	{
+		name: "actionUrl",
+		label: "Alert action link",
+		example: "/system/addons",
+		group: "system",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["system"],
+		systemEventKinds: [...ALERT_EPISODE]
 	},
 	{
 		name: "exportId",
@@ -83447,7 +83911,10 @@ var NC_TEMPLATE_HELD_BACK_SYSTEM_EVENT_KINDS = [
 	"device-tank-full",
 	"device-tank-normal",
 	"node-restarting",
-	"node-updating"
+	"node-updating",
+	"alert-critical",
+	"alert-error",
+	"alert-critical-resolved"
 ];
 /**
 * The catalog as `getTemplateCatalog` SERVES it: every descriptor, with the
@@ -86247,6 +86714,24 @@ Object.defineProperty(exports, "alarmPanelCapability", {
 		return alarmPanelCapability;
 	}
 });
+Object.defineProperty(exports, "alertEpisodeId", {
+	enumerable: true,
+	get: function() {
+		return alertEpisodeId;
+	}
+});
+Object.defineProperty(exports, "alertEpisodeKind", {
+	enumerable: true,
+	get: function() {
+		return alertEpisodeKind;
+	}
+});
+Object.defineProperty(exports, "alertEpisodePayload", {
+	enumerable: true,
+	get: function() {
+		return alertEpisodePayload;
+	}
+});
 Object.defineProperty(exports, "applyBlockingEdit", {
 	enumerable: true,
 	get: function() {
@@ -86541,6 +87026,18 @@ Object.defineProperty(exports, "isAlarmControllableCap", {
 		return isAlarmControllableCap;
 	}
 });
+Object.defineProperty(exports, "isAlertEpisodeOpen", {
+	enumerable: true,
+	get: function() {
+		return isAlertEpisodeOpen;
+	}
+});
+Object.defineProperty(exports, "isAlertEpisodeSeverity", {
+	enumerable: true,
+	get: function() {
+		return isAlertEpisodeSeverity;
+	}
+});
 Object.defineProperty(exports, "isAppLinkBase", {
 	enumerable: true,
 	get: function() {
@@ -86715,6 +87212,12 @@ Object.defineProperty(exports, "occupancyScope", {
 		return occupancyScope;
 	}
 });
+Object.defineProperty(exports, "parseAlertEpisodePayload", {
+	enumerable: true,
+	get: function() {
+		return parseAlertEpisodePayload;
+	}
+});
 Object.defineProperty(exports, "parseProcStatus", {
 	enumerable: true,
 	get: function() {
@@ -86889,6 +87392,12 @@ Object.defineProperty(exports, "sleep", {
 		return sleep;
 	}
 });
+Object.defineProperty(exports, "startMoverUnderClearance", {
+	enumerable: true,
+	get: function() {
+		return startMoverUnderClearance;
+	}
+});
 Object.defineProperty(exports, "storageOccupancyCapability", {
 	enumerable: true,
 	get: function() {