@camstack/addon-provider-hikvision 1.2.142 → 1.2.144

package/dist/addon.js

@@ -10802,6 +10802,57 @@ var ClipSearchStrictnessSchema = _enum([
 	"balanced",
 	"strict"
 ]);
+new Set([
+	{
+		id: "person",
+		name: "Person"
+	},
+	{
+		id: "vehicle",
+		name: "Vehicle"
+	},
+	{
+		id: "animal",
+		name: "Animal"
+	},
+	{
+		id: "package",
+		name: "Package"
+	}
+].map((l) => l.id));
+var COCO_TO_MACRO = {
+	mapping: {
+		person: "person",
+		bicycle: "vehicle",
+		car: "vehicle",
+		motorcycle: "vehicle",
+		airplane: "vehicle",
+		bus: "vehicle",
+		train: "vehicle",
+		truck: "vehicle",
+		boat: "vehicle",
+		bird: "animal",
+		cat: "animal",
+		dog: "animal",
+		horse: "animal",
+		sheep: "animal",
+		cow: "animal",
+		elephant: "animal",
+		bear: "animal",
+		zebra: "animal",
+		giraffe: "animal",
+		suitcase: "package",
+		backpack: "package",
+		handbag: "package"
+	},
+	preserveOriginal: false
+};
+/** Steps a root detector may declare it fills. */
+var FILLABLE_STEP_IDS = [
+	"animal-classifier",
+	"vehicle-classifier",
+	"package-detection"
+];
 var MODEL_FORMATS = [
 	"onnx",
 	"coreml",
@@ -10934,6 +10985,12 @@ var ModelLicenseSchema = preprocess((value) => typeof value === "string" ? { wei
 	/** True when the weights or their data forbid commercial use. */
 	nonCommercial: boolean().optional()
 }));
