@camstack/addon-pipeline 1.1.58 → 1.1.60

package/dist/audio-analyzer/index.js

@@ -3,9 +3,9 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../chunk-D6vf50IK.js");
-const require_dist = require("../dist-Bn6Uq4vq.js");
+const require_dist = require("../dist-DynD1EC-.js");
 const require_node_topology_platform = require("../node-topology-platform-CFZ7F4xW.js");
-const require_model_download_service_C_IHWnXx = require("../model-download-service-C-IHWnXx-D326YNnt.js");
+const require_model_download_service_Cp9f4dk6 = require("../model-download-service-Cp9f4dk6-Cp_GTKTw.js");
 let node_fs = require("node:fs");
 node_fs = require_chunk.__toESM(node_fs);
 let node_path = require("node:path");
@@ -84,7 +84,7 @@ var YamnetPythonPipeline = class {
 				url: YAMNET_MODEL_URL,
 				dest: modelPath
 			} });
-			await require_model_download_service_C_IHWnXx.downloadFile(YAMNET_MODEL_URL, modelPath);
+			await require_model_download_service_Cp9f4dk6.downloadFile(YAMNET_MODEL_URL, modelPath);
 			this.log.info("YAMNet ONNX model downloaded", { meta: { sizeBytes: node_fs.statSync(modelPath).size } });
 		}
 		if (!node_fs.existsSync(labelsPath)) {
@@ -92,7 +92,7 @@ var YamnetPythonPipeline = class {
 				url: YAMNET_LABELS_URL,
 				dest: labelsPath
 			} });
-			await require_model_download_service_C_IHWnXx.downloadFile(YAMNET_LABELS_URL, labelsPath);
+			await require_model_download_service_Cp9f4dk6.downloadFile(YAMNET_LABELS_URL, labelsPath);
 		}
 		const pythonDir = resolveAudioPythonDir();
 		if (this.installPythonRequirements) await this.installPythonRequirements(node_path.join(pythonDir, "requirements-audio.txt"));

package/dist/audio-analyzer/index.mjs

@@ -1,7 +1,7 @@
 import { t as __require } from "../chunk-BdkLduGY.mjs";
-import { C as mapAudioLabelToMacro, H as hydrateSchema, I as errMsg, L as BaseAddon, h as audioAnalyzerCapability, l as HF_BASE_URL, m as audioAnalysisCapability, n as AUDIO_BACKEND_CHOICES, o as DEFAULT_AUDIO_ANALYZER_CONFIG } from "../dist-CnwwDzX3.mjs";
+import { C as mapAudioLabelToMacro, L as errMsg, R as BaseAddon, U as hydrateSchema, h as audioAnalyzerCapability, l as HF_BASE_URL, m as audioAnalysisCapability, n as AUDIO_BACKEND_CHOICES, o as DEFAULT_AUDIO_ANALYZER_CONFIG } from "../dist-CcqqznPf.mjs";
 import { t as pickNodePlatformArch } from "../node-topology-platform-BkR_k6WT.mjs";
-import { r as downloadFile } from "../model-download-service-C-IHWnXx-3Mmeob3l.mjs";
+import { r as downloadFile } from "../model-download-service-Cp9f4dk6-0wh7OK3s.mjs";
 import * as fs from "node:fs";
 import * as path$1 from "node:path";
 //#region src/audio-analyzer/audio-pipeline.ts

package/dist/detection-pipeline/index.js

@@ -3,10 +3,10 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../chunk-D6vf50IK.js");
-const require_dist = require("../dist-Bn6Uq4vq.js");
-const require_step_definitions = require("../step-definitions-D7NOrnzz.js");
+const require_dist = require("../dist-DynD1EC-.js");
+const require_step_definitions = require("../step-definitions-DhhwklAL.js");
 const require_node_topology_platform = require("../node-topology-platform-CFZ7F4xW.js");
-const require_model_download_service_C_IHWnXx = require("../model-download-service-C-IHWnXx-D326YNnt.js");
+const require_model_download_service_Cp9f4dk6 = require("../model-download-service-Cp9f4dk6-Cp_GTKTw.js");
 let node_child_process = require("node:child_process");
 let sharp = require("sharp");
 sharp = require_chunk.__toESM(sharp);
