@camstack/addon-osd-manager 0.1.3 → 0.1.4

package/dist/index.js

@@ -24802,6 +24802,7 @@ var FaceInfoSchema = object({
 var FaceFilterEnum = _enum([
 	"unassigned",
 	"recognized",
+	"identified",
 	"all"
 ]);
 var MediaFileLiteSchema$1 = object({
@@ -24841,6 +24842,8 @@ var faceGalleryCapability = {
 			auth: "admin"
 		}),
 		listRecentFaces: method(object({
+			/** Restrict to one camera. Absent keeps the cluster-wide gallery view. */
+			deviceId: number().int().optional(),
 			limit: number().int().positive().optional(),
 			filter: FaceFilterEnum.optional(),
 			/**
@@ -27384,6 +27387,10 @@ var OsdSourceSchema = discriminatedUnion("kind", [
 		capName: string().min(1).max(64),
 		/** Dot path inside the slice, e.g. `detected`, `value`, `mode`. */
 		valuePath: string().min(1).max(64)
+	}),
+	object({
+		kind: literal("latest-recognition"),
+		recognition: _enum(["person", "plate"])
 	})
 ]);
 var OsdSlotBindingSchema = object({
@@ -27522,6 +27529,21 @@ var osdManagerCapability = {
 			auth: "admin"
 		}),
 		/**
+		* Replace one camera's binding configuration from another. Writable source
+		* slots are mapped by ordinal onto writable target slots so different
+		* provider slot ids do not make the copied configuration disappear.
+		*/
+		copyDeviceConfiguration: method(object({
+			sourceDeviceId: number().int(),
+			targetDeviceId: number().int()
+		}), object({
+			copied: number().int().nonnegative(),
+			skipped: number().int().nonnegative()
+		}), {
+			kind: "mutation",
+			auth: "admin"
+		}),
+		/**
 		* Render without writing. `binding` overrides the stored one so an
 		* editor can preview an unsaved change. Mutation kind only to carry
 		* the binding object safely; no side effects.
@@ -33706,6 +33728,12 @@ Object.freeze({
 		addonId: null,
 		access: "delete"
 	},
+	"osdManager.copyDeviceConfiguration": {
+		capName: "osd-manager",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"osdManager.getConditionSupport": {
 		capName: "osd-manager",
 		capScope: "system",
@@ -36589,7 +36617,8 @@ var OsdBindingsStore = class {
 * Widening it means giving `evaluateGate` the facts to answer it — a
 * live detection subject would unlock `classes`, `zones`, `minConfidence`.
 */
-var OSD_SUPPORTED_CONDITIONS = ["devices", "deviceState"];
+var OSD_SUPPORTED_CONDITIONS = ["deviceState"];
+var OSD_RUNTIME_CONDITIONS = ["devices", ...OSD_SUPPORTED_CONDITIONS];
 var OPEN = { open: true };
 /**
 * Which condition keys are set on `conditions` but outside the supported
@@ -36597,7 +36626,7 @@ var OPEN = { open: true };
 */
 function unsupportedConditionKeys(conditions) {
 	if (conditions === void 0) return [];
-	const supported = new Set(OSD_SUPPORTED_CONDITIONS);
+	const supported = new Set(OSD_RUNTIME_CONDITIONS);
 	const present = [];
 	for (const [key, value] of Object.entries(conditions)) {
 		if (value === void 0) continue;
@@ -36840,6 +36869,10 @@ function resolveSource(binding, cameraDeviceId, facts) {
 	const source = binding.source;
 	if (source.kind === "static") return { value: { raw: source.text } };
 	if (source.kind === "clock") return { value: { raw: formatClock(facts.atMs, source.pattern, source.timezone) } };
+	if (source.kind === "latest-recognition") {
+		const value = facts.recognitionByDevice.get(cameraDeviceId)?.[source.recognition];
+		return value === void 0 ? { reason: `no recognized ${source.recognition} has been persisted for device ${cameraDeviceId}` } : { value: { raw: value } };
+	}
 	const deviceId = source.deviceId ?? cameraDeviceId;
 	const deviceState = facts.stateByDevice.get(deviceId);
 	if (deviceState === void 0) return { reason: `no state mirrored for device ${deviceId}` };
@@ -36963,6 +36996,10 @@ var OsdManager = class {
 	lastWritten = /* @__PURE__ */ new Map();
 	/** Cameras with at least one binding — the loop's work list. */
 	boundDevices = /* @__PURE__ */ new Set();
+	recognitions = /* @__PURE__ */ new Map();
+	recognitionHydration = /* @__PURE__ */ new Map();
+	recognitionGeneration = /* @__PURE__ */ new Map();
+	recognitionInvalidatedAt = /* @__PURE__ */ new Map();
 	timer = null;
 	constructor(deps) {
 		this.deps = deps;
@@ -36990,6 +37027,36 @@ var OsdManager = class {
 		this.lastWritten.clear();
 	}
 	/**
+	* Keep recognition overlays event-fresh. The persisted-track hydration below
+	* remains the restart/cold-start authority; lifecycle events only advance it.
+	*/
+	onTrackLifecycle(payload) {
+		let changed = false;
+		if (payload.label !== void 0 && (payload.bestClassName === "person" || payload.classes.includes("person"))) changed = this.mergeRecognition(payload.deviceId, "person", payload.label, payload.lastSeen, payload.firstSeen) || changed;
+		if (payload.plateText !== void 0) changed = this.mergeRecognition(payload.deviceId, "plate", payload.plateText, payload.lastSeen, payload.firstSeen) || changed;
+		if (!changed || !this.boundDevices.has(payload.deviceId)) return;
+		this.renderDeviceInternal(payload.deviceId, null).catch((err) => {
+			this.logger.warn("osd-manager: recognition-triggered render failed", {
+				tags: { deviceId: payload.deviceId },
+				meta: { error: String(err) }
+			});
+		});
+	}
+	/** Gallery rows are authoritative for corrections, assignments and deletion. */
+	onRecognitionGalleryChanged(deviceId) {
+		this.recognitionGeneration.set(deviceId, (this.recognitionGeneration.get(deviceId) ?? 0) + 1);
+		this.recognitionInvalidatedAt.set(deviceId, this.now());
+		this.recognitions.delete(deviceId);
+		this.recognitionHydration.delete(deviceId);
+		if (!this.boundDevices.has(deviceId)) return;
+		this.renderDeviceInternal(deviceId, null).catch((err) => {
+			this.logger.warn("osd-manager: gallery-triggered render failed", {
+				tags: { deviceId },
+				meta: { error: String(err) }
+			});
+		});
+	}
+	/**
 	* Reconcile the work list against the store rather than trusting an event
 	* to have arrived (D8). Cheap: one settings read per camera, on the tick
 	* cadence, not per frame.
@@ -37083,6 +37150,54 @@ var OsdManager = class {
 		});
 		return { success: true };
 	};
+	copyDeviceConfiguration = async ({ sourceDeviceId, targetDeviceId }) => {
+		if (sourceDeviceId === targetDeviceId) throw new Error("osd-manager: source and target camera must be different");
+		const [sourceStatus, targetStatus, sourceBindings] = await Promise.all([
+			this.deps.readOsdStatus(sourceDeviceId),
+			this.deps.readOsdStatus(targetDeviceId),
+			this.readBindings(sourceDeviceId)
+		]);
+		if (sourceStatus === null) throw new Error(`osd-manager: source device ${sourceDeviceId} exposes no overlay slots`);
+		if (targetStatus === null) throw new Error(`osd-manager: target device ${targetDeviceId} exposes no overlay slots`);
+		const sourceSlots = sourceStatus.overlays.filter((slot) => slot.readOnly !== true && sourceBindings[slot.id] !== void 0);
+		if (sourceSlots.length === 0) throw new Error(`osd-manager: source device ${sourceDeviceId} has no configured writable slots`);
+		const targetSlots = targetStatus.overlays.filter((slot) => slot.readOnly !== true);
+		const copiedBindings = {};
+		const copyCount = Math.min(sourceSlots.length, targetSlots.length);
+		for (let index = 0; index < copyCount; index += 1) {
+			const sourceSlot = sourceSlots[index];
+			const targetSlot = targetSlots[index];
+			if (sourceSlot === void 0 || targetSlot === void 0) continue;
+			const binding = sourceBindings[sourceSlot.id];
+			if (binding === void 0) continue;
+			const conditions = binding.conditions;
+			const normalizedConditions = conditions === void 0 ? void 0 : (() => {
+				const { devices: _cameraScope, ...rest } = conditions;
+				return Object.keys(rest).length === 0 ? void 0 : rest;
+			})();
+			copiedBindings[targetSlot.id] = {
+				...binding,
+				conditions: normalizedConditions
+			};
+		}
+		await this.deps.bindings(targetDeviceId).set(copiedBindings);
+		for (const key of [...this.lastWritten.keys()]) if (key.startsWith(`${targetDeviceId}:`)) this.lastWritten.delete(key);
+		if (Object.keys(copiedBindings).length > 0) this.boundDevices.add(targetDeviceId);
+		else this.boundDevices.delete(targetDeviceId);
+		await this.renderDeviceInternal(targetDeviceId, null);
+		this.logger.info("osd-manager: camera configuration copied", {
+			tags: { deviceId: targetDeviceId },
+			meta: {
+				sourceDeviceId,
+				copied: Object.keys(copiedBindings).length,
+				skipped: Math.max(0, sourceSlots.length - targetSlots.length)
+			}
+		});
+		return {
+			copied: Object.keys(copiedBindings).length,
+			skipped: Math.max(0, sourceSlots.length - targetSlots.length)
+		};
+	};
 	previewSlot = async ({ deviceId, slotId, binding }) => {
 		if (binding !== void 0) assertSupportedConditions(binding.conditions);
 		const effective = binding ?? (await this.readBindings(deviceId))[slotId] ?? null;
@@ -37157,6 +37272,7 @@ var OsdManager = class {
 	*/
 	async collectFacts(cameraDeviceId, bindings) {
 		const wanted = new Set([cameraDeviceId]);
+		const needsRecognition = Object.values(bindings).some((binding) => binding.source.kind === "latest-recognition");
 		for (const binding of Object.values(bindings)) {
 			if (binding.source.kind === "device-state" && binding.source.deviceId !== void 0) wanted.add(binding.source.deviceId);
 			const gated = binding.conditions?.deviceState?.deviceId;
@@ -37175,12 +37291,59 @@ var OsdManager = class {
 				meta: { error: String(err) }
 			});
 		}
+		if (needsRecognition) await this.hydrateRecognitions(cameraDeviceId);
+		const recognitionByDevice = /* @__PURE__ */ new Map();
+		const known = this.recognitions.get(cameraDeviceId);
+		if (known !== void 0) recognitionByDevice.set(cameraDeviceId, {
+			...known.person !== void 0 ? { person: known.person.text } : {},
+			...known.plate !== void 0 ? { plate: known.plate.text } : {}
+		});
 		return {
 			atMs: this.now(),
 			stateByDevice,
+			recognitionByDevice,
 			deviceState: (id) => gateState.get(id)
 		};
 	}
+	async hydrateRecognitions(deviceId) {
+		const existing = this.recognitionHydration.get(deviceId);
+		if (existing !== void 0) return existing;
+		const generation = this.recognitionGeneration.get(deviceId) ?? 0;
+		const hydration = (async () => {
+			try {
+				const latest = await this.deps.readLatestRecognitions(deviceId);
+				if ((this.recognitionGeneration.get(deviceId) ?? 0) !== generation) return;
+				if (latest.person !== void 0) this.mergeRecognition(deviceId, "person", latest.person.text, latest.person.atMs);
+				if (latest.plate !== void 0) this.mergeRecognition(deviceId, "plate", latest.plate.text, latest.plate.atMs);
+			} catch (err) {
+				this.logger.warn("osd-manager: recognition history hydration failed", {
+					tags: { deviceId },
+					meta: { error: String(err) }
+				});
+				this.recognitionHydration.delete(deviceId);
+			}
+		})();
+		this.recognitionHydration.set(deviceId, hydration);
+		await hydration;
+	}
+	mergeRecognition(deviceId, kind, text, atMs, trackFirstSeen) {
+		const normalized = text.trim();
+		if (normalized === "") return false;
+		const invalidatedAt = this.recognitionInvalidatedAt.get(deviceId);
+		if (trackFirstSeen !== void 0 && invalidatedAt !== void 0 && trackFirstSeen <= invalidatedAt) return false;
+		const current = this.recognitions.get(deviceId) ?? {};
+		const previous = current[kind];
+		if (previous !== void 0 && previous.atMs > atMs) return false;
+		if (previous?.atMs === atMs && previous.text === normalized) return false;
+		this.recognitions.set(deviceId, {
+			...current,
+			[kind]: {
+				text: normalized,
+				atMs
+			}
+		});
+		return true;
+	}
 	async readBindings(deviceId) {
 		try {
 			return await this.deps.bindings(deviceId).get();
@@ -37240,7 +37403,8 @@ var OsdManagerAddon = class extends BaseAddon {
 		icon: "monitor",
 		path: "/addon/osd-manager",
 		remoteName: "addon_osd_manager_page",
-		bundle: "remoteEntry.js"
+		bundle: "remoteEntry.js",
+		section: "detection"
 	}];
 	constructor() {
 		super({ ...DEFAULTS });
@@ -37288,9 +37452,41 @@ var OsdManagerAddon = class extends BaseAddon {
 				const bindings = await ctx.api.deviceManager.getBindings.query({ deviceId });
 				return [...new Set(bindings.entries.map((e) => e.capName))];
 			},
+			readLatestRecognitions: async (deviceId) => {
+				const [faces, plates] = await Promise.all([ctx.api.faceGallery.listRecentFaces.query({
+					deviceId,
+					limit: 1,
+					filter: "identified",
+					includeCrops: false
+				}), ctx.api.plateGallery.listPlates.query({
+					deviceId,
+					limit: 1
+				})]);
+				const face = faces[0];
+				const plate = plates[0];
+				return {
+					...face?.identityName !== void 0 ? { person: {
+						text: face.identityName,
+						atMs: face.timestamp
+					} } : {},
+					...plate !== void 0 ? { plate: {
+						text: plate.text,
+						atMs: plate.timestamp
+					} } : {}
+				};
+			},
 			bindings: (deviceId) => store.forDevice(deviceId)
 		});
 		this.manager = manager;
+		this.subscribe({ category: EventCategory.PipelineAnalyticsTrackLifecycle }, (event) => {
+			manager.onTrackLifecycle(event.data);
+		});
+		this.subscribe({ category: EventCategory.PipelineAnalyticsFaceGalleryChanged }, (event) => {
+			manager.onRecognitionGalleryChanged(event.data.deviceId);
+		});
+		this.subscribe({ category: EventCategory.PipelineAnalyticsPlateGalleryChanged }, (event) => {
+			manager.onRecognitionGalleryChanged(event.data.deviceId);
+		});
 		await manager.start(Math.max(1, this.config.tickSeconds) * 1e3);
 		const pagesProvider = {
 			id: this.id,

package/dist/index.mjs

@@ -24798,6 +24798,7 @@ var FaceInfoSchema = object({
 var FaceFilterEnum = _enum([
 	"unassigned",
 	"recognized",
+	"identified",
 	"all"
 ]);
 var MediaFileLiteSchema$1 = object({
@@ -24837,6 +24838,8 @@ var faceGalleryCapability = {
 			auth: "admin"
 		}),
 		listRecentFaces: method(object({
+			/** Restrict to one camera. Absent keeps the cluster-wide gallery view. */
+			deviceId: number().int().optional(),
 			limit: number().int().positive().optional(),
 			filter: FaceFilterEnum.optional(),
 			/**
@@ -27380,6 +27383,10 @@ var OsdSourceSchema = discriminatedUnion("kind", [
 		capName: string().min(1).max(64),
 		/** Dot path inside the slice, e.g. `detected`, `value`, `mode`. */
 		valuePath: string().min(1).max(64)
+	}),
+	object({
+		kind: literal("latest-recognition"),
+		recognition: _enum(["person", "plate"])
 	})
 ]);
 var OsdSlotBindingSchema = object({
@@ -27518,6 +27525,21 @@ var osdManagerCapability = {
 			auth: "admin"
 		}),
 		/**
+		* Replace one camera's binding configuration from another. Writable source
+		* slots are mapped by ordinal onto writable target slots so different
+		* provider slot ids do not make the copied configuration disappear.
+		*/
+		copyDeviceConfiguration: method(object({
+			sourceDeviceId: number().int(),
+			targetDeviceId: number().int()
+		}), object({
+			copied: number().int().nonnegative(),
+			skipped: number().int().nonnegative()
+		}), {
+			kind: "mutation",
+			auth: "admin"
+		}),
+		/**
 		* Render without writing. `binding` overrides the stored one so an
 		* editor can preview an unsaved change. Mutation kind only to carry
 		* the binding object safely; no side effects.
@@ -33702,6 +33724,12 @@ Object.freeze({
 		addonId: null,
 		access: "delete"
 	},
+	"osdManager.copyDeviceConfiguration": {
+		capName: "osd-manager",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"osdManager.getConditionSupport": {
 		capName: "osd-manager",
 		capScope: "system",
@@ -36585,7 +36613,8 @@ var OsdBindingsStore = class {
 * Widening it means giving `evaluateGate` the facts to answer it — a
 * live detection subject would unlock `classes`, `zones`, `minConfidence`.
 */
-var OSD_SUPPORTED_CONDITIONS = ["devices", "deviceState"];
+var OSD_SUPPORTED_CONDITIONS = ["deviceState"];
+var OSD_RUNTIME_CONDITIONS = ["devices", ...OSD_SUPPORTED_CONDITIONS];
 var OPEN = { open: true };
 /**
 * Which condition keys are set on `conditions` but outside the supported
@@ -36593,7 +36622,7 @@ var OPEN = { open: true };
 */
 function unsupportedConditionKeys(conditions) {
 	if (conditions === void 0) return [];
-	const supported = new Set(OSD_SUPPORTED_CONDITIONS);
+	const supported = new Set(OSD_RUNTIME_CONDITIONS);
 	const present = [];
 	for (const [key, value] of Object.entries(conditions)) {
 		if (value === void 0) continue;
@@ -36836,6 +36865,10 @@ function resolveSource(binding, cameraDeviceId, facts) {
 	const source = binding.source;
 	if (source.kind === "static") return { value: { raw: source.text } };
 	if (source.kind === "clock") return { value: { raw: formatClock(facts.atMs, source.pattern, source.timezone) } };
+	if (source.kind === "latest-recognition") {
+		const value = facts.recognitionByDevice.get(cameraDeviceId)?.[source.recognition];
+		return value === void 0 ? { reason: `no recognized ${source.recognition} has been persisted for device ${cameraDeviceId}` } : { value: { raw: value } };
+	}
 	const deviceId = source.deviceId ?? cameraDeviceId;
 	const deviceState = facts.stateByDevice.get(deviceId);
 	if (deviceState === void 0) return { reason: `no state mirrored for device ${deviceId}` };
@@ -36959,6 +36992,10 @@ var OsdManager = class {
 	lastWritten = /* @__PURE__ */ new Map();
 	/** Cameras with at least one binding — the loop's work list. */
 	boundDevices = /* @__PURE__ */ new Set();
+	recognitions = /* @__PURE__ */ new Map();
+	recognitionHydration = /* @__PURE__ */ new Map();
+	recognitionGeneration = /* @__PURE__ */ new Map();
+	recognitionInvalidatedAt = /* @__PURE__ */ new Map();
 	timer = null;
 	constructor(deps) {
 		this.deps = deps;
@@ -36986,6 +37023,36 @@ var OsdManager = class {
 		this.lastWritten.clear();
 	}
 	/**
+	* Keep recognition overlays event-fresh. The persisted-track hydration below
+	* remains the restart/cold-start authority; lifecycle events only advance it.
+	*/
+	onTrackLifecycle(payload) {
+		let changed = false;
+		if (payload.label !== void 0 && (payload.bestClassName === "person" || payload.classes.includes("person"))) changed = this.mergeRecognition(payload.deviceId, "person", payload.label, payload.lastSeen, payload.firstSeen) || changed;
+		if (payload.plateText !== void 0) changed = this.mergeRecognition(payload.deviceId, "plate", payload.plateText, payload.lastSeen, payload.firstSeen) || changed;
+		if (!changed || !this.boundDevices.has(payload.deviceId)) return;
+		this.renderDeviceInternal(payload.deviceId, null).catch((err) => {
+			this.logger.warn("osd-manager: recognition-triggered render failed", {
+				tags: { deviceId: payload.deviceId },
+				meta: { error: String(err) }
+			});
+		});
+	}
+	/** Gallery rows are authoritative for corrections, assignments and deletion. */
+	onRecognitionGalleryChanged(deviceId) {
+		this.recognitionGeneration.set(deviceId, (this.recognitionGeneration.get(deviceId) ?? 0) + 1);
+		this.recognitionInvalidatedAt.set(deviceId, this.now());
+		this.recognitions.delete(deviceId);
+		this.recognitionHydration.delete(deviceId);
+		if (!this.boundDevices.has(deviceId)) return;
+		this.renderDeviceInternal(deviceId, null).catch((err) => {
+			this.logger.warn("osd-manager: gallery-triggered render failed", {
+				tags: { deviceId },
+				meta: { error: String(err) }
+			});
+		});
+	}
+	/**
 	* Reconcile the work list against the store rather than trusting an event
 	* to have arrived (D8). Cheap: one settings read per camera, on the tick
 	* cadence, not per frame.
@@ -37079,6 +37146,54 @@ var OsdManager = class {
 		});
 		return { success: true };
 	};
+	copyDeviceConfiguration = async ({ sourceDeviceId, targetDeviceId }) => {
+		if (sourceDeviceId === targetDeviceId) throw new Error("osd-manager: source and target camera must be different");
+		const [sourceStatus, targetStatus, sourceBindings] = await Promise.all([
+			this.deps.readOsdStatus(sourceDeviceId),
+			this.deps.readOsdStatus(targetDeviceId),
+			this.readBindings(sourceDeviceId)
+		]);
+		if (sourceStatus === null) throw new Error(`osd-manager: source device ${sourceDeviceId} exposes no overlay slots`);
+		if (targetStatus === null) throw new Error(`osd-manager: target device ${targetDeviceId} exposes no overlay slots`);
+		const sourceSlots = sourceStatus.overlays.filter((slot) => slot.readOnly !== true && sourceBindings[slot.id] !== void 0);
+		if (sourceSlots.length === 0) throw new Error(`osd-manager: source device ${sourceDeviceId} has no configured writable slots`);
+		const targetSlots = targetStatus.overlays.filter((slot) => slot.readOnly !== true);
+		const copiedBindings = {};
+		const copyCount = Math.min(sourceSlots.length, targetSlots.length);
+		for (let index = 0; index < copyCount; index += 1) {
+			const sourceSlot = sourceSlots[index];
+			const targetSlot = targetSlots[index];
+			if (sourceSlot === void 0 || targetSlot === void 0) continue;
+			const binding = sourceBindings[sourceSlot.id];
+			if (binding === void 0) continue;
+			const conditions = binding.conditions;
+			const normalizedConditions = conditions === void 0 ? void 0 : (() => {
+				const { devices: _cameraScope, ...rest } = conditions;
+				return Object.keys(rest).length === 0 ? void 0 : rest;
+			})();
+			copiedBindings[targetSlot.id] = {
+				...binding,
+				conditions: normalizedConditions
+			};
+		}
+		await this.deps.bindings(targetDeviceId).set(copiedBindings);
+		for (const key of [...this.lastWritten.keys()]) if (key.startsWith(`${targetDeviceId}:`)) this.lastWritten.delete(key);
+		if (Object.keys(copiedBindings).length > 0) this.boundDevices.add(targetDeviceId);
+		else this.boundDevices.delete(targetDeviceId);
+		await this.renderDeviceInternal(targetDeviceId, null);
+		this.logger.info("osd-manager: camera configuration copied", {
+			tags: { deviceId: targetDeviceId },
+			meta: {
+				sourceDeviceId,
+				copied: Object.keys(copiedBindings).length,
+				skipped: Math.max(0, sourceSlots.length - targetSlots.length)
+			}
+		});
+		return {
+			copied: Object.keys(copiedBindings).length,
+			skipped: Math.max(0, sourceSlots.length - targetSlots.length)
+		};
+	};
 	previewSlot = async ({ deviceId, slotId, binding }) => {
 		if (binding !== void 0) assertSupportedConditions(binding.conditions);
 		const effective = binding ?? (await this.readBindings(deviceId))[slotId] ?? null;
@@ -37153,6 +37268,7 @@ var OsdManager = class {
 	*/
 	async collectFacts(cameraDeviceId, bindings) {
 		const wanted = new Set([cameraDeviceId]);
+		const needsRecognition = Object.values(bindings).some((binding) => binding.source.kind === "latest-recognition");
 		for (const binding of Object.values(bindings)) {
 			if (binding.source.kind === "device-state" && binding.source.deviceId !== void 0) wanted.add(binding.source.deviceId);
 			const gated = binding.conditions?.deviceState?.deviceId;
@@ -37171,12 +37287,59 @@ var OsdManager = class {
 				meta: { error: String(err) }
 			});
 		}
+		if (needsRecognition) await this.hydrateRecognitions(cameraDeviceId);
+		const recognitionByDevice = /* @__PURE__ */ new Map();
+		const known = this.recognitions.get(cameraDeviceId);
+		if (known !== void 0) recognitionByDevice.set(cameraDeviceId, {
+			...known.person !== void 0 ? { person: known.person.text } : {},
+			...known.plate !== void 0 ? { plate: known.plate.text } : {}
+		});
 		return {
 			atMs: this.now(),
 			stateByDevice,
+			recognitionByDevice,
 			deviceState: (id) => gateState.get(id)
 		};
 	}
+	async hydrateRecognitions(deviceId) {
+		const existing = this.recognitionHydration.get(deviceId);
+		if (existing !== void 0) return existing;
+		const generation = this.recognitionGeneration.get(deviceId) ?? 0;
+		const hydration = (async () => {
+			try {
+				const latest = await this.deps.readLatestRecognitions(deviceId);
+				if ((this.recognitionGeneration.get(deviceId) ?? 0) !== generation) return;
+				if (latest.person !== void 0) this.mergeRecognition(deviceId, "person", latest.person.text, latest.person.atMs);
+				if (latest.plate !== void 0) this.mergeRecognition(deviceId, "plate", latest.plate.text, latest.plate.atMs);
+			} catch (err) {
+				this.logger.warn("osd-manager: recognition history hydration failed", {
+					tags: { deviceId },
+					meta: { error: String(err) }
+				});
+				this.recognitionHydration.delete(deviceId);
+			}
+		})();
+		this.recognitionHydration.set(deviceId, hydration);
+		await hydration;
+	}
+	mergeRecognition(deviceId, kind, text, atMs, trackFirstSeen) {
+		const normalized = text.trim();
+		if (normalized === "") return false;
+		const invalidatedAt = this.recognitionInvalidatedAt.get(deviceId);
+		if (trackFirstSeen !== void 0 && invalidatedAt !== void 0 && trackFirstSeen <= invalidatedAt) return false;
+		const current = this.recognitions.get(deviceId) ?? {};
+		const previous = current[kind];
+		if (previous !== void 0 && previous.atMs > atMs) return false;
+		if (previous?.atMs === atMs && previous.text === normalized) return false;
+		this.recognitions.set(deviceId, {
+			...current,
+			[kind]: {
+				text: normalized,
+				atMs
+			}
+		});
+		return true;
+	}
 	async readBindings(deviceId) {
 		try {
 			return await this.deps.bindings(deviceId).get();
@@ -37236,7 +37399,8 @@ var OsdManagerAddon = class extends BaseAddon {
 		icon: "monitor",
 		path: "/addon/osd-manager",
 		remoteName: "addon_osd_manager_page",
-		bundle: "remoteEntry.js"
+		bundle: "remoteEntry.js",
+		section: "detection"
 	}];
 	constructor() {
 		super({ ...DEFAULTS });
@@ -37284,9 +37448,41 @@ var OsdManagerAddon = class extends BaseAddon {
 				const bindings = await ctx.api.deviceManager.getBindings.query({ deviceId });
 				return [...new Set(bindings.entries.map((e) => e.capName))];
 			},
+			readLatestRecognitions: async (deviceId) => {
+				const [faces, plates] = await Promise.all([ctx.api.faceGallery.listRecentFaces.query({
+					deviceId,
+					limit: 1,
+					filter: "identified",
+					includeCrops: false
+				}), ctx.api.plateGallery.listPlates.query({
+					deviceId,
+					limit: 1
+				})]);
+				const face = faces[0];
+				const plate = plates[0];
+				return {
+					...face?.identityName !== void 0 ? { person: {
+						text: face.identityName,
+						atMs: face.timestamp
+					} } : {},
+					...plate !== void 0 ? { plate: {
+						text: plate.text,
+						atMs: plate.timestamp
+					} } : {}
+				};
+			},
 			bindings: (deviceId) => store.forDevice(deviceId)
 		});
 		this.manager = manager;
+		this.subscribe({ category: EventCategory.PipelineAnalyticsTrackLifecycle }, (event) => {
+			manager.onTrackLifecycle(event.data);
+		});
+		this.subscribe({ category: EventCategory.PipelineAnalyticsFaceGalleryChanged }, (event) => {
+			manager.onRecognitionGalleryChanged(event.data.deviceId);
+		});
+		this.subscribe({ category: EventCategory.PipelineAnalyticsPlateGalleryChanged }, (event) => {
+			manager.onRecognitionGalleryChanged(event.data.deviceId);
+		});
 		await manager.start(Math.max(1, this.config.tickSeconds) * 1e3);
 		const pagesProvider = {
 			id: this.id,

package/dist/remoteEntry.js

@@ -1,2 +1,2 @@
-import { n as e, t } from "./virtual_mf-REMOTE_ENTRY_ID___mfe_internal__addon_osd_manager_page__remoteEntry_js-Bx-1SwyE.mjs";
+import { n as e, t } from "./virtual_mf-REMOTE_ENTRY_ID___mfe_internal__addon_osd_manager_page__remoteEntry_js-CdG2yVd0.mjs";
 export { t as get, e as init };

package/dist/{virtual_mf-REMOTE_ENTRY_ID___mfe_internal__addon_osd_manager_page__remoteEntry_js-Bx-1SwyE.mjs → virtual_mf-REMOTE_ENTRY_ID___mfe_internal__addon_osd_manager_page__remoteEntry_js-CdG2yVd0.mjs}

@@ -2753,7 +2753,7 @@ async function rr(e) {
 	}
 }
 async function ir() {
-	return tr ||= rr(() => import("./_virtual_mf-localSharedImportMap___mfe_internal__addon_osd_manager_page-BBrLl2CB.mjs")).catch((e) => {
+	return tr ||= rr(() => import("./_virtual_mf-localSharedImportMap___mfe_internal__addon_osd_manager_page-CL-YG2or.mjs")).catch((e) => {
 		throw tr = void 0, e;
 	}), tr;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@camstack/addon-osd-manager",
-  "version": "0.1.3",
-  "description": "Binds camera on-screen-display slots to live device state",
+  "version": "0.1.4",
+  "description": "Binds camera on-screen-display slots to live state and recognitions",
   "keywords": [
     "camstack",
     "addon",
@@ -33,7 +33,7 @@
         "category": "system",
         "name": "OSD Manager",
         "version": "0.1.0",
-        "description": "Drives the text a camera burns into its own video. Each overlay slot the camera exposes can be bound to a live value — any cap-keyed device state, a clock, or a literal — formatted with a template and shown only while a condition holds. Conditions use the notification centre's vocabulary. Writes nothing when the rendered text has not changed.",
+        "description": "Drives the text a camera burns into its own video. Each overlay slot can be bound to device state, the latest recognized person or plate, a clock, or a literal. Writes nothing when the rendered text has not changed.",
         "entry": "./dist/index.js",
         "icon": "assets/icon.svg",
         "color": "#f59e0b",
@@ -57,7 +57,8 @@
             "icon": "monitor",
             "path": "/addon/osd-manager",
             "remoteName": "addon_osd_manager_page",
-            "bundle": "remoteEntry.js"
+            "bundle": "remoteEntry.js",
+            "section": "detection"
           }
         ]
       }