@camstack/addon-pipeline 1.2.122 → 1.2.124

package/dist/stream-broker/index.js

@@ -24097,6 +24097,19 @@ var SCRUB_RECENTER_MS = 12e4;
 /** Hard bound on warm reads, derived from the session RAM budget. */
 var SCRUB_WARM_MAX_SEGMENTS = Math.max(1, Math.floor(SCRUB_FRAGMENT_CACHE_MAX_BYTES / 2e5));
 /**
+* Pause between two IDLE warm reads — the fill that continues AFTER a seek or
+* a scrub commit, while no finger is down.
+*
+* Idle warm exists because the cold/warm ratio on the recordings spindle is
+* 19× (531 ms vs 28 ms, measured 2026-08-25) and the operator's think-time on
+* a landed frame is the one window where the spindle is otherwise free. But
+* that same spindle carries every camera's writes and the export/event reads:
+* an UNPACED background walk would be one more saturating reader. One segment
+* read per gap keeps the fill under ~1 read/s worst case — the window fills in
+* a couple of minutes and the drag that follows lands on RAM.
+*/
+var IDLE_WARM_READ_GAP_MS = 250;
+/**
 * Median recent read time at or above which the feeder STOPS speculating.
 *
 * Speculation is a bet that spare I/O exists. When reads are this slow there is
@@ -24363,6 +24376,13 @@ var RecordedFeeder = class {
 	scrubReadMsWindow = [];
 	/** Warm-up runs once per drag, from the playhead the finger went down on. */
 	scrubWarmStarted = false;
+	/**
+	* True while the fill window belongs to IDLE mode — started by a seek (a
+	* timeline tap or a scrub commit) rather than by a drag. An idle fill paces
+	* itself ({@link IDLE_WARM_READ_GAP_MS}) and yields to any in-flight seek;
+	* a drag's own warm (`beginScrub`) always takes the window over.
+	*/
+	idleWarm = false;
 	/** Centre of the fill currently in flight (or last completed). */
 	scrubWarmCentreMs = null;
 	/** Bumped to abort a fill without aborting the drag tick (`scrubToken`). */
@@ -24607,6 +24627,7 @@ var RecordedFeeder = class {
 					bytes: loaded.bytes,
 					loadAusMs: Math.round(loadAusMs)
 				});
+				this.startIdleWarm(this.cursorMs);
 				return;
 			}
 			if (!stateAnnounced) {
@@ -24643,6 +24664,7 @@ var RecordedFeeder = class {
 				},
 				resumeAfterPtsMs
 			});
