@camstack/system 1.1.51 → 1.1.53

package/dist/builtins/sqlite-storage/sqlite-settings.addon.mjs

@@ -1,4 +1,4 @@
-import { Ct as parseJsonUnknown, J as settingsStoreCapability, nt as errMsg, pt as asJsonObject, rt as BaseAddon, s as RUNTIME_DEFAULTS } from "../../dist-BWQX9yUj.mjs";
+import { Y as settingsStoreCapability, it as BaseAddon, mt as asJsonObject, rt as errMsg, s as RUNTIME_DEFAULTS, wt as parseJsonUnknown } from "../../dist-D7_69kDt.mjs";
 import { randomUUID } from "node:crypto";
 import Database from "better-sqlite3";
 //#region src/builtins/sqlite-storage/sqlite-settings-backend.ts
@@ -504,10 +504,18 @@ var SqliteSettingsBackend = class SqliteSettingsBackend {
 		if (existingCols.length > 0) {
 			const existingNames = new Set(existingCols.map((c) => c.name));
 			const declaredNames = new Set(schema.columns.map((c) => c.name));
-			const missingDeclared = schema.columns.some((c) => !existingNames.has(c.name));
-			if (existingCols.length <= 2 && existingNames.has("data") && !declaredNames.has("data") || missingDeclared) try {
+			const missingCols = schema.columns.filter((c) => !existingNames.has(c.name));
+			const isLegacyKv = existingCols.length <= 2 && existingNames.has("data") && !declaredNames.has("data");
+			const addableInPlace = (col) => !col.primaryKey && !col.unique && (!col.notNull || col.defaultValue !== void 0);
+			if (isLegacyKv || missingCols.some((c) => !addableInPlace(c))) try {
 				this.getDb().exec(`DROP TABLE "${table}"`);
 			} catch {}
+			else if (missingCols.length > 0) for (const col of missingCols) {
+				const parts = [`"${col.name}" ${col.type}`];
+				if (col.notNull) parts.push("NOT NULL");
+				if (col.defaultValue !== void 0) parts.push(`DEFAULT ${typeof col.defaultValue === "string" ? `'${col.defaultValue}'` : col.defaultValue === null ? "NULL" : String(col.defaultValue)}`);
+				this.getDb().exec(`ALTER TABLE "${table}" ADD COLUMN ${parts.join(" ")}`);
+			}
 		}
 		this.getDb().exec(`CREATE TABLE IF NOT EXISTS "${table}" (${colDefs.join(", ")})`);
 		if (schema.indexes) for (const idx of schema.indexes) {

package/dist/builtins/storage-orchestrator/storage-orchestrator.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-C3uHEBtP.js");
+const require_dist = require("../../dist-BNro5CRu.js");
 let node_path = require("node:path");
 node_path = require_chunk.__toESM(node_path);
 let node_fs_promises = require("node:fs/promises");

package/dist/builtins/storage-orchestrator/storage-orchestrator.addon.mjs

@@ -1,4 +1,4 @@
-import { St as parseJsonObject, X as storageCapability, rt as BaseAddon, u as StorageLocationTypeSchema } from "../../dist-BWQX9yUj.mjs";
+import { Ct as parseJsonObject, Z as storageCapability, it as BaseAddon, u as StorageLocationTypeSchema } from "../../dist-D7_69kDt.mjs";
 import * as path$1 from "node:path";
 import * as fs from "node:fs/promises";
 import { buildStorageLocationRegistry } from "@camstack/system";

package/dist/builtins/system-config/system-config.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-C3uHEBtP.js");
+const require_dist = require("../../dist-BNro5CRu.js");
 //#region src/builtins/system-config/system-config.addon.ts
 /**
 * Built-in `system-config` addon — Phase 4 of the settings redesign.
@@ -108,9 +108,9 @@ var SystemConfigAddon = class extends require_dist.BaseAddon {
 				type: "text",
 				key: "tokenExpiry",
 				label: "Token Expiry",
-				description: "JWT token lifetime (e.g. 24h, 7d, 1h)",
-				placeholder: "24h",
-				default: "24h"
+				description: "JWT token lifetime (e.g. 24h, 7d, 30d)",
+				placeholder: "30d",
+				default: "30d"
 			}]
 		}] };
 	}

package/dist/builtins/system-config/system-config.addon.mjs

@@ -1,4 +1,4 @@
-import { bt as hydrateSchema, nt as errMsg, rt as BaseAddon } from "../../dist-BWQX9yUj.mjs";
+import { it as BaseAddon, rt as errMsg, xt as hydrateSchema } from "../../dist-D7_69kDt.mjs";
 //#region src/builtins/system-config/system-config.addon.ts
 /**
 * Built-in `system-config` addon — Phase 4 of the settings redesign.
@@ -103,9 +103,9 @@ var SystemConfigAddon = class extends BaseAddon {
 				type: "text",
 				key: "tokenExpiry",
 				label: "Token Expiry",
-				description: "JWT token lifetime (e.g. 24h, 7d, 1h)",
-				placeholder: "24h",
-				default: "24h"
+				description: "JWT token lifetime (e.g. 24h, 7d, 30d)",
+				placeholder: "30d",
+				default: "30d"
 			}]
 		}] };
 	}

package/dist/builtins/winston-logging/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-C3uHEBtP.js");
+const require_dist = require("../../dist-BNro5CRu.js");
 const require_formatter = require("../../formatter-DqAKDlvN.js");
 let node_path = require("node:path");
 node_path = require_chunk.__toESM(node_path);

package/dist/builtins/winston-logging/index.mjs

@@ -1,4 +1,4 @@
-import { I as logDestinationCapability, rt as BaseAddon } from "../../dist-BWQX9yUj.mjs";
+import { L as logDestinationCapability, it as BaseAddon } from "../../dist-D7_69kDt.mjs";
 import { t as formatLogLine } from "../../formatter-B7qW8bPJ.mjs";
 import * as path$1 from "node:path";
 import path from "node:path";

package/dist/{dist-C3uHEBtP.js → dist-BNro5CRu.js}

@@ -1,5 +1,5 @@
 let zod = require("zod");
-//#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";
@@ -149,6 +149,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";
@@ -1799,6 +1802,19 @@ function scopeKey(scope) {
 		case "device": return `device:${scope.deviceId}`;
 	}
 }
+/**
+* Producer transition order within ONE generation: `starting → ready →
+* down`. Used by `hydrate` to accept only forward moves for
+* same-generation snapshot records (a snapshot can be ahead of a lost
+* delta, never behind it, within one producer generation).
+*/
+function stateRank(state) {
+	switch (state) {
+		case "starting": return 0;
+		case "ready": return 1;
+		case "down": return 2;
+	}
+}
 function scopesEqual(a, b) {
 	if (a.type !== b.type) return false;
 	if (a.type === "global" || b.type === "global") return true;
@@ -1849,43 +1865,70 @@ var ReadinessRegistry = class {
 		return Array.from(this.snapshot.values());
 	}
 	/**
-	* Hydrate the snapshot from an authoritative source. Entries already
-	* present locally are skipped — live deltas (received via the event
-	* bus subscription) always take precedence over the snapshot. For
-	* each newly hydrated entry, a one-shot transition is dispatched to
-	* matching subscriptions so pending `awaitReady` callers unblock
-	* without having to wait for a fresh event.
+	* Hydrate the snapshot from an authoritative source — a RECONCILE, not
+	* an add-only merge (D8: readiness events are telemetry and may be
+	* lost; the on-reconnect/periodic snapshot re-pull is the repair path,
+	* so it MUST be able to advance a stale record — the 2026-07-17
+	* "still awaiting platform-probe forever" wedge was this method
+	* skipping every already-seen key).
 	*
-	* Local `epoch` is reset to 1 per entry — consumer-side epoch is
-	* derived from observed generation transitions, so this mirrors the
-	* value that would have been assigned had the consumer observed the
-	* first `ready` event directly.
+	*  - **Unseen keys** are added (epoch 1 — mirrors the value the
+	*    consumer would have derived from the first observed `ready`).
+	*  - **Existing keys** are UPDATED when the authoritative record
+	*    carries a different generation (producer restart / synthetic-down
+	*    superseded — epoch bumps on a new-generation `ready`, mirroring
+	*    `ingest`), or a FORWARD state move within the same generation
+	*    (`starting → ready → down`; within one producer generation a
+	*    snapshot can only be ahead of a lost delta, never behind it).
+	*  - **Never a same-generation regress** — a snapshot pulled just
+	*    before a live delta landed must not un-ready a record (the next
+	*    reconcile round converges it anyway).
+	*  - **Never a record this process is authoritative for** — node-scoped
+	*    records for our own nodeId, and device/global records we emitted,
+	*    keep local truth (an authority's stale copy of OUR record must
+	*    not regress us).
+	*
+	* Every applied entry dispatches a one-shot transition to matching
+	* subscriptions so pending `awaitReady` callers unblock without having
+	* to wait for a fresh event.
 	*/
 	hydrate(records) {
 		const now = this.now();
 		for (const record of records) {
 			const key = readinessKey(record.capName, record.scope);
-			if (this.snapshot.has(key)) continue;
+			const prev = this.snapshot.get(key) ?? null;
+			let epoch;
+			let durationInPrevState;
+			if (prev !== null) {
+				if (this.isLocallyAuthoritative(prev)) continue;
+				const sameGeneration = prev.generation === record.generation;
+				if (sameGeneration && stateRank(record.state) <= stateRank(prev.state)) continue;
+				epoch = !sameGeneration && record.state === "ready" ? prev.epoch + 1 : prev.epoch;
+				durationInPrevState = Math.max(0, now - prev.lastChange);
+			} else {
+				epoch = 1;
+				durationInPrevState = 0;
+			}
 			const hydrated = {
 				capName: record.capName,
 				scope: record.scope,
 				state: record.state,
 				generation: record.generation,
-				epoch: 1,
+				epoch,
 				lastChange: now,
 				sourceNodeId: record.sourceNodeId
 			};
 			this.snapshot.set(key, hydrated);
-			if (this.logger) this.logger.debug(`readiness: ${record.capName} (${scopeKey(record.scope)}) → ${record.state} (hydrated, gen=${record.generation.slice(0, 6)})`);
+			if (this.logger) this.logger.debug(`readiness: ${record.capName} (${scopeKey(record.scope)}) → ${record.state} (hydrated${prev !== null ? " update" : ""}, gen=${record.generation.slice(0, 6)})`);
 			const transition = {
 				capName: record.capName,
 				scope: record.scope,
 				state: record.state,
-				epoch: 1,
+				epoch,
 				generation: record.generation,
 				sourceNodeId: "hydrated",
 				ts: now,
-				durationInPrevState: 0
+				durationInPrevState
 			};
 			for (const sub of this.subscriptions) {
 				if (sub.capName !== record.capName) continue;
@@ -1898,6 +1941,17 @@ var ReadinessRegistry = class {
 			}
 		}
 	}
+	/**
+	* True when THIS process is the origin authority for `record` — a
+	* snapshot pulled from elsewhere must never overwrite it:
+	*  - node-scoped records whose `scope.nodeId` is our own node id
+	*    (this process — or a child bridged onto our bus — emits them);
+	*  - device/global-scoped records whose latest transition WE emitted.
+	*/
+	isLocallyAuthoritative(record) {
+		if (record.scope.type === "node") return record.scope.nodeId === this.sourceNodeId;
+		return record.sourceNodeId === this.sourceNodeId;
+	}
 	/** Shallow copy of the full snapshot — mainly for diagnostics/tests. */
 	getAll() {
 		return new Map(this.snapshot);
@@ -3201,6 +3255,24 @@ var RecordingRetentionSchema = zod.z.object({
 	maxSizeGb: zod.z.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 = zod.z.enum([
+	"minimal",
+	"low",
+	"standard",
+	"high",
+	"max"
+]);
+/**
 * The full per-camera recording intent — the wire shape of a RecordingTarget.
 *
 * `mode` is the authoritative storage choice; `schedule`/`triggers`/`pre`/`post`
@@ -3237,7 +3309,14 @@ var RecordingConfigSchema = zod.z.object({
 	* derived into bands once via `migrateConfigToBands`.
 	*/
 	bands: zod.z.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()
 });
 /**
 * `StorageLocationType` — an addon-declared id that identifies the *kind* of
@@ -6903,10 +6982,23 @@ var deviceDiscoveryCapability = {
 	}
 };
 /**
-* Doorbell button cap. Installed on a `DeviceType.Button` accessory
-* with `role: DeviceRole.Doorbell`. Emits an `onPressed` event every
-* time the firmware pushes a ring; status tracks the last press and
-* a pressCount since start (diagnostic).
+* Doorbell button cap. Two kinds of providers coexist behind this cap
+* name (same pattern as `snapshot`):
+*
+*   - **Native** providers: registered per-device by device-driver
+*     addons via `ctx.registerNativeCap` — either on a
+*     `DeviceType.Button` accessory with `role: DeviceRole.Doorbell`,
+*     or directly on the camera (Reolink registers at camera level).
+*     Emits an `onPressed` event every time the firmware pushes a
+*     ring; status tracks the last press and a pressCount since start
+*     (diagnostic).
+*
+*   - **Wrapper** provider: the `virtual-doorbell` system builtin
+*     (`@camstack/system/builtins/doorbell`). Turns ANY binary-ish
+*     device (contact / switch / event-emitter …) into a doorbell for
+*     a camera. `defaultActive: false` — the operator explicitly binds
+*     it per camera in the device-bindings UI, then picks the source
+*     device + trigger in the per-device settings.
 *
 * The DeviceEventPropagator re-emits `onPressed` on the camera parent
 * — subscribers listening at the camera level receive ring events
@@ -6927,7 +7019,10 @@ var doorbellCapability = {
 	scope: "device",
 	deviceNative: true,
 	mode: "singleton",
-	deviceTypes: [DeviceType.Button],
+	kind: "wrapper",
+	defaultActive: false,
+	deviceTypes: [DeviceType.Button, DeviceType.Camera],
+	exposesDeviceSettings: true,
 	methods: {},
 	events: { 
 	/**
@@ -13565,6 +13660,14 @@ var ConfigEntrySchema = zod.z.object({
 	value: zod.z.unknown(),
 	description: zod.z.string().optional()
 });
+var DeviceLinkModeSchema = zod.z.enum(["auto", "manual"]);
+/** One resolved linked device — the compact projection consumers need. */
+var LinkedDeviceSchema = zod.z.object({
+	deviceId: zod.z.number(),
+	name: zod.z.string(),
+	location: zod.z.string().nullable(),
+	features: zod.z.array(zod.z.string())
+});
 var SavedDeviceRowSchema = zod.z.object({
 	/** Numeric id reserved at allocateDeviceId time. */
 	id: zod.z.number(),
@@ -13672,6 +13775,7 @@ var deviceManagerCapability = {
 	name: "device-manager",
 	scope: "system",
 	mode: "singleton",
+	exposesDeviceSettings: true,
 	methods: {
 		/** Reserve (or re-resolve) a progressive numeric id for `(addonId, stableId)`.
 		*  Idempotent: returns the existing id if one is already persisted for the
@@ -13922,6 +14026,19 @@ var deviceManagerCapability = {
 		getDevice: method(zod.z.object({ deviceId: zod.z.number() }), DeviceInfoSchema.nullable()),
 		/** List children of a parent device (by parent numeric id). */
 		getChildren: method(zod.z.object({ parentDeviceId: zod.z.number() }), zod.z.array(DeviceInfoSchema)),
+		/**
+		* Resolve the devices LINKED to a camera — the single policy authority
+		* both consumers call (viewer devices panel + pipeline-analytics event
+		* kinds/ingest). Device-tree children are ALWAYS included; mode 'auto'
+		* (default) adds every device sharing the camera's non-null `location`,
+		* mode 'manual' adds the persisted manual list instead. Excludes the
+		* camera itself; deduped. Configuration is standard per-device settings
+		* (see the module docblock) — there are no bespoke link mutations.
+		*/
+		getLinkedDevices: method(zod.z.object({ deviceId: zod.z.number() }), zod.z.object({
+			mode: DeviceLinkModeSchema,
+			devices: zod.z.array(LinkedDeviceSchema)
+		})),
 		/** Get stream sources for a camera device. */
 		getStreamSources: method(zod.z.object({ deviceId: zod.z.number() }), zod.z.array(StreamSourceEntrySchema$1)),
 		/** Get config entries (key + value + description) for a device. */
@@ -15640,6 +15757,61 @@ var EventKindSchema = zod.z.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 = zod.z.discriminatedUnion("kind", [MaskRectShapeSchema, MaskPolygonShapeSchema]);
+/** Closed icon vocabulary so clients render a known glyph per kind. */
+var EventKindIconSchema = zod.z.enum([
+	"motion",
+	"audio",
+	"person",
+	"vehicle",
+	"animal",
+	"door",
+	"pir",
+	"smoke",
+	"water",
+	"button",
+	"generic"
+]);
+var EventKindCategorySchema = zod.z.enum([
+	"motion",
+	"audio",
+	"detection",
+	"sensor",
+	"custom"
+]);
+var EventKindDescriptorSchema = zod.z.object({
+	/** Stable kind id (e.g. 'motion', 'person', 'contact'). */
+	kind: zod.z.string(),
+	label: zod.z.string(),
+	/** Hex color for timeline/legend rendering. */
+	color: zod.z.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: zod.z.object({
+		capName: zod.z.string(),
+		deviceId: zod.z.number()
+	})
+});
+var SensorEventSchema = zod.z.object({
+	id: zod.z.string(),
+	/** The CAMERA the event is attributed to (a sensor linked to N cameras
+	*  yields N rows, one per camera). */
+	deviceId: zod.z.number(),
+	/** The linked sensor device whose state changed. */
+	sourceDeviceId: zod.z.number(),
+	/** Event kind id — matches an `EventKindDescriptor.kind`. */
+	kind: zod.z.string(),
+	/** Snapshot of the sensor cap's runtime-state slice at the change. */
+	value: zod.z.record(zod.z.string(), zod.z.unknown()).nullable(),
+	timestamp: zod.z.number()
+});
 var TrackPositionSchema = zod.z.object({
 	x: zod.z.number(),
 	y: zod.z.number(),
@@ -15653,6 +15825,30 @@ var TrackSnapshotSchema = zod.z.object({
 	mediaKey: zod.z.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 = zod.z.object({
+	minX: zod.z.number(),
+	minY: zod.z.number(),
+	maxX: zod.z.number(),
+	maxY: zod.z.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 = zod.z.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
@@ -15703,7 +15899,11 @@ var TrackSchema = zod.z.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: zod.z.array(TrackAudioLabelSchema).readonly().optional()
+	audioLabels: zod.z.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: zod.z.string(),
@@ -15813,11 +16013,13 @@ var MediaFileSchema = zod.z.object({
 	sizeBytes: zod.z.number(),
 	timestamp: zod.z.number()
 });
+var DEFAULT_EVENT_QUERY_LIMIT = 1e3;
+var MAX_EVENT_QUERY_LIMIT = 5e3;
 var DeviceEventQueryInput = zod.z.object({
 	deviceId: zod.z.number(),
 	since: zod.z.number().optional(),
 	until: zod.z.number().optional(),
-	limit: zod.z.number().int().min(1).max(5e3).default(1e3),
+	limit: zod.z.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
@@ -15825,6 +16027,27 @@ var DeviceEventQueryInput = zod.z.object({
 	projection: zod.z.enum(["full", "slim"]).optional()
 });
 var ObjectEventQueryInput = DeviceEventQueryInput.extend({ classFilter: zod.z.string().optional() });
+var RecentTracksQueryInput = zod.z.object({
+	/** Devices to merge. An empty array yields `{ tracks: [], nextCursor: null }`. */
+	deviceIds: zod.z.array(zod.z.number()),
+	/** Window lower bound on `lastSeen` (inclusive). */
+	since: zod.z.number().optional(),
+	/** Window upper bound on `lastSeen` (inclusive). */
+	until: zod.z.number().optional(),
+	/** Page size. Default 200, max 1000. */
+	limit: zod.z.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: zod.z.string().optional(),
+	/** See {@link TrackProjectionSchema}. Default `full`. */
+	projection: TrackProjectionSchema.optional()
+});
+var RecentTracksPageSchema = zod.z.object({
+	/** Merged page, ordered by (`lastSeen` DESC, `trackId` DESC). */
+	tracks: zod.z.array(TrackSchema).readonly(),
+	/** Cursor for the next page, or null when this page is the last. */
+	nextCursor: zod.z.string().nullable()
+});
 var KeyEventQueryInput = zod.z.object({
 	deviceId: zod.z.number(),
 	/** Window lower bound (track firstSeen ≥ since). */
@@ -15921,8 +16144,27 @@ var pipelineAnalyticsCapability = {
 			deviceId: zod.z.number(),
 			since: zod.z.number().optional(),
 			until: zod.z.number().optional(),
-			limit: zod.z.number().optional()
+			limit: zod.z.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()
 		}), zod.z.array(TrackSchema).readonly()),
+		/**
+		* Batched cluster-wide track listing — ONE call for the events page /
+		* reel first paint instead of a per-camera `listTracks` fan-out. Merges
+		* the persisted completed tracks of every requested device, sorted by
+		* `lastSeen` DESC with a stable (lastSeen, trackId) cursor. Per-device
+		* indexed pages (`idx_tracks_device_lastSeen`) are k-way merged
+		* provider-side; `projection: 'slim'` drops the heavy `positions[]` /
+		* `snapshots[]` JSON (returned as empty arrays). Active in-RAM tracks
+		* are not included (same contract as `listTracks`).
+		*/
+		listRecentTracks: method(RecentTracksQueryInput, RecentTracksPageSchema),
 		clearTracks: method(zod.z.object({ deviceId: zod.z.number() }), zod.z.void(), {
 			kind: "mutation",
 			auth: "admin"
@@ -15931,6 +16173,26 @@ var pipelineAnalyticsCapability = {
 		getObjectEvents: method(ObjectEventQueryInput, zod.z.array(ObjectEventSchema).readonly()),
 		getAudioEvents: method(DeviceEventQueryInput, zod.z.array(AudioEventSchema).readonly()),
 		/**
+		* Every event kind the device can produce: built-ins (motion + audio),
+		* detection classes actually observed for the device (from the track
+		* history), and sensor kinds contributed by LINKED devices (resolved via
+		* `device-manager.getLinkedDevices`, mapped through `EVENT_KIND_BY_CAP`).
+		*/
+		listEventKinds: method(zod.z.object({ deviceId: zod.z.number() }), zod.z.array(EventKindDescriptorSchema).readonly()),
+		/**
+		* Sensor-event history for a camera: state changes of LINKED sensor
+		* devices, attributed to the camera at ingest time (one row per linked
+		* camera). Mirrors `getAudioEvents` query semantics; `kinds` narrows to
+		* a kind subset.
+		*/
+		getSensorEvents: method(zod.z.object({
+			deviceId: zod.z.number(),
+			since: zod.z.number().optional(),
+			until: zod.z.number().optional(),
+			kinds: zod.z.array(zod.z.string()).optional(),
+			limit: zod.z.number().int().min(1).max(MAX_EVENT_QUERY_LIMIT).default(DEFAULT_EVENT_QUERY_LIMIT)
+		}), zod.z.array(SensorEventSchema).readonly()),
+		/**
 		* Importance-ranked highlights for a device+window. Queries completed
 		* tracks by (deviceId, firstSeen ∈ [since,until]), scores each (or reuses
 		* the persisted score), filters by minImportance/classFilter, orders by
@@ -20545,7 +20807,12 @@ var RecordingStorageUsageSchema = zod.z.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 = zod.z.discriminatedUnion("kind", [zod.z.object({
 	kind: zod.z.literal("segment"),
@@ -20554,7 +20821,8 @@ var LocateSegmentResultSchema = zod.z.discriminatedUnion("kind", [zod.z.object({
 	bytes: zod.z.number()
 }), zod.z.object({
 	kind: zod.z.literal("gap"),
-	nearestEdgeMs: zod.z.number().nullable()
+	nearestEdgeMs: zod.z.number().nullable(),
+	prevEndMs: zod.z.number().nullable().optional()
 })]);
 /** Raw bytes of one finalized footage segment (read off disk on the recording node). */
 var ReadSegmentBytesResultSchema = zod.z.object({ data: zod.z.instanceof(Uint8Array) });
@@ -22717,6 +22985,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"deviceManager.getLinkedDevices": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"deviceManager.getRoleDisplayDefaults": {
 		capName: "device-manager",
 		capScope: "system",
@@ -24271,6 +24545,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"pipelineAnalytics.getSensorEvents": {
+		capName: "pipeline-analytics",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
 	"pipelineAnalytics.getTrack": {
 		capName: "pipeline-analytics",
 		capScope: "device",
@@ -24283,6 +24563,18 @@ var METHOD_ACCESS_MAP = 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",
@@ -26548,6 +26840,12 @@ Object.defineProperty(exports, "deviceStatusCapability", {
 		return deviceStatusCapability;
 	}
 });
+Object.defineProperty(exports, "doorbellCapability", {
+	enumerable: true,
+	get: function() {
+		return doorbellCapability;
+	}
+});
 Object.defineProperty(exports, "emitDownForOwnedCaps", {
 	enumerable: true,
 	get: function() {