@@ -3690,6 +3690,15 @@ var ONNX_FLOOR = {
 */
 var PROBE_READY_TIMEOUT_MS = 12e4;
 /**
+* Bound for the direct `platformProbe.getCapabilities` reconcile RPC issued
+* when the readiness gate times out (D8: readiness events are telemetry —
+* lossy — so a timed-out registry wait is reconciled against the provider
+* itself before conceding to the conservative floor). `getCapabilities`
+* resolves only once the probe is complete, so an answer IS readiness; the
+* race bound keeps a wedged transport from wedging `setApi`.
+*/
+var PROBE_DIRECT_RPC_TIMEOUT_MS = 6e4;
+/**
 * Build the onnx-cpu floor pick using `pickBestRuntime` with a null hardware
 * env.  Used wherever the old `detectBestEngine()` sync probe fell back — the
 * result is identical (onnx / cpu) but is now derived through the shared rules
@@ -3922,7 +3931,11 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 				nodeId
 			}, { timeoutMs: PROBE_READY_TIMEOUT_MS });
 		} catch (err) {
-			this.log.warn("platform-probe readiness gate timed out — conservative engine pick (floor is not persisted)", { meta: {
+			if (await this.probePlatformReadinessDirect()) this.log.info("platform-probe readiness reconciled via direct probe RPC (ready event lost)", { meta: {
+				nodeId,
+				timeoutMs: PROBE_READY_TIMEOUT_MS
+			} });
+			else this.log.warn("platform-probe readiness gate timed out — conservative engine pick (floor is not persisted)", { meta: {
 				nodeId,
 				timeoutMs: PROBE_READY_TIMEOUT_MS,
 				error: require_dist.errMsg(err)
@@ -3933,6 +3946,31 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 		this.startProvisioningForCurrentEngine();
 	}
 	/**
+	* Authoritative platform-probe reconcile: query the probe provider
+	* DIRECTLY over the cap plane. The RPC resolves only once the async
+	* probe has completed (`getCapabilities` awaits the probe promise), so
+	* a successful answer proves readiness independent of the (lossy)
+	* `system.ready-state` event stream. Mirrors the local-node branch of
+	* `resolveProbeHardware` — an unpinned `getCapabilities` routes to this
+	* node's own in-process provider (agent parent / hub). Bounded by
+	* {@link PROBE_DIRECT_RPC_TIMEOUT_MS}; `false` on any failure.
+	*/
+	async probePlatformReadinessDirect() {
+		const api = this.addonCtx?.api;
+		if (!api) return false;
+		let timer;
+		try {
+			const bound = new Promise((resolve) => {
+				timer = setTimeout(() => resolve(null), PROBE_DIRECT_RPC_TIMEOUT_MS);
+			});
+			return await Promise.race([api.platformProbe.getCapabilities.query(), bound]) !== null;
+		} catch {
+			return false;
+		} finally {
+			if (timer !== void 0) clearTimeout(timer);
+		}
+	}
+	/**
 	* Resolve the `'auto'` engine LIVE from this node's own kernel inference
 	* resolver (`ctx.kernel.inferenceEngine`) — the runtime mirror of
 	* `ctx.kernel.hwaccel`. Each node (hub + forked worker + remote agent)
@@ -4139,7 +4177,7 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 			if (!step.enabled) continue;
 			const modelEntry = await this.resolveModelEntry(step.addonId, step.modelId);
 			if (!modelEntry) continue;
-			if (require_model_download_service_C_IHWnXx.isModelDownloaded(this.modelsDir, modelEntry, format)) continue;
+			if (require_model_download_service_Cp9f4dk6.isModelDownloaded(this.modelsDir, modelEntry, format)) continue;
 			await this.downloadWithRetry(modelEntry, format, 3);
 		}
 	}
@@ -4514,7 +4552,7 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 				const formats = {};
 				for (const [formatKey, entry] of Object.entries(m.formats)) {
 					if (!entry) continue;
-					const downloaded = require_model_download_service_C_IHWnXx.isModelDownloaded(this.modelsDir, m, formatKey);
+					const downloaded = require_model_download_service_Cp9f4dk6.isModelDownloaded(this.modelsDir, m, formatKey);
 					formats[formatKey] = {
 						url: entry.url,
 						sizeMB: entry.sizeMB,
@@ -4637,7 +4675,7 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 		const { modelId, format, addonId } = input;
 		const modelEntry = await this.resolveModelEntry(addonId, modelId);
 		if (!modelEntry) throw new Error(`Model "${modelId}" not found in step "${addonId}" catalog`);
-		if (!require_model_download_service_C_IHWnXx.deleteModelFromDisk(this.modelsDir, modelEntry, format)) throw new Error(`Model "${modelId}" (${format}) is not downloaded — nothing to delete`);
+		if (!require_model_download_service_Cp9f4dk6.deleteModelFromDisk(this.modelsDir, modelEntry, format)) throw new Error(`Model "${modelId}" (${format}) is not downloaded — nothing to delete`);
 		this.log.info("Model deleted from disk", { meta: {
 			modelId,
 			format
@@ -5193,7 +5231,7 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 			const format = this.currentEngine?.format ?? "onnx";
 			for (const step of needed) {
 				const modelEntry = await this.resolveModelEntry(step.addonId, step.modelId);
-				if (modelEntry && !require_model_download_service_C_IHWnXx.isModelDownloaded(this.modelsDir, modelEntry, format)) {
+				if (modelEntry && !require_model_download_service_Cp9f4dk6.isModelDownloaded(this.modelsDir, modelEntry, format)) {
 					this.log.info("Downloading model for step", { meta: {
 						modelId: step.modelId,
 						format,
@@ -5218,7 +5256,7 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 	/** Download a model with retry + exponential backoff */
 	async downloadWithRetry(entry, format, maxRetries, onProgress) {
 		for (let attempt = 1; attempt <= maxRetries; attempt++) try {
-			await require_model_download_service_C_IHWnXx.ensureModel(this.modelsDir, entry, format, onProgress);
+			await require_model_download_service_Cp9f4dk6.ensureModel(this.modelsDir, entry, format, onProgress);
 			this.log.info("Model downloaded successfully", { meta: { modelId: entry.id } });
 			return;
 		} catch (err) {
@@ -6024,7 +6062,7 @@ function buildSchemaSlots(format, modelsDir, customByStep) {
 				id: m.id,
 				name: m.name,
 				formats: Object.fromEntries(Object.entries(m.formats).map(([f, entry]) => [f, {
-					downloaded: require_model_download_service_C_IHWnXx.isModelDownloaded(modelsDir, m, f),
+					downloaded: require_model_download_service_Cp9f4dk6.isModelDownloaded(modelsDir, m, f),
 					sizeMB: entry.sizeMB
 				}])),
 				...m.group ? { group: m.group } : {},

package/dist/detection-pipeline/index.mjs

@@ -1,8 +1,8 @@
 import { t as __require } from "../chunk-BdkLduGY.mjs";
-import { D as nodePin, H as hydrateSchema, I as errMsg, K as parseJsonUnknown, L as BaseAddon, O as pipelineExecutorCapability, P as supportedRuntimes$1, V as createEvent, Y as sleep, b as detectionPipelineCapability, f as YAMNET_TO_MACRO, j as runtimeDevices$1, st as EventCategory, t as APPLE_SA_TO_MACRO, v as defaultDeviceFor$1, x as evaluateZoneRules } from "../dist-CnwwDzX3.mjs";
-import { a as getStepDefinition, i as getStep, n as ALL_STEPS, o as resolveModelForFormat, r as getDefaultModelForFormat, t as ALL_PIPELINE_STEPS } from "../step-definitions-DhEe57Wn.mjs";
+import { D as nodePin, F as supportedRuntimes$1, H as createEvent, L as errMsg, M as runtimeDevices$1, O as pipelineExecutorCapability, R as BaseAddon, U as hydrateSchema, X as sleep, b as detectionPipelineCapability, ct as EventCategory, f as YAMNET_TO_MACRO, q as parseJsonUnknown, t as APPLE_SA_TO_MACRO, v as defaultDeviceFor$1, x as evaluateZoneRules } from "../dist-CcqqznPf.mjs";
+import { a as getStepDefinition, i as getStep, n as ALL_STEPS, o as resolveModelForFormat, r as getDefaultModelForFormat, t as ALL_PIPELINE_STEPS } from "../step-definitions-CvwB_Otk.mjs";
 import { t as pickNodePlatformArch } from "../node-topology-platform-BkR_k6WT.mjs";
-import { a as isModelDownloaded, i as ensureModel, n as deleteModelFromDisk } from "../model-download-service-C-IHWnXx-3Mmeob3l.mjs";
+import { a as isModelDownloaded, i as ensureModel, n as deleteModelFromDisk } from "../model-download-service-Cp9f4dk6-0wh7OK3s.mjs";
 import { spawn } from "node:child_process";
 import sharp from "sharp";
 import * as fs from "node:fs";
@@ -3682,6 +3682,15 @@ var ONNX_FLOOR = {
 */
 var PROBE_READY_TIMEOUT_MS = 12e4;
 /**
+* Bound for the direct `platformProbe.getCapabilities` reconcile RPC issued
+* when the readiness gate times out (D8: readiness events are telemetry —
+* lossy — so a timed-out registry wait is reconciled against the provider
+* itself before conceding to the conservative floor). `getCapabilities`
+* resolves only once the probe is complete, so an answer IS readiness; the
+* race bound keeps a wedged transport from wedging `setApi`.
+*/
+var PROBE_DIRECT_RPC_TIMEOUT_MS = 6e4;
+/**
 * Build the onnx-cpu floor pick using `pickBestRuntime` with a null hardware
 * env.  Used wherever the old `detectBestEngine()` sync probe fell back — the
 * result is identical (onnx / cpu) but is now derived through the shared rules
@@ -3914,7 +3923,11 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 				nodeId
 			}, { timeoutMs: PROBE_READY_TIMEOUT_MS });
 		} catch (err) {
-			this.log.warn("platform-probe readiness gate timed out — conservative engine pick (floor is not persisted)", { meta: {
+			if (await this.probePlatformReadinessDirect()) this.log.info("platform-probe readiness reconciled via direct probe RPC (ready event lost)", { meta: {
+				nodeId,
+				timeoutMs: PROBE_READY_TIMEOUT_MS
+			} });
+			else this.log.warn("platform-probe readiness gate timed out — conservative engine pick (floor is not persisted)", { meta: {
 				nodeId,
 				timeoutMs: PROBE_READY_TIMEOUT_MS,
 				error: errMsg(err)
@@ -3925,6 +3938,31 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 		this.startProvisioningForCurrentEngine();
 	}
 	/**
+	* Authoritative platform-probe reconcile: query the probe provider
+	* DIRECTLY over the cap plane. The RPC resolves only once the async
+	* probe has completed (`getCapabilities` awaits the probe promise), so
+	* a successful answer proves readiness independent of the (lossy)
+	* `system.ready-state` event stream. Mirrors the local-node branch of
+	* `resolveProbeHardware` — an unpinned `getCapabilities` routes to this
+	* node's own in-process provider (agent parent / hub). Bounded by
+	* {@link PROBE_DIRECT_RPC_TIMEOUT_MS}; `false` on any failure.
+	*/
+	async probePlatformReadinessDirect() {
+		const api = this.addonCtx?.api;
+		if (!api) return false;
+		let timer;
+		try {
+			const bound = new Promise((resolve) => {
+				timer = setTimeout(() => resolve(null), PROBE_DIRECT_RPC_TIMEOUT_MS);
+			});
+			return await Promise.race([api.platformProbe.getCapabilities.query(), bound]) !== null;
+		} catch {
+			return false;
+		} finally {
+			if (timer !== void 0) clearTimeout(timer);
+		}
+	}
+	/**
 	* Resolve the `'auto'` engine LIVE from this node's own kernel inference
 	* resolver (`ctx.kernel.inferenceEngine`) — the runtime mirror of
 	* `ctx.kernel.hwaccel`. Each node (hub + forked worker + remote agent)

package/dist/{dist-CnwwDzX3.mjs → dist-CcqqznPf.mjs}

@@ -1,4 +1,4 @@
-//#region ../types/dist/event-category-CFZs3jI4.mjs
+//#region ../types/dist/event-category-H4AVePnn.mjs
 var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["SystemBoot"] = "system.boot";
 	EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -148,6 +148,9 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["RecordingSegmentWritten"] = "recording.segment.written";
 	EventCategory["RecordingPolicyFallback"] = "recording.policy.fallback";
 	EventCategory["RecordingRetentionCompleted"] = "recording.retention.completed";
+	/** Runner-sampled scrub thumbnail (~1/5 s/camera). Telemetry (D8): a lost
+	*  thumb is a scrub gap the recorder's keyframe backfill covers. */
+	EventCategory["RecordingThumbSampled"] = "recording.thumb-sampled";
 	EventCategory["DetectionEvent"] = "detection.event";
 	EventCategory["SessionTrackNew"] = "session.track.new";
 	EventCategory["SessionTrackExpired"] = "session.track.expired";
@@ -7376,6 +7379,65 @@ var RecordingRetentionSchema = object({
 	maxSizeGb: number().min(0).optional()
 });
 /**
+* Scrub-thumbnail fidelity preset — the single per-camera selector bundling the
+* sprite tile RESOLUTION + JPEG QUALITY the recorder packs timeline-scrub
+* previews at. Five graduated steps; absent on a config = `standard` (the
+* shipped default, matching `sheet-geometry`/`sheet-composer`).
+*
+* Existing sheets are IMMUTABLE — a changed preset applies to NEW windows only.
+* Each window's index sidecar carries its own tile dims, so a camera whose
+* preset changed over time renders every historical window at the dims it was
+* written with.
+*/
+var ScrubThumbnailPresetSchema = _enum([
+	"minimal",
+	"low",
+	"standard",
+	"high",
+	"max"
+]);
+/**
+* Preset → tile geometry + JPEG quality. Every step is 16:9; the graduated
+* ladder trades sheet size (and remote fetch cost) for scrub crispness.
+* `standard` matches the shipped `sheet-geometry`/`sheet-composer` defaults
+* (480×270 q72), so an unset config is byte-identical to today. The map is
+* strictly monotone in resolution AND quality across the ordered steps.
+*/
+var SCRUB_THUMBNAIL_PRESETS = {
+	minimal: {
+		tileWidth: 240,
+		tileHeight: 135,
+		quality: 55
+	},
+	low: {
+		tileWidth: 320,
+		tileHeight: 180,
+		quality: 60
+	},
+	standard: {
+		tileWidth: 480,
+		tileHeight: 270,
+		quality: 72
+	},
+	high: {
+		tileWidth: 640,
+		tileHeight: 360,
+		quality: 80
+	},
+	max: {
+		tileWidth: 960,
+		tileHeight: 540,
+		quality: 85
+	}
+};
+/**
+* Resolve the geometry for a recording config's scrub-thumbnail preset,
+* defaulting to `standard` when unset. Pure — no I/O.
+*/
+function resolveScrubThumbnailGeometry(preset) {
+	return SCRUB_THUMBNAIL_PRESETS[preset ?? "standard"];
+}
+/**
 * The full per-camera recording intent — the wire shape of a RecordingTarget.
 *
 * `mode` is the authoritative storage choice; `schedule`/`triggers`/`pre`/`post`
@@ -7412,7 +7474,14 @@ var RecordingConfigSchema = object({
 	* derived into bands once via `migrateConfigToBands`.
 	*/
 	bands: array(RecordingBandSchema).optional(),
-	retention: RecordingRetentionSchema.optional()
+	retention: RecordingRetentionSchema.optional(),
+	/**
+	* Per-camera scrub-thumbnail fidelity preset (resolution + JPEG quality for
+	* timeline-scrub sprite previews). Absent = `standard`. Applies to NEW
+	* windows only — existing sheets are immutable, and each window's index
+	* carries its own tile dims so mixed-preset history renders correctly.
+	*/
+	scrubThumbnails: ScrubThumbnailPresetSchema.optional()
 });
 /** All seven weekdays (0 = Sunday … 6 = Saturday), used when a schedule omits a
 *  weekday filter. */
@@ -10738,7 +10807,7 @@ object({
 	deviceId: number(),
 	timestamp: number()
 });
-DeviceType.Button;
+DeviceType.Button, DeviceType.Camera;
 /**
 * Enum-state sensor — a string value picked from a finite option set.
 * Drives HA `sensor` entries with `state_class: enum` (HVAC action
@@ -15569,6 +15638,14 @@ var ConfigEntrySchema = object({
 	value: unknown(),
 	description: string().optional()
 });
+var DeviceLinkModeSchema = _enum(["auto", "manual"]);
+/** One resolved linked device — the compact projection consumers need. */
+var LinkedDeviceSchema = object({
+	deviceId: number(),
+	name: string(),
+	location: string().nullable(),
+	features: array(string())
+});
 var SavedDeviceRowSchema = object({
 	/** Numeric id reserved at allocateDeviceId time. */
 	id: number(),
@@ -15790,7 +15867,10 @@ method(object({
 }), _void(), {
 	kind: "mutation",
 	auth: "admin"
-}), method(object({ addonId: string() }), array(SavedDeviceRowSchema)), method(object({ addonId: string().optional() }), array(DeviceInfoSchema)), method(object({ deviceId: number() }), DeviceInfoSchema.nullable()), method(object({ parentDeviceId: number() }), array(DeviceInfoSchema)), method(object({ deviceId: number() }), array(StreamSourceEntrySchema$1)), method(object({ deviceId: number() }), array(ConfigEntrySchema)), method(object({ deviceId: number() }), ConfigUISchemaOutput), method(object({
+}), method(object({ addonId: string() }), array(SavedDeviceRowSchema)), method(object({ addonId: string().optional() }), array(DeviceInfoSchema)), method(object({ deviceId: number() }), DeviceInfoSchema.nullable()), method(object({ parentDeviceId: number() }), array(DeviceInfoSchema)), method(object({ deviceId: number() }), object({
+	mode: DeviceLinkModeSchema,
+	devices: array(LinkedDeviceSchema)
+})), method(object({ deviceId: number() }), array(StreamSourceEntrySchema$1)), method(object({ deviceId: number() }), array(ConfigEntrySchema)), method(object({ deviceId: number() }), ConfigUISchemaOutput), method(object({
 	deviceId: number(),
 	values: record(string(), unknown())
 }), object({ success: literal(true) }), {
@@ -17059,6 +17139,61 @@ var EventKindSchema = _enum([
 	"object",
 	"audio"
 ]);
+/**
+* Spatial filter for `listTracks` — the rect + polygon variants of the shared
+* MaskShape vocabulary (see `mask-shape.ts`). Coordinates are NORMALIZED 0..1
+* of the camera frame (top-left origin), matching the drawing-plane editor.
+*/
+var TrackZoneFilterSchema = discriminatedUnion("kind", [MaskRectShapeSchema, MaskPolygonShapeSchema]);
+/** Closed icon vocabulary so clients render a known glyph per kind. */
+var EventKindIconSchema = _enum([
+	"motion",
+	"audio",
+	"person",
+	"vehicle",
+	"animal",
+	"door",
+	"pir",
+	"smoke",
+	"water",
+	"button",
+	"generic"
+]);
+var EventKindCategorySchema = _enum([
+	"motion",
+	"audio",
+	"detection",
+	"sensor",
+	"custom"
+]);
+var EventKindDescriptorSchema = object({
+	/** Stable kind id (e.g. 'motion', 'person', 'contact'). */
+	kind: string(),
+	label: string(),
+	/** Hex color for timeline/legend rendering. */
+	color: string(),
+	icon: EventKindIconSchema,
+	category: EventKindCategorySchema,
+	/** Which cap + device contributes this kind. For built-ins the camera
+	*  itself; for sensor kinds the LINKED source device. */
+	source: object({
+		capName: string(),
+		deviceId: number()
+	})
+});
+var SensorEventSchema = object({
+	id: string(),
+	/** The CAMERA the event is attributed to (a sensor linked to N cameras
+	*  yields N rows, one per camera). */
+	deviceId: number(),
+	/** The linked sensor device whose state changed. */
+	sourceDeviceId: number(),
+	/** Event kind id — matches an `EventKindDescriptor.kind`. */
+	kind: string(),
+	/** Snapshot of the sensor cap's runtime-state slice at the change. */
+	value: record(string(), unknown()).nullable(),
+	timestamp: number()
+});
 var TrackPositionSchema = object({
 	x: number(),
 	y: number(),
@@ -17072,6 +17207,30 @@ var TrackSnapshotSchema = object({
 	mediaKey: string()
 });
 /**
+* Normalized 0..1 trajectory envelope (min/max over every position bbox,
+* divided by the track's detection-frame dims), computed at persist time.
+* Absent when the frame dims were unknown when the track was persisted
+* (legacy rows / dims-less sources) and on active (in-RAM) tracks.
+*/
+var TrackEnvelopeSchema = object({
+	minX: number(),
+	minY: number(),
+	maxX: number(),
+	maxY: number()
+});
+/**
+* Row projection for track list queries. `full` (default) returns the
+* complete Track including the frame-rate `positions[]` history and the
+* `snapshots[]` references — megabytes across a page of tracks. `slim`
+* keeps every scalar the list surfaces actually render (ids, class(es),
+* label / audioLabels / importance enrichment, firstSeen/lastSeen, state,
+* zonesVisited, bestEventId, envelope) and returns `positions` /
+* `snapshots` as EMPTY arrays — detail views re-fetch the full row via
+* `getTrack`. Mirrors the event-store `projection` convention
+* (`getObjectEvents` et al.).
+*/
+var TrackProjectionSchema = _enum(["full", "slim"]);
+/**
 * One audio-classification label heard on the track's camera while the
 * track was alive, aggregated per label. An "episode" is one persisted
 * audio event (the confident-classification path: score ≥ the device's
@@ -17122,7 +17281,11 @@ var TrackSchema = object({
 	/** Audio-classification labels heard on the camera during the track's
 	*  life (score ≥ device `classificationMinScore`), aggregated per label.
 	*  Absent on legacy rows / tracks with no confident audio. */
-	audioLabels: array(TrackAudioLabelSchema).readonly().optional()
+	audioLabels: array(TrackAudioLabelSchema).readonly().optional(),
+	/** Normalized 0..1 trajectory envelope (see {@link TrackEnvelopeSchema}).
+	*  Populated from the persisted envelope columns on historical reads;
+	*  absent on legacy rows, dims-less tracks and active (in-RAM) tracks. */
+	envelope: TrackEnvelopeSchema.optional()
 });
 var BaseEventFields = {
 	id: string(),
@@ -17232,11 +17395,13 @@ var MediaFileSchema = object({
 	sizeBytes: number(),
 	timestamp: number()
 });
+var DEFAULT_EVENT_QUERY_LIMIT = 1e3;
+var MAX_EVENT_QUERY_LIMIT = 5e3;
 var DeviceEventQueryInput = object({
 	deviceId: number(),
 	since: number().optional(),
 	until: number().optional(),
-	limit: number().int().min(1).max(5e3).default(1e3),
+	limit: number().int().min(1).max(MAX_EVENT_QUERY_LIMIT).default(DEFAULT_EVENT_QUERY_LIMIT),
 	/** `slim` drops heavy JSON fields (regions/bbox/zones) and carries an
 	*  optional `mediaUrl` (populated by B5). `full` (default) keeps today's
 	*  exact behaviour. Callers may omit this field — the store defaults to
@@ -17244,6 +17409,27 @@ var DeviceEventQueryInput = object({
 	projection: _enum(["full", "slim"]).optional()
 });
 var ObjectEventQueryInput = DeviceEventQueryInput.extend({ classFilter: string().optional() });
+var RecentTracksQueryInput = object({
+	/** Devices to merge. An empty array yields `{ tracks: [], nextCursor: null }`. */
+	deviceIds: array(number()),
+	/** Window lower bound on `lastSeen` (inclusive). */
+	since: number().optional(),
+	/** Window upper bound on `lastSeen` (inclusive). */
+	until: number().optional(),
+	/** Page size. Default 200, max 1000. */
+	limit: number().int().min(1).max(1e3).default(200),
+	/** Opaque continuation cursor from a previous page's `nextCursor`.
+	*  Encodes the (lastSeen, trackId) sort position — treat as opaque. */
+	cursor: string().optional(),
+	/** See {@link TrackProjectionSchema}. Default `full`. */
+	projection: TrackProjectionSchema.optional()
+});
+var RecentTracksPageSchema = object({
+	/** Merged page, ordered by (`lastSeen` DESC, `trackId` DESC). */
+	tracks: array(TrackSchema).readonly(),
+	/** Cursor for the next page, or null when this page is the last. */
+	nextCursor: string().nullable()
+});
 var KeyEventQueryInput = object({
 	deviceId: number(),
 	/** Window lower bound (track firstSeen ≥ since). */
@@ -17326,11 +17512,25 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
 	deviceId: number(),
 	since: number().optional(),
 	until: number().optional(),
-	limit: number().optional()
-}), array(TrackSchema).readonly()), method(object({ deviceId: number() }), _void(), {
-	kind: "mutation",
-	auth: "admin"
-}), method(DeviceEventQueryInput, array(MotionEventSchema).readonly()), method(ObjectEventQueryInput, array(ObjectEventSchema).readonly()), method(DeviceEventQueryInput, array(AudioEventSchema).readonly()), method(KeyEventQueryInput, array(KeyEventSchema).readonly()), method(object({
+	limit: number().optional(),
+	/** Spatial filter — only tracks whose trajectory intersects the zone
+	*  (normalized 0..1 rect or polygon). SQL-prefiltered on the persisted
+	*  envelope columns, then precisely tested per position. Tracks with
+	*  an unknown envelope (no frame dims at persist time) always match. */
+	zone: TrackZoneFilterSchema.optional(),
+	/** See {@link TrackProjectionSchema}. Default `full` (backward
+	*  compatible — omitting the field keeps today's exact behaviour). */
+	projection: TrackProjectionSchema.optional()
+}), array(TrackSchema).readonly()), method(RecentTracksQueryInput, RecentTracksPageSchema), method(object({ deviceId: number() }), _void(), {
+	kind: "mutation",
+	auth: "admin"
+}), method(DeviceEventQueryInput, array(MotionEventSchema).readonly()), method(ObjectEventQueryInput, array(ObjectEventSchema).readonly()), method(DeviceEventQueryInput, array(AudioEventSchema).readonly()), method(object({ deviceId: number() }), array(EventKindDescriptorSchema).readonly()), method(object({
+	deviceId: number(),
+	since: number().optional(),
+	until: number().optional(),
+	kinds: array(string()).optional(),
+	limit: number().int().min(1).max(MAX_EVENT_QUERY_LIMIT).default(DEFAULT_EVENT_QUERY_LIMIT)
+}), array(SensorEventSchema).readonly()), method(KeyEventQueryInput, array(KeyEventSchema).readonly()), method(object({
 	deviceId: number(),
 	since: number(),
 	until: number(),
@@ -20626,7 +20826,12 @@ var RecordingStorageUsageSchema = object({
 /**
 * Result of locating footage at a wall-clock instant for one device/profile.
 * `segment` carries the covering segment's window; `gap` reports the forward
-* nearest covered edge (`null` past the end of footage / when none exists).
+* nearest covered edge (`null` past the end of footage / when none exists)
+* and the backward covered edge `prevEndMs` (exclusive end of the nearest
+* footage behind the epoch; `null` when none — optional so older providers
+* that omit it stay valid). `prevEndMs` lets a backward frame-step hop the
+* small inter-segment cracks (durMs under-covers the span to the next
+* startMs by ~11-17 ms) instead of no-opping at a segment head.
 */
 var LocateSegmentResultSchema = discriminatedUnion("kind", [object({
 	kind: literal("segment"),
@@ -20635,7 +20840,8 @@ var LocateSegmentResultSchema = discriminatedUnion("kind", [object({
 	bytes: number()
 }), object({
 	kind: literal("gap"),
-	nearestEdgeMs: number().nullable()
+	nearestEdgeMs: number().nullable(),
+	prevEndMs: number().nullable().optional()
 })]);
 /** Raw bytes of one finalized footage segment (read off disk on the recording node). */
 var ReadSegmentBytesResultSchema = object({ data: _instanceof(Uint8Array) });
@@ -22237,6 +22443,12 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"deviceManager.getLinkedDevices": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"deviceManager.getRoleDisplayDefaults": {
 		capName: "device-manager",
 		capScope: "system",
@@ -23791,6 +24003,12 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"pipelineAnalytics.getSensorEvents": {
+		capName: "pipeline-analytics",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
 	"pipelineAnalytics.getTrack": {
 		capName: "pipeline-analytics",
 		capScope: "device",
@@ -23803,6 +24021,18 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"pipelineAnalytics.listEventKinds": {
+		capName: "pipeline-analytics",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
+	"pipelineAnalytics.listRecentTracks": {
+		capName: "pipeline-analytics",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
 	"pipelineAnalytics.listTracks": {
 		capName: "pipeline-analytics",
 		capScope: "device",
@@ -25992,4 +26222,4 @@ function defaultDeviceFor(id) {
 	return def(id).defaultDevice;
 }
 //#endregion
-export { discriminatedUnion as $, recordingCapability as A, DeviceType as B, mapAudioLabelToMacro as C, nodePin as D, motionDetectionCapability as E, webrtcSessionCapability as F, makeSourceBrokerId as G, hydrateSchema as H, errMsg as I, selectAssignedProfileSlots as J, parseJsonUnknown as K, BaseAddon as L, storageEvictableCapability as M, streamBrokerCapability as N, pipelineExecutorCapability as O, supportedRuntimes as P, boolean as Q, CAM_PROFILE_ORDER as R, hfModelUrl as S, migrateConfigToBands as T, isEvent as U, createEvent as V, makeProfileBrokerId as W, _enum as X, sleep as Y, array as Z, customAction as _, COCO_TO_MACRO as a, string as at, detectionPipelineCapability as b, EncodeProfileSchema as c, RingBuffer as d, lazy as et, YAMNET_TO_MACRO as f, cameraStreamsCapability as g, audioAnalyzerCapability as h, COCO_80_LABELS as i, record as it, runtimeDevices as j, pipelineRunnerCapability as k, HF_BASE_URL as l, audioAnalysisCapability as m, AUDIO_BACKEND_CHOICES as n, number as nt, DEFAULT_AUDIO_ANALYZER_CONFIG as o, union as ot, addonWidgetsSourceCapability as p, parseProfileBrokerId as q, AUDIO_MACRO_LABELS as r, object as rt, EVENT_PAD_MS as s, EventCategory as st, APPLE_SA_TO_MACRO as t, literal as tt, RecordingConfigSchema as u, defaultDeviceFor as v, maskUrlCredentials as w, evaluateZoneRules as x, defineCustomActions as y, DeviceFeature as z };
+export { boolean as $, recordingCapability as A, DeviceFeature as B, mapAudioLabelToMacro as C, nodePin as D, motionDetectionCapability as E, supportedRuntimes as F, makeProfileBrokerId as G, createEvent as H, webrtcSessionCapability as I, parseProfileBrokerId as J, makeSourceBrokerId as K, errMsg as L, runtimeDevices as M, storageEvictableCapability as N, pipelineExecutorCapability as O, streamBrokerCapability as P, array as Q, BaseAddon as R, hfModelUrl as S, migrateConfigToBands as T, hydrateSchema as U, DeviceType as V, isEvent as W, sleep as X, selectAssignedProfileSlots as Y, _enum as Z, customAction as _, COCO_TO_MACRO as a, record as at, detectionPipelineCapability as b, EncodeProfileSchema as c, EventCategory as ct, RingBuffer as d, discriminatedUnion as et, YAMNET_TO_MACRO as f, cameraStreamsCapability as g, audioAnalyzerCapability as h, COCO_80_LABELS as i, object as it, resolveScrubThumbnailGeometry as j, pipelineRunnerCapability as k, HF_BASE_URL as l, audioAnalysisCapability as m, AUDIO_BACKEND_CHOICES as n, literal as nt, DEFAULT_AUDIO_ANALYZER_CONFIG as o, string as ot, addonWidgetsSourceCapability as p, parseJsonUnknown as q, AUDIO_MACRO_LABELS as r, number as rt, EVENT_PAD_MS as s, union as st, APPLE_SA_TO_MACRO as t, lazy as tt, RecordingConfigSchema as u, defaultDeviceFor as v, maskUrlCredentials as w, evaluateZoneRules as x, defineCustomActions as y, CAM_PROFILE_ORDER as z };