@camstack/addon-pipeline 1.2.276 → 1.2.279

package/dist/recorder/index.js

@@ -13763,6 +13763,35 @@ var PlacementService = class {
 		});
 	}
 };
+/** How long each kind stays quiet after it has been listed. Absent = no bound. */
+var QUIET_BY_KIND = {
+	audio: 5 * 6e4,
+	motion: 2 * 6e4
+};
+/**
+* Thin a run of same-kind rows to one per cooldown.
+*
+* The DECISION is made oldest-first, because a cooldown read off an unsorted
+* list keeps an arbitrary subset. The ANSWER keeps the caller's own order:
+* this provider lists newest-first, and quietly reversing it here would have
+* turned a density filter into a reordering — caught by the spec that pins
+* `clips[0].kind`, which is the only reason it is not shipping.
+*/
+function applyQuietKinds(clips) {
+	const lastEmitted = /* @__PURE__ */ new Map();
+	const dropped = /* @__PURE__ */ new Set();
+	for (const clip of [...clips].toSorted((a, b) => a.timeRange.startMs - b.timeRange.startMs)) {
+		const quietMs = QUIET_BY_KIND[clip.kind];
+		if (quietMs === void 0) continue;
+		const previous = lastEmitted.get(clip.kind);
+		if (previous !== void 0 && clip.timeRange.startMs - previous < quietMs) {
+			dropped.add(clip.id);
+			continue;
+		}
+		lastEmitted.set(clip.kind, clip.timeRange.startMs);
+	}
+	return clips.filter((clip) => !dropped.has(clip.id));
+}
 //#endregion
 //#region src/recorder/addon/videoclip-visits.ts
 /**
@@ -13811,10 +13840,22 @@ function clusterFootageVisits(ranges, gapMs = require_dist.VISIT_MERGE_GAP_MS) {
 * so the visit became the recording session.
 *
 * Measured on 592, 2026-09-21, 24 h: seven rows covering the whole day, one of
-* them 7 h 58 m. Clustering the same day's EVENTS at the same 30 s gives 46
-* visits overnight and 36 in the day, median 17 s, longest 99 s. The constant
-* was right; the input was not. No duration cap: it would split by the clock
-* rather than by what happened, and nothing here needs splitting that way.
+* them 7 h 58 m.
+*
+* ## And the grain is the PADDING, not a constant
+*
+* `VISIT_MERGE_GAP_MS` (30 s) was arbitrary here and sat on a cliff. 592's
+* worst hour holds 492 events — 150 object, 98 motion, **244 audio** — whose
+* LARGEST gap is 25 s, so nothing ever reached 30 and the hour was one row.
+* Measured on that hour:
+*
+* | rule | clips | longest |
+* | --- | --- | --- |
+* | 30 s | 1 | 66 min |
+* | `preMs + postMs` (15 s) | 105 | 3.5 min |
+*
+* So two clips merge exactly when they would otherwise OVERLAP. Nothing to
+* tune, nothing to disagree with the pad.
 *
 * ## What the footage is still for
 *
@@ -13825,7 +13866,8 @@ function clusterFootageVisits(ranges, gapMs = require_dist.VISIT_MERGE_GAP_MS) {
 * recorder never kept is not a clip, and listing it is a row that opens onto
 * nothing.
 */
-function clusterEventVisits(events, ranges, gapMs, pad) {
+function clusterEventVisits(events, ranges, pad) {
+	const gapMs = pad.preMs + pad.postMs;
 	if (events.length === 0 || ranges.length === 0) return [];
 	const times = [...events].map((e) => e.timestamp).toSorted((a, b) => a - b);
 	const sortedRanges = [...ranges].toSorted((a, b) => a.startMs - b.startMs);
@@ -14111,7 +14153,7 @@ function intersectsWindow(clip, since, until) {
 * scan on an indexed column buys a list that stops changing under the cursor.
 */
 function leftOverhangMs(pad) {
-	return require_dist.VISIT_MERGE_GAP_MS + pad.preMs;
+	return pad.preMs + pad.postMs + pad.preMs;
 }
 /** No events at all — what the degraded branch annotates its visits with. */
 var NO_EVENTS = {
@@ -14171,14 +14213,14 @@ function createVideoclipsProvider(deps) {
 					since: readSince,
 					until
 				});
-				clips = visitsToClips(clusterEventVisits(allEvents(events), ranges, require_dist.VISIT_MERGE_GAP_MS, deps.defaultPad), events, deps.defaultPad, vouched);
+				clips = visitsToClips(clusterEventVisits(allEvents(events), ranges, deps.defaultPad), events, deps.defaultPad, vouched);
 			} catch (err) {
 				deps.logWarn?.("videoclips: availability read failed — listing unfiltered", {
 					deviceId,
 					error: err instanceof Error ? err.message : String(err)
 				});
 			}
-			const inWindow = clips.filter((c) => intersectsWindow(c, since, until));
+			const inWindow = applyQuietKinds(clips).filter((c) => intersectsWindow(c, since, until));
 			const answer = limit != null ? inWindow.slice(0, limit) : inWindow;
 			reportUnvouchedClips(deps, deviceId, answer);
 			return answer;

package/dist/recorder/index.mjs

@@ -13756,6 +13756,35 @@ var PlacementService = class {
 		});
 	}
 };