+			this.startIdleWarm(this.cursorMs);
 		} catch (err) {
 			if (!this.disposed && token === this.seekToken) {
 				this.stopPositionReports();
@@ -24756,7 +24778,36 @@ var RecordedFeeder = class {
 		this.stopPositionReports();
 		this.scrubWarmStarted = false;
 		this.scrubReadMsWindow = [];
-		if (this.cursorMs > 0 && this.deps.profile === SCRUB_WHOLE_SEGMENT_PROFILE) this.startScrubWarm(this.cursorMs, this.scrubToken);
+		if (this.cursorMs > 0 && this.deps.profile === SCRUB_WHOLE_SEGMENT_PROFILE) {
+			this.idleWarm = false;
+			this.startScrubWarm(this.cursorMs, this.scrubToken, { force: true });
+		}
+	}
+	/**
+	* Start (or recentre) the IDLE fill: called after every completed seek —
+	* a timeline tap or a scrub commit — with the landed cursor. The operator is
+	* now LOOKING at that frame; the next gesture almost always starts near it,
+	* and this is the one moment the spindle is not serving the finger. Bounds:
+	* the same session cache budget as the drag warm (48 MB LRU — no new store),
+	* the same {@link SCRUB_WARM_MAX_SEGMENTS} per-window cap, plus the idle
+	* pacing gap. `low`-only for the same reason the drag warm is: a `high`
+	* window would be hundreds of MB of reads for a profile no drag reads.
+	*/
+	startIdleWarm(centreMs) {
+		if (this.disposed || this.scrubbing) return;
+		if (centreMs <= 0 || this.deps.profile !== SCRUB_WHOLE_SEGMENT_PROFILE) return;
+		this.idleWarm = true;
+		this.startScrubWarm(centreMs, this.scrubToken, { force: true });
+	}
+	/**
+	* Whether the fill loop generation `dragGen` may keep working. During a drag
+	* only that drag's generation runs (a commit bumps `scrubToken` and the old
+	* walker exits); outside a drag the loop runs exactly while idle warm is on.
+	*/
+	warmLoopAlive(dragGen) {
+		if (this.disposed) return false;
+		if (this.scrubbing) return dragGen === this.scrubToken;
+		return this.idleWarm;
 	}
 	/**
 	* Warm the window the drag is about to move through: {@link SCRUB_WARM_BACK_MS}
@@ -24796,19 +24847,29 @@ var RecordedFeeder = class {
 	async runScrubFillLoop(dragGen) {
 		let lastWorked = -1;
 		try {
-			while (!this.disposed && this.scrubbing && dragGen === this.scrubToken) {
+			while (this.warmLoopAlive(dragGen)) {
 				const gen = this.scrubWarmGen;
 				const centre = this.scrubWarmCentreMs;
 				if (centre === null) return;
-				await this.warmScrubWindow(centre, dragGen, gen, this.scrubWarmBackMs, this.scrubWarmFwdMs);
+				const startedAt = performance.now();
+				const fetched = await this.warmScrubWindow(centre, dragGen, gen, this.scrubWarmBackMs, this.scrubWarmFwdMs);
 				lastWorked = gen;
-				if (gen === this.scrubWarmGen) return;
+				if (gen === this.scrubWarmGen) {
+					this.deps.onLog?.("scrub-feeder:warm-done", {
+						fillGen: gen,
+						idle: this.idleWarm && !this.scrubbing,
+						fetched,
+						ms: Math.round(performance.now() - startedAt)
+					});
+					if (!this.scrubbing) this.idleWarm = false;
+					return;
+				}
 			}
 		} finally {
 			this.scrubFillLoopActive = false;
-			if (!this.disposed && this.scrubbing && dragGen === this.scrubToken && this.scrubWarmCentreMs !== null && this.scrubWarmGen !== lastWorked) {
+			if (!this.disposed && (this.scrubbing || this.idleWarm) && this.scrubWarmCentreMs !== null && this.scrubWarmGen !== lastWorked) {
 				this.scrubFillLoopActive = true;
-				this.runScrubFillLoop(dragGen);
+				this.runScrubFillLoop(this.scrubToken);
 			}
 		}
 	}
@@ -24833,7 +24894,7 @@ var RecordedFeeder = class {
 	}
 	async warmScrubWindow(centreMs, dragGen, fillGen, backMs, fwdMs) {
 		const spent = await this.warmScrubDirection(centreMs, -1, backMs, 0, dragGen, fillGen);
-		await this.warmScrubDirection(centreMs, 1, fwdMs, spent, dragGen, fillGen);
+		return this.warmScrubDirection(centreMs, 1, fwdMs, spent, dragGen, fillGen);
 	}
 	/**
 	* Walk `dir` from `fromMs` until `spanMs` of timeline is warm (or the shared
@@ -24844,7 +24905,7 @@ var RecordedFeeder = class {
 		let read = spent;
 		let probeMs = fromMs;
 		for (let i = 0; i < SCRUB_WARM_MAX_SEGMENTS; i++) {
-			if (this.disposed || !this.scrubbing || dragGen !== this.scrubToken) return read;
+			if (!this.warmLoopAlive(dragGen)) return read;
 			if (fillGen !== this.scrubWarmGen) return read;
 			if (read >= SCRUB_WARM_MAX_SEGMENTS) return read;
 			if (Math.abs(probeMs - fromMs) > spanMs) return read;
@@ -24870,19 +24931,27 @@ var RecordedFeeder = class {
 				durMs: warm.durMs,
 				fetched: false
 			};
+			if (this.idleWarm && !this.scrubbing) {
+				await new Promise((r) => setTimeout(r, this.deps.idleWarmGapMs ?? IDLE_WARM_READ_GAP_MS));
+				while (this.inFlightSeekEpochMs !== null) {
+					if (!this.warmLoopAlive(dragGen) || fillGen !== this.scrubWarmGen) return null;
+					await new Promise((r) => setTimeout(r, 20));
+				}
+				if (!this.warmLoopAlive(dragGen) || fillGen !== this.scrubWarmGen) return null;
+			}
 			if (!await this.waitForTickReadIdle(fillGen)) return null;
 			const loc = await this.withTimeout(this.deps.locate({
 				deviceId: this.deps.deviceId,
 				profile: this.deps.profile,
 				epochMs: probeMs
 			}));
-			if (this.disposed || !this.scrubbing || dragGen !== this.scrubToken) return null;
+			if (!this.warmLoopAlive(dragGen)) return null;
 			if (fillGen !== this.scrubWarmGen) return null;
 			if (loc.kind !== "segment") return null;
 			if (!await this.waitForTickReadIdle(fillGen)) return null;
 			const load = await this.loadScrubFragment(loc, probeMs);
-			if (load !== null) this.scrubStats?.recordPrefetchRead(load.readBytes);
-			if (this.disposed || !this.scrubbing || dragGen !== this.scrubToken || load === null) return null;
+			if (load !== null && this.scrubbing) this.scrubStats?.recordPrefetchRead(load.readBytes);
+			if (!this.warmLoopAlive(dragGen) || load === null) return null;
 			if (fillGen !== this.scrubWarmGen) return null;
 			this.scrubCache.put(this.deps.profile, load.seg);
 			this.scrubPrefetched.add(load.seg.startMs);
@@ -24899,7 +24968,8 @@ var RecordedFeeder = class {
 	async waitForTickReadIdle(fillGen) {
 		while (this.scrubTickReadInFlight) {
 			await new Promise((r) => setTimeout(r, 4));
-			if (this.disposed || !this.scrubbing || fillGen !== this.scrubWarmGen) return false;
+			if (this.disposed || fillGen !== this.scrubWarmGen) return false;
+			if (!this.scrubbing && !this.idleWarm) return false;
 		}
 		return true;
 	}
@@ -26085,6 +26155,7 @@ var RecordedFeeder = class {
 		this.seekToken++;
 		this.advanceToken++;
 		this.scrubbing = false;
+		this.idleWarm = false;
 		this.scrubToken++;
 		this.scrubSegment = null;
 		this.scrubPrevTarget = null;

package/dist/stream-broker/index.mjs

@@ -24092,6 +24092,19 @@ var SCRUB_RECENTER_MS = 12e4;
 /** Hard bound on warm reads, derived from the session RAM budget. */
 var SCRUB_WARM_MAX_SEGMENTS = Math.max(1, Math.floor(SCRUB_FRAGMENT_CACHE_MAX_BYTES / 2e5));
 /**
+* Pause between two IDLE warm reads — the fill that continues AFTER a seek or
+* a scrub commit, while no finger is down.
+*
+* Idle warm exists because the cold/warm ratio on the recordings spindle is
+* 19× (531 ms vs 28 ms, measured 2026-08-25) and the operator's think-time on
+* a landed frame is the one window where the spindle is otherwise free. But
+* that same spindle carries every camera's writes and the export/event reads:
+* an UNPACED background walk would be one more saturating reader. One segment
+* read per gap keeps the fill under ~1 read/s worst case — the window fills in
+* a couple of minutes and the drag that follows lands on RAM.
+*/
+var IDLE_WARM_READ_GAP_MS = 250;
+/**
 * Median recent read time at or above which the feeder STOPS speculating.
 *
 * Speculation is a bet that spare I/O exists. When reads are this slow there is
@@ -24358,6 +24371,13 @@ var RecordedFeeder = class {
 	scrubReadMsWindow = [];
 	/** Warm-up runs once per drag, from the playhead the finger went down on. */
 	scrubWarmStarted = false;
+	/**
+	* True while the fill window belongs to IDLE mode — started by a seek (a
+	* timeline tap or a scrub commit) rather than by a drag. An idle fill paces
+	* itself ({@link IDLE_WARM_READ_GAP_MS}) and yields to any in-flight seek;
+	* a drag's own warm (`beginScrub`) always takes the window over.
+	*/
+	idleWarm = false;
 	/** Centre of the fill currently in flight (or last completed). */
 	scrubWarmCentreMs = null;
 	/** Bumped to abort a fill without aborting the drag tick (`scrubToken`). */
@@ -24602,6 +24622,7 @@ var RecordedFeeder = class {
 					bytes: loaded.bytes,
 					loadAusMs: Math.round(loadAusMs)
 				});
+				this.startIdleWarm(this.cursorMs);
 				return;
 			}
 			if (!stateAnnounced) {
@@ -24638,6 +24659,7 @@ var RecordedFeeder = class {
 				},
 				resumeAfterPtsMs
 			});
