@camstack/types 1.1.49 → 1.1.51

package/dist/index.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sleep = require("./sleep-BfvNtyu8.js");
+const require_sleep = require("./sleep-CF-UWPp0.js");
 const require_event_category = require("./event-category-CGj9fI4L.js");
 const require_enums = require("./enums.js");
 const require_err_msg = require("./err-msg-COpsHMw2.js");
@@ -1048,6 +1048,71 @@ function migrateConfigToBands(config) {
 	return schedules.map((schedule) => bandFromSchedule(schedule, bandMode, config));
 }
 //#endregion
+//#region src/interfaces/ops-log.ts
+/**
+* Ops-log — the durable, append-only operations audit shared by the
+* recordings and events management surfaces.
+*
+* ONE row shape is reused for both domains so a single "Activity" view can
+* merge the recorder's DurableState ring (recordings ops-log) and the
+* pipeline-analytics SQLite collection (events ops-log). Each row records a
+* management operation, WHY it ran (reason), and its measurable effect
+* (itemsAffected + bytesReclaimed). Writes are best-effort — a failed log must
+* never fail the operation it records.
+*/
+/** Which management domain the operation belongs to. */
+var OpsLogDomainSchema = zod.z.enum(["recording", "events"]);
+/** The kind of management operation performed. */
+var OpsLogOpSchema = zod.z.enum([
+	"prune",
+	"manual-delete",
+	"rescan",
+	"retention-run"
+]);
+/** Why the operation ran. */
+var OpsLogReasonSchema = zod.z.enum([
+	"retention",
+	"quota",
+	"manual",
+	"operator"
+]);
+/** One audit row, shared verbatim by both domains. */
+var OpsLogEntrySchema = zod.z.object({
+	/** Unique row id. */
+	id: zod.z.string(),
+	/** Epoch ms the operation completed. */
+	at: zod.z.number(),
+	domain: OpsLogDomainSchema,
+	op: OpsLogOpSchema,
+	reason: OpsLogReasonSchema,
+	/** The camera the op targeted; null for a cluster/global op. */
+	deviceId: zod.z.number().nullable(),
+	/** Node that performed the op (the log carries nodeId — no cross-node aggregation). */
+	nodeId: zod.z.string(),
+	/** Buckets / rows deleted (op-specific unit). */
+	itemsAffected: zod.z.number(),
+	/** Bytes reclaimed by the op (0 when not measurable). */
+	bytesReclaimed: zod.z.number(),
+	/** Free-text detail (e.g. "floor moved to <ts>"); null when none. */
+	detail: zod.z.string().nullable(),
+	/** Who/what triggered the op. */
+	actor: zod.z.string()
+});
+/** Shared query input for the per-domain `listOpsLog` cap methods. */
+var OpsLogQueryInputSchema = zod.z.object({
+	/** Restrict to a single camera; omit for every row. */
+	deviceId: zod.z.number().optional(),
+	/** Max rows returned, newest-first. */
+	limit: zod.z.number().int().min(1).max(1e3).optional()
+});
+/**
+* Default cap on the recorder's DurableState ops-log ring — the newest N rows
+* survive; older ones are evicted on append.
+*/
+var OPS_LOG_RING_DEFAULT_MAX = 500;
+/** Default page size for a `listOpsLog` query when the caller omits `limit`. */
+var OPS_LOG_DEFAULT_LIMIT = 200;
+//#endregion
 //#region src/interfaces/storage-location.ts
 /**
 * `StorageLocationType` — an addon-declared id that identifies the *kind* of
@@ -2707,6 +2772,143 @@ function getAudioMacroClassIds() {
 	return AUDIO_MACRO_LABELS.map((l) => l.id);
 }
 //#endregion
+//#region src/catalogs/event-taxonomy.ts
+/**
+* Unified event-kind taxonomy — THE single source of truth for
+* `kind → { parentKind, category, level, color, iconId, labelKey, label,
+* icon }`.
+*
+* This dictionary folds together what used to be scattered across four
+* copies:
+*   - `capabilities/sensor-event-kinds.ts` (sensor cap colors)
+*   - `addon-post-analysis/.../services/event-kinds.ts`
+*     (MOTION/PERSON/VEHICLE… _COLOR constants)
+*   - `ui-library/composites/detection-colors.ts` (CLASS_COLORS)
+*   - `addon-post-analysis/shared/frame/box-drawer.ts` (DEFAULT_COLOR)
+*   - the COCO / audio class maps (macro ↔ sub relationships)
+*
+* The DATA (serializable — color/iconId/labelKey/parentKind) lives here in
+* `@camstack/types`. The UI-side mapping `iconId → lucide component` and
+* `labelKey → t()` lives in `@camstack/ui-library`. UIs never hardcode a
+* color or an icon: they read this dictionary (server descriptors carry the
+* fields inline; the client resolves color/icon/label from `iconId`/`kind`).
+*
+* Two levels only (v1 YAGNI): macro → sub. `person` is a leaf macro.
+*/
+var TAXONOMY_COLORS = {
+	motion: "#f59e0b",
+	audio: "#06b6d4",
+	person: "#22c55e",
+	vehicle: "#3b82f6",
+	animal: "#f97316",
+	package: "#a855f7",
+	sensor: "#8b5cf6",
+	control: "#10b981",
+	genericDetection: "#64748b"
+};
+/** Global default color when a kind is unknown (matches legacy box-drawer). */
+var DEFAULT_EVENT_COLOR = "#22ff55";
+var DETECTION_SUB_COLORS = {
+	car: "#f59e0b",
+	truck: "#d97706",
+	bus: "#b45309",
+	motorcycle: "#eab308",
+	bicycle: "#ca8a04",
+	airplane: "#60a5fa",
+	boat: "#2563eb",
+	train: "#1d4ed8",
+	bird: "#14b8a6",
+	dog: "#84cc16",
+	cat: "#f97316",
+	horse: "#a16207",
+	sheep: "#a3a3a3",
+	cow: "#78716c",
+	elephant: "#6b7280",
+	bear: "#7c2d12",
+	zebra: "#404040",
+	giraffe: "#d4a373"
+};
+function titleCase(id) {
+	return id.split(/[-_ ]/).filter((p) => p.length > 0).map((p) => p.charAt(0).toUpperCase() + p.slice(1)).join(" ");
+}
+var entries = /* @__PURE__ */ new Map();
+function macro(kind, category, color, iconId, label) {
+	entries.set(kind, {
+		kind,
+		parentKind: null,
+		level: "macro",
+		category,
+		color,
+		iconId,
+		labelKey: `eventKind.${kind}`,
+		label
+	});
+}
+function sub(kind, parentKind, category, color, iconId, label) {
+	entries.set(kind, {
+		kind,
+		parentKind,
+		level: "sub",
+		category,
+		color,
+		iconId,
+		labelKey: `eventKind.${kind}`,
+		label
+	});
+}
+macro("motion", "motion", TAXONOMY_COLORS.motion, "motion", "Motion");
+macro("audio", "audio", TAXONOMY_COLORS.audio, "audio", "Audio");
+macro("person", "detection", TAXONOMY_COLORS.person, "person", "Person");
+macro("vehicle", "detection", TAXONOMY_COLORS.vehicle, "vehicle", "Vehicle");
+macro("animal", "detection", TAXONOMY_COLORS.animal, "animal", "Animal");
+macro("package", "package", TAXONOMY_COLORS.package, "package", "Package");
+macro("sensor", "sensor", TAXONOMY_COLORS.sensor, "sensor", "Sensor");
+macro("control", "control", TAXONOMY_COLORS.control, "control", "Control");
+for (const [cocoClass, macroClass] of Object.entries(COCO_TO_MACRO.mapping)) {
+	if (macroClass !== "vehicle" && macroClass !== "animal") continue;
+	if (entries.has(cocoClass)) continue;
+	sub(cocoClass, macroClass, "detection", DETECTION_SUB_COLORS[cocoClass] ?? TAXONOMY_COLORS.genericDetection, cocoClass, titleCase(cocoClass));
+}
+sub("package-delivered", "package", "package", TAXONOMY_COLORS.package, "package", "Package delivered");
+sub("package-picked-up", "package", "package", TAXONOMY_COLORS.package, "package", "Package picked up");
+sub("contact", "sensor", "sensor", "#f59e0b", "door", "Contact");
+sub("motion-sensor", "sensor", "sensor", TAXONOMY_COLORS.sensor, "pir", "Motion sensor");
+sub("smoke", "sensor", "sensor", "#ef4444", "smoke", "Smoke");
+sub("flood", "sensor", "sensor", "#3b82f6", "water", "Water leak");
+sub("gas", "sensor", "sensor", "#ef4444", "gas", "Gas");
+sub("carbon-monoxide", "sensor", "sensor", "#dc2626", "smoke", "Carbon monoxide");
+sub("vibration", "sensor", "sensor", "#eab308", "vibration", "Vibration");
+sub("tamper", "sensor", "sensor", "#f97316", "tamper", "Tamper");
+sub("presence", "sensor", "sensor", "#22c55e", "presence", "Presence");
+sub("enum-sensor", "sensor", "sensor", TAXONOMY_COLORS.sensor, "generic", "Sensor state");
+sub("device-event", "sensor", "sensor", "#10b981", "button", "Device event");
+sub("lock", "control", "control", "#0ea5e9", "lock", "Lock");
+sub("switch", "control", "control", TAXONOMY_COLORS.control, "switch", "Switch");
+sub("siren", "control", "control", "#dc2626", "siren", "Siren");
+sub("button", "control", "control", "#10b981", "button", "Button");
+sub("doorbell", "control", "control", "#a855f7", "doorbell", "Doorbell");
+for (const l of AUDIO_MACRO_LABELS) {
+	const kind = `audio-${l.id}`;
+	if (entries.has(kind)) continue;
+	sub(kind, "audio", "audio", TAXONOMY_COLORS.audio, kind, l.name);
+}
+/** The complete taxonomy dictionary, keyed by kind. */
+var EVENT_TAXONOMY = Object.freeze(Object.fromEntries(entries));
+/** Taxonomy entry for a kind, or undefined when unknown. */
+function getTaxonomyEntry(kind) {
+	return EVENT_TAXONOMY[kind];
+}
+/** Color for a kind — dictionary value, else the global default. */
+function colorForKind(kind) {
+	return EVENT_TAXONOMY[kind]?.color ?? "#22ff55";
+}
+/** The sub kinds whose `parentKind` is `macro` (empty for a leaf macro). */
+function subKindsOf(macro) {
+	const out = [];
+	for (const e of Object.values(EVENT_TAXONOMY)) if (e.parentKind === macro) out.push(e);
+	return out;
+}
+//#endregion
 //#region src/types/device-type.ts
 var DEVICE_TYPE_INFO = { ["camera"]: {
 	type: "camera",
@@ -11066,9 +11268,10 @@ var zoneRulesCapability = {
 	* `package` backs the package-drop detector — a package zone is a
 	* `ZoneRule` on the `'package'` stage referencing drawn polygons
 	* (see docs/superpowers/specs/2026-07-17-package-zones-design.md §3.1).
-	* The orchestrator provider that writes this stage lands in a later
-	* slice; until then the mirror carries only `{motion, detection}` and
-	* consumers read `package` as absent (treat as `[]`).
+	* The orchestrator provider writes this stage as a first-class slice
+	* (Phase 4): every mutation mirrors the full `{motion, detection,
+	* package}` shape, so consumers read the current package rules directly
+	* off `device.state.zoneRules.value.package`.
 	*/
 	runtimeState: zod.z.object({
 		motion: zod.z.array(ZoneRuleSchema).readonly(),
@@ -13073,7 +13276,10 @@ function createSystemProxy(api) {
 			assignPlates: (input) => dispatch("plateGallery", "assignPlates", "mutation", input),
 			unassignPlates: (input) => dispatch("plateGallery", "unassignPlates", "mutation", input)
 		},
-		recording: { getStorageUsage: (input) => dispatch("recording", "getStorageUsage", "query", input) },
+		recording: {
+			getStorageUsage: (input) => dispatch("recording", "getStorageUsage", "query", input),
+			listOpsLog: (input) => dispatch("recording", "listOpsLog", "query", input)
+		},
 		recordingExport: {
 			getExport: (input) => dispatch("recordingExport", "getExport", "query", input),
 			cancelExport: (input) => dispatch("recordingExport", "cancelExport", "mutation", input),
@@ -18352,17 +18558,30 @@ var EventKindCategorySchema = zod.z.enum([
 	"audio",
 	"detection",
 	"sensor",
+	"control",
 	"custom",
 	"package"
 ]);
+/** Taxonomy level — macro (timeline lane) vs sub (events-page leaf). */
+var EventKindLevelSchema = zod.z.enum(["macro", "sub"]);
 var EventKindDescriptorSchema = zod.z.object({
-	/** Stable kind id (e.g. 'motion', 'person', 'contact'). */
+	/** Stable kind id (e.g. 'motion', 'vehicle', 'car', 'lock'). */
 	kind: zod.z.string(),
+	/** i18n key resolved on the UI side; `label` is the English fallback. */
+	labelKey: zod.z.string(),
+	/** English fallback label (kept for clients that don't translate). */
 	label: zod.z.string(),
 	/** Hex color for timeline/legend rendering. */
 	color: zod.z.string(),
+	/** Dictionary id → lucide component on the UI side. */
+	iconId: zod.z.string(),
+	/** Legacy closed-vocab glyph — fallback for `iconId`. */
 	icon: EventKindIconSchema,
 	category: EventKindCategorySchema,
+	/** Macro parent for this kind ('car' → 'vehicle'); null for a macro. */
+	parentKind: zod.z.string().nullable(),
+	/** Derived from `parentKind`, explicit for the client tree. */
+	level: EventKindLevelSchema,
 	/** Which cap + device contributes this kind. For built-ins the camera
 	*  itself; for sensor kinds the LINKED source device. */
 	source: zod.z.object({
@@ -18435,11 +18654,21 @@ var TrackAudioLabelSchema = zod.z.object({
 	firstAt: zod.z.number(),
 	lastAt: zod.z.number()
 });
+/**
+* How a track was produced. `pipeline` (default / absent) = the spatial
+* detection+tracking pipeline. `sensor` = a SYNTHETIC track projected from a
+* linked sensor/control state change (no positions; carries a snapshot). The
+* spatial subsystems (tracker association, occupancy count, re-id/embedding,
+* resurrection) MUST skip `sensor` tracks — they have no bbox trajectory.
+*/
+var TrackSourceSchema = zod.z.enum(["pipeline", "sensor"]);
 var TrackSchema = zod.z.object({
 	trackId: zod.z.string(),
 	deviceId: zod.z.number(),
 	className: zod.z.string(),
 	label: zod.z.string().optional(),
+	/** Track provenance. Absent ⇒ `pipeline` (legacy rows). */
+	source: TrackSourceSchema.optional(),
 	firstSeen: zod.z.number(),
 	lastSeen: zod.z.number(),
 	/** Frame-rate position history (subject to maxPositionHistory cap). */
@@ -18694,6 +18923,26 @@ var TrackCascadeCountsSchema = zod.z.object({
 	/** Per-track CLIP search vectors removed (best-effort). */
 	embeddings: zod.z.number().int()
 });
+/** Event-store footprint for one camera. */
+var EventStoreDeviceFootprintSchema = zod.z.object({
+	deviceId: zod.z.number(),
+	/** Persisted event rows (motion + object + audio) for the camera. */
+	rows: zod.z.number().int(),
+	/** Event-owned media bytes on disk for the camera. */
+	bytes: zod.z.number().int()
+});
+/** Aggregate event-store footprint: global totals + per-camera breakdown. */
+var EventStoreFootprintSchema = zod.z.object({
+	totalRows: zod.z.number().int(),
+	totalBytes: zod.z.number().int(),
+	devices: zod.z.array(EventStoreDeviceFootprintSchema).readonly()
+});
+/** Per-kind counts returned by the event-prune / device-delete mutations. */
+var EventPruneCountsSchema = zod.z.object({
+	motion: zod.z.number().int(),
+	object: zod.z.number().int(),
+	audio: zod.z.number().int()
+});
 var pipelineAnalyticsCapability = {
 	name: "pipeline-analytics",
 	scope: "device",
@@ -18855,6 +19104,45 @@ var pipelineAnalyticsCapability = {
 			kind: "mutation",
 			auth: "admin"
 		}),
+		/**
+		* 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,
+		* computed on demand.
+		*/
+		getEventStoreFootprint: require_sleep.method(zod.z.object({}), EventStoreFootprintSchema, {
+			kind: "query",
+			auth: "admin"
+		}),
+		/**
+		* Cluster-wide prune of events older than `olderThanMs` (exclusive) across
+		* every camera, deleting each event's media in lockstep. Logged to the
+		* events ops-log with `reason` (default `'retention'`). Returns the summed
+		* per-kind deleted counts.
+		*/
+		pruneEvents: require_sleep.method(zod.z.object({
+			olderThanMs: zod.z.number(),
+			reason: OpsLogReasonSchema.optional()
+		}), EventPruneCountsSchema, {
+			kind: "mutation",
+			auth: "admin"
+		}),
+		/**
+		* Manually delete EVERY event (motion + object + audio) for one camera and
+		* its event-owned media in lockstep. Logged to the events ops-log as
+		* `op:'manual-delete', reason:'manual'`. Destructive — the admin UI guards
+		* it behind a confirm.
+		*/
+		deleteDeviceEvents: require_sleep.method(zod.z.object({ deviceId: zod.z.number() }), EventPruneCountsSchema, {
+			kind: "mutation",
+			auth: "admin"
+		}),
+		/** The events ops-log rows (newest-first), optionally scoped to one camera.
+		*  Backed by a declared pipeline-analytics SQLite collection. */
+		listOpsLog: require_sleep.method(OpsLogQueryInputSchema, zod.z.array(OpsLogEntrySchema).readonly(), {
+			kind: "query",
+			auth: "admin"
+		}),
 		getEventMedia: require_sleep.method(zod.z.object({
 			eventId: zod.z.string(),
 			kind: MediaFileKindEnum.optional()
@@ -18911,53 +19199,107 @@ var pipelineAnalyticsCapability = {
 //#endregion
 //#region src/capabilities/sensor-event-kinds.ts
 /**
-* Sensor cap name → static event-kind descriptor. A linked device
-* contributes one entry per bound cap present in this map.
+* Cap → event-kind mapping for the SENSOR / CONTROL cap families — the table
+* `pipeline-analytics.listEventKinds` uses to turn a linked device's bound
+* caps into per-camera event-kind descriptors.
+*
+* The descriptor DATA (color / iconId / labelKey / parentKind / category)
+* is NOT duplicated here — every entry is derived from the single
+* `EVENT_TAXONOMY` dictionary (`catalogs/event-taxonomy.ts`). This file owns
+* ONLY the cap-name → taxonomy-kind mapping. Adding a new eventful sensor /
+* control cap means adding one line here (and a taxonomy entry); the anti-
+* drift guard `scripts/check-event-kind-coverage.ts` fails the build if an
+* eventful cap is missing.
 */
-var EVENT_KIND_BY_CAP = {
-	contact: {
-		kind: "contact",
-		label: "Contact",
-		color: "#f59e0b",
-		icon: "door",
-		category: "sensor"
-	},
-	flood: {
-		kind: "flood",
-		label: "Water leak",
-		color: "#3b82f6",
-		icon: "water",
-		category: "sensor"
-	},
-	gas: {
-		kind: "gas",
-		label: "Gas",
-		color: "#ef4444",
-		icon: "smoke",
-		category: "sensor"
-	},
-	"carbon-monoxide": {
-		kind: "carbon-monoxide",
-		label: "Carbon monoxide",
-		color: "#dc2626",
-		icon: "smoke",
-		category: "sensor"
-	},
-	"enum-sensor": {
-		kind: "enum-sensor",
-		label: "Sensor state",
-		color: "#8b5cf6",
-		icon: "generic",
-		category: "sensor"
-	},
-	"event-emitter": {
-		kind: "device-event",
-		label: "Device event",
-		color: "#10b981",
-		icon: "button",
-		category: "sensor"
-	}
+/** Map a taxonomy `iconId` onto the legacy closed `EventKindIcon` enum. */
+var LEGACY_ICON = {
+	motion: "motion",
+	audio: "audio",
+	person: "person",
+	vehicle: "vehicle",
+	animal: "animal",
+	package: "package",
+	door: "door",
+	pir: "pir",
+	smoke: "smoke",
+	water: "water",
+	button: "button",
+	generic: "generic",
+	gas: "smoke",
+	vibration: "generic",
+	tamper: "generic",
+	presence: "person",
+	lock: "generic",
+	siren: "generic",
+	switch: "generic",
+	doorbell: "button"
+};
+function legacyIcon(iconId) {
+	return LEGACY_ICON[iconId] ?? "generic";
+}
+/**
+* Cap name → taxonomy kind id. Covers EVERY eventful sensor / control cap.
+* The anti-drift guard cross-checks this against the eventful caps declared
+* in `packages/types/src/capabilities/*.cap.ts`.
+*/
+var CAP_TO_KIND = {
+	contact: "contact",
+	motion: "motion-sensor",
+	smoke: "smoke",
+	flood: "flood",
+	gas: "gas",
+	"carbon-monoxide": "carbon-monoxide",
+	vibration: "vibration",
+	tamper: "tamper",
+	presence: "presence",
+	"enum-sensor": "enum-sensor",
+	"event-emitter": "device-event",
+	"lock-control": "lock",
+	switch: "switch",
+	button: "button",
+	doorbell: "doorbell"
 };
+function buildDescriptor(capName, kind) {
+	const t = EVENT_TAXONOMY[kind];
+	if (t === void 0) throw new Error(`EVENT_KIND_BY_CAP: cap '${capName}' maps to unknown taxonomy kind '${kind}'`);
+	return {
+		...t,
+		icon: legacyIcon(t.iconId)
+	};
+}
+/**
+* Sensor / control cap name → static event-kind descriptor. A linked device
+* contributes one entry per bound cap present in this map.
+*/
+var EVENT_KIND_BY_CAP = Object.freeze(Object.fromEntries(Object.entries(CAP_TO_KIND).map(([capName, kind]) => [capName, buildDescriptor(capName, kind)])));
+/** The cap names covered by the taxonomy (for the anti-drift guard). */
+var EVENTFUL_CAP_NAMES = Object.keys(CAP_TO_KIND);
+/**
+* Build a full `EventKindDescriptor` for a taxonomy `kind`, stamping the
+* per-device `source`. Returns null when `kind` is not in the taxonomy.
+* This is THE bridge from the serializable taxonomy dictionary to the cap
+* wire shape — every event-kind descriptor the server emits goes through it,
+* so color/iconId/labelKey are never re-declared at a call site.
+*/
+function buildEventKindDescriptor(kind, source) {
+	const t = EVENT_TAXONOMY[kind];
+	if (t === void 0) return null;
+	return {
+		kind: t.kind,
+		labelKey: t.labelKey,
+		label: t.label,
+		color: t.color,
+		iconId: t.iconId,
+		icon: legacyIcon(t.iconId),
+		category: t.category,
+		parentKind: t.parentKind,
+		level: t.level,
+		source: {
+			capName: source.capName,
+			deviceId: source.deviceId
+		}
+	};
+}
 //#endregion
 //#region src/capabilities/pipeline-orchestrator.cap.ts
 var CameraPipelineConfigSchema = zod.z.object({
@@ -23592,14 +23934,43 @@ var recordingCapability = {
 			auth: "admin"
 		}),
 		/** Apply this device's retention policy to footage now; returns the oldest
-		*  surviving footage start (the retention floor) or null if no footage. */
-		pruneFootage: require_sleep.method(zod.z.object({ deviceId: zod.z.number() }), zod.z.object({
+		*  surviving footage start (the retention floor) or null if no footage. The
+		*  prune is logged to the recordings ops-log with `reason` (default
+		*  `'retention'` — the policy-driven prune; `'quota'` when disk-pressure
+		*  triggered). */
+		pruneFootage: require_sleep.method(zod.z.object({
+			deviceId: zod.z.number(),
+			reason: OpsLogReasonSchema.optional()
+		}), zod.z.object({
 			floorMs: zod.z.number().nullable(),
 			deletedBuckets: zod.z.number().int(),
 			reclaimedBytes: zod.z.number().int()
 		}), {
 			kind: "mutation",
 			auth: "admin"
+		}),
+		/**
+		* Manually delete a camera's footage — the whole footprint, or a
+		* `[fromMs, toMs)` window when either bound is given. Logged to the
+		* recordings ops-log as `op:'manual-delete', reason:'manual'`. Destructive:
+		* the admin UI guards it behind a confirm.
+		*/
+		deleteFootprint: require_sleep.method(zod.z.object({
+			deviceId: zod.z.number(),
+			fromMs: zod.z.number().optional(),
+			toMs: zod.z.number().optional()
+		}), zod.z.object({
+			deletedBuckets: zod.z.number().int(),
+			reclaimedBytes: zod.z.number().int()
+		}), {
+			kind: "mutation",
+			auth: "admin"
+		}),
+		/** The recordings ops-log rows (newest-first), optionally scoped to one
+		*  camera. Backed by the recorder's bounded DurableState ring. */
+		listOpsLog: require_sleep.method(OpsLogQueryInputSchema, zod.z.array(OpsLogEntrySchema).readonly(), {
+			kind: "query",
+			auth: "admin"
 		})
 	}
 };
@@ -28062,6 +28433,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "delete"
 	},
+	"pipelineAnalytics.deleteDeviceEvents": {
+		capName: "pipeline-analytics",
+		capScope: "device",
+		addonId: null,
+		access: "delete"
+	},
 	"pipelineAnalytics.deleteTracks": {
 		capName: "pipeline-analytics",
 		capScope: "device",
@@ -28092,6 +28469,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"pipelineAnalytics.getEventStoreFootprint": {
+		capName: "pipeline-analytics",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
 	"pipelineAnalytics.getKeyEvents": {
 		capName: "pipeline-analytics",
 		capScope: "device",
@@ -28134,6 +28517,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"pipelineAnalytics.listOpsLog": {
+		capName: "pipeline-analytics",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
 	"pipelineAnalytics.listRecentTracks": {
 		capName: "pipeline-analytics",
 		capScope: "device",
@@ -28146,6 +28535,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"pipelineAnalytics.pruneEvents": {
+		capName: "pipeline-analytics",
+		capScope: "device",
+		addonId: null,
+		access: "create"
+	},
 	"pipelineAnalytics.pruneEventsBefore": {
 		capName: "pipeline-analytics",
 		capScope: "device",
@@ -28908,6 +29303,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"recording.deleteFootprint": {
+		capName: "recording",
+		capScope: "system",
+		addonId: null,
+		access: "delete"
+	},
 	"recording.getAvailability": {
 		capName: "recording",
 		capScope: "system",
@@ -28938,6 +29339,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"recording.listOpsLog": {
+		capName: "recording",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"recording.locateSegment": {
 		capName: "recording",
 		capScope: "system",
@@ -31099,6 +31506,7 @@ exports.DATAPLANE_SECRET_HEADER = require_sleep.DATAPLANE_SECRET_HEADER;
 exports.DEFAULT_ADDON_PLACEMENT = DEFAULT_ADDON_PLACEMENT;
 exports.DEFAULT_AUDIO_ANALYZER_CONFIG = DEFAULT_AUDIO_ANALYZER_CONFIG;
 exports.DEFAULT_DECODER_HWACCEL_CONFIG = DEFAULT_DECODER_HWACCEL_CONFIG;
+exports.DEFAULT_EVENT_COLOR = DEFAULT_EVENT_COLOR;
 exports.DEFAULT_FEATURES = DEFAULT_FEATURES;
 exports.DEFAULT_RETENTION = DEFAULT_RETENTION;
 exports.DEFAULT_SCRUB_THUMBNAIL_PRESET = DEFAULT_SCRUB_THUMBNAIL_PRESET;
@@ -31138,8 +31546,10 @@ exports.DiscoveredTargetSchema = DiscoveredTargetSchema;
 exports.DisposerChain = require_sleep.DisposerChain;
 exports.DoorbellPressEventSchema = DoorbellPressEventSchema;
 exports.DoorbellStatusSchema = DoorbellStatusSchema;
+exports.EVENTFUL_CAP_NAMES = EVENTFUL_CAP_NAMES;
 exports.EVENT_KIND_BY_CAP = EVENT_KIND_BY_CAP;
 exports.EVENT_PAD_MS = EVENT_PAD_MS;
+exports.EVENT_TAXONOMY = EVENT_TAXONOMY;
 exports.EXPRESSION_BUILTINS = EXPRESSION_BUILTINS;
 exports.EXPRESSION_BUILTIN_NAMES = EXPRESSION_BUILTIN_NAMES;
 exports.EXPRESSION_COMPILE_CACHE_CAPACITY = EXPRESSION_COMPILE_CACHE_CAPACITY;
@@ -31303,8 +31713,15 @@ exports.NotificationRuleSchema = NotificationRuleSchema;
 exports.NotificationSchema = NotificationSchema;
 exports.NotifierStatusSchema = NotifierStatusSchema;
 exports.NumericSensorStatusSchema = NumericSensorStatusSchema;
+exports.OPS_LOG_DEFAULT_LIMIT = OPS_LOG_DEFAULT_LIMIT;
+exports.OPS_LOG_RING_DEFAULT_MAX = OPS_LOG_RING_DEFAULT_MAX;
 exports.OauthIntegrationDescriptorSchema = OauthIntegrationDescriptorSchema;
 exports.ObjectEventSchema = ObjectEventSchema;
+exports.OpsLogDomainSchema = OpsLogDomainSchema;
+exports.OpsLogEntrySchema = OpsLogEntrySchema;
+exports.OpsLogOpSchema = OpsLogOpSchema;
+exports.OpsLogQueryInputSchema = OpsLogQueryInputSchema;
+exports.OpsLogReasonSchema = OpsLogReasonSchema;
 exports.OrchestratorMetricsSchema = OrchestratorMetricsSchema;
 exports.OsdOverlayKindEnum = OsdOverlayKindEnum;
 exports.OsdOverlayPatchSchema = OsdOverlayPatchSchema;
@@ -31477,6 +31894,7 @@ exports.SubscribeFramesResultSchema = require_sleep.SubscribeFramesResultSchema;
 exports.SwitchStatusSchema = SwitchStatusSchema;
 exports.SystemMetricsSchema = SystemMetricsSchema;
 exports.SystemMirror = SystemMirror;
+exports.TAXONOMY_COLORS = TAXONOMY_COLORS;
 exports.TIMEZONES = TIMEZONES;
 exports.TamperStatusSchema = TamperStatusSchema;
 exports.TankStatusSchema = TankStatusSchema;
@@ -31570,6 +31988,7 @@ exports.bindAddonActions = bindAddonActions;
 exports.brightnessCapability = brightnessCapability;
 exports.brokerCapability = brokerCapability;
 exports.buildAddonRouteProvider = buildAddonRouteProvider;
+exports.buildEventKindDescriptor = buildEventKindDescriptor;
 exports.buildModelVariantGroups = buildModelVariantGroups;
 exports.buildStreamParamsConfigSchema = buildStreamParamsConfigSchema;
 exports.buttonCapability = buttonCapability;
@@ -31585,6 +32004,7 @@ exports.climateControlCapability = climateControlCapability;
 exports.collectHydratedFieldEntries = require_sleep.collectHydratedFieldEntries;
 exports.collectHydratedFieldValues = require_sleep.collectHydratedFieldValues;
 exports.colorCapability = colorCapability;
+exports.colorForKind = colorForKind;
 exports.compileExpression = compileExpression;
 exports.compileExpressionSafe = compileExpressionSafe;
 exports.connectivityCapability = connectivityCapability;
@@ -31653,6 +32073,7 @@ exports.gasCapability = gasCapability;
 exports.getAudioMacroClassIds = getAudioMacroClassIds;
 exports.getByPath = getByPath;
 exports.getCapsByProviderKind = getCapsByProviderKind;
+exports.getTaxonomyEntry = getTaxonomyEntry;
 exports.hfModelUrl = hfModelUrl;
 exports.htmlToText = htmlToText;
 exports.humidifierCapability = humidifierCapability;
@@ -31788,6 +32209,7 @@ exports.streamCatalogCapability = streamCatalogCapability;
 exports.streamParamsCapability = streamParamsCapability;
 exports.streamPixels = streamPixels;
 exports.streamQualityLabel = streamQualityLabel;
+exports.subKindsOf = subKindsOf;
 exports.supportedRuntimes = supportedRuntimes;
 exports.switchCapability = switchCapability;
 exports.synthesizeSourceInfo = synthesizeSourceInfo;