@camstack/addon-post-analysis 1.2.651 → 1.2.653

package/dist/pipeline-analytics/index.js

@@ -2,7 +2,7 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_clip_model_registry = require("../clip-model-registry-Dte3QQEt.js");
+const require_clip_model_registry = require("../clip-model-registry-Bz1uQvQ8.js");
 let node_fs = require("node:fs");
 node_fs = require_clip_model_registry.__toESM(node_fs, 1);
 let node_path = require("node:path");
@@ -9063,6 +9063,7 @@ var en_default = {
 	"system.node-offline.body.agent": "Agent {{nodeName}} is offline",
 	"system.node-offline.body.agent.connection-lost": "Agent {{nodeName}} lost its connection to the hub",
 	"system.node-offline.body.agent.shutdown": "Agent {{nodeName}} shut down",
+	"system.node-offline.body.agent.updating": "Agent {{nodeName}} went offline while updating and has not come back after {{graceMin}} minutes",
 	"system.node-inference-unavailable.title": "Node cannot infer — {{nodeId}}",
 	"system.node-inference-unavailable.body": "Node {{nodeId}} can no longer run inference — every enabled device is unavailable ({{devices}}). It will not receive cameras until one returns.",
 	"system.addon-crash-loop.title": "Addon crash-loop — {{nodeId}}",
@@ -9467,6 +9468,7 @@ var it_default = {
 	"system.node-offline.body.agent": "L'agent {{nodeName}} è offline",
 	"system.node-offline.body.agent.connection-lost": "L'agent {{nodeName}} ha perso la connessione con l'hub",
 	"system.node-offline.body.agent.shutdown": "L'agent {{nodeName}} si è spento",
+	"system.node-offline.body.agent.updating": "L'agent {{nodeName}} è andato offline durante un aggiornamento e non è tornato dopo {{graceMin}} minuti",
 	"system.node-inference-unavailable.title": "Nodo senza inferenza — {{nodeId}}",
 	"system.node-inference-unavailable.body": "Il nodo {{nodeId}} non può più eseguire inferenza — tutti i dispositivi abilitati non sono disponibili ({{devices}}). Non riceverà camere finché uno non torna disponibile.",
 	"system.addon-crash-loop.title": "Crash-loop addon — {{nodeId}}",
@@ -70507,7 +70509,12 @@ Object.freeze({
 	"calendar-source": ["listCalendars", "listEvents"],
 	"custom-model-registry": ["listModels"],
 	"data-store-provider": ["histogram", "query"],
-	"device-export": ["listExposedDevices", "listSupportedDeviceKinds"],
+	"device-export": [
+		"listExposedDevices",
+		"listExposedEntities",
+		"listSupportedDeviceKinds",
+		"listSupportedEntityKinds"
+	],
 	"device-extension": ["listSlots", "listSources"],
 	"device-provider": ["discoverDevices", "getDevices"],
 	"device-removal-hook": ["listDeviceData"],
@@ -70532,6 +70539,7 @@ Object.freeze({
 		"listTargets"
 	],
 	"recording": ["listSources"],
+	"remote-layout-components": ["listComponents"],
 	"storage-occupancy": ["getOccupancy"],
 	"storage-provider": ["list"],
 	"template": ["list"],
@@ -70546,6 +70554,12 @@ Object.freeze({
 	"videoclips": ["listClips", "listSources"]
 });
 Object.freeze({
+	"device-export": [
+		"exposeEntity",
+		"listExposedEntities",
+		"listSupportedEntityKinds",
+		"unexposeEntity"
+	],
 	"log-destination": [
 		"cancelRead",
 		"describeRead",
@@ -80753,12 +80767,13 @@ function incomingFromNodeRestarting(facts, data) {
 		nodeIds: [nodeId]
 	});
 	const packageName = stringField(data, "packageName") ?? "@camstack/server";
+	const what = stringField(data, "what");
 	const fromVersion = stringField(data, "fromVersion");
 	const bodyKey = toVersion === void 0 ? "system.node-updating.body.plain" : fromVersion === void 0 ? "system.node-updating.body.toOnly" : "system.node-updating.body";
 	return systemSubject({
 		facts,
 		kind: "node-updating",
-		subject: `node-updating:${nodeId}:${toVersion ?? "unknown"}`,
+		subject: what === void 0 || what === "server" ? `node-updating:${nodeId}:${toVersion ?? "unknown"}` : `node-updating:${nodeId}:${what}:${toVersion ?? "unknown"}`,
 		titleKey: "system.node-updating.title",
 		bodyKey,
 		textParams: {
@@ -90260,13 +90275,17 @@ var DeviceLivenessHoldoff = class {
 	rememberIfAbsent(subject, state) {
 		if (!this.lastNotified.has(subject)) this.lastNotified.set(subject, state);
 	}
-	/** A real ledger flip. Starts / resets the trailing timer. */
-	arm(subject, incoming) {
+	/**
+	* A real ledger flip. Starts / resets the trailing timer. `delayMs` replaces
+	* the default delay for THIS arm only (a node's planned-update grace).
+	*/
+	arm(subject, incoming, delayMs) {
+		const delay = delayMs ?? this.delayMs;
 		this.pending.set(subject, incoming);
 		this.trackDeparture(subject, incoming);
 		const existing = this.timers.get(subject);
 		if (existing !== void 0) this.cancel(existing);
-		if (this.delayMs <= 0) {
+		if (delay <= 0) {
 			this.timers.delete(subject);
 			this.fire(subject);
 			return;
@@ -90274,7 +90293,7 @@ var DeviceLivenessHoldoff = class {
 		const id = this.schedule(() => {
 			this.timers.delete(subject);
 			this.fire(subject);
-		}, this.delayMs);
+		}, delay);
 		this.timers.set(subject, id);
 	}
 	dispose() {
@@ -92921,6 +92940,71 @@ var NcRuleStore = class NcRuleStore {
 	}
 };
 //#endregion
+//#region src/notification-center/planned-update-window.ts
+/**
+* A node that ANNOUNCED an update is expected to go offline — the window that
+* says so lives here.
+*
+* `system.restarting` becomes `node-updating` / `node-restarting`; the centre
+* records the announcement per node (RAM, refreshed by the event, never by a
+* read — D49). An offline for that node inside {@link PLANNED_UPDATE_OFFLINE_GRACE_MS}
+* of the announcement is held for the whole window instead of the usual 60 s
+* hold-off: back in time means no offline notification at all, not back means
+* one offline that says it happened during an update. A lost announcement
+* (events may be dropped, D8) simply behaves as before.
+*/
+/** How long after an announcement an offline is held, and how long the announcement counts. */
+var PLANNED_UPDATE_OFFLINE_GRACE_MS = 10 * 6e4;
+var NC_PLANNED_UPDATE_NODES_MAX = 256;
+var NcPlannedUpdateWindow = class {
+	graceMs;
+	/** Insertion-ordered: the oldest node is evicted first. */
+	announcedAt = /* @__PURE__ */ new Map();
+	/** When an offline was put on hold, per node. */
+	heldAt = /* @__PURE__ */ new Map();
+	constructor(graceMs = PLANNED_UPDATE_OFFLINE_GRACE_MS) {
+		this.graceMs = graceMs;
+	}
+	get windowMs() {
+		return this.graceMs;
+	}
+	get graceMinutes() {
+		return Math.round(this.graceMs / 6e4);
+	}
+	/** Feed every system subject the intake accepted; only the two announcements are kept. */
+	observe(system, atMs) {
+		if (system.kind !== "node-updating" && system.kind !== "node-restarting") return;
+		const nodeId = system.nodeId;
+		if (nodeId === void 0) return;
+		this.announcedAt.delete(nodeId);
+		this.announcedAt.set(nodeId, atMs);
+		while (this.announcedAt.size > NC_PLANNED_UPDATE_NODES_MAX) {
+			const oldest = this.announcedAt.keys().next();
+			if (oldest.done === true) break;
+			this.announcedAt.delete(oldest.value);
+		}
+	}
+	/** True when the node announced an update no longer than the window ago. */
+	isPlanned(nodeId, atMs) {
+		const at = this.announcedAt.get(nodeId);
+		return at !== void 0 && atMs - at <= this.graceMs;
+	}
+	/** An offline was put on hold for this node. */
+	hold(nodeId, atMs) {
+		this.heldAt.set(nodeId, atMs);
+	}
+	/**
+	* The node is back: seconds the held offline lasted, or `null` when no offline
+	* was held, or its window already ran out (the offline was sent).
+	*/
+	release(nodeId, atMs) {
+		const at = this.heldAt.get(nodeId);
+		if (at === void 0) return null;
+		this.heldAt.delete(nodeId);
+		return atMs - at < this.graceMs ? Math.round((atMs - at) / 1e3) : null;
+	}
+};
+//#endregion
 //#region src/notification-center/restart-supersede.ts
 /** How many landings are remembered — one per node per update, so a fleet's worth. */
 var NC_UPDATE_LANDINGS_MAX = 256;
@@ -101881,6 +101965,7 @@ function onSystemEvent(host, event) {
 	const system = incoming.subject.systemEvent;
 	if (system !== void 0) host.stateSummary.observeSystem(system, host.now());
 	if (system !== void 0) host.updateLandings.observe(system, host.now());
+	if (system !== void 0) host.plannedUpdates.observe(system, host.now());
 	const observation = system !== void 0 ? ledgeredLiveness(system) : null;
 	if (observation !== null) {
 		const previous = host.liveness.stateOf(observation.subject);
@@ -101907,7 +101992,11 @@ function onSystemEvent(host, event) {
 			});
 			return;
 		}
-		if (isDeviceLivenessKind(observation.kind) || isNodeLivenessKind(observation.kind)) {
+		if (isNodeLivenessKind(observation.kind) && system !== void 0) {
+			armNodeLiveness(host, holdoff, observation.subject, incoming, system);
+			return;
+		}
+		if (isDeviceLivenessKind(observation.kind)) {
 			holdoff.arm(observation.subject, incoming);
 			return;
 		}
@@ -101918,6 +102007,50 @@ function onSystemEvent(host, event) {
 	host.consumeEvent(incoming);
 }
 /**
+* Arm a node liveness flip. An OFFLINE of a node that announced an update is
+* held for the whole planned-update window and worded as such if it is still
+* sent; the node's return inside the window is logged and sends nothing (the
+* hold-off sees the state bounce back to the one last notified).
+*/
+function armNodeLiveness(host, holdoff, subject, incoming, system) {
+	const nodeId = system.nodeId;
+	const now = host.now();
+	if (nodeId === void 0) {
+		holdoff.arm(subject, incoming);
+		return;
+	}
+	const window = host.plannedUpdates;
+	if (system.kind === "node-offline" && window.isPlanned(nodeId, now)) {
+		window.hold(nodeId, now);
+		holdoff.arm(subject, withPlannedUpdateWording(incoming, system, window.graceMinutes), window.windowMs);
+		return;
+	}
+	if (system.kind === "node-online") {
+		const backAfterSec = window.release(nodeId, now);
+		if (backAfterSec !== null) host.logger.info(`node ${nodeId}: offline suppressed: planned update, back after ${backAfterSec}s`, { meta: {
+			nodeId,
+			backAfterSec
+		} });
+	}
+	holdoff.arm(subject, incoming);
+}
+function withPlannedUpdateWording(incoming, system, graceMin) {
+	return {
+		...incoming,
+		subject: {
+			...incoming.subject,
+			systemEvent: {
+				...system,
+				bodyKey: "system.node-offline.body.agent.updating",
+				textParams: {
+					...system.textParams,
+					graceMin: String(graceMin)
+				}
+			}
+		}
+	};
+}
+/**
 * One edge of an alert episode, from the bus or from the reconcile. The
 * ledger decides whether it is news; only news reaches the rules.
 */
@@ -105736,6 +105869,7 @@ var NotificationCenter = class {
 	stateSummary;
 	/** Every `server-updated` heard, so a stale `node-updating` is not sent after it (D723). */
 	updateLandings = new NcUpdateLandings();
+	plannedUpdates = new NcPlannedUpdateWindow();
 	/** States the `deviceState` rule gate reads. Refreshed on the reload tick;
 	*  read with no I/O on the persist hook. */
 	deviceStates;
@@ -107128,6 +107262,9 @@ var NotificationCenter = class {
 			get timelapseRules() {
 				return self.timelapseRules;
 			},
+			get plannedUpdates() {
+				return self.plannedUpdates;
+			},
 			get updateLandings() {
 				return self.updateLandings;
 			},

package/dist/pipeline-analytics/index.mjs

@@ -1,4 +1,4 @@
-import { $ as MediaFileKindEnum, $i as BaseAddon, $n as cloneAlarmSettings, $r as paintHex, $t as OpsLogEntrySchema, A as DeclaredDevices, Aa as unknown, Ai as storageOccupancyCapability, An as TrackSideSchema, Ar as isAudioClassName, At as NcAlarmSensorsInputSchema, B as FULL_IMAGE_BBOX, Bi as systemEventSummarySplitOf, Bn as applyModeDelaysEdits, Br as isRootSuppliableStepId, Bt as NcRuleUpdateInputSchema, C as ClearTrackRelationResultSchema, Ca as partialRecord, Ci as ruleGroupingApplies, Cn as TimelapseRuleInputSchema, Cr as failureContributionCapability, Ct as NC_SNOOZE_MAX_MINUTES, D as DEFAULT_TIMELAPSE_PREVIEW_TEXT, Da as templateLiteral, Di as sensorRaisedOf, Dn as TrackPuritySchema, Dr as isAlertEpisodeOpen, Dt as NC_TEMPLATE_VARS, E as DEFAULT_EVENT_COLOR, Ea as string, Ei as secureActuationFor, En as TrackPlacementSchema, Er as isAlarmControllableCap, Et as NC_TAXONOMY, F as EVENT_DENSITY_BATCH_MAX, Fi as syncActiveAlarmProfileSettings, Fn as alarmPanelCapability, Fr as isEventOwnerType, Ft as NcRuleActionSchema, G as ListTrackRelationsResultSchema, Gi as withSystemEventClasses, Gn as audioMetricsCapability, Gr as kebabToCamel, Gt as NcSnoozeSuppressedSchema, H as LABEL_SUPPLY_MACRO, Hi as templateVarsFor, Hn as applySecureOnArmEdit, Hr as isSystemDelivery, Ht as NcSharedSequenceSchema, I as EVENT_KIND_BY_CAP, Ii as systemEventDeliveryProblems, In as alertEpisodeId, Ir as isKnownTemplateVar, It as NcRuleInputSchema, J as MAX_BIRTH_DECISION_RECORDS, Ji as canonicalHash, Jn as buildSubjectPath, Jr as memoizePinnedFfmpeg, Jt as NcTaxonomySchema, K as LockStateSchema, Ki as zoneAnalyticsCapability, Kn as audioModeOf, Kr as linkedStepOf, Kt as NcStateSummarySectionIdSchema, L as EVENT_OWNER_TYPES, Li as systemEventFamilyProblems, Ln as alertEpisodeKind, Lr as isLabelSupplyStepId, Lt as NcRulePatchSchema, M as EMBEDDING_MODEL_FAILED, Mi as subjectPathSampleFromBox, Mn as activateAlarmProfile, Mr as isDetectionMacroClass, Mt as NcAlarmSettingsPatchSchema, N as EMBEDDING_REQUIREMENTS_FAILED, Ni as subjectPathSvgPoints, Nn as addonWidgetsSourceCapability, Nr as isDrawableSubjectPath, Nt as NcConditionDescriptorSchema, O as DETECTION_MACRO_CLASSES, Oa as tuple, Oi as servedTemplateVars, On as TrackRelationKindSchema, Or as isAlertEpisodeSeverity, Ot as NcAlarmConfigSchema, P as EMBEDDING_REQUIREMENTS_UNAVAILABLE, Pi as summarizeReview, Pn as alarmDeviceSecureOnArm, Pr as isEventKindLabelKey, Pt as NcConditionsSchema, Q as MOTION_CLOSE_AFTER_MS, Qi as errMsg, Qn as classifyRetrainReview, Qr as occupancyScope, Qt as OPS_LOG_DEFAULT_LIMIT, R as EXPORT_DENSE_MAX_RANGES, Ri as systemEventFilterApplies, Rn as alertEpisodePayload, Rr as isMediaOwnerType, Rt as NcRuleSchema, S as ClearTrackRelationInputSchema, Sa as object, Si as ruleDeviceCompatCapQueries, Sn as TRACK_RELATIONS_DEFAULT_LIMIT, Sr as faceGalleryCapability, St as NC_SENSOR_TRANSITION_KINDS, T as DEFAULT_DETAIL_CROP_CONVENTION, Ta as strictObject, Ti as sceneMonitorCapability, Tn as TimelapseRuleSchema, Tr as gifFromMp4Args, Tt as NC_SYSTEM_EVENT_KIND_GROUP_SPECS, U as LabelAttributionSchema, Ui as vectorDimFromBase64, Un as armRemovalReconcile, Ur as isSystemEventSummaryRule, Ut as NcSnoozeInputSchema, V as FailureCounters, Vi as templateCarriesSummary, Vn as applyNonBlockingEdit, Vr as isScheduleActive, Vt as NcScheduleSchema, W as ListTrackRelationsInputSchema, Wi as viewerLinkBaseOf, Wn as assertTimelapseCadences, Wr as isVectorIndexDimConflict, Wt as NcSnoozeSchema, X as MAX_TRACK_PURITIES, Xi as isSourceCap, Xn as bundledCamstack, Xr as normalizeNcMediaPolicy, Xt as NcTemplatePreviewSchema, Y as MAX_BIRTH_LATENCY_PROXY_MS, Yi as evaluateSensorEdge, Yn as buildViewerLink, Yr as ncMediaPolicyError, Yt as NcTemplatePreviewInputSchema, Z as MAX_TRACK_RELATIONS, Zi as DeviceType, Zn as calendarEventLocalSpan, Zr as notificationRulesCapability, Zt as NcTemplateVarDescriptorSchema, _ as BIRTH_DECISION_DEFAULT_LIMIT, _a as boolean, _n as SceneMonitorSchema, _t as NC_CONSUMABLE_SYSTEM_EVENT_KINDS, a as CLIP_EMBEDDING_STEP_ID, aa as createEvent, ai as plateGalleryCapability, an as RetrainDismissedSchema, ar as deleteAlarmProfile, at as NC_ALARM_NOTIFY_FIELDS, b as BucketAccumulator, ba as looseObject, bi as ruleAutoTriggersAlarm, bn as SetTrackRelationInputSchema, br as eventKindLabel, bt as NC_GROUPING_MAX_SEC, c as readClusterModelPinStrict, ca as defineRecordKinds, ci as readMotionTriggeredBy, cn as SCENE_CONFIRM_DEFAULT_MAX_IMAGE_PX, cr as deriveRecordingMode, ct as NC_AUDIO_CONFIRM_HITS_DEFAULT, d as APPEARANCE_BLOCKS, da as nodePin, di as resolveClipSearchMinScore, dn as SCENE_DEFAULT_CHECK_INTERVAL_SEC, dr as deviceAttentionKind, dt as NC_CLIP_PRE_ROLL_DEFAULT_SEC, ea as CAP_ADVANCE_FIELDS, ei as paletteResultSchema, en as PackageLlmVerdictSchema, er as consumableFormOf, et as MotionTriggeredBySchema, f as APPEARANCE_RESOLVES_AMBIGUITY_DEFAULT, fi as resolveDeliveryParams, fn as SCENE_DEFAULT_OBSERVATION_SPACING_SEC, fr as deviceRemovalHookCapability, ft as NC_CLIP_RETENTION_MAX_SEC, g as ArchivedDebugNoteSchema, ga as array, gi as resolveNcMediaImage, gn as SCENE_RESET_RECAPTURES, gt as NC_CONSUMABLE_LOW_PERCENT_DEFAULT, h as AlarmArmModeSchema, ha as _enum, hi as resolveModeNotifyPolicy, hn as SCENE_DIVERGED, hr as embeddingRefusalOf, ht as NC_CONFIRM_DEFAULT_TIMEOUT_MS, ia as RECORD_QUERY_MAX, ii as pipelineAnalyticsCapability, in as RebuildObjectEmbeddingsRefusalSchema, ir as createAlarmProfile, it as NC_ALARM_DELAY_MAX_SEC, j as DetectionSourceSchema, ja as EventCategory, ji as subKindsOf, jn as TrackSourceSchema, jr as isDefaultAlarmProfileId, jt as NcAlarmSensorsSchema, k as DETECTION_PIPELINE_CAP_NAME, ka as union, ki as startMoverUnderClearance, kn as TrackRelationSchema, kr as isAppLinkBase, kt as NcAlarmPostTriggeredActionSchema, l as resolveClusterModelPin, la as hydrateSchema, li as readTimelapseGeneratedAt, ln as SCENE_CONFIRM_DEFAULT_TIMEOUT_MS, lr as describeSystemEventDeliveryProblem, lt as NC_AUDIO_CONFIRM_WINDOW_SEC_DEFAULT, m as AUDIO_MACRO_LABELS, ma as ZodObject, mi as resolveModeDelays, mn as SCENE_DEFAULT_UNCOVERED_POLICY, mt as NC_CONFIRM_DEFAULT_MAX_IMAGE_PX, na as InvalidRecordError, nn as RECORDING_EXPORT_MAX_READ_BYTES, nr as coreBlockIdFromAddonId, nt as NC_ALARM_DEFAULT_TRIGGERED_DURATION_SEC, o as CLUSTER_MODEL_OWNER_ADDON_ID, oa as customAction, oi as projectSubjectPath, on as RetrainOriginSchema, or as deriveDetailCropRect, ot as NC_ALARM_SYSTEM_EVENT_KINDS, p as ARCHIVED_DEBUG_NOTES_DEFAULT_LIMIT, pa as sleep$1, pi as resolveLocationMode, pn as SCENE_DEFAULT_QUIET_SECONDS, pt as NC_CONDITION_CATALOG, q as MAX_ARCHIVED_DEBUG_NOTES, qi as DEFAULT_FIRST_SIGHTING_FRESHNESS_MS, qn as buildEventKindDescriptor, qr as mayWriteToLocation, qt as NcSystemEventKindSchema, ra as RECORD_MAX_DATA_BYTES, ri as pickFaceRescoreIntervalMinutes, rn as RECORDING_SOURCE_CAMSTACK_ADDON, rr as cosineSimilarity$1, rt as NC_ALARM_DELAY_FIELDS, s as FACE_EMBEDDING_STEP_ID, sa as defineCustomActions, si as readDeviceStateFrom, sn as RetrainStatusSchema, sr as derivePostTriggeredAction, st as NC_ALARM_TRIGGERED_MAX_SEC, t as BUILTIN_CLIP_MODELS, ta as CamProfileSchema, ti as parseAlertEpisodePayload, tr as consumableLowPercentOf, tt as NC_ALARM_DEFAULT_PROFILE_ID, u as APPEARANCE_BIN_COUNT, ua as isDeviceScopedCap, ui as renameAlarmProfile, un as SCENE_DEFAULT_ANCHOR_THRESHOLD, ur as describeSystemEventFamilyProblem, ut as NC_CLIP_POST_ROLL_DEFAULT_SEC, v as BaseDevice, va as discriminatedUnion, vi as retrainRevisionConflictMessage, vn as SetTrackPurityInputSchema, vr as encodeVectorBase64, vt as NC_DEFAULT_SNOOZE_MINUTES, w as CoverStateSchema, wa as record, wi as ruleKindOf, wn as TimelapseRulePatchSchema, wr as gifDeriveSpeed, wt as NC_STATE_SUMMARY_SECTION_IDS, x as COCO_TO_MACRO, xa as number, xi as ruleBelongsToAlarm$1, xn as TIMELAPSE_DENSE_FLOOR_SEC, xr as evictionPolicyOfLocation, xt as NC_GROUPING_MIN_SEC, y as BirthDecisionRecordSchema, ya as literal, yi as rootSupplyServes, yn as SetTrackPurityResultSchema, yr as ensureAlarmProfiles, yt as NC_GROUPING_DEFAULT_SEC, z as FIRST_LEVEL_MACRO_CLASSES, zi as systemEventSummaryScheduleOf, zn as applyBlockingEdit, zr as isRetiredClearKey, zt as NcRuleTargetSchema } from "../clip-model-registry-BWY8P-AK.mjs";
+import { $ as MediaFileKindEnum, $i as BaseAddon, $n as cloneAlarmSettings, $r as paintHex, $t as OpsLogEntrySchema, A as DeclaredDevices, Aa as unknown, Ai as storageOccupancyCapability, An as TrackSideSchema, Ar as isAudioClassName, At as NcAlarmSensorsInputSchema, B as FULL_IMAGE_BBOX, Bi as systemEventSummarySplitOf, Bn as applyModeDelaysEdits, Br as isRootSuppliableStepId, Bt as NcRuleUpdateInputSchema, C as ClearTrackRelationResultSchema, Ca as partialRecord, Ci as ruleGroupingApplies, Cn as TimelapseRuleInputSchema, Cr as failureContributionCapability, Ct as NC_SNOOZE_MAX_MINUTES, D as DEFAULT_TIMELAPSE_PREVIEW_TEXT, Da as templateLiteral, Di as sensorRaisedOf, Dn as TrackPuritySchema, Dr as isAlertEpisodeOpen, Dt as NC_TEMPLATE_VARS, E as DEFAULT_EVENT_COLOR, Ea as string, Ei as secureActuationFor, En as TrackPlacementSchema, Er as isAlarmControllableCap, Et as NC_TAXONOMY, F as EVENT_DENSITY_BATCH_MAX, Fi as syncActiveAlarmProfileSettings, Fn as alarmPanelCapability, Fr as isEventOwnerType, Ft as NcRuleActionSchema, G as ListTrackRelationsResultSchema, Gi as withSystemEventClasses, Gn as audioMetricsCapability, Gr as kebabToCamel, Gt as NcSnoozeSuppressedSchema, H as LABEL_SUPPLY_MACRO, Hi as templateVarsFor, Hn as applySecureOnArmEdit, Hr as isSystemDelivery, Ht as NcSharedSequenceSchema, I as EVENT_KIND_BY_CAP, Ii as systemEventDeliveryProblems, In as alertEpisodeId, Ir as isKnownTemplateVar, It as NcRuleInputSchema, J as MAX_BIRTH_DECISION_RECORDS, Ji as canonicalHash, Jn as buildSubjectPath, Jr as memoizePinnedFfmpeg, Jt as NcTaxonomySchema, K as LockStateSchema, Ki as zoneAnalyticsCapability, Kn as audioModeOf, Kr as linkedStepOf, Kt as NcStateSummarySectionIdSchema, L as EVENT_OWNER_TYPES, Li as systemEventFamilyProblems, Ln as alertEpisodeKind, Lr as isLabelSupplyStepId, Lt as NcRulePatchSchema, M as EMBEDDING_MODEL_FAILED, Mi as subjectPathSampleFromBox, Mn as activateAlarmProfile, Mr as isDetectionMacroClass, Mt as NcAlarmSettingsPatchSchema, N as EMBEDDING_REQUIREMENTS_FAILED, Ni as subjectPathSvgPoints, Nn as addonWidgetsSourceCapability, Nr as isDrawableSubjectPath, Nt as NcConditionDescriptorSchema, O as DETECTION_MACRO_CLASSES, Oa as tuple, Oi as servedTemplateVars, On as TrackRelationKindSchema, Or as isAlertEpisodeSeverity, Ot as NcAlarmConfigSchema, P as EMBEDDING_REQUIREMENTS_UNAVAILABLE, Pi as summarizeReview, Pn as alarmDeviceSecureOnArm, Pr as isEventKindLabelKey, Pt as NcConditionsSchema, Q as MOTION_CLOSE_AFTER_MS, Qi as errMsg, Qn as classifyRetrainReview, Qr as occupancyScope, Qt as OPS_LOG_DEFAULT_LIMIT, R as EXPORT_DENSE_MAX_RANGES, Ri as systemEventFilterApplies, Rn as alertEpisodePayload, Rr as isMediaOwnerType, Rt as NcRuleSchema, S as ClearTrackRelationInputSchema, Sa as object, Si as ruleDeviceCompatCapQueries, Sn as TRACK_RELATIONS_DEFAULT_LIMIT, Sr as faceGalleryCapability, St as NC_SENSOR_TRANSITION_KINDS, T as DEFAULT_DETAIL_CROP_CONVENTION, Ta as strictObject, Ti as sceneMonitorCapability, Tn as TimelapseRuleSchema, Tr as gifFromMp4Args, Tt as NC_SYSTEM_EVENT_KIND_GROUP_SPECS, U as LabelAttributionSchema, Ui as vectorDimFromBase64, Un as armRemovalReconcile, Ur as isSystemEventSummaryRule, Ut as NcSnoozeInputSchema, V as FailureCounters, Vi as templateCarriesSummary, Vn as applyNonBlockingEdit, Vr as isScheduleActive, Vt as NcScheduleSchema, W as ListTrackRelationsInputSchema, Wi as viewerLinkBaseOf, Wn as assertTimelapseCadences, Wr as isVectorIndexDimConflict, Wt as NcSnoozeSchema, X as MAX_TRACK_PURITIES, Xi as isSourceCap, Xn as bundledCamstack, Xr as normalizeNcMediaPolicy, Xt as NcTemplatePreviewSchema, Y as MAX_BIRTH_LATENCY_PROXY_MS, Yi as evaluateSensorEdge, Yn as buildViewerLink, Yr as ncMediaPolicyError, Yt as NcTemplatePreviewInputSchema, Z as MAX_TRACK_RELATIONS, Zi as DeviceType, Zn as calendarEventLocalSpan, Zr as notificationRulesCapability, Zt as NcTemplateVarDescriptorSchema, _ as BIRTH_DECISION_DEFAULT_LIMIT, _a as boolean, _n as SceneMonitorSchema, _t as NC_CONSUMABLE_SYSTEM_EVENT_KINDS, a as CLIP_EMBEDDING_STEP_ID, aa as createEvent, ai as plateGalleryCapability, an as RetrainDismissedSchema, ar as deleteAlarmProfile, at as NC_ALARM_NOTIFY_FIELDS, b as BucketAccumulator, ba as looseObject, bi as ruleAutoTriggersAlarm, bn as SetTrackRelationInputSchema, br as eventKindLabel, bt as NC_GROUPING_MAX_SEC, c as readClusterModelPinStrict, ca as defineRecordKinds, ci as readMotionTriggeredBy, cn as SCENE_CONFIRM_DEFAULT_MAX_IMAGE_PX, cr as deriveRecordingMode, ct as NC_AUDIO_CONFIRM_HITS_DEFAULT, d as APPEARANCE_BLOCKS, da as nodePin, di as resolveClipSearchMinScore, dn as SCENE_DEFAULT_CHECK_INTERVAL_SEC, dr as deviceAttentionKind, dt as NC_CLIP_PRE_ROLL_DEFAULT_SEC, ea as CAP_ADVANCE_FIELDS, ei as paletteResultSchema, en as PackageLlmVerdictSchema, er as consumableFormOf, et as MotionTriggeredBySchema, f as APPEARANCE_RESOLVES_AMBIGUITY_DEFAULT, fi as resolveDeliveryParams, fn as SCENE_DEFAULT_OBSERVATION_SPACING_SEC, fr as deviceRemovalHookCapability, ft as NC_CLIP_RETENTION_MAX_SEC, g as ArchivedDebugNoteSchema, ga as array, gi as resolveNcMediaImage, gn as SCENE_RESET_RECAPTURES, gt as NC_CONSUMABLE_LOW_PERCENT_DEFAULT, h as AlarmArmModeSchema, ha as _enum, hi as resolveModeNotifyPolicy, hn as SCENE_DIVERGED, hr as embeddingRefusalOf, ht as NC_CONFIRM_DEFAULT_TIMEOUT_MS, ia as RECORD_QUERY_MAX, ii as pipelineAnalyticsCapability, in as RebuildObjectEmbeddingsRefusalSchema, ir as createAlarmProfile, it as NC_ALARM_DELAY_MAX_SEC, j as DetectionSourceSchema, ja as EventCategory, ji as subKindsOf, jn as TrackSourceSchema, jr as isDefaultAlarmProfileId, jt as NcAlarmSensorsSchema, k as DETECTION_PIPELINE_CAP_NAME, ka as union, ki as startMoverUnderClearance, kn as TrackRelationSchema, kr as isAppLinkBase, kt as NcAlarmPostTriggeredActionSchema, l as resolveClusterModelPin, la as hydrateSchema, li as readTimelapseGeneratedAt, ln as SCENE_CONFIRM_DEFAULT_TIMEOUT_MS, lr as describeSystemEventDeliveryProblem, lt as NC_AUDIO_CONFIRM_WINDOW_SEC_DEFAULT, m as AUDIO_MACRO_LABELS, ma as ZodObject, mi as resolveModeDelays, mn as SCENE_DEFAULT_UNCOVERED_POLICY, mt as NC_CONFIRM_DEFAULT_MAX_IMAGE_PX, na as InvalidRecordError, nn as RECORDING_EXPORT_MAX_READ_BYTES, nr as coreBlockIdFromAddonId, nt as NC_ALARM_DEFAULT_TRIGGERED_DURATION_SEC, o as CLUSTER_MODEL_OWNER_ADDON_ID, oa as customAction, oi as projectSubjectPath, on as RetrainOriginSchema, or as deriveDetailCropRect, ot as NC_ALARM_SYSTEM_EVENT_KINDS, p as ARCHIVED_DEBUG_NOTES_DEFAULT_LIMIT, pa as sleep$1, pi as resolveLocationMode, pn as SCENE_DEFAULT_QUIET_SECONDS, pt as NC_CONDITION_CATALOG, q as MAX_ARCHIVED_DEBUG_NOTES, qi as DEFAULT_FIRST_SIGHTING_FRESHNESS_MS, qn as buildEventKindDescriptor, qr as mayWriteToLocation, qt as NcSystemEventKindSchema, ra as RECORD_MAX_DATA_BYTES, ri as pickFaceRescoreIntervalMinutes, rn as RECORDING_SOURCE_CAMSTACK_ADDON, rr as cosineSimilarity$1, rt as NC_ALARM_DELAY_FIELDS, s as FACE_EMBEDDING_STEP_ID, sa as defineCustomActions, si as readDeviceStateFrom, sn as RetrainStatusSchema, sr as derivePostTriggeredAction, st as NC_ALARM_TRIGGERED_MAX_SEC, t as BUILTIN_CLIP_MODELS, ta as CamProfileSchema, ti as parseAlertEpisodePayload, tr as consumableLowPercentOf, tt as NC_ALARM_DEFAULT_PROFILE_ID, u as APPEARANCE_BIN_COUNT, ua as isDeviceScopedCap, ui as renameAlarmProfile, un as SCENE_DEFAULT_ANCHOR_THRESHOLD, ur as describeSystemEventFamilyProblem, ut as NC_CLIP_POST_ROLL_DEFAULT_SEC, v as BaseDevice, va as discriminatedUnion, vi as retrainRevisionConflictMessage, vn as SetTrackPurityInputSchema, vr as encodeVectorBase64, vt as NC_DEFAULT_SNOOZE_MINUTES, w as CoverStateSchema, wa as record, wi as ruleKindOf, wn as TimelapseRulePatchSchema, wr as gifDeriveSpeed, wt as NC_STATE_SUMMARY_SECTION_IDS, x as COCO_TO_MACRO, xa as number, xi as ruleBelongsToAlarm$1, xn as TIMELAPSE_DENSE_FLOOR_SEC, xr as evictionPolicyOfLocation, xt as NC_GROUPING_MIN_SEC, y as BirthDecisionRecordSchema, ya as literal, yi as rootSupplyServes, yn as SetTrackPurityResultSchema, yr as ensureAlarmProfiles, yt as NC_GROUPING_DEFAULT_SEC, z as FIRST_LEVEL_MACRO_CLASSES, zi as systemEventSummaryScheduleOf, zn as applyBlockingEdit, zr as isRetiredClearKey, zt as NcRuleTargetSchema } from "../clip-model-registry-BrazZJvr.mjs";
 import { t as __exportAll } from "../embedding-encoder/index.mjs";
 import * as fs$1 from "node:fs";
 import { createWriteStream, promises } from "node:fs";
@@ -9055,6 +9055,7 @@ var en_default = {
 	"system.node-offline.body.agent": "Agent {{nodeName}} is offline",
 	"system.node-offline.body.agent.connection-lost": "Agent {{nodeName}} lost its connection to the hub",
 	"system.node-offline.body.agent.shutdown": "Agent {{nodeName}} shut down",
+	"system.node-offline.body.agent.updating": "Agent {{nodeName}} went offline while updating and has not come back after {{graceMin}} minutes",
 	"system.node-inference-unavailable.title": "Node cannot infer — {{nodeId}}",
 	"system.node-inference-unavailable.body": "Node {{nodeId}} can no longer run inference — every enabled device is unavailable ({{devices}}). It will not receive cameras until one returns.",
 	"system.addon-crash-loop.title": "Addon crash-loop — {{nodeId}}",
@@ -9459,6 +9460,7 @@ var it_default = {
 	"system.node-offline.body.agent": "L'agent {{nodeName}} è offline",
 	"system.node-offline.body.agent.connection-lost": "L'agent {{nodeName}} ha perso la connessione con l'hub",
 	"system.node-offline.body.agent.shutdown": "L'agent {{nodeName}} si è spento",
+	"system.node-offline.body.agent.updating": "L'agent {{nodeName}} è andato offline durante un aggiornamento e non è tornato dopo {{graceMin}} minuti",
 	"system.node-inference-unavailable.title": "Nodo senza inferenza — {{nodeId}}",
 	"system.node-inference-unavailable.body": "Il nodo {{nodeId}} non può più eseguire inferenza — tutti i dispositivi abilitati non sono disponibili ({{devices}}). Non riceverà camere finché uno non torna disponibile.",
 	"system.addon-crash-loop.title": "Crash-loop addon — {{nodeId}}",
@@ -70412,7 +70414,12 @@ Object.freeze({
 	"calendar-source": ["listCalendars", "listEvents"],
 	"custom-model-registry": ["listModels"],
 	"data-store-provider": ["histogram", "query"],
-	"device-export": ["listExposedDevices", "listSupportedDeviceKinds"],
+	"device-export": [
+		"listExposedDevices",
+		"listExposedEntities",
+		"listSupportedDeviceKinds",
+		"listSupportedEntityKinds"
+	],
 	"device-extension": ["listSlots", "listSources"],
 	"device-provider": ["discoverDevices", "getDevices"],
 	"device-removal-hook": ["listDeviceData"],
@@ -70437,6 +70444,7 @@ Object.freeze({
 		"listTargets"
 	],
 	"recording": ["listSources"],
+	"remote-layout-components": ["listComponents"],
 	"storage-occupancy": ["getOccupancy"],
 	"storage-provider": ["list"],
 	"template": ["list"],
@@ -70451,6 +70459,12 @@ Object.freeze({
 	"videoclips": ["listClips", "listSources"]
 });
 Object.freeze({
+	"device-export": [
+		"exposeEntity",
+		"listExposedEntities",
+		"listSupportedEntityKinds",
+		"unexposeEntity"
+	],
 	"log-destination": [
 		"cancelRead",
 		"describeRead",
@@ -80658,12 +80672,13 @@ function incomingFromNodeRestarting(facts, data) {
 		nodeIds: [nodeId]
 	});
 	const packageName = stringField(data, "packageName") ?? "@camstack/server";
+	const what = stringField(data, "what");
 	const fromVersion = stringField(data, "fromVersion");
 	const bodyKey = toVersion === void 0 ? "system.node-updating.body.plain" : fromVersion === void 0 ? "system.node-updating.body.toOnly" : "system.node-updating.body";
 	return systemSubject({
 		facts,
 		kind: "node-updating",
-		subject: `node-updating:${nodeId}:${toVersion ?? "unknown"}`,
+		subject: what === void 0 || what === "server" ? `node-updating:${nodeId}:${toVersion ?? "unknown"}` : `node-updating:${nodeId}:${what}:${toVersion ?? "unknown"}`,
 		titleKey: "system.node-updating.title",
 		bodyKey,
 		textParams: {
@@ -90165,13 +90180,17 @@ var DeviceLivenessHoldoff = class {
 	rememberIfAbsent(subject, state) {
 		if (!this.lastNotified.has(subject)) this.lastNotified.set(subject, state);
 	}
-	/** A real ledger flip. Starts / resets the trailing timer. */
-	arm(subject, incoming) {
+	/**
+	* A real ledger flip. Starts / resets the trailing timer. `delayMs` replaces
+	* the default delay for THIS arm only (a node's planned-update grace).
+	*/
+	arm(subject, incoming, delayMs) {
+		const delay = delayMs ?? this.delayMs;
 		this.pending.set(subject, incoming);
 		this.trackDeparture(subject, incoming);
 		const existing = this.timers.get(subject);
 		if (existing !== void 0) this.cancel(existing);
-		if (this.delayMs <= 0) {
+		if (delay <= 0) {
 			this.timers.delete(subject);
 			this.fire(subject);
 			return;
@@ -90179,7 +90198,7 @@ var DeviceLivenessHoldoff = class {
 		const id = this.schedule(() => {
 			this.timers.delete(subject);
 			this.fire(subject);
-		}, this.delayMs);
+		}, delay);
 		this.timers.set(subject, id);
 	}
 	dispose() {
@@ -92826,6 +92845,71 @@ var NcRuleStore = class NcRuleStore {
 	}
 };
 //#endregion
+//#region src/notification-center/planned-update-window.ts
+/**
+* A node that ANNOUNCED an update is expected to go offline — the window that
+* says so lives here.
+*
+* `system.restarting` becomes `node-updating` / `node-restarting`; the centre
+* records the announcement per node (RAM, refreshed by the event, never by a
+* read — D49). An offline for that node inside {@link PLANNED_UPDATE_OFFLINE_GRACE_MS}
+* of the announcement is held for the whole window instead of the usual 60 s
+* hold-off: back in time means no offline notification at all, not back means
+* one offline that says it happened during an update. A lost announcement
+* (events may be dropped, D8) simply behaves as before.
+*/
+/** How long after an announcement an offline is held, and how long the announcement counts. */
+var PLANNED_UPDATE_OFFLINE_GRACE_MS = 10 * 6e4;
+var NC_PLANNED_UPDATE_NODES_MAX = 256;
+var NcPlannedUpdateWindow = class {
+	graceMs;
+	/** Insertion-ordered: the oldest node is evicted first. */
+	announcedAt = /* @__PURE__ */ new Map();
+	/** When an offline was put on hold, per node. */
+	heldAt = /* @__PURE__ */ new Map();
+	constructor(graceMs = PLANNED_UPDATE_OFFLINE_GRACE_MS) {
+		this.graceMs = graceMs;
+	}
+	get windowMs() {
+		return this.graceMs;
+	}
+	get graceMinutes() {
+		return Math.round(this.graceMs / 6e4);
+	}
+	/** Feed every system subject the intake accepted; only the two announcements are kept. */
+	observe(system, atMs) {
+		if (system.kind !== "node-updating" && system.kind !== "node-restarting") return;
+		const nodeId = system.nodeId;
+		if (nodeId === void 0) return;
+		this.announcedAt.delete(nodeId);
+		this.announcedAt.set(nodeId, atMs);
+		while (this.announcedAt.size > NC_PLANNED_UPDATE_NODES_MAX) {
+			const oldest = this.announcedAt.keys().next();
+			if (oldest.done === true) break;
+			this.announcedAt.delete(oldest.value);
+		}
+	}
+	/** True when the node announced an update no longer than the window ago. */
+	isPlanned(nodeId, atMs) {
+		const at = this.announcedAt.get(nodeId);
+		return at !== void 0 && atMs - at <= this.graceMs;
+	}
+	/** An offline was put on hold for this node. */
+	hold(nodeId, atMs) {
+		this.heldAt.set(nodeId, atMs);
+	}
+	/**
+	* The node is back: seconds the held offline lasted, or `null` when no offline
+	* was held, or its window already ran out (the offline was sent).
+	*/
+	release(nodeId, atMs) {
+		const at = this.heldAt.get(nodeId);
+		if (at === void 0) return null;
+		this.heldAt.delete(nodeId);
+		return atMs - at < this.graceMs ? Math.round((atMs - at) / 1e3) : null;
+	}
+};
+//#endregion
 //#region src/notification-center/restart-supersede.ts
 /** How many landings are remembered — one per node per update, so a fleet's worth. */
 var NC_UPDATE_LANDINGS_MAX = 256;
@@ -101786,6 +101870,7 @@ function onSystemEvent(host, event) {
 	const system = incoming.subject.systemEvent;
 	if (system !== void 0) host.stateSummary.observeSystem(system, host.now());
 	if (system !== void 0) host.updateLandings.observe(system, host.now());
+	if (system !== void 0) host.plannedUpdates.observe(system, host.now());
 	const observation = system !== void 0 ? ledgeredLiveness(system) : null;
 	if (observation !== null) {
 		const previous = host.liveness.stateOf(observation.subject);
@@ -101812,7 +101897,11 @@ function onSystemEvent(host, event) {
 			});
 			return;
 		}
-		if (isDeviceLivenessKind(observation.kind) || isNodeLivenessKind(observation.kind)) {
+		if (isNodeLivenessKind(observation.kind) && system !== void 0) {
+			armNodeLiveness(host, holdoff, observation.subject, incoming, system);
+			return;
+		}
+		if (isDeviceLivenessKind(observation.kind)) {
 			holdoff.arm(observation.subject, incoming);
 			return;
 		}
@@ -101823,6 +101912,50 @@ function onSystemEvent(host, event) {
 	host.consumeEvent(incoming);
 }
 /**
+* Arm a node liveness flip. An OFFLINE of a node that announced an update is
+* held for the whole planned-update window and worded as such if it is still
+* sent; the node's return inside the window is logged and sends nothing (the
+* hold-off sees the state bounce back to the one last notified).
+*/
+function armNodeLiveness(host, holdoff, subject, incoming, system) {
+	const nodeId = system.nodeId;
+	const now = host.now();
+	if (nodeId === void 0) {
+		holdoff.arm(subject, incoming);
+		return;
+	}
+	const window = host.plannedUpdates;
+	if (system.kind === "node-offline" && window.isPlanned(nodeId, now)) {
+		window.hold(nodeId, now);
+		holdoff.arm(subject, withPlannedUpdateWording(incoming, system, window.graceMinutes), window.windowMs);
+		return;
+	}
+	if (system.kind === "node-online") {
+		const backAfterSec = window.release(nodeId, now);
+		if (backAfterSec !== null) host.logger.info(`node ${nodeId}: offline suppressed: planned update, back after ${backAfterSec}s`, { meta: {
+			nodeId,
+			backAfterSec
+		} });
+	}
+	holdoff.arm(subject, incoming);
+}
+function withPlannedUpdateWording(incoming, system, graceMin) {
+	return {
+		...incoming,
+		subject: {
+			...incoming.subject,
+			systemEvent: {
+				...system,
+				bodyKey: "system.node-offline.body.agent.updating",
+				textParams: {
+					...system.textParams,
+					graceMin: String(graceMin)
+				}
+			}
+		}
+	};
+}
+/**
 * One edge of an alert episode, from the bus or from the reconcile. The
 * ledger decides whether it is news; only news reaches the rules.
 */
@@ -105641,6 +105774,7 @@ var NotificationCenter = class {
 	stateSummary;
 	/** Every `server-updated` heard, so a stale `node-updating` is not sent after it (D723). */
 	updateLandings = new NcUpdateLandings();
+	plannedUpdates = new NcPlannedUpdateWindow();
 	/** States the `deviceState` rule gate reads. Refreshed on the reload tick;
 	*  read with no I/O on the persist hook. */
 	deviceStates;
@@ -107033,6 +107167,9 @@ var NotificationCenter = class {
 			get timelapseRules() {
 				return self.timelapseRules;
 			},
+			get plannedUpdates() {
+				return self.plannedUpdates;
+			},
 			get updateLandings() {
 				return self.updateLandings;
 			},

package/dist/pipeline-analytics/remoteEntry.js

@@ -30,7 +30,7 @@ async function d(e) {
 	}
 }
 async function f() {
-	return l ||= d(() => import("./_virtual_mf-localSharedImportMap___mfe_internal__addon_pipeline_analytics_widgets-_vVfXkDx.mjs")).catch((e) => {
+	return l ||= d(() => import("./_virtual_mf-localSharedImportMap___mfe_internal__addon_pipeline_analytics_widgets-D6DnF6Vk.mjs")).catch((e) => {
 		throw l = void 0, e;
 	}), l;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-post-analysis",
-  "version": "1.2.651",
+  "version": "1.2.653",
   "description": "Post-Analysis bundle — enrichment, embedding-encoder, pipeline-analytics. Multi-entry npm package shipping addons that consume pipeline output.",
   "keywords": [
     "camstack",