+			this.startIdleWarm(this.cursorMs);
 		} catch (err) {
 			if (!this.disposed && token === this.seekToken) {
 				this.stopPositionReports();
@@ -24751,7 +24773,36 @@ var RecordedFeeder = class {
 		this.stopPositionReports();
 		this.scrubWarmStarted = false;
 		this.scrubReadMsWindow = [];
-		if (this.cursorMs > 0 && this.deps.profile === SCRUB_WHOLE_SEGMENT_PROFILE) this.startScrubWarm(this.cursorMs, this.scrubToken);
+		if (this.cursorMs > 0 && this.deps.profile === SCRUB_WHOLE_SEGMENT_PROFILE) {
+			this.idleWarm = false;
+			this.startScrubWarm(this.cursorMs, this.scrubToken, { force: true });
+		}
+	}
+	/**
+	* Start (or recentre) the IDLE fill: called after every completed seek —
+	* a timeline tap or a scrub commit — with the landed cursor. The operator is
+	* now LOOKING at that frame; the next gesture almost always starts near it,
+	* and this is the one moment the spindle is not serving the finger. Bounds:
+	* the same session cache budget as the drag warm (48 MB LRU — no new store),
+	* the same {@link SCRUB_WARM_MAX_SEGMENTS} per-window cap, plus the idle
+	* pacing gap. `low`-only for the same reason the drag warm is: a `high`
+	* window would be hundreds of MB of reads for a profile no drag reads.
+	*/
+	startIdleWarm(centreMs) {
+		if (this.disposed || this.scrubbing) return;
+		if (centreMs <= 0 || this.deps.profile !== SCRUB_WHOLE_SEGMENT_PROFILE) return;
+		this.idleWarm = true;
+		this.startScrubWarm(centreMs, this.scrubToken, { force: true });
+	}
+	/**
+	* Whether the fill loop generation `dragGen` may keep working. During a drag
+	* only that drag's generation runs (a commit bumps `scrubToken` and the old
+	* walker exits); outside a drag the loop runs exactly while idle warm is on.
+	*/
+	warmLoopAlive(dragGen) {
+		if (this.disposed) return false;
+		if (this.scrubbing) return dragGen === this.scrubToken;
+		return this.idleWarm;
 	}
 	/**
 	* Warm the window the drag is about to move through: {@link SCRUB_WARM_BACK_MS}
@@ -24791,19 +24842,29 @@ var RecordedFeeder = class {
 	async runScrubFillLoop(dragGen) {
 		let lastWorked = -1;
 		try {
-			while (!this.disposed && this.scrubbing && dragGen === this.scrubToken) {
+			while (this.warmLoopAlive(dragGen)) {
 				const gen = this.scrubWarmGen;
 				const centre = this.scrubWarmCentreMs;
 				if (centre === null) return;
-				await this.warmScrubWindow(centre, dragGen, gen, this.scrubWarmBackMs, this.scrubWarmFwdMs);
+				const startedAt = performance.now();
+				const fetched = await this.warmScrubWindow(centre, dragGen, gen, this.scrubWarmBackMs, this.scrubWarmFwdMs);
 				lastWorked = gen;
-				if (gen === this.scrubWarmGen) return;
+				if (gen === this.scrubWarmGen) {
+					this.deps.onLog?.("scrub-feeder:warm-done", {
+						fillGen: gen,
+						idle: this.idleWarm && !this.scrubbing,
+						fetched,
+						ms: Math.round(performance.now() - startedAt)
+					});
+					if (!this.scrubbing) this.idleWarm = false;
+					return;
+				}
 			}
 		} finally {
 			this.scrubFillLoopActive = false;
-			if (!this.disposed && this.scrubbing && dragGen === this.scrubToken && this.scrubWarmCentreMs !== null && this.scrubWarmGen !== lastWorked) {
+			if (!this.disposed && (this.scrubbing || this.idleWarm) && this.scrubWarmCentreMs !== null && this.scrubWarmGen !== lastWorked) {
 				this.scrubFillLoopActive = true;
-				this.runScrubFillLoop(dragGen);
+				this.runScrubFillLoop(this.scrubToken);
 			}
 		}
 	}
@@ -24828,7 +24889,7 @@ var RecordedFeeder = class {
 	}
 	async warmScrubWindow(centreMs, dragGen, fillGen, backMs, fwdMs) {
 		const spent = await this.warmScrubDirection(centreMs, -1, backMs, 0, dragGen, fillGen);
-		await this.warmScrubDirection(centreMs, 1, fwdMs, spent, dragGen, fillGen);
+		return this.warmScrubDirection(centreMs, 1, fwdMs, spent, dragGen, fillGen);
 	}
 	/**
 	* Walk `dir` from `fromMs` until `spanMs` of timeline is warm (or the shared
@@ -24839,7 +24900,7 @@ var RecordedFeeder = class {
 		let read = spent;
 		let probeMs = fromMs;
 		for (let i = 0; i < SCRUB_WARM_MAX_SEGMENTS; i++) {
-			if (this.disposed || !this.scrubbing || dragGen !== this.scrubToken) return read;
+			if (!this.warmLoopAlive(dragGen)) return read;
 			if (fillGen !== this.scrubWarmGen) return read;
 			if (read >= SCRUB_WARM_MAX_SEGMENTS) return read;
 			if (Math.abs(probeMs - fromMs) > spanMs) return read;
@@ -24865,19 +24926,27 @@ var RecordedFeeder = class {
 				durMs: warm.durMs,
 				fetched: false
 			};
+			if (this.idleWarm && !this.scrubbing) {
+				await new Promise((r) => setTimeout(r, this.deps.idleWarmGapMs ?? IDLE_WARM_READ_GAP_MS));
+				while (this.inFlightSeekEpochMs !== null) {
+					if (!this.warmLoopAlive(dragGen) || fillGen !== this.scrubWarmGen) return null;
+					await new Promise((r) => setTimeout(r, 20));
+				}
+				if (!this.warmLoopAlive(dragGen) || fillGen !== this.scrubWarmGen) return null;
+			}
 			if (!await this.waitForTickReadIdle(fillGen)) return null;
 			const loc = await this.withTimeout(this.deps.locate({
 				deviceId: this.deps.deviceId,
 				profile: this.deps.profile,
 				epochMs: probeMs
 			}));
-			if (this.disposed || !this.scrubbing || dragGen !== this.scrubToken) return null;
+			if (!this.warmLoopAlive(dragGen)) return null;
 			if (fillGen !== this.scrubWarmGen) return null;
 			if (loc.kind !== "segment") return null;
 			if (!await this.waitForTickReadIdle(fillGen)) return null;
 			const load = await this.loadScrubFragment(loc, probeMs);
-			if (load !== null) this.scrubStats?.recordPrefetchRead(load.readBytes);
-			if (this.disposed || !this.scrubbing || dragGen !== this.scrubToken || load === null) return null;
+			if (load !== null && this.scrubbing) this.scrubStats?.recordPrefetchRead(load.readBytes);
+			if (!this.warmLoopAlive(dragGen) || load === null) return null;
 			if (fillGen !== this.scrubWarmGen) return null;
 			this.scrubCache.put(this.deps.profile, load.seg);
 			this.scrubPrefetched.add(load.seg.startMs);
@@ -24894,7 +24963,8 @@ var RecordedFeeder = class {
 	async waitForTickReadIdle(fillGen) {
 		while (this.scrubTickReadInFlight) {
 			await new Promise((r) => setTimeout(r, 4));
-			if (this.disposed || !this.scrubbing || fillGen !== this.scrubWarmGen) return false;
+			if (this.disposed || fillGen !== this.scrubWarmGen) return false;
+			if (!this.scrubbing && !this.idleWarm) return false;
 		}
 		return true;
 	}
@@ -26080,6 +26150,7 @@ var RecordedFeeder = class {
 		this.seekToken++;
 		this.advanceToken++;
 		this.scrubbing = false;
+		this.idleWarm = false;
 		this.scrubToken++;
 		this.scrubSegment = null;
 		this.scrubPrevTarget = null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-pipeline",
-  "version": "1.2.122",
+  "version": "1.2.124",
   "description": "Pipeline bundle — runner, detection, motion, audio + stream broker. Multi-entry npm package shipping pipeline addons under a single bundle.",
   "keywords": [
     "camstack",
@@ -70,8 +70,7 @@
         "execution": {
           "placement": "any-node",
           "heapProfile": "heavy",
-          "group": "detection",
-          "maxOldSpaceMb": 0
+          "group": "detection"
         },
         "capabilities": [
           {
@@ -104,8 +103,7 @@
         "execution": {
           "placement": "any-node",
           "heapProfile": "heavy",
-          "group": "detection",
-          "maxOldSpaceMb": 0
+          "group": "detection"
         },
         "protected": true,
         "icon": "assets/icon.svg",
@@ -121,8 +119,7 @@
         "execution": {
           "placement": "any-node",
           "heapProfile": "heavy",
-          "group": "detection",
-          "maxOldSpaceMb": 0
+          "group": "detection"
         },
         "capabilities": [
           {
@@ -149,8 +146,7 @@
         "entry": "./dist/audio-analyzer/index.js",
         "execution": {
           "placement": "any-node",
-          "heapProfile": "heavy",
-          "maxOldSpaceMb": 0
+          "heapProfile": "heavy"
         },
         "capabilities": [
           {
@@ -172,8 +168,7 @@
         "entry": "./dist/stream-broker/index.js",
         "execution": {
           "placement": "any-node",
-          "heapProfile": "heavy",
-          "maxOldSpaceMb": 0
+          "heapProfile": "heavy"
         },
         "capabilities": [
           {
@@ -203,7 +198,7 @@
         "execution": {
           "placement": "any-node",
           "heapProfile": "heavy",
-          "maxOldSpaceMb": 0
+          "maxOldSpaceMb": 3072
         },
         "capabilities": [
           {