@camstack/addon-osd-manager 0.1.2 → 0.1.4

package/dist/index.js

@@ -21791,6 +21791,22 @@ var TerminalProfileInfoSchema = object({
 	label: string(),
 	description: string().optional()
 });
+var TerminalOutputEventSchema = discriminatedUnion("kind", [object({
+	seq: number().int().positive(),
+	kind: literal("data"),
+	data: string()
+}), object({
+	seq: number().int().positive(),
+	kind: literal("exit"),
+	exitCode: number().int(),
+	signal: number().int().optional()
+})]);
+var TerminalOutputBatchSchema = object({
+	cursor: number().int().nonnegative(),
+	reset: boolean(),
+	snapshot: string().optional(),
+	events: array(TerminalOutputEventSchema).readonly()
+});
 /**
 * terminal-session — singleton system capability for interactive TTY sessions.
 *
@@ -21829,6 +21845,28 @@ var terminalSessionCapability = {
 			kind: "mutation",
 			auth: "admin"
 		}),
+		/**
+		* Pull ordered output after a cursor. This capability transport is what
+		* makes remote-agent terminals possible; `reset + snapshot` repairs a
+		* caller that fell behind the bounded replay window.
+		*/
+		pullOutput: method(object({
+			sessionId: string(),
+			afterSeq: number().int().nonnegative(),
+			waitMs: number().int().min(0).max(2e3).default(0)
+		}), TerminalOutputBatchSchema, {
+			kind: "mutation",
+			auth: "admin",
+			timeoutMs: 15e3
+		}),
+		/** Write terminal input through the node-routable capability plane. */
+		writeInput: method(object({
+			sessionId: string(),
+			data: string().max(64 * 1024)
+		}), _void(), {
+			kind: "mutation",
+			auth: "admin"
+		}),
 		/** Terminate a live session and release its pty. */
 		close: method(object({ sessionId: string() }), _void(), {
 			kind: "mutation",
@@ -24764,6 +24802,7 @@ var FaceInfoSchema = object({
 var FaceFilterEnum = _enum([
 	"unassigned",
 	"recognized",
+	"identified",
 	"all"
 ]);
 var MediaFileLiteSchema$1 = object({
@@ -24803,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(),
 			/**
@@ -27346,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({
@@ -27484,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.
@@ -33668,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",
@@ -35708,12 +35774,24 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"terminalSession.pullOutput": {
+		capName: "terminal-session",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"terminalSession.resize": {
 		capName: "terminal-session",
 		capScope: "system",
 		addonId: null,
 		access: "create"
 	},
+	"terminalSession.writeInput": {
+		capName: "terminal-session",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"toast.onToast": {
 		capName: "toast",
 		capScope: "system",
@@ -36539,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
@@ -36547,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;
@@ -36790,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}` };
@@ -36913,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;
@@ -36940,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.
@@ -37033,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;
@@ -37107,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;
@@ -37125,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();
@@ -37175,7 +37388,24 @@ function cacheKey(deviceId, slotId) {
 */
 var DEFAULTS = { tickSeconds: DEFAULT_TICK_MS / 1e3 };
 var OsdManagerAddon = class extends BaseAddon {
+	id = "osd-manager";
 	manager = null;
+	/**
+	* Module-Federation page declaration surfaced via the `addon-pages-source`
+	* collection cap. Mirrors the manifest `pages[]` entry — admin-ui's
+	* `<AddonPageLoader>` loads `addon_osd_manager_page/page` from
+	* `/api/addon-pages/osd-manager/remoteEntry.js`. Modeled directly on
+	* `addon-benchmark` / `addon-model-studio` (docs/roadmap.md 4d).
+	*/
+	pages = [{
+		id: "osd-manager",
+		label: "OSD Manager",
+		icon: "monitor",
+		path: "/addon/osd-manager",
+		remoteName: "addon_osd_manager_page",
+		bundle: "remoteEntry.js",
+		section: "detection"
+	}];
 	constructor() {
 		super({ ...DEFAULTS });
 	}
@@ -37222,13 +37452,52 @@ 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,
+			listPages: () => this.pages
+		};
 		return [{
 			capability: osdManagerCapability,
 			provider: manager
+		}, {
+			capability: addonPagesSourceCapability,
+			provider: pagesProvider
 		}];
 	}
 	async onConfigChanged() {