@camstack/addon-osd-manager 0.1.82 → 0.1.84

package/dist/index.js

@@ -7726,6 +7726,35 @@ var CameraSwitchGroupSchema = object({
 	/** Unix ms when the group was composed server-side. */
 	fetchedAt: number()
 });
+/** One archived note — the operator's words plus enough context to find what
+*  they were looking at, after the track itself is gone. */
+var ArchivedDebugNoteSchema = object({
+	/** Archive row id. Derived from `(sourceTrackId, note)`, so re-archiving the
+	*  same sentence about the same track lands on the row already there. */
+	id: string(),
+	/** The operator's own words, verbatim. */
+	note: string(),
+	/** The camera. Required — every question here is asked per-camera. */
+	deviceId: number().int(),
+	/** The track the note was written on. PROVENANCE, not ownership: the track
+	*  is expected to be gone, and this row is not a reference to it. */
+	sourceTrackId: string(),
+	/** Epoch ms the note was moved here, i.e. when the operator reviewed it. */
+	archivedAt: number().int(),
+	/** The track's `firstSeen`, when the row still knew it; `null` otherwise. */
+	trackStartedAt: number().int().nullable(),
+	/** The track's detector class (`person`, `car`, …); `null` when unknown. */
+	trackClass: string().nullable(),
+	/** The track's display label at review time; `null` when it had none. */
+	trackLabel: string().nullable()
+});
+/** Query input for `listArchivedDebugNotes` — newest first, one camera or all. */
+var ArchivedDebugNoteQueryInputSchema = object({
+	/** Restrict to a single camera; omit for every row. */
+	deviceId: number().int().optional(),
+	/** Max rows returned, newest-first. */
+	limit: number().int().min(1).max(1e3).optional()
+});
 /**
 * Ops-log — the durable, append-only operations audit shared by the
 * recordings and events management surfaces.
@@ -18052,14 +18081,14 @@ var alarmPanelCapability = {
 			code: string().min(1).optional()
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		disarm: method(object({
 			deviceId: number().int().nonnegative(),
 			code: string().min(1).optional()
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		/**
 		* Force the panel into the `triggered` state — used by HA
@@ -18070,7 +18099,7 @@ var alarmPanelCapability = {
 		*/
 		trigger: method(object({ deviceId: number().int().nonnegative() }), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		})
 	},
 	status: {
@@ -23004,6 +23033,31 @@ var pipelineAnalyticsCapability = {
 			flags: TrackFlagsPatchSchema
 		}), TrackFlagsSchema, { kind: "mutation" }),
 		/**
+		* The archived debug notes, newest first — the corpus of what operators
+		* have asked to be checked, across tracks that no longer exist (D405).
+		*
+		* `setTrackFlags` writes it: a patch carrying `debug: false` still clears
+		* the note off the track row in the same statement (D353's invariant is
+		* untouched), but the note is APPENDED here first. That is the whole point
+		* — before D405, finishing a review destroyed every note written during it,
+		* and the ones that survived aged out with their tracks. This method is the
+		* only way to read what was kept.
+		*
+		* `auth: 'protected'`, matching `setTrackFlags` next door and for the same
+		* reason: the notes are written from the viewer, by an authenticated
+		* non-admin session, and a corpus only an admin can read is a corpus the
+		* person who wrote it cannot use. It carries operator prose about cameras
+		* and nothing else — no media, no paths, no identities beyond a track's
+		* own display label.
+		*
+		* Newest-first, capped by `limit` (default
+		* {@link ARCHIVED_DEBUG_NOTES_DEFAULT_LIMIT}), optionally one camera. The
+		* table itself is bounded by row count, not by age — see
+		* {@link MAX_ARCHIVED_DEBUG_NOTES} for why an age clock would be the wrong
+		* bound for exactly this data.
+		*/
+		listArchivedDebugNotes: method(ArchivedDebugNoteQueryInputSchema, array(ArchivedDebugNoteSchema).readonly(), { kind: "query" }),
+		/**
 		* Durable event-store footprint for the management UI: event rows
 		* (motion + object + audio) counted per camera + total, plus the
 		* event-owned media bytes on disk per camera + total. Stat/count-based,
@@ -28656,7 +28710,7 @@ var brightnessCapability = {
 		percentage: number().min(0).max(100)
 	}), _void(), {
 		kind: "mutation",
-		auth: "admin"
+		auth: "protected"
 	}) },
 	events: { 
 	/**
@@ -28705,7 +28759,7 @@ var buttonCapability = {
 	deviceTypes: [DeviceType.Button],
 	methods: { press: method(object({ deviceId: number().int().nonnegative() }), _void(), {
 		kind: "mutation",
-		auth: "admin"
+		auth: "protected"
 	}) }
 };
 /**
@@ -28922,28 +28976,28 @@ var climateControlCapability = {
 			mode: HvacModeSchema
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		setFanMode: method(object({
 			deviceId: number().int().nonnegative(),
 			fanMode: string().min(1)
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		setPreset: method(object({
 			deviceId: number().int().nonnegative(),
 			preset: string().min(1)
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		setTarget: method(object({
 			deviceId: number().int().nonnegative(),
 			target: number()
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		setTargetRange: method(object({
 			deviceId: number().int().nonnegative(),
@@ -28951,28 +29005,28 @@ var climateControlCapability = {
 			targetHigh: number()
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		setTargetHumidity: method(object({
 			deviceId: number().int().nonnegative(),
 			targetHumidity: number().min(0).max(100)
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		setSwingVertical: method(object({
 			deviceId: number().int().nonnegative(),
 			on: boolean()
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		setSwingHorizontal: method(object({
 			deviceId: number().int().nonnegative(),
 			on: boolean()
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		})
 	},
 	status: {
@@ -29072,7 +29126,7 @@ var colorCapability = {
 		color: ColorInputSchema
 	}), _void(), {
 		kind: "mutation",
-		auth: "admin"
+		auth: "protected"
 	}) },
 	events: { 
 	/**
@@ -29409,7 +29463,7 @@ var controlCapability = {
 		control: ControlSetValueInputSchema
 	}), _void(), {
 		kind: "mutation",
-		auth: "admin"
+		auth: "protected"
 	}) },
 	status: {
 		schema: ControlStatusSchema,
@@ -29455,29 +29509,29 @@ var coverCapability = {
 	methods: {
 		open: method(object({ deviceId: number().int().nonnegative() }), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		close: method(object({ deviceId: number().int().nonnegative() }), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		stop: method(object({ deviceId: number().int().nonnegative() }), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		setPosition: method(object({
 			deviceId: number().int().nonnegative(),
 			position: number().min(0).max(100)
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		setTiltPosition: method(object({
 			deviceId: number().int().nonnegative(),
 			tiltPosition: number().min(0).max(100)
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		})
 	},
 	status: {
@@ -30309,28 +30363,28 @@ var fanControlCapability = {
 			percentage: number().min(0).max(100)
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		setPreset: method(object({
 			deviceId: number().int().nonnegative(),
 			preset: string().min(1)
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		setDirection: method(object({
 			deviceId: number().int().nonnegative(),
 			direction: FanDirectionSchema
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		setOscillating: method(object({
 			deviceId: number().int().nonnegative(),
 			oscillating: boolean()
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		})
 	},
 	status: {
@@ -30552,21 +30606,21 @@ var humidifierCapability = {
 			on: boolean()
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		setTargetHumidity: method(object({
 			deviceId: number().int().nonnegative(),
 			humidity: number().min(0).max(100)
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		setMode: method(object({
 			deviceId: number().int().nonnegative(),
 			mode: string().min(1)
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		})
 	},
 	status: {
@@ -31285,15 +31339,15 @@ var lawnMowerControlCapability = {
 	methods: {
 		startMowing: method(object({ deviceId: number().int().nonnegative() }), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		pause: method(object({ deviceId: number().int().nonnegative() }), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		dock: method(object({ deviceId: number().int().nonnegative() }), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		})
 	},
 	status: {
@@ -31695,18 +31749,18 @@ var lockControlCapability = {
 			code: string().min(1).optional()
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		unlock: method(object({
 			deviceId: number().int().nonnegative(),
 			code: string().min(1).optional()
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		open: method(object({ deviceId: number().int().nonnegative() }), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		})
 	},
 	status: {
@@ -31809,65 +31863,65 @@ var mediaPlayerCapability = {
 	methods: {
 		play: method(object({ deviceId: number().int().nonnegative() }), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		pause: method(object({ deviceId: number().int().nonnegative() }), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		stop: method(object({ deviceId: number().int().nonnegative() }), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		next: method(object({ deviceId: number().int().nonnegative() }), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		previous: method(object({ deviceId: number().int().nonnegative() }), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		seek: method(object({
 			deviceId: number().int().nonnegative(),
 			positionMs: number().int().nonnegative()
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		setVolume: method(object({
 			deviceId: number().int().nonnegative(),
 			volumeLevel: number().min(0).max(100)
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		setMute: method(object({
 			deviceId: number().int().nonnegative(),
 			muted: boolean()
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		setShuffle: method(object({
 			deviceId: number().int().nonnegative(),
 			shuffle: boolean()
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		setRepeat: method(object({
 			deviceId: number().int().nonnegative(),
 			repeat: MediaPlayerRepeatSchema
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		selectSource: method(object({
 			deviceId: number().int().nonnegative(),
 			source: string().min(1)
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		playMedia: method(object({
 			deviceId: number().int().nonnegative(),
@@ -31878,7 +31932,7 @@ var mediaPlayerCapability = {
 			mediaType: string().min(1)
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		})
 	},
 	status: {
@@ -33678,27 +33732,27 @@ var petFeederCapability = {
 			hopper2: gramsPortion.optional()
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		/** Cancel an in-progress manual feed. */
 		cancelFeed: method(object({ deviceId: number().int().nonnegative() }), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		/** Reset the desiccant "days remaining" counter after replacing it. */
 		resetDesiccant: method(object({ deviceId: number().int().nonnegative() }), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		/** Mark a hopper as refilled (D4H/D4S/D4SH). */
 		markFoodReplenished: method(object({ deviceId: number().int().nonnegative() }), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		/** Call the pet with the recorded prompt (D3). */
 		callPet: method(object({ deviceId: number().int().nonnegative() }), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		/** Play a stored sound by id (D3 / D4H / D4SH). */
 		playSound: method(object({
@@ -33706,7 +33760,7 @@ var petFeederCapability = {
 			soundId: number().int().nonnegative()
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		/** Toggle the child-lock (manual-lock) setting. */
 		setChildLock: method(object({
@@ -33714,7 +33768,7 @@ var petFeederCapability = {
 			on: boolean()
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		/** Toggle the front indicator light. */
 		setIndicatorLight: method(object({
@@ -33722,7 +33776,7 @@ var petFeederCapability = {
 			on: boolean()
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		/** Toggle the dispense chime. */
 		setFeedSound: method(object({
@@ -33730,7 +33784,7 @@ var petFeederCapability = {
 			on: boolean()
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		/** Set the speaker / prompt volume level. */
 		setVolume: method(object({
@@ -33738,7 +33792,7 @@ var petFeederCapability = {
 			level: number().int().nonnegative()
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		})
 	},
 	status: {
@@ -36351,7 +36405,7 @@ var switchCapability = {
 		on: boolean()
 	}), _void(), {
 		kind: "mutation",
-		auth: "admin"
+		auth: "protected"
 	}) },
 	events: { onStateChanged: { data: object({
 		deviceId: number(),
@@ -37490,30 +37544,30 @@ var vacuumControlCapability = {
 	methods: {
 		start: method(object({ deviceId: number().int().nonnegative() }), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		pause: method(object({ deviceId: number().int().nonnegative() }), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		stop: method(object({ deviceId: number().int().nonnegative() }), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		returnToBase: method(object({ deviceId: number().int().nonnegative() }), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		locate: method(object({ deviceId: number().int().nonnegative() }), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		setFanSpeed: method(object({
 			deviceId: number().int().nonnegative(),
 			speed: string().min(1)
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		})
 	},
 	status: {
@@ -37557,22 +37611,22 @@ var valveCapability = {
 	methods: {
 		open: method(object({ deviceId: number().int().nonnegative() }), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		close: method(object({ deviceId: number().int().nonnegative() }), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		stop: method(object({ deviceId: number().int().nonnegative() }), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		setPosition: method(object({
 			deviceId: number().int().nonnegative(),
 			position: number().min(0).max(100)
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		})
 	},
 	status: {
@@ -37671,21 +37725,21 @@ var waterHeaterCapability = {
 			temp: number().finite()
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		setOperationMode: method(object({
 			deviceId: number().int().nonnegative(),
 			mode: string().min(1)
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		setAway: method(object({
 			deviceId: number().int().nonnegative(),
 			on: boolean()
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		})
 	},
 	status: {
@@ -41720,6 +41774,12 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"pipelineAnalytics.listArchivedDebugNotes": {
+		capName: "pipeline-analytics",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
 	"pipelineAnalytics.listEventKinds": {
 		capName: "pipeline-analytics",
 		capScope: "device",
@@ -45507,6 +45567,11 @@ Object.freeze({
 		form: "array",
 		optional: true
 	}],
+	"pipelineAnalytics.listArchivedDebugNotes": [{
+		name: "deviceId",
+		form: "single",
+		optional: true
+	}],
 	"pipelineAnalytics.listEventKinds": [{
 		name: "deviceId",
 		form: "single",