+/** How long each kind stays quiet after it has been listed. Absent = no bound. */
+var QUIET_BY_KIND = {
+	audio: 5 * 6e4,
+	motion: 2 * 6e4
+};
+/**
+* Thin a run of same-kind rows to one per cooldown.
+*
+* The DECISION is made oldest-first, because a cooldown read off an unsorted
+* list keeps an arbitrary subset. The ANSWER keeps the caller's own order:
+* this provider lists newest-first, and quietly reversing it here would have
+* turned a density filter into a reordering — caught by the spec that pins
+* `clips[0].kind`, which is the only reason it is not shipping.
+*/
+function applyQuietKinds(clips) {
+	const lastEmitted = /* @__PURE__ */ new Map();
+	const dropped = /* @__PURE__ */ new Set();
+	for (const clip of [...clips].toSorted((a, b) => a.timeRange.startMs - b.timeRange.startMs)) {
+		const quietMs = QUIET_BY_KIND[clip.kind];
+		if (quietMs === void 0) continue;
+		const previous = lastEmitted.get(clip.kind);
+		if (previous !== void 0 && clip.timeRange.startMs - previous < quietMs) {
+			dropped.add(clip.id);
+			continue;
+		}
+		lastEmitted.set(clip.kind, clip.timeRange.startMs);
+	}
+	return clips.filter((clip) => !dropped.has(clip.id));
+}
 //#endregion
 //#region src/recorder/addon/videoclip-visits.ts
 /**
@@ -13804,10 +13833,22 @@ function clusterFootageVisits(ranges, gapMs = VISIT_MERGE_GAP_MS) {
 * so the visit became the recording session.
 *
 * Measured on 592, 2026-09-21, 24 h: seven rows covering the whole day, one of
-* them 7 h 58 m. Clustering the same day's EVENTS at the same 30 s gives 46
-* visits overnight and 36 in the day, median 17 s, longest 99 s. The constant
-* was right; the input was not. No duration cap: it would split by the clock
-* rather than by what happened, and nothing here needs splitting that way.
+* them 7 h 58 m.
+*
+* ## And the grain is the PADDING, not a constant
+*
+* `VISIT_MERGE_GAP_MS` (30 s) was arbitrary here and sat on a cliff. 592's
+* worst hour holds 492 events — 150 object, 98 motion, **244 audio** — whose
+* LARGEST gap is 25 s, so nothing ever reached 30 and the hour was one row.
+* Measured on that hour:
+*
+* | rule | clips | longest |
+* | --- | --- | --- |
+* | 30 s | 1 | 66 min |
+* | `preMs + postMs` (15 s) | 105 | 3.5 min |
+*
+* So two clips merge exactly when they would otherwise OVERLAP. Nothing to
+* tune, nothing to disagree with the pad.
 *
 * ## What the footage is still for
 *
@@ -13818,7 +13859,8 @@ function clusterFootageVisits(ranges, gapMs = VISIT_MERGE_GAP_MS) {
 * recorder never kept is not a clip, and listing it is a row that opens onto
 * nothing.
 */
-function clusterEventVisits(events, ranges, gapMs, pad) {
+function clusterEventVisits(events, ranges, pad) {
+	const gapMs = pad.preMs + pad.postMs;
 	if (events.length === 0 || ranges.length === 0) return [];
 	const times = [...events].map((e) => e.timestamp).toSorted((a, b) => a - b);
 	const sortedRanges = [...ranges].toSorted((a, b) => a.startMs - b.startMs);
@@ -14104,7 +14146,7 @@ function intersectsWindow(clip, since, until) {
 * scan on an indexed column buys a list that stops changing under the cursor.
 */
 function leftOverhangMs(pad) {
-	return VISIT_MERGE_GAP_MS + pad.preMs;
+	return pad.preMs + pad.postMs + pad.preMs;
 }
 /** No events at all — what the degraded branch annotates its visits with. */
 var NO_EVENTS = {
@@ -14164,14 +14206,14 @@ function createVideoclipsProvider(deps) {
 					since: readSince,
 					until
 				});
-				clips = visitsToClips(clusterEventVisits(allEvents(events), ranges, VISIT_MERGE_GAP_MS, deps.defaultPad), events, deps.defaultPad, vouched);
+				clips = visitsToClips(clusterEventVisits(allEvents(events), ranges, deps.defaultPad), events, deps.defaultPad, vouched);
 			} catch (err) {
 				deps.logWarn?.("videoclips: availability read failed — listing unfiltered", {
 					deviceId,
 					error: err instanceof Error ? err.message : String(err)
 				});
 			}
-			const inWindow = clips.filter((c) => intersectsWindow(c, since, until));
+			const inWindow = applyQuietKinds(clips).filter((c) => intersectsWindow(c, since, until));
 			const answer = limit != null ? inWindow.slice(0, limit) : inWindow;
 			reportUnvouchedClips(deps, deviceId, answer);
 			return answer;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-pipeline",
-  "version": "1.2.276",
+  "version": "1.2.279",
   "description": "Pipeline bundle — runner, detection, motion, audio + stream broker. Multi-entry npm package shipping pipeline addons under a single bundle.",
   "keywords": [
     "camstack",