@camstack/addon-osd-manager 0.1.96 → 0.1.98

package/dist/index.mjs

@@ -1,4 +1,4 @@
-//#region ../types/dist/event-category-DAXzJeTX.mjs
+//#region ../types/dist/event-category-ZyX6jcse.mjs
 var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["SystemBoot"] = "system.boot";
 	EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -559,7 +559,7 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	* a package zone — a newly-appeared stationary object of a package class
 	* that cleared the class / zone / dwell / size gates. Payload:
 	* `PipelineAnalyticsPackageDeliveredPayload` carrying `{ deviceId,
-	* entryId, className, zoneIds, keyFrameMediaKey?, bbox, timestamp }`.
+	* entryId, className, zoneIds, keyFrameMediaId?, bbox, timestamp }`.
 	* Telemetry (D8): the durable record is the `package-events` store row;
 	* this bus topic drives notifier rules + live UI. See
 	* docs/superpowers/specs/2026-07-17-package-zones-design.md §5.1.
@@ -5345,7 +5345,7 @@ var ZodIssueCode = {
 var ZodFirstPartyTypeKind;
 ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
 //#endregion
-//#region ../types/dist/sleep-BnujYGPe.mjs
+//#region ../types/dist/sleep-DBKu2-U5.mjs
 /**
 * The audio chunk plane's byte format, and the ONE expansion from a coded
 * window to float samples (D455).
@@ -7408,13 +7408,30 @@ new Set([
 	"scene",
 	"motion",
 	"object",
-	"audio"
+	"audio",
+	"mosaic"
 ]);
-new Set([
+/**
+* The owner types that are event tables, in the order the event-media resolver
+* should consider them. Exported so a consumer asking "is this key an event?"
+* does not re-spell the list and drift from it.
+*/
+var EVENT_OWNER_TYPES = [
 	"motion",
 	"object",
 	"audio"
-]);
+];
+/**
+* The same list as a Zod enum, for the cap inputs that must NAME the table
+* (D482: `getEventMedia` / `listEventMedia` take an owner, and an owner is
+* `(table, id)`).
+*
+* Built FROM {@link EVENT_OWNER_TYPES} rather than re-spelled: a fourth event
+* table would otherwise be accepted by the codec and refused at the door, with
+* nothing failing until a caller asked.
+*/
+var EventOwnerTypeSchema = _enum(EVENT_OWNER_TYPES);
+new Set(EVENT_OWNER_TYPES);
 var EncodeProfileSchema = object({
 	video: object({
 		codec: _enum([
@@ -7453,7 +7470,23 @@ var EncodeProfileSchema = object({
 			"zerolatency",
 			"film",
 			"animation"
-		]).optional()
+		]).optional(),
+		/**
+		* ONE slice per access unit.
+		*
+		* `-tune zerolatency` turns on x264's sliced threads, and a frame then leaves
+		* the encoder as five NAL slices that share one RTP timestamp and carry one
+		* marker bit. A libwebrtc depacketiser sees five frame-starts and one
+		* frame-end per frame: the first pictures render and the video then freezes
+		* for good while the audio, on its own plane, plays on. Measured on this hub
+		* 2026-09-13 against the Echo, and reduced to one slice by this flag alone.
+		*
+		* A NAMED field and not a raw flag, because {@link EgressEncodeSchema} omits
+		* `outputArgs` on purpose: an opaque array is part of the sharing key, so two
+		* consumers meaning the same thing spelled differently would stop sharing one
+		* child. Absent means "whatever the encoder does" — today's behaviour.
+		*/
+		singleSlicePerFrame: boolean().optional()
 	}),
 	audio: union([literal("passthrough"), object({
 		codec: _enum([
@@ -7503,7 +7536,7 @@ var BASE_LIVE_EGRESS_PROFILE = {
 	audio: "passthrough"
 };
 ({ ...BASE_LIVE_EGRESS_PROFILE }), { ...BASE_LIVE_EGRESS_PROFILE.video };
-({ ...BASE_LIVE_EGRESS_PROFILE });
+({ ...BASE_LIVE_EGRESS_PROFILE }), { ...BASE_LIVE_EGRESS_PROFILE.video };
 /**
 * Deep wiring healthcheck — snapshot of active reachability probes across
 * every declared capability + widget of every installed plugin, on every
@@ -13379,6 +13412,59 @@ var settingsStoreCapability = {
 			filter: QueryFilterSchema.optional(),
 			columns: array(string()).readonly().optional()
 		}), array(SettingsRecordSchema).readonly()),
+		/**
+		* Make a SLOT hold this row — insert it, or update whatever already
+		* occupies the slot — and answer with the id the row HAS.
+		*
+		* ## Why the store needed this
+		*
+		* {@link set} is already an upsert, but its slot is the PRIMARY KEY: the
+		* caller has to know the id to address the row. That is exactly what a
+		* collection keyed by an `INTEGER` rowid alias cannot do — SQLite assigns
+		* the id, so a writer whose uniqueness rule is "one row per
+		* `(ownerKind, ownerId, kind, slot)`" has no id to name and no way to
+		* express the rule. {@link insert} can express it (a UNIQUE index
+		* arbitrates) but only by THROWING at the loser of a race, and the loser
+		* here is a legitimate re-capture, not an error.
+		*
+		* Getting there without this method means read-then-write: query the slot,
+		* then `insert` or `update`. Two statements instead of one, a race between
+		* them, and a recovery path that has to recognise a UNIQUE violation by its
+		* MESSAGE — across a process boundary, because the store lives behind an
+		* RPC door. A string match would be the whole gate, and a store that
+		* rephrased its error would lose the row silently. One statement has no
+		* such gate (D482).
+		*
+		* ## The contract
+		*
+		* `conflict` names the DECLARED columns that identify the slot. They must
+		* be covered by a UNIQUE index on the collection — SQLite resolves an
+		* `ON CONFLICT` target against its indexes and REFUSES the statement when
+		* none matches, so a wrong list is a loud error on the first write, never a
+		* silently duplicated row. An empty list is refused rather than passed on:
+		* `ON CONFLICT()` is not valid SQL, and the intent it would most likely
+		* encode ("no slot, just insert") is {@link insert}.
+		*
+		* Row shape is {@link insert}'s: `record.id` is used when the collection
+		* needs a supplied key and IGNORED when the primary key is an `INTEGER`
+		* rowid alias — exactly as `insert` and `insertMany` already treat it.
+		*
+		* Returns the id either way: the one SQLite assigned on an insert, or the
+		* one the row it updated already had. A caller cannot tell which happened,
+		* and deliberately — every caller wants the slot's id, and one that needed
+		* to distinguish creation from replacement would have to read first anyway.
+		*/
+		upsert: method(object({
+			namespace: string().optional(),
+			collection: string(),
+			/** Declared columns identifying the slot; must be covered by a UNIQUE
+			*  index on the collection. Never empty. */
+			conflict: array(string()).readonly(),
+			record: BulkRecordSchema
+		}), object({ 
+		/** The id the row HAS: assigned by SQLite on an insert, or the existing
+		*  row's own id on an update. */
+id: union([string(), number()]) }), { kind: "mutation" }),
 		/** Insert a new record. */
 		insert: method(object({
 			namespace: string().optional(),
@@ -13668,6 +13754,20 @@ id: union([string(), number()]) }), {
 			kind: "mutation",
 			auth: "admin"
 		}),
+		/**
+		* Make a slot hold this row, and answer with the id the row HAS. The
+		* engine half of `settings-store.upsert` — read that docblock for why the
+		* store needed a slot that is not the primary key (D482).
+		*/
+		upsert: method(object({
+			namespace: string().optional(),
+			collection: string(),
+			conflict: array(string()).readonly(),
+			record: BulkRecordSchema
+		}), object({ id: union([string(), number()]) }), {
+			kind: "mutation",
+			auth: "admin"
+		}),
 		/** Insert many records in ONE transaction. All or nothing. */
 		insertMany: method(object({
 			namespace: string().optional(),
@@ -21852,8 +21952,8 @@ var TrackPositionSchema = object({
 var TrackSnapshotSchema = object({
 	timestamp: number(),
 	position: TrackPositionSchema,
-	/** MediaStore key; resolve via `getTrackMedia({ trackId })`. */
-	mediaKey: string()
+	/** The snapshot's media row id (D482); resolve via `listTrackMedia({ trackId })`. */
+	mediaId: number().int()
 });
 /**
 * Normalized 0..1 trajectory envelope (min/max over every position bbox,
@@ -22457,14 +22557,14 @@ var ObjectEventSchema = object({
 	*  pixel-space `bbox` onto a displayed image. Omitted in slim projection. */
 	frameWidth: number().optional(),
 	frameHeight: number().optional(),
-	/** MediaStore key for the crop attached to this event (if any). */
-	mediaKey: string().optional(),
-	/** Design B: MediaStore key of the track's native-resolution key frame (the
+	/** Media row id of the crop attached to this event (if any) — D482. */
+	mediaId: number().int().optional(),
+	/** Design B: media row id of the track's native-resolution key frame (the
 	*  best-detection full frame). Resolve via the event-media data-plane
-	*  (`/addon/<addonId>/event-media/<keyFrameMediaKey>`) for a detail view that
+	*  (`/addon/<addonId>/event-media/m/<keyFrameMediaId>`) for a detail view that
 	*  draws `bbox` over the native frame. Absent on legacy rows / non-decoded
-	*  sources — consumers fall back to `mediaKey` (the tight crop). */
-	keyFrameMediaKey: string().optional(),
+	*  sources — consumers fall back to `mediaId` (the tight crop). */
+	keyFrameMediaId: number().int().optional(),
 	/** Populated by B5 (recording playback URL for this event). */
 	mediaUrl: string().optional(),
 	/** The parent track's key-event importance [0,1], propagated to every object
@@ -22514,7 +22614,7 @@ var MediaFileKindEnum = _enum([
 * hub-main's heap on the way past — for an `<img>` that would have cached it.
 *
 * `url` points at the `event-media` data plane
-* (`/addon/<addonId>/event-media/<storedKey>`), which serves the same blob
+* (`/addon/<addonId>/event-media/m/<mediaId>` — D482), which serves the same blob
 * with an ETag and `Cache-Control: immutable`, honours conditional GETs, can
 * render a `?variant=thumb`, and streams. The hub gate in front of it requires
 * a bearer or the session cookie (`access: 'authenticated'`), so the bytes are
@@ -22522,10 +22622,13 @@ var MediaFileKindEnum = _enum([
 * `data-plane-access.ts` for the rule and the one gap it does not close
 * (per-device scoping).
 *
-* The URL is built from the row's **stored** key, which is not always its
-* published `kind`: a track's face/plate crop is stored as `crop` under
+* The URL is built from the row's own id, which since D482 says nothing about
+* the row's owner or kind — and that is the point. The published `kind` is not
+* the stored one (a track's face/plate crop is stored as `crop` under
 * `('face'|'plate', '<prefix>-<trackId>')` and published as
-* `faceCrop`/`plateCrop`. `MediaStore.getByKey` knows only the stored key.
+* `faceCrop`/`plateCrop`), and under the old composite key the URL had to be
+* taken from `row.key` verbatim or it 404'd exactly those two rows. An id
+* cannot be mis-reconstructed, because there is nothing in it to reconstruct.
 *
 * ## `base64` is TRANSITIONAL and is going away
 *
@@ -22538,7 +22641,19 @@ var MediaFileKindEnum = _enum([
 * `analytics-query-facade.ts`; nothing else reads it.
 */
 var MediaFileSchema = object({
-	key: string(),
+	/**
+	* The media row's OWN id — the rowid SQLite assigned it (D482).
+	*
+	* It used to be the row's composite key, `<ownerType>:<ownerId>:<fileKind>
+	* [:<timestampMs>]`, which embedded a FOREIGN id. D474 made event ids
+	* per-table rowid aliases, so `object:101314` and `motion:101314` are two
+	* different rows that spell the same number, and a track whose
+	* `bestEventId` was an object event was served a motion event's snapshot —
+	* a night-time thumbnail on an afternoon track, with no error anywhere. A
+	* surrogate id cannot name the wrong row's owner, because it names no owner
+	* at all.
+	*/
+	mediaId: number().int(),
 	kind: MediaFileKindEnum,
 	sizeBytes: number(),
 	timestamp: number()
@@ -22646,7 +22761,7 @@ var RetrainTrackSchema = object({
 });
 /** A frame the picker may offer — an index row, no blob was read to produce it. */
 var RetrainFrameCandidateSchema = object({
-	mediaKey: string(),
+	mediaId: number().int(),
 	kind: MediaFileKindEnum,
 	timestamp: number(),
 	sizeBytes: number().int(),
@@ -22660,7 +22775,7 @@ var RetrainFrameSchema = object({
 	deviceId: number(),
 	trackId: string(),
 	/** Provenance only. It may already point at nothing — that is expected. */
-	sourceMediaKey: string(),
+	sourceMediaId: number().int(),
 	sourceKind: MediaFileKindEnum,
 	sizeBytes: number().int(),
 	width: number().int(),
@@ -22676,7 +22791,7 @@ var RetrainCopyRefusalSchema = _enum([
 var RetrainFrameSelectionSchema = object({
 	copied: array(RetrainFrameSchema).readonly(),
 	refused: array(object({
-		sourceMediaKey: string(),
+		sourceMediaId: number().int(),
 		reason: RetrainCopyRefusalSchema
 	})).readonly()
 });
@@ -22684,7 +22799,7 @@ var RetrainFrameListSchema = object({
 	candidates: array(RetrainFrameCandidateSchema).readonly(),
 	copies: array(RetrainFrameSchema).readonly(),
 	/** What the page pre-selects — the native key frame when one survives. */
-	autoPickMediaKey: string().optional()
+	autoPickMediaId: number().int().optional()
 });
 /** What the operator asked the assist to look for. */
 var RetrainAssistSubjectSchema = discriminatedUnion("kind", [object({
@@ -22779,9 +22894,11 @@ var RecentTracksQueryInput = object({
 });
 /**
 * A Summary (D359): the per-camera session envelope that references tracks.
-* `groupShotKey` is the media key of its group shot (`ownerKind: 'summary'`,
-* served by the event-media plane by key), null until the first frame with a
-* member visible has been materialised.
+* `groupShotMediaId` is the media ROW id of its group shot (`ownerKind:
+* 'summary'`, served by the event-media plane at `/m/<id>`), null until the
+* first frame with a member visible has been materialised (D482 — it was the
+* row's composite key, which embedded the owner and could name another table's
+* row once event ids became per-table rowids).
 */
 var SummarySchema = object({
 	id: string(),
@@ -22790,19 +22907,115 @@ var SummarySchema = object({
 	lastActiveAt: number(),
 	sealedAt: number().nullable(),
 	memberCount: number().int().nonnegative(),
-	groupShotKey: string().nullable()
+	groupShotMediaId: number().int().nullable()
 });
 var SummariesQueryInput = object({
 	deviceIds: array(number()).min(1),
 	since: number().optional(),
 	until: number().optional(),
-	limit: number().int().min(1).max(200).default(50)
+	limit: number().int().min(1).max(200).default(50),
+	/** The same member-wise filter {@link listRecentSummaries} takes — one
+	*  meaning of "dog" on every summary surface. */
+	classes: array(string().min(1).max(60)).max(40).optional()
 });
-var SummariesPageSchema = object({ summaries: array(SummarySchema).readonly() });
 var SummaryDetailSchema = object({
 	summary: SummarySchema,
-	/** Member track ids, in absorption order. */
-	trackIds: array(string()).readonly()
+	/** Members in absorption order, oldest join first. */
+	members: array(object({
+		trackId: string(),
+		/**
+		* The track's class at the time it JOINED, or `null` when it was unresolved
+		* and the track no longer exists to fill it.
+		*
+		* The join, not the latest opinion: class voting can re-decide a track's
+		* class afterwards, and a group's composition is the history of who came
+		* together. A consumer counts these to badge a thumbnail — "two people and a
+		* dog" — rather than being handed a second, denormalised tally that would
+		* drift from the members it claims to describe.
+		*/
+		className: string().nullable(),
+		/** `primary` is the one member that carries the group's identity. */
+		role: _enum([
+			"primary",
+			"sibling",
+			"child"
+		]).nullable(),
+		joinedAt: number(),
+		/** Tier 1 — the sub-class (`dog`, `van`), resolved from the member's track
+		*  at read time. Absent when nothing resolved, never an empty string. */
+		label: string().optional(),
+		/** Tier 2 — the instance: a person's name, a plate. Absent when the pipeline
+		*  recognised nobody, and absent for a member whose track has been pruned —
+		*  a thumbnail that names the wrong person is worse than one naming nobody. */
+		subLabel: string().optional()
+	})).readonly()
+});
+/**
+* What a LIST of groups carries: the envelope plus what it is MADE OF.
+*
+* Coarse on purpose — the operator's rule is "only the rough data on the list,
+* we extend when we notice we need more". Enough to draw the card ("two people
+* and a dog") and no more. The MEMBERS, their names and the per-member links
+* are on {@link getSummary}: shipping every member of every group so a client
+* can count them turns a page of two hundred groups into a thousand records to
+* draw two hundred badges.
+*/
+var SummaryListItemSchema = object({
+	summary: SummarySchema,
+	/** Class counts, most numerous first; `className: null` is a member whose
+	*  class never resolved, counted so the counts add up to `memberCount`. */
+	classes: array(object({
+		className: string().nullable(),
+		count: number().int().positive()
+	})).readonly()
+});
+var SummariesPageSchema = object({ summaries: array(SummaryListItemSchema).readonly() });
+/**
+* The paged feed, deliberately the SAME shape as {@link RecentTracksQueryInput}.
+*
+* The reel on the cameras page and the Events gallery both ride a cursor, so a
+* summaries feed that could only answer "the last N for these cameras"
+* (`listSummaries`) would make groups available in the timeline and nowhere
+* else. Two feeds with different ordering contracts would be two ideas of what
+* "newest" means, on one screen.
+*/
+var RecentSummariesQueryInput = object({
+	/** Devices to merge. An empty array yields an empty page. */
+	deviceIds: array(number()),
+	/** Window lower bound on `lastActiveAt` (inclusive). */
+	since: number().optional(),
+	/** Window upper bound on `lastActiveAt` (inclusive). */
+	until: number().optional(),
+	limit: number().int().min(1).max(500).default(100),
+	/** Opaque continuation cursor from a previous page's `nextCursor`. */
+	cursor: string().optional(),
+	/**
+	* Restrict to these classes — THE SAME FIELD `listRecentTracks` takes, and
+	* deliberately the same name: the events filter tree emits one list of ticked
+	* taxonomy nodes, and a summaries feed that called it something else would
+	* make the operator's one filter component produce two shapes.
+	*
+	* A question about the MEMBERS: a group matches when ANY of them does. "Show
+	* me the arrivals with a dog" has to return the group of four people who had
+	* one with them; a filter on the group's own fields could only ever answer
+	* about its primary.
+	*
+	* Matched against all THREE tiers of a member — the class (`animal`), the
+	* sub-class (`dog`) and the instance (a name, a plate) — because which tier a
+	* ticked node lives on is the taxonomy's business, not the caller's. `dog` is
+	* an event kind in the tree and a tier-1 label on an `animal` track; a filter
+	* that read only the class would answer "animal" and never "dog".
+	*
+	* ABSENT or EMPTY means no filter — absent is not a selection of none.
+	*/
+	classes: array(string().min(1).max(60)).max(40).optional()
+});
+var RecentSummariesPageSchema = object({
+	/** Ordered by (`lastActiveAt` DESC, id DESC). Same light item as
+	*  {@link listSummaries} — one list shape, so a card renders the same
+	*  whichever feed drew it. */
+	summaries: array(SummaryListItemSchema).readonly(),
+	nextCursor: string().nullable()
 });
 var RecentTracksPageSchema = object({
 	/** Merged page, ordered by (`lastSeen` DESC, `trackId` DESC). */
@@ -23244,6 +23457,11 @@ var pipelineAnalyticsCapability = {
 		listRecentTracks: method(RecentTracksQueryInput, RecentTracksPageSchema),
 		/** Newest first by `openedAt`, for a camera set, inside an optional window. */
 		listSummaries: method(SummariesQueryInput, SummariesPageSchema),
+		/**
+		* The PAGED feed — the reel and the Events gallery. Same cursor contract as
+		* {@link listRecentTracks}, so one screen cannot hold two ideas of newest.
+		*/
+		listRecentSummaries: method(RecentSummariesQueryInput, RecentSummariesPageSchema),
 		/** One summary with its member track ids; `null` for an id nobody wrote. */
 		getSummary: method(object({ id: string() }), SummaryDetailSchema.nullable()),
 		clearTracks: method(object({ deviceId: number() }), _void(), {
@@ -23773,7 +23991,7 @@ var pipelineAnalyticsCapability = {
 		selectRetrainFrames: method(object({
 			deviceId: number(),
 			trackId: string(),
-			mediaKeys: array(string()).min(1)
+			mediaIds: array(number().int()).min(1)
 		}), RetrainFrameSelectionSchema, {
 			kind: "mutation",
 			auth: "admin"
@@ -23937,8 +24155,29 @@ var pipelineAnalyticsCapability = {
 			kind: "query",
 			auth: "admin"
 		}),
+		/**
+		* The media an EVENT owns.
+		*
+		* `ownerType` is REQUIRED, and that is the whole correction (D482). An
+		* event is a row in ONE of three tables, and since D474 each numbers from
+		* 1 independently: `motion:101314` and `object:101314` both exist. This
+		* method took a bare `eventId` and the provider probed motion → object →
+		* audio, stopping at the first hit — so on the live hub, where object
+		* events own no media of their own and 299 883 of 300 559 media rows are
+		* motion-owned, EVERY object event resolved to its motion namesake. A
+		* track from 17:34 on camera 615 was served a snapshot from 22:35 eleven
+		* days earlier, silently.
+		*
+		* D476 had already disambiguated the KEY (`motion:` vs `object:`); this is
+		* the API catching up to it. Naming the table is not a "qualification" of
+		* the ambiguity — a listing BY OWNER has no address to make surrogate: the
+		* owner IS (table, id), and half of it is not a question.
+		*/
 		getEventMedia: method(object({
-			eventId: string(),
+			/** Which of the three event tables owns the row. */
+			ownerType: EventOwnerTypeSchema,
+			/** The event's rowid in that table (D474: an event id is a number). */
+			eventId: number().int(),
 			kind: MediaFileKindEnum.optional(),
 			deviceId: number()
 		}), array(MediaFileSchema).readonly()),
@@ -23983,11 +24222,14 @@ var pipelineAnalyticsCapability = {
 		* the live hub: one event's `fullFrameBoxed` is 2 824 077 B, base64'd to
 		* ~3.8 MB, allocated whole in hub-main's heap, for a list of keys.
 		*
-		* Same `deviceId` authorization subject as `getEventMedia`, and the same
-		* rows — this is a projection of that method, never a different question.
+		* Same `deviceId` authorization subject as `getEventMedia`, the same
+		* REQUIRED `ownerType` (read that method's docblock for the night-time
+		* thumbnail this closes — D482), and the same rows: this is a projection
+		* of that method, never a different question.
 		*/
 		listEventMedia: method(object({
-			eventId: string(),
+			ownerType: EventOwnerTypeSchema,
+			eventId: number().int(),
 			deviceId: number()
 		}), array(MediaFileInfoSchema).readonly()),
 		/**
@@ -30614,8 +30856,8 @@ var IdentitySchema = object({
 	id: string(),
 	name: string(),
 	sampleCount: number().int().nonnegative(),
-	coverMediaKey: string().optional(),
-	/** Inline base64 of the cover sample's crop, resolved from `coverMediaKey`.
+	coverMediaId: number().int().optional(),
+	/** Inline base64 of the cover sample's crop, resolved from `coverMediaId`.
 	*  Lets the UI render the person's face avatar instead of a placeholder icon. */
 	coverBase64: string().optional()
 });
@@ -30641,8 +30883,8 @@ var IdentitySampleAuditRowSchema = object({
 	enrolledAt: number().int(),
 	deviceId: number().int().optional(),
 	source: _enum(["detected", "photo"]),
-	/** The enrolled crop's media key, so the panel can show the evidence. */
-	mediaKey: string().optional(),
+	/** The enrolled crop's media row id, so the panel can show the evidence. */
+	mediaId: number().int().optional(),
 	/**
 	* False = the sample is stamped with a DIFFERENT face model, and a cosine
 	* across feature spaces is a well-formed float with no meaning. Every number
@@ -30711,15 +30953,15 @@ var FaceInfoSchema = object({
 	*/
 	cropUrl: string().optional(),
 	/** Design B: the face bbox (pixel space) on the key frame — lets a detail
-	*  view draw the box over the native `keyFrameMediaKey` frame. Absent on
+	*  view draw the box over the native `keyFrameMediaId` frame. Absent on
 	*  legacy rows written before design B. */
 	faceBbox: BoundingBoxSchema.optional(),
 	/** Design B: MediaStore key of the track's native-resolution key frame.
 	*  Fetch the native JPEG via the event-media data-plane
-	*  (`/addon/<addonId>/event-media/<keyFrameMediaKey>`). Absent when the
+	*  (`/addon/<addonId>/event-media/m/<keyFrameMediaId>`). Absent when the
 	*  track produced no key frame (e.g. native/onboard source) — the UI falls
 	*  back to the inline `base64` face crop. */
-	keyFrameMediaKey: string().optional(),
+	keyFrameMediaId: number().int().optional(),
 	/** Winning identity-match cosine (0..1) for this face's track, when an
 	*  identity was auto-confirmed. Lets the UI surface WHY a face was assigned
 	*  (confidence badge / low-confidence audit). Absent on legacy rows and on
@@ -30788,11 +31030,14 @@ var FaceClusterSchema = object({
 * `data:image/jpeg;base64,…` from a row whose `key` sat right beside it, in a
 * dialog already rendering its key FRAME from the `event-media` plane.
 *
-* `url` is `/addon/<addonId>/event-media/<encoded key>`. The plane resolves a
-* media key directly, so this needed no new plane and no new access decision.
+* `url` is `/addon/<addonId>/event-media/m/<mediaId>` (D482). The plane
+* resolves a media row by its own id, so this needed no new plane and no new
+* access decision.
 */
 var MediaFileLiteSchema$1 = object({
-	key: string(),
+	/** The media row's own id — the same address `MediaFileRef.mediaId` carries
+	*  (D482). It was the row's composite key, which embedded the owner. */
+	mediaId: number().int(),
 	kind: string(),
 	url: string(),
 	sizeBytes: number(),
@@ -30814,7 +31059,7 @@ var faceGalleryCapability = {
 		* covers inline, ~10 KB of base64 per row, on a query this UI mounts
 		* four times and the viewer holds at `staleTime: 30_000`.
 		*
-		* Nothing loses its avatar: `coverMediaKey` is already on every row and
+		* Nothing loses its avatar: `coverMediaId` is already on every row and
 		* the `event-media` plane serves that key `immutable` with an ETag.
 		*
 		* **This is an INPUT field, so it does not reach the addon until the
@@ -34553,8 +34798,8 @@ var VehicleSchema = object({
 	id: string(),
 	name: string(),
 	sampleCount: number().int().nonnegative(),
-	coverMediaKey: string().optional(),
-	/** Inline base64 of the cover sample's plate crop, resolved from `coverMediaKey`. */
+	coverMediaId: number().int().optional(),
+	/** Inline base64 of the cover sample's plate crop, resolved from `coverMediaId`. */
 	coverBase64: string().optional()
 });
 var VehicleSampleInfoSchema = object({
@@ -34587,7 +34832,7 @@ var PlateInfoSchema = object({
 	/** keyFrame parity: the plate bbox (pixel space) on the native key frame. */
 	plateBbox: BoundingBoxSchema.optional(),
 	/** keyFrame parity: MediaStore key of the track's native-resolution key frame. */
-	keyFrameMediaKey: string().optional(),
+	keyFrameMediaId: number().int().optional(),
 	base64: string().optional(),
 	/**
 	* Same crop as a data-plane URL, always present when the plate has a stored
@@ -34608,11 +34853,14 @@ var PlateInfoSchema = object({
 * `data:image/jpeg;base64,…` from a row whose `key` sat right beside it, in a
 * dialog already rendering its key FRAME from the `event-media` plane.
 *
-* `url` is `/addon/<addonId>/event-media/<encoded key>`. The plane resolves a
-* media key directly, so this needed no new plane and no new access decision.
+* `url` is `/addon/<addonId>/event-media/m/<mediaId>` (D482). The plane
+* resolves a media row by its own id, so this needed no new plane and no new
+* access decision.
 */
 var MediaFileLiteSchema = object({
-	key: string(),
+	/** The media row's own id — the same address `MediaFileRef.mediaId` carries
+	*  (D482). It was the row's composite key, which embedded the owner. */
+	mediaId: number().int(),
 	kind: string(),
 	url: string(),
 	sizeBytes: number(),
@@ -34694,7 +34942,7 @@ var plateGalleryCapability = {
 		listVehicles: method(object({ 
 		/** Inline {@link VehicleSchema.coverBase64} on every row. Default
 		*  `false` — the vehicle twin of `faceGallery.listIdentities`'s
-		*  option; `coverMediaKey` + the `event-media` plane carry the picture.
+		*  option; `coverMediaId` + the `event-media` plane carry the picture.
 		*  INPUT field: stripped by the hub router until the train ships, which
 		*  resolves to `false` and is exactly the intended default. */
 includeCrops: boolean().optional() }).optional(), array(VehicleSchema).readonly()),
@@ -36557,7 +36805,14 @@ var SceneReferenceSchema = object({
 	modelId: string(),
 	condition: SceneConditionSchema,
 	capturedAt: number(),
-	thumbnailMediaId: string().optional(),
+	/**
+	* The reference thumbnail's media ROW id (D482).
+	*
+	* The name already said `mediaId` while the value was the row's composite
+	* key — a leftover that read as done and was not. It is the row's own id
+	* now, addressed at `/addon/<addonId>/event-media/m/<id>`.
+	*/
+	thumbnailMediaId: number().int().optional(),
 	/** Whole-frame (downscaled) embedding captured alongside the ROI crop. The
 	*  anti-view-shift anchor: a bumped camera, a PTZ preset or a re-aim makes the
 	*  normalized rect frame a different piece of world, and the scene would
@@ -37648,7 +37903,29 @@ var LoggingSettingsPatchSchema = object({
 	* disarmed the channels it did not mention would make the Levels page and
 	* the Diagnostics page fight over the same value.
 	*/
-	channels: array(LogChannelWindowPatchSchema).readonly().optional()
+	channels: array(LogChannelWindowPatchSchema).readonly().optional(),
+	/**
+	* How many days the analytics OPS LOG is kept — the audit trail of what
+	* retention actually deleted.
+	*
+	* It lives HERE, on the logging document, and not on the analytics addon's
+	* settings form, on the operator's instruction: every other log-ish window in
+	* this system is configured through this one document, and a retention audit
+	* configured somewhere else is a second place to look when the question is
+	* "what happened to my data".
+	*
+	* That placement has a cost worth stating: this document ships in the
+	* framework closure, so this knob needs a published `@camstack/server` while
+	* the four windows beside it (D485) reach a node on `camstack deploy`.
+	*
+	* `retention-model.ts` argued this one must NOT follow a device window,
+	* because the audit trail is the history of the SWEEP and not of the camera.
+	* That argument stands and is untouched — what changes is that 30 days stops
+	* being a constant nobody can reach. `0` keeps it forever. The floor is 1 day
+	* rather than 0-as-delete: an audit log truncated to nothing is precisely the
+	* state in which the next 9.5 GiB leak cannot be explained.
+	*/
+	opsLogRetentionDays: number().int().min(0).max(3650).optional()
 });
 /**
 * Which LAYER of the hierarchy is addressed. Absent = the cluster layer.
@@ -37721,6 +37998,14 @@ var LoggingSettingsStateSchema = object({
 	channels: array(LogChannelDescriptorSchema).readonly(),
 	/** The channels ARMED right now, each with its deadline. */
 	activeChannels: array(LogChannelWindowStateSchema).readonly(),
+	/**
+	* The ops-log window in days, as it is in force. `0` = kept forever.
+	*
+	* Reported rather than left to the caller's memory of what it wrote: this is
+	* the value the analytics sweep will actually use, and an operator asking how
+	* long their audit trail lives should not have to infer it from a default.
+	*/
+	opsLogRetentionDays: number().int().min(0),
 	persisted: boolean()
 });
 var systemCapability = {
@@ -38692,7 +38977,7 @@ var StationaryObjectSchema = object({
 	/** Enrichment label carried from the source track (identity / plate). */
 	label: string().optional(),
 	/** Native-resolution key-frame media key for the parked object's best image. */
-	keyFrameMediaKey: string().optional()
+	keyFrameMediaId: number().int().optional()
 });
 var CameraOccupancySnapshotSchema = object({
 	/** Frame timestamp of the inference result that produced this snapshot. */
@@ -40195,6 +40480,12 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"dataStoreProvider.upsert": {
+		capName: "data-store-provider",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"dayNight.getOptions": {
 		capName: "day-night",
 		capScope: "device",
@@ -42631,6 +42922,12 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"pipelineAnalytics.listRecentSummaries": {
+		capName: "pipeline-analytics",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
 	"pipelineAnalytics.listRecentTracks": {
 		capName: "pipeline-analytics",
 		capScope: "device",
@@ -44059,6 +44356,12 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"settingsStore.upsert": {
+		capName: "settings-store",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"smtpProvider.getStatus": {
 		capName: "smtp-provider",
 		capScope: "system",
@@ -46452,6 +46755,11 @@ Object.freeze({
 		form: "single",
 		optional: true
 	}],
+	"pipelineAnalytics.listRecentSummaries": [{
+		name: "deviceIds",
+		form: "array",
+		optional: false
+	}],
 	"pipelineAnalytics.listRecentTracks": [{
 		name: "deviceIds",
 		form: "array",