+/** One `fillsClassifierEffects` entry — see `ModelCatalogEntry.fillsClassifierEffects`. */
+var FillsClassifierEffectSchema = object({
+	stepId: _enum(FILLABLE_STEP_IDS),
+	labelToEffect: record(string(), string()),
+	uncovered: array(string()).readonly()
+});
 var ModelCatalogEntrySchema = object({
 	id: string(),
 	name: string(),
@@ -11060,6 +11117,16 @@ var ModelCatalogEntrySchema = object({
 	*/
 	classMap: DetectionCatalogClassMapSchema.optional(),
 	/**
+	* The pipeline steps this ROOT detector already does the work of (D715):
+	* its labels name the effect the step exists to produce (`deer` for
+	* `animal-classifier`, `package` for `package-detection`). Derived from the
+	* labelmap by `deriveClassifierFills`, never hand-written; a COCO model
+	* declares none. Whether a declaration is honoured is the step's own
+	* `labelLink` policy (`resolveLabelLink`). `labelToEffect` values are in
+	* `FILLABLE_STEP_VOCABULARIES` (guard `check-label-link-vocabulary`).
+	*/
+	fillsClassifierEffects: array(FillsClassifierEffectSchema).readonly().optional(),
+	/**
 	* The model's CLIP feature-space contract (text encoder, dimension, vector
 	* index, token window, search floor) — see `clip-model.ts`. Present ONLY on a
 	* CLIP image encoder; its absence is what "not a CLIP model" means to the
@@ -18402,51 +18469,6 @@ method(object({}), array(TargetKindSchema)), method(object({}), array(TargetSche
 	kind: "mutation",
 	auth: "admin"
 });
-new Set([
-	{
-		id: "person",
-		name: "Person"
-	},
-	{
-		id: "vehicle",
-		name: "Vehicle"
-	},
-	{
-		id: "animal",
-		name: "Animal"
-	},
-	{
-		id: "package",
-		name: "Package"
-	}
-].map((l) => l.id));
-var COCO_TO_MACRO = {
-	mapping: {
-		person: "person",
-		bicycle: "vehicle",
-		car: "vehicle",
-		motorcycle: "vehicle",
-		airplane: "vehicle",
-		bus: "vehicle",
-		train: "vehicle",
-		truck: "vehicle",
-		boat: "vehicle",
-		bird: "animal",
-		cat: "animal",
-		dog: "animal",
-		horse: "animal",
-		sheep: "animal",
-		cow: "animal",
-		elephant: "animal",
-		bear: "animal",
-		zebra: "animal",
-		giraffe: "animal",
-		suitcase: "package",
-		backpack: "package",
-		handbag: "package"
-	},
-	preserveOriginal: false
-};
 var AUDIO_MACRO_LABELS = [
 	{
 		id: "speech",
@@ -19242,6 +19264,8 @@ var NcSystemEventKindSchema = _enum([
 	"stream-offline",
 	"node-online",
 	"node-offline",
+	"node-restarting",
+	"node-updating",
 	"node-inference-unavailable",
 	"detection-blind",
 	"addon-crash-loop",
@@ -23888,7 +23912,8 @@ var PipelineModelOptionSchema = object({
 	group: ModelVariantGroupSchema.optional(),
 	legacy: boolean().optional(),
 	provider: ModelProviderIdSchema.optional(),
-	defaultConfidence: number().optional()
+	defaultConfidence: number().optional(),
+	fillsClassifierEffects: array(FillsClassifierEffectSchema).readonly().optional()
 });
 var ConfigFieldBridge = custom();
 var PipelineAddonSchemaSchema = object({
@@ -33567,7 +33592,8 @@ var MotionStatusSchema = object({
 	*   writes this slice (not even a boot seed), and neither does the runner's
 	*   phase machine: its phase is "a session is attached" for every on-motion
 	*   session, not motion, and it now has its own `DetectionPhaseTransition`.
-	*   A provider's `isDetected` answers from the hub's slice.
+	*   A provider's `isDetected` and `getStatus` answer from the hub's slice
+	*   (`hubMotionNativeProvider`).
 	* - **Sensors** (Home Assistant binary sensors, Homematic, Matter, Alexa
 	*   imports) — the provider pushes both edges itself, from the upstream
 	*   system's own state change. That is the sensor's own fact.
@@ -53831,6 +53857,8 @@ new Map(Object.entries({
 	"detection-blind": "device-events",
 	"node-online": "system",
 	"node-offline": "system",
+	"node-restarting": "system",
+	"node-updating": "system",
 	"node-inference-unavailable": "system",
 	"addon-crash-loop": "system",
 	"addon-update-available": "system",
@@ -53908,6 +53936,7 @@ var NC_SYSTEM_EVENT_KIND_GROUP_SPECS = [
 		kinds: [
 			"node-offline",
 			"node-online",
+			"node-restarting",
 			"node-inference-unavailable"
 		]
 	},
@@ -53929,6 +53958,7 @@ var NC_SYSTEM_EVENT_KIND_GROUP_SPECS = [
 		label: "Server & container updates",
 		kinds: [
 			"server-update-available",
+			"node-updating",
 			"server-updated",
 			"wrapper-update-available"
 		]
@@ -54076,6 +54106,7 @@ var STATE_SUMMARY_SECTION_VARS = [
 		kinds: [
 			"node-offline",
 			"node-online",
+			"node-restarting",
 			"node-inference-unavailable"
 		]
 	},
@@ -54097,6 +54128,7 @@ var STATE_SUMMARY_SECTION_VARS = [
 		example: "server 1.2.377 → 1.2.378",
 		kinds: [
 			"server-update-available",
+			"node-updating",
 			"server-updated",
 			"wrapper-update-available"
 		]
@@ -54552,10 +54584,9 @@ TimelapseRuleInputSchema.extend({
 	createdAt: number(),
 	updatedAt: number()
 });
-async function readHubMotionDetected(deviceState, deviceId) {
-	let slice;
+async function readSlice(deviceState, deviceId) {
 	try {
-		slice = await deviceState.getCapSlice.query({
+		return await deviceState.getCapSlice.query({
 			deviceId,
 			capName: "motion"
 		});
@@ -54563,10 +54594,44 @@ async function readHubMotionDetected(deviceState, deviceId) {
 		const reason = err instanceof Error ? err.message : String(err);
 		throw new Error(`motion state of device ${deviceId} is unreadable: ${reason}`, { cause: err });
 	}
-	const detected = slice?.["detected"];
+}
+/**
+* The hub's `motion` slice as a `MotionStatus`, or `null` when nobody has
+* published it since the hub started. Throws when the hub does not answer or
+* the slice is malformed — never a made-up "no motion".
+*/
+async function readHubMotionStatus(deviceState, deviceId) {
+	const slice = await readSlice(deviceState, deviceId);
+	if (slice === null) return null;
+	const parsed = MotionStatusSchema.safeParse(slice);
+	if (!parsed.success) throw new Error(`motion state of device ${deviceId} is malformed on the hub: ${parsed.error.message}`);
+	return parsed.data;
+}
+async function readHubMotionDetected(deviceState, deviceId) {
+	const detected = (await readSlice(deviceState, deviceId))?.["detected"];
 	if (typeof detected !== "boolean") throw new Error(`motion state of device ${deviceId} is not published yet (unknown)`);
 	return detected;
 }
+/**
+* The native `motion` provider of a camera whose slice the orchestrator writes
+* (D696): `isDetected` AND `getStatus`, both from the hub. `owner` names the
+* provider class in the deviceId-mismatch error.
+*/
+function hubMotionNativeProvider(deviceState, deviceId, owner) {
+	const ownDevice = (asked) => {
+		if (asked !== deviceId) throw new Error(`${owner}: motion deviceId mismatch, expected ${deviceId}, got ${asked}`);
+	};
+	return {
+		isDetected: async ({ deviceId: asked }) => {
+			ownDevice(asked);
+			return readHubMotionDetected(deviceState, deviceId);
+		},
+		getStatus: async ({ deviceId: asked }) => {
+			ownDevice(asked);
+			return readHubMotionStatus(deviceState, deviceId);
+		}
+	};
+}
 MotionOnMotionChangedDataSchema.omit({ triggeredBy: true });
 function providerMotionEvent(source, data) {
 	return createEvent(EventCategory.ProviderMotion, source, data);
@@ -59911,6 +59976,75 @@ function createAccessoryDevice(kind, ctx, parent) {
 		default: throw new Error(`Hikvision provider does not implement accessory kind "${String(kind)}"`);
 	}
 }
+var ALARM_INGRESS_MESSAGE = "hikvision: alarm event received";
+var countsRecord = (counts) => Object.fromEntries(counts);
+function createAlarmIngressLog(deps) {
+	const intervalMs = deps.intervalMs ?? 6e4;
+	const bursts = /* @__PURE__ */ new Map();
+	const tags = { deviceId: deps.deviceId };
+	const received = (ev) => {
+		const existing = bursts.get(ev.camStreamId);
+		const burst = existing ?? {
+			startedAt: ev.at,
+			lastLineAt: ev.at,
+			counts: /* @__PURE__ */ new Map(),
+			types: /* @__PURE__ */ new Set(),
+			ticks: 0
+		};
+		if (!existing) bursts.set(ev.camStreamId, burst);
+		burst.ticks += 1;
+		if (!burst.types.has(ev.type)) {
+			burst.types.add(ev.type);
+			deps.logger.info(ALARM_INGRESS_MESSAGE, {
+				tags,
+				meta: {
+					edge: "start",
+					type: ev.type,
+					state: ev.state,
+					camStreamId: ev.camStreamId,
+					...ev.aiClass === null ? {} : { aiClass: ev.aiClass },
+					...existing ? { burstAgeMs: ev.at - burst.startedAt } : {}
+				}
+			});
+			burst.lastLineAt = Math.max(burst.lastLineAt, ev.at);
+			return;
+		}
+		burst.counts.set(ev.type, (burst.counts.get(ev.type) ?? 0) + 1);
+		if (ev.at - burst.lastLineAt < intervalMs) return;
+		deps.logger.info(ALARM_INGRESS_MESSAGE, {
+			tags,
+			meta: {
+				edge: "ongoing",
+				camStreamId: ev.camStreamId,
+				counts: countsRecord(burst.counts),
+				windowMs: ev.at - burst.lastLineAt,
+				burstAgeMs: ev.at - burst.startedAt
+			}
+		});
+		burst.counts.clear();
+		burst.lastLineAt = ev.at;
+	};
+	const ended = (camStreamId, at) => {
+		const burst = bursts.get(camStreamId);
+		if (!burst) return;
+		bursts.delete(camStreamId);
+		deps.logger.info(ALARM_INGRESS_MESSAGE, {
+			tags,
+			meta: {
+				edge: "end",
+				camStreamId,
+				counts: countsRecord(burst.counts),
+				ticks: burst.ticks,
+				types: [...burst.types],
+				durationMs: at - burst.startedAt
+			}
+		});
+	};
+	return {
+		received,
+		ended
+	};
+}
 function createAlarmTypeTally(deps) {
 	const intervalMs = deps.intervalMs ?? 3e5;
 	const lastLoggedAt = /* @__PURE__ */ new Map();
@@ -64297,6 +64431,20 @@ var HikvisionCamera = class HikvisionCamera extends BaseDevice {
 		});
 		return this.unhandledAlarmsTally;
 	}
+	/**
+	* Sampled info-level ingress line for the motion-bearing alarms (VMD and
+	* smart events): one at each burst's start, one per minute while it lasts,
+	* one at its end — never one per ~1 Hz tick. Lazy for the same reason as
+	* `unhandledAlarms`.
+	*/
+	motionIngressLog = null;
+	get motionIngress() {
+		this.motionIngressLog ??= createAlarmIngressLog({
+			logger: this.ctx.logger,
+			deviceId: this.id
+		});
+		return this.motionIngressLog;
+	}
 	/** Hysteresis: drop motion-active back to inactive after this many ms with
 	*  no fresh `VMD` event. Hikvision fires VMD every ~1s while motion is
 	*  active; missing 2 ticks signals the burst is over. */
@@ -66859,19 +67007,25 @@ var HikvisionCamera = class HikvisionCamera extends BaseDevice {
 	* The native `motion` cap. Its presence is what defaults the camera to
 	* `motionSources: ['onboard']`. This provider writes NO `motion` slice (D696):
 	* the orchestrator is its only writer, with the EFFECTIVE motion, on the hub.
-	* `isDetected` therefore answers from the hub's slice; an unreadable hub, or
-	* a slice nobody has published since the hub started, makes the call fail.
-	* It never answers `false` for "unknown" (D49, D393).
+	* `isDetected` AND `getStatus` therefore answer from the hub's slice
+	* (`hubMotionNativeProvider`; without its own `getStatus` the framework's
+	* default reads this process's empty local state and answers `null`). An
+	* unreadable hub fails both; never `false` for "unknown" (D49, D393).
 	*/
 	registerMotionCap() {
-		this.ctx.registerNativeCap(motionCapability, { isDetected: async ({ deviceId }) => {
-			if (deviceId !== this.id) throw new Error(`HikvisionCamera: deviceId mismatch, expected ${this.id}, got ${deviceId}`);
-			return readHubMotionDetected(this.ctx.api.deviceState, this.id);
-		} });
+		const motionProvider = hubMotionNativeProvider(this.ctx.api.deviceState, this.id, "HikvisionCamera");
+		this.ctx.registerNativeCap(motionCapability, motionProvider);
 	}
 	handleMotionEvent(ev, camStreamId) {
 		const now = ev.observedAt;
 		this.lastMotionAt.set(camStreamId, now);
+		this.motionIngress.received({
+			type: ev.type,
+			state: ev.state,
+			aiClass: ev.aiClass,
+			camStreamId,
+			at: now
+		});
 		this.ctx.eventBus.emit(providerMotionEvent(this.eventSource, {
 			deviceId: this.id,
 			detected: true,
@@ -66884,6 +67038,7 @@ var HikvisionCamera = class HikvisionCamera extends BaseDevice {
 			const clearedAt = Date.now();
 			this.lastMotionAt.set(camStreamId, 0);
 			this.motionInactiveTimers.delete(camStreamId);
+			this.motionIngress.ended(camStreamId, clearedAt);
 			this.ctx.eventBus.emit(providerMotionEvent(this.eventSource, {
 				deviceId: this.id,
 				detected: false,

package/dist/addon.mjs

@@ -10781,6 +10781,57 @@ var ClipSearchStrictnessSchema = _enum([
 	"balanced",
 	"strict"
 ]);
+new Set([
+	{
+		id: "person",
+		name: "Person"
+	},
+	{
+		id: "vehicle",
+		name: "Vehicle"
+	},
+	{
+		id: "animal",
+		name: "Animal"
+	},
+	{
+		id: "package",
+		name: "Package"
+	}
+].map((l) => l.id));
+var COCO_TO_MACRO = {
+	mapping: {
+		person: "person",
+		bicycle: "vehicle",
+		car: "vehicle",
+		motorcycle: "vehicle",
+		airplane: "vehicle",
+		bus: "vehicle",
+		train: "vehicle",
+		truck: "vehicle",
+		boat: "vehicle",
+		bird: "animal",
+		cat: "animal",
+		dog: "animal",
+		horse: "animal",
+		sheep: "animal",
+		cow: "animal",
+		elephant: "animal",
+		bear: "animal",
+		zebra: "animal",
+		giraffe: "animal",
+		suitcase: "package",
+		backpack: "package",
+		handbag: "package"
+	},
+	preserveOriginal: false
+};
+/** Steps a root detector may declare it fills. */
+var FILLABLE_STEP_IDS = [
+	"animal-classifier",
+	"vehicle-classifier",
+	"package-detection"
+];
 var MODEL_FORMATS = [
 	"onnx",
 	"coreml",
@@ -10913,6 +10964,12 @@ var ModelLicenseSchema = preprocess((value) => typeof value === "string" ? { wei
 	/** True when the weights or their data forbid commercial use. */
 	nonCommercial: boolean().optional()
 }));
+/** One `fillsClassifierEffects` entry — see `ModelCatalogEntry.fillsClassifierEffects`. */
+var FillsClassifierEffectSchema = object({
+	stepId: _enum(FILLABLE_STEP_IDS),
+	labelToEffect: record(string(), string()),
+	uncovered: array(string()).readonly()
+});
 var ModelCatalogEntrySchema = object({
 	id: string(),
 	name: string(),
@@ -11039,6 +11096,16 @@ var ModelCatalogEntrySchema = object({
 	*/
 	classMap: DetectionCatalogClassMapSchema.optional(),
 	/**
+	* The pipeline steps this ROOT detector already does the work of (D715):
+	* its labels name the effect the step exists to produce (`deer` for
+	* `animal-classifier`, `package` for `package-detection`). Derived from the
+	* labelmap by `deriveClassifierFills`, never hand-written; a COCO model
+	* declares none. Whether a declaration is honoured is the step's own
+	* `labelLink` policy (`resolveLabelLink`). `labelToEffect` values are in
+	* `FILLABLE_STEP_VOCABULARIES` (guard `check-label-link-vocabulary`).
+	*/
+	fillsClassifierEffects: array(FillsClassifierEffectSchema).readonly().optional(),
+	/**
 	* The model's CLIP feature-space contract (text encoder, dimension, vector
 	* index, token window, search floor) — see `clip-model.ts`. Present ONLY on a
 	* CLIP image encoder; its absence is what "not a CLIP model" means to the
@@ -18381,51 +18448,6 @@ method(object({}), array(TargetKindSchema)), method(object({}), array(TargetSche
 	kind: "mutation",
 	auth: "admin"
 });
-new Set([
-	{
-		id: "person",
-		name: "Person"
-	},
-	{
-		id: "vehicle",
-		name: "Vehicle"
-	},
-	{
-		id: "animal",
-		name: "Animal"
-	},
-	{
-		id: "package",
-		name: "Package"
-	}
-].map((l) => l.id));
-var COCO_TO_MACRO = {
-	mapping: {
-		person: "person",
-		bicycle: "vehicle",
-		car: "vehicle",
-		motorcycle: "vehicle",
-		airplane: "vehicle",
-		bus: "vehicle",
-		train: "vehicle",
-		truck: "vehicle",
-		boat: "vehicle",
-		bird: "animal",
-		cat: "animal",
-		dog: "animal",
-		horse: "animal",
-		sheep: "animal",
-		cow: "animal",
-		elephant: "animal",
-		bear: "animal",
-		zebra: "animal",
-		giraffe: "animal",
-		suitcase: "package",
-		backpack: "package",
-		handbag: "package"
-	},
-	preserveOriginal: false
-};
 var AUDIO_MACRO_LABELS = [
 	{
 		id: "speech",
@@ -19221,6 +19243,8 @@ var NcSystemEventKindSchema = _enum([
 	"stream-offline",
 	"node-online",
 	"node-offline",
+	"node-restarting",
+	"node-updating",
 	"node-inference-unavailable",
 	"detection-blind",
 	"addon-crash-loop",
@@ -23867,7 +23891,8 @@ var PipelineModelOptionSchema = object({
 	group: ModelVariantGroupSchema.optional(),
 	legacy: boolean().optional(),
 	provider: ModelProviderIdSchema.optional(),
-	defaultConfidence: number().optional()
+	defaultConfidence: number().optional(),
+	fillsClassifierEffects: array(FillsClassifierEffectSchema).readonly().optional()
 });
 var ConfigFieldBridge = custom();
 var PipelineAddonSchemaSchema = object({
@@ -33546,7 +33571,8 @@ var MotionStatusSchema = object({
 	*   writes this slice (not even a boot seed), and neither does the runner's
 	*   phase machine: its phase is "a session is attached" for every on-motion
 	*   session, not motion, and it now has its own `DetectionPhaseTransition`.
-	*   A provider's `isDetected` answers from the hub's slice.
+	*   A provider's `isDetected` and `getStatus` answer from the hub's slice
+	*   (`hubMotionNativeProvider`).
 	* - **Sensors** (Home Assistant binary sensors, Homematic, Matter, Alexa
 	*   imports) — the provider pushes both edges itself, from the upstream
 	*   system's own state change. That is the sensor's own fact.
@@ -53810,6 +53836,8 @@ new Map(Object.entries({
 	"detection-blind": "device-events",
 	"node-online": "system",
 	"node-offline": "system",
+	"node-restarting": "system",
+	"node-updating": "system",
 	"node-inference-unavailable": "system",
 	"addon-crash-loop": "system",
 	"addon-update-available": "system",
@@ -53887,6 +53915,7 @@ var NC_SYSTEM_EVENT_KIND_GROUP_SPECS = [
 		kinds: [
 			"node-offline",
 			"node-online",
+			"node-restarting",
 			"node-inference-unavailable"
 		]
 	},
@@ -53908,6 +53937,7 @@ var NC_SYSTEM_EVENT_KIND_GROUP_SPECS = [
 		label: "Server & container updates",
 		kinds: [
 			"server-update-available",
+			"node-updating",
 			"server-updated",
 			"wrapper-update-available"
 		]
@@ -54055,6 +54085,7 @@ var STATE_SUMMARY_SECTION_VARS = [
 		kinds: [
 			"node-offline",
 			"node-online",
+			"node-restarting",
 			"node-inference-unavailable"
 		]
 	},
@@ -54076,6 +54107,7 @@ var STATE_SUMMARY_SECTION_VARS = [
 		example: "server 1.2.377 → 1.2.378",
 		kinds: [
 			"server-update-available",
+			"node-updating",
 			"server-updated",
 			"wrapper-update-available"
 		]
@@ -54531,10 +54563,9 @@ TimelapseRuleInputSchema.extend({
 	createdAt: number(),
 	updatedAt: number()
 });
-async function readHubMotionDetected(deviceState, deviceId) {
-	let slice;
+async function readSlice(deviceState, deviceId) {
 	try {
-		slice = await deviceState.getCapSlice.query({
+		return await deviceState.getCapSlice.query({
 			deviceId,
 			capName: "motion"
 		});
@@ -54542,10 +54573,44 @@ async function readHubMotionDetected(deviceState, deviceId) {
 		const reason = err instanceof Error ? err.message : String(err);
 		throw new Error(`motion state of device ${deviceId} is unreadable: ${reason}`, { cause: err });
 	}
-	const detected = slice?.["detected"];
+}
+/**
+* The hub's `motion` slice as a `MotionStatus`, or `null` when nobody has
+* published it since the hub started. Throws when the hub does not answer or
+* the slice is malformed — never a made-up "no motion".
+*/
+async function readHubMotionStatus(deviceState, deviceId) {
+	const slice = await readSlice(deviceState, deviceId);
+	if (slice === null) return null;
+	const parsed = MotionStatusSchema.safeParse(slice);
+	if (!parsed.success) throw new Error(`motion state of device ${deviceId} is malformed on the hub: ${parsed.error.message}`);
+	return parsed.data;
+}
+async function readHubMotionDetected(deviceState, deviceId) {
+	const detected = (await readSlice(deviceState, deviceId))?.["detected"];
 	if (typeof detected !== "boolean") throw new Error(`motion state of device ${deviceId} is not published yet (unknown)`);
 	return detected;
 }
+/**
+* The native `motion` provider of a camera whose slice the orchestrator writes
+* (D696): `isDetected` AND `getStatus`, both from the hub. `owner` names the
+* provider class in the deviceId-mismatch error.
+*/
+function hubMotionNativeProvider(deviceState, deviceId, owner) {
+	const ownDevice = (asked) => {
+		if (asked !== deviceId) throw new Error(`${owner}: motion deviceId mismatch, expected ${deviceId}, got ${asked}`);
+	};
+	return {
+		isDetected: async ({ deviceId: asked }) => {
+			ownDevice(asked);
+			return readHubMotionDetected(deviceState, deviceId);
+		},
+		getStatus: async ({ deviceId: asked }) => {
+			ownDevice(asked);
+			return readHubMotionStatus(deviceState, deviceId);
+		}
+	};
+}
 MotionOnMotionChangedDataSchema.omit({ triggeredBy: true });
 function providerMotionEvent(source, data) {
 	return createEvent(EventCategory.ProviderMotion, source, data);
@@ -59890,6 +59955,75 @@ function createAccessoryDevice(kind, ctx, parent) {
 		default: throw new Error(`Hikvision provider does not implement accessory kind "${String(kind)}"`);
 	}
 }
+var ALARM_INGRESS_MESSAGE = "hikvision: alarm event received";
+var countsRecord = (counts) => Object.fromEntries(counts);
+function createAlarmIngressLog(deps) {
+	const intervalMs = deps.intervalMs ?? 6e4;
+	const bursts = /* @__PURE__ */ new Map();
+	const tags = { deviceId: deps.deviceId };
+	const received = (ev) => {
+		const existing = bursts.get(ev.camStreamId);
+		const burst = existing ?? {
+			startedAt: ev.at,
+			lastLineAt: ev.at,
+			counts: /* @__PURE__ */ new Map(),
+			types: /* @__PURE__ */ new Set(),
+			ticks: 0
+		};
+		if (!existing) bursts.set(ev.camStreamId, burst);
+		burst.ticks += 1;
+		if (!burst.types.has(ev.type)) {
+			burst.types.add(ev.type);
+			deps.logger.info(ALARM_INGRESS_MESSAGE, {
+				tags,
+				meta: {
+					edge: "start",
+					type: ev.type,
+					state: ev.state,
+					camStreamId: ev.camStreamId,
+					...ev.aiClass === null ? {} : { aiClass: ev.aiClass },
+					...existing ? { burstAgeMs: ev.at - burst.startedAt } : {}
+				}
+			});
+			burst.lastLineAt = Math.max(burst.lastLineAt, ev.at);
+			return;
+		}
+		burst.counts.set(ev.type, (burst.counts.get(ev.type) ?? 0) + 1);
+		if (ev.at - burst.lastLineAt < intervalMs) return;
+		deps.logger.info(ALARM_INGRESS_MESSAGE, {
+			tags,
+			meta: {
+				edge: "ongoing",
+				camStreamId: ev.camStreamId,
+				counts: countsRecord(burst.counts),
+				windowMs: ev.at - burst.lastLineAt,
+				burstAgeMs: ev.at - burst.startedAt
+			}
+		});
+		burst.counts.clear();
+		burst.lastLineAt = ev.at;
+	};
+	const ended = (camStreamId, at) => {
+		const burst = bursts.get(camStreamId);
+		if (!burst) return;
+		bursts.delete(camStreamId);
+		deps.logger.info(ALARM_INGRESS_MESSAGE, {
+			tags,
+			meta: {
+				edge: "end",
+				camStreamId,
+				counts: countsRecord(burst.counts),
+				ticks: burst.ticks,
+				types: [...burst.types],
+				durationMs: at - burst.startedAt
+			}
+		});
+	};
+	return {
+		received,
+		ended
+	};
+}
 function createAlarmTypeTally(deps) {
 	const intervalMs = deps.intervalMs ?? 3e5;
 	const lastLoggedAt = /* @__PURE__ */ new Map();
@@ -64276,6 +64410,20 @@ var HikvisionCamera = class HikvisionCamera extends BaseDevice {
 		});
 		return this.unhandledAlarmsTally;
 	}
+	/**
+	* Sampled info-level ingress line for the motion-bearing alarms (VMD and
+	* smart events): one at each burst's start, one per minute while it lasts,
+	* one at its end — never one per ~1 Hz tick. Lazy for the same reason as
+	* `unhandledAlarms`.
+	*/
+	motionIngressLog = null;
+	get motionIngress() {
+		this.motionIngressLog ??= createAlarmIngressLog({
+			logger: this.ctx.logger,
+			deviceId: this.id
+		});
+		return this.motionIngressLog;
+	}
 	/** Hysteresis: drop motion-active back to inactive after this many ms with
 	*  no fresh `VMD` event. Hikvision fires VMD every ~1s while motion is
 	*  active; missing 2 ticks signals the burst is over. */
@@ -66838,19 +66986,25 @@ var HikvisionCamera = class HikvisionCamera extends BaseDevice {
 	* The native `motion` cap. Its presence is what defaults the camera to
 	* `motionSources: ['onboard']`. This provider writes NO `motion` slice (D696):
 	* the orchestrator is its only writer, with the EFFECTIVE motion, on the hub.
-	* `isDetected` therefore answers from the hub's slice; an unreadable hub, or
-	* a slice nobody has published since the hub started, makes the call fail.
-	* It never answers `false` for "unknown" (D49, D393).
+	* `isDetected` AND `getStatus` therefore answer from the hub's slice
+	* (`hubMotionNativeProvider`; without its own `getStatus` the framework's
+	* default reads this process's empty local state and answers `null`). An
+	* unreadable hub fails both; never `false` for "unknown" (D49, D393).
 	*/
 	registerMotionCap() {
-		this.ctx.registerNativeCap(motionCapability, { isDetected: async ({ deviceId }) => {
-			if (deviceId !== this.id) throw new Error(`HikvisionCamera: deviceId mismatch, expected ${this.id}, got ${deviceId}`);
-			return readHubMotionDetected(this.ctx.api.deviceState, this.id);
-		} });
+		const motionProvider = hubMotionNativeProvider(this.ctx.api.deviceState, this.id, "HikvisionCamera");
+		this.ctx.registerNativeCap(motionCapability, motionProvider);
 	}
 	handleMotionEvent(ev, camStreamId) {
 		const now = ev.observedAt;
 		this.lastMotionAt.set(camStreamId, now);
+		this.motionIngress.received({
+			type: ev.type,
+			state: ev.state,
+			aiClass: ev.aiClass,
+			camStreamId,
+			at: now
+		});
 		this.ctx.eventBus.emit(providerMotionEvent(this.eventSource, {
 			deviceId: this.id,
 			detected: true,
@@ -66863,6 +67017,7 @@ var HikvisionCamera = class HikvisionCamera extends BaseDevice {
 			const clearedAt = Date.now();
 			this.lastMotionAt.set(camStreamId, 0);
 			this.motionInactiveTimers.delete(camStreamId);
+			this.motionIngress.ended(camStreamId, clearedAt);
 			this.ctx.eventBus.emit(providerMotionEvent(this.eventSource, {
 				deviceId: this.id,
 				detected: false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-provider-hikvision",
-  "version": "1.2.142",
+  "version": "1.2.144",
   "description": "Hikvision camera device provider addon for CamStack — ISAPI over HTTP(S) with digest auth (snapshot, alarm stream, RTSP discovery)",
   "keywords": [
     "camstack",