@camstack/addon-pipeline 1.1.57 → 1.1.59

package/dist/{model-download-service-C-IHWnXx-3Mmeob3l.mjs → model-download-service-Cp9f4dk6-0wh7OK3s.mjs}

@@ -3,7 +3,7 @@ import { createReadStream, promises } from "node:fs";
 import * as path$1 from "node:path";
 import path from "node:path";
 import "node:crypto";
-//#region ../system/dist/model-download-service-C-IHWnXx.mjs
+//#region ../system/dist/model-download-service-Cp9f4dk6.mjs
 /**
 * Map a rel path to one candidate absolute path PER root, keeping only roots the
 * path stays within (traversal guard). The handler serves the first candidate
@@ -121,7 +121,7 @@ function createFileDataPlaneHandler(opts) {
 		const baseHeaders = {
 			"content-type": contentTypeFor(absPath, opts.contentTypes),
 			"accept-ranges": "bytes",
-			"cache-control": "no-cache"
+			"cache-control": opts.cacheControl?.(rel) ?? "no-cache"
 		};
 		const range = parseRangeHeader(req.headers.range, size);
 		if (range) {

package/dist/{model-download-service-C-IHWnXx-D326YNnt.js → model-download-service-Cp9f4dk6-Cp_GTKTw.js}

@@ -4,7 +4,7 @@ node_fs = require_chunk.__toESM(node_fs, 1);
 let node_path = require("node:path");
 node_path = require_chunk.__toESM(node_path, 1);
 require("node:crypto");
-//#region ../system/dist/model-download-service-C-IHWnXx.mjs
+//#region ../system/dist/model-download-service-Cp9f4dk6.mjs
 /**
 * Map a rel path to one candidate absolute path PER root, keeping only roots the
 * path stays within (traversal guard). The handler serves the first candidate
@@ -122,7 +122,7 @@ function createFileDataPlaneHandler(opts) {
 		const baseHeaders = {
 			"content-type": contentTypeFor(absPath, opts.contentTypes),
 			"accept-ranges": "bytes",
-			"cache-control": "no-cache"
+			"cache-control": opts.cacheControl?.(rel) ?? "no-cache"
 		};
 		const range = parseRangeHeader(req.headers.range, size);
 		if (range) {

package/dist/motion-wasm/index.js

@@ -2,7 +2,7 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_dist = require("../dist-CK8Ur-OS.js");
+const require_dist = require("../dist-B1u-QN05.js");
 let node_fs = require("node:fs");
 let node_path = require("node:path");
 //#region src/motion-wasm/wasm-motion-detector.ts

package/dist/motion-wasm/index.mjs

@@ -1,4 +1,4 @@
-import { B as DeviceType, E as motionDetectionCapability, L as BaseAddon, U as hydrateSchema, x as evaluateZoneRules } from "../dist-CL531uVA.mjs";
+import { B as DeviceType, E as motionDetectionCapability, H as hydrateSchema, L as BaseAddon, x as evaluateZoneRules } from "../dist-DKeNH_5z.mjs";
 import { readFileSync } from "node:fs";
 import { join } from "node:path";
 //#region src/motion-wasm/wasm-motion-detector.ts

package/dist/pipeline-runner/index.js

@@ -3,11 +3,11 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../chunk-D6vf50IK.js");
-const require_dist = require("../dist-CK8Ur-OS.js");
+const require_dist = require("../dist-B1u-QN05.js");
 const require_remote_restream = require("../remote-restream-CO36Sr30.js");
-const require_hub_hostname = require("../hub-hostname-DAJXlOgV.js");
+const require_sheet_geometry = require("../sheet-geometry-BN80zpCa.js");
 const require_worker_protocol = require("../worker-protocol-PP4jKHHJ.js");
-const require_step_definitions = require("../step-definitions-DHAxruAQ.js");
+const require_step_definitions = require("../step-definitions-CPch37vh.js");
 let node_child_process = require("node:child_process");
 let node_url = require("node:url");
 let sharp = require("sharp");
@@ -1279,6 +1279,40 @@ function cropRgb(frame, bbox, maxWidth) {
 		height: outH
 	};
 }
+var ThumbSamplerPolicy = class {
+	intervalMs;
+	minGapMs;
+	now;
+	/** Last accepted-sample wall clock per device. */
+	lastAcceptedAt = /* @__PURE__ */ new Map();
+	constructor(options) {
+		this.intervalMs = Math.max(0, options.intervalMs);
+		this.minGapMs = Math.max(0, options.minGapMs ?? 1e3);
+		this.now = options.now ?? (() => Date.now());
+	}
+	/**
+	* Decide whether to sample `deviceId` now. Returns true (and records the
+	* acceptance) when the larger of `intervalMs` / `minGapMs` has elapsed since
+	* the last accepted sample for this device; false otherwise. The FIRST call
+	* for a device always samples (cold start).
+	*/
+	shouldSample(deviceId) {
+		const now = this.now();
+		const gate = Math.max(this.intervalMs, this.minGapMs);
+		const last = this.lastAcceptedAt.get(deviceId);
+		if (last !== void 0 && now - last < gate) return false;
+		this.lastAcceptedAt.set(deviceId, now);
+		return true;
+	}
+	/** Forget a device (detach / phase exit) so its next frame cold-starts. */
+	forget(deviceId) {
+		this.lastAcceptedAt.delete(deviceId);
+	}
+	/** Drop all per-device state (shutdown). */
+	clear() {
+		this.lastAcceptedAt.clear();
+	}
+};
 //#endregion
 //#region src/session-decode/session-decode-coordinator.ts
 /** How long to wait after `kill()` before escalating to `kill('SIGKILL')`. */
@@ -2029,6 +2063,8 @@ async function runDetailSubtree(deps, input) {
 //#region src/pipeline-runner/index.ts
 var DEFAULT_CONFIG = {
 	maxQueueDepth: 30,
+	thumbnailsEnabled: true,
+	thumbnailSampleMs: 5e3,
 	maxConcurrentInferences: 16,
 	targetLoadPercent: 80,
 	minThrottledFps: 1,
@@ -2244,7 +2280,7 @@ function resolveSessionDecodeOwnerNodeId(config) {
 function resolveOwnerRestreamHost(frameSource, hubUrl) {
 	const reachable = frameSource.ownerReachableHost?.trim();
 	if (reachable !== void 0 && reachable.length > 0) return reachable;
-	return require_hub_hostname.resolveHubHostname(frameSource.hubHostnameOverride, hubUrl);
+	return require_sheet_geometry.resolveHubHostname(frameSource.hubHostnameOverride, hubUrl);
 }
 /**
 * Acquire the broker's COMPRESSED passthrough restream for one camStream and
@@ -2350,6 +2386,12 @@ var PipelineRunnerAddon = class extends require_dist.BaseAddon {
 	* Initialised in {@link onInitialize} once `nodeId` is known.
 	*/
 	retainedFrames = null;
+	/**
+	* Scrub-thumbnail sampler policy (2026-07-16). Gates the per-camera JPEG
+	* encode to ~1 / `thumbnailSampleMs` (with a hard 1 Hz ceiling) so the cost
+	* stays a couple ms of sharp every few seconds. Null until `onInitialize`.
+	*/
+	thumbSampler = null;
 	attached = /* @__PURE__ */ new Map();
 	nodeId = "unknown";
 	metricsSnapshotTimer = null;
@@ -2470,6 +2512,7 @@ var PipelineRunnerAddon = class extends require_dist.BaseAddon {
 			nodeId: this.nodeId,
 			logger: this.ctx.logger.child("retained-frames")
 		});
+		this.thumbSampler = new ThumbSamplerPolicy({ intervalMs: this.config.thumbnailSampleMs });
 		this.runner = new PipelineRunner({
 			maxQueueDepth: this.config.maxQueueDepth,
 			maxConcurrentInferences: this.config.maxConcurrentInferences,
@@ -2559,6 +2602,8 @@ var PipelineRunnerAddon = class extends require_dist.BaseAddon {
 		this.nativeCropRegistry.clear();
 		this.retainedFrames?.clear();
 		this.retainedFrames = null;
+		this.thumbSampler?.clear();
+		this.thumbSampler = null;
 	}
 	async cacheBenchFrame(input) {
 		const sharp$2 = (await import("sharp")).default;
@@ -3021,6 +3066,59 @@ var PipelineRunnerAddon = class extends require_dist.BaseAddon {
 			frameSpace: denormalizeRect(paddedBbox, handle.width, handle.height)
 		};
 	}
+	/**
+	* Scrub-thumbnail sampler (2026-07-16). Rides the already-decoded rgb
+	* detection frame: at most once per `thumbnailSampleMs` per camera (policy
+	* enforces a 1 Hz hard ceiling), downscale to a ~320px JPEG and emit it as
+	* `recording.thumb-sampled` telemetry. The recorder (single designated node)
+	* packs 5-minute sprite sheets from these. Fire-and-forget — a failed encode
+	* is logged at debug and never disturbs the decode/detect path. Zero extra
+	* decode (frame exists); one sharp encode per cadence per camera (D9: a
+	* compressed payload at 1/5 Hz, never raw pixels at frame-rate).
+	*/
+	maybeSampleThumbnail(deviceId, frame) {
+		if (!this.config.thumbnailsEnabled) return;
+		const sampler = this.thumbSampler;
+		if (!sampler || frame.format !== "rgb") return;
+		if (!sampler.shouldSample(deviceId)) return;
+		const capturedAt = typeof frame.capturedAt === "number" && frame.capturedAt > 0 ? frame.capturedAt : Date.now();
+		const width = frame.width;
+		const height = frame.height;
+		const data = frame.data;
+		(async () => {
+			try {
+				const targetW = Math.min(320, width);
+				const image = (0, sharp.default)(data, { raw: {
+					width,
+					height,
+					channels: 3
+				} });
+				if (targetW < width) image.resize(targetW);
+				const jpeg = await image.jpeg({ quality: 60 }).toBuffer();
+				const meta = {
+					width: targetW,
+					height: Math.round(targetW * height / width)
+				};
+				this.ctxIfReady?.eventBus.emit(require_dist.createEvent(require_dist.EventCategory.RecordingThumbSampled, {
+					type: "pipeline",
+					id: deviceId,
+					nodeId: this.nodeId,
+					deviceId
+				}, {
+					deviceId,
+					capturedAt,
+					width: meta.width,
+					height: meta.height,
+					jpeg: new Uint8Array(jpeg)
+				}));
+			} catch (err) {
+				this.ctx?.logger.debug("thumbnail sample encode failed", {
+					tags: { deviceId },
+					meta: { error: err instanceof Error ? err.message : String(err) }
+				});
+			}
+		})();
+	}
 	/** Real `runPipeline` dep: node-local `pipelineExecutor.runPipeline` on the `'full'` plane. */
 	async runDetailPipeline(steps, imageJpeg, deviceId) {
 		const api = this.ctxIfReady?.api;
@@ -3098,6 +3196,7 @@ var PipelineRunnerAddon = class extends require_dist.BaseAddon {
 		attachment.detectionUnsubscribe?.();
 		this.lastMotionFrameAt.delete(deviceId);
 		this.lastDecodeUnexpectedEndAt.delete(deviceId);
+		this.thumbSampler?.forget(deviceId);
 		this.attached.delete(deviceId);
 		this.lastMotionAt.delete(deviceId);
 		this.lastEmittedCameraMetrics.delete(deviceId);
@@ -3339,6 +3438,7 @@ var PipelineRunnerAddon = class extends require_dist.BaseAddon {
 						const handle = retainedFrames?.write(config.deviceId, frame) ?? void 0;
 						if (handle && nativeCrop) this.nativeCropRegistry.register(handle, nativeCrop);
 						this.enqueueSharedDetectionFrame(config.deviceId, frame, handle);
+						this.maybeSampleThumbnail(config.deviceId, frame);
 					}
 				});
 			}
@@ -3516,14 +3616,16 @@ var PipelineRunnerAddon = class extends require_dist.BaseAddon {
 		}
 		if (steps.length === 0) return null;
 		let image;
-		if (frame.format === "rgb") try {
-			image = await (0, sharp.default)(frame.data, { raw: {
-				width: frame.width,
-				height: frame.height,
-				channels: 3
-			} }).jpeg({ quality: DETECTION_HOP_JPEG_QUALITY }).toBuffer();
-		} catch (err) {
-			log.debug("runInference: frame JPEG encode failed — falling back to raw pixels", { meta: { error: require_dist.errMsg(err) } });
+		if (!this.executorCoLocated()) {
+			if (frame.format === "rgb") try {
+				image = await (0, sharp.default)(frame.data, { raw: {
+					width: frame.width,
+					height: frame.height,
+					channels: 3
+				} }).jpeg({ quality: DETECTION_HOP_JPEG_QUALITY }).toBuffer();
+			} catch (err) {
+				log.debug("runInference: frame JPEG encode failed — falling back to raw pixels", { meta: { error: require_dist.errMsg(err) } });
+			}
 		}
 		try {
 			return await api.pipelineExecutor.runPipeline.mutate({
@@ -3538,6 +3640,20 @@ var PipelineRunnerAddon = class extends require_dist.BaseAddon {
 			return null;
 		}
 	}
+	/** Sticky true once the executor's provider shows up in THIS process' local
+	*  registry (the `detection` execution.group) — from then on the per-frame
+	*  call is in-process and raw pixels are zero-copy. Re-checks while false
+	*  (a co-located sibling may register after the runner's first frames). */
+	executorCoLocatedSticky = false;
+	executorCoLocated() {
+		if (this.executorCoLocatedSticky) return true;
+		if (this.ctx?.capabilities?.get("pipeline-executor") !== void 0) {
+			this.executorCoLocatedSticky = true;
+			this.ctx?.logger.info("executor co-located in this runner — raw in-process frame transport");
+			return true;
+		}
+		return false;
+	}
 	async runMotionAnalysis(deviceId, frame, handle) {
 		const ctx = this.ctx;
 		const runner = this.runner;
@@ -3977,12 +4093,31 @@ var PipelineRunnerAddon = class extends require_dist.BaseAddon {
 					step: 1,
 					default: DEFAULT_CONFIG.maxConcurrentDecodeSpawns,
 					showValue: true
+				},
+				{
+					type: "boolean",
+					key: "thumbnailsEnabled",
+					label: "Scrub thumbnails",
+					description: "Sample the already-decoded detection frame into small JPEG scrub thumbnails (zero extra decode). The recorder packs them into 5-minute sprite sheets the viewer timeline scrubs. Disable to stop emitting thumbnail telemetry from this node.",
+					default: DEFAULT_CONFIG.thumbnailsEnabled
+				},
+				{
+					type: "slider",
+					key: "thumbnailSampleMs",
+					label: "Thumbnail cadence (ms)",
+					description: "How often (ms) each camera contributes a scrub thumbnail. Lower = denser scrub preview + more storage; a hard 1 Hz ceiling always applies. Default 5000.",
+					min: 1e3,
+					max: 3e4,
+					step: 1e3,
+					default: DEFAULT_CONFIG.thumbnailSampleMs,
+					showValue: true
 				}
 			]
 		}] });
 	}
 	async onConfigChanged() {
 		this.runner?.updateLimits(this.config);
+		this.thumbSampler = new ThumbSamplerPolicy({ intervalMs: this.config.thumbnailSampleMs });
 		this.spawnGate?.resize(Math.max(1, this.config.maxConcurrentDecodeSpawns));
 		this.ctx.logger.info("pipeline-runner tuning updated", { meta: {
 			maxQueueDepth: this.config.maxQueueDepth,

package/dist/pipeline-runner/index.mjs

@@ -1,8 +1,8 @@
-import { $ as boolean, D as nodePin, H as createEvent, I as errMsg, L as BaseAddon, Q as array, V as EventCategory, Z as _enum, _ as customAction, it as object, k as pipelineRunnerCapability, ot as string, rt as number, tt as lazy, y as defineCustomActions } from "../dist-CL531uVA.mjs";
+import { D as nodePin, I as errMsg, L as BaseAddon, Q as boolean, V as createEvent, X as _enum, Z as array, _ as customAction, at as string, et as lazy, k as pipelineRunnerCapability, nt as number, rt as object, st as EventCategory, y as defineCustomActions } from "../dist-DKeNH_5z.mjs";
 import { n as profileForStreamId, t as isRemoteRestream } from "../remote-restream-BeHi78PZ.mjs";
-import { t as resolveHubHostname } from "../hub-hostname-cCknRYKj.mjs";
+import { r as resolveHubHostname } from "../sheet-geometry-Bk3fR4s7.mjs";
 import { t as isWorkerReply } from "../worker-protocol-CyVJTZEO.mjs";
-import { a as getStepDefinition } from "../step-definitions-1d3_vQ6S.mjs";
+import { a as getStepDefinition } from "../step-definitions-DUB27V8Y.mjs";
 import { fork } from "node:child_process";
 import { fileURLToPath } from "node:url";
 import sharp from "sharp";
@@ -1273,6 +1273,40 @@ function cropRgb(frame, bbox, maxWidth) {
 		height: outH
 	};
 }
+var ThumbSamplerPolicy = class {
+	intervalMs;
+	minGapMs;
+	now;
+	/** Last accepted-sample wall clock per device. */
+	lastAcceptedAt = /* @__PURE__ */ new Map();
+	constructor(options) {
+		this.intervalMs = Math.max(0, options.intervalMs);
+		this.minGapMs = Math.max(0, options.minGapMs ?? 1e3);
+		this.now = options.now ?? (() => Date.now());
+	}
+	/**
+	* Decide whether to sample `deviceId` now. Returns true (and records the
+	* acceptance) when the larger of `intervalMs` / `minGapMs` has elapsed since
+	* the last accepted sample for this device; false otherwise. The FIRST call
+	* for a device always samples (cold start).
+	*/
+	shouldSample(deviceId) {
+		const now = this.now();
+		const gate = Math.max(this.intervalMs, this.minGapMs);
+		const last = this.lastAcceptedAt.get(deviceId);
+		if (last !== void 0 && now - last < gate) return false;
+		this.lastAcceptedAt.set(deviceId, now);
+		return true;
+	}
+	/** Forget a device (detach / phase exit) so its next frame cold-starts. */
+	forget(deviceId) {
+		this.lastAcceptedAt.delete(deviceId);
+	}
+	/** Drop all per-device state (shutdown). */
+	clear() {
+		this.lastAcceptedAt.clear();
+	}
+};
 //#endregion
 //#region src/session-decode/session-decode-coordinator.ts
 /** How long to wait after `kill()` before escalating to `kill('SIGKILL')`. */
@@ -2023,6 +2057,8 @@ async function runDetailSubtree(deps, input) {
 //#region src/pipeline-runner/index.ts
 var DEFAULT_CONFIG = {
 	maxQueueDepth: 30,
+	thumbnailsEnabled: true,
+	thumbnailSampleMs: 5e3,
 	maxConcurrentInferences: 16,
 	targetLoadPercent: 80,
 	minThrottledFps: 1,
@@ -2344,6 +2380,12 @@ var PipelineRunnerAddon = class extends BaseAddon {
 	* Initialised in {@link onInitialize} once `nodeId` is known.
 	*/
 	retainedFrames = null;
+	/**
+	* Scrub-thumbnail sampler policy (2026-07-16). Gates the per-camera JPEG
+	* encode to ~1 / `thumbnailSampleMs` (with a hard 1 Hz ceiling) so the cost
+	* stays a couple ms of sharp every few seconds. Null until `onInitialize`.
+	*/
+	thumbSampler = null;
 	attached = /* @__PURE__ */ new Map();
 	nodeId = "unknown";
 	metricsSnapshotTimer = null;
@@ -2464,6 +2506,7 @@ var PipelineRunnerAddon = class extends BaseAddon {
 			nodeId: this.nodeId,
 			logger: this.ctx.logger.child("retained-frames")
 		});
+		this.thumbSampler = new ThumbSamplerPolicy({ intervalMs: this.config.thumbnailSampleMs });
 		this.runner = new PipelineRunner({
 			maxQueueDepth: this.config.maxQueueDepth,
 			maxConcurrentInferences: this.config.maxConcurrentInferences,
@@ -2553,6 +2596,8 @@ var PipelineRunnerAddon = class extends BaseAddon {
 		this.nativeCropRegistry.clear();
 		this.retainedFrames?.clear();
 		this.retainedFrames = null;
+		this.thumbSampler?.clear();
+		this.thumbSampler = null;
 	}
 	async cacheBenchFrame(input) {
 		const sharp = (await import("sharp")).default;
@@ -3015,6 +3060,59 @@ var PipelineRunnerAddon = class extends BaseAddon {
 			frameSpace: denormalizeRect(paddedBbox, handle.width, handle.height)
 		};
 	}
+	/**
+	* Scrub-thumbnail sampler (2026-07-16). Rides the already-decoded rgb
+	* detection frame: at most once per `thumbnailSampleMs` per camera (policy
+	* enforces a 1 Hz hard ceiling), downscale to a ~320px JPEG and emit it as
+	* `recording.thumb-sampled` telemetry. The recorder (single designated node)
+	* packs 5-minute sprite sheets from these. Fire-and-forget — a failed encode
+	* is logged at debug and never disturbs the decode/detect path. Zero extra
+	* decode (frame exists); one sharp encode per cadence per camera (D9: a
+	* compressed payload at 1/5 Hz, never raw pixels at frame-rate).
+	*/
+	maybeSampleThumbnail(deviceId, frame) {
+		if (!this.config.thumbnailsEnabled) return;
+		const sampler = this.thumbSampler;
+		if (!sampler || frame.format !== "rgb") return;
+		if (!sampler.shouldSample(deviceId)) return;
+		const capturedAt = typeof frame.capturedAt === "number" && frame.capturedAt > 0 ? frame.capturedAt : Date.now();
+		const width = frame.width;
+		const height = frame.height;
+		const data = frame.data;
+		(async () => {
+			try {
+				const targetW = Math.min(320, width);
+				const image = sharp(data, { raw: {
+					width,
+					height,
+					channels: 3
+				} });
+				if (targetW < width) image.resize(targetW);
+				const jpeg = await image.jpeg({ quality: 60 }).toBuffer();
+				const meta = {
+					width: targetW,
+					height: Math.round(targetW * height / width)
+				};
+				this.ctxIfReady?.eventBus.emit(createEvent(EventCategory.RecordingThumbSampled, {
+					type: "pipeline",
+					id: deviceId,
+					nodeId: this.nodeId,
+					deviceId
+				}, {
+					deviceId,
+					capturedAt,
+					width: meta.width,
+					height: meta.height,
+					jpeg: new Uint8Array(jpeg)
+				}));
+			} catch (err) {
+				this.ctx?.logger.debug("thumbnail sample encode failed", {
+					tags: { deviceId },
+					meta: { error: err instanceof Error ? err.message : String(err) }
+				});
+			}
+		})();
+	}
 	/** Real `runPipeline` dep: node-local `pipelineExecutor.runPipeline` on the `'full'` plane. */
 	async runDetailPipeline(steps, imageJpeg, deviceId) {
 		const api = this.ctxIfReady?.api;
@@ -3092,6 +3190,7 @@ var PipelineRunnerAddon = class extends BaseAddon {
 		attachment.detectionUnsubscribe?.();
 		this.lastMotionFrameAt.delete(deviceId);
 		this.lastDecodeUnexpectedEndAt.delete(deviceId);
+		this.thumbSampler?.forget(deviceId);
 		this.attached.delete(deviceId);
 		this.lastMotionAt.delete(deviceId);
 		this.lastEmittedCameraMetrics.delete(deviceId);
@@ -3333,6 +3432,7 @@ var PipelineRunnerAddon = class extends BaseAddon {
 						const handle = retainedFrames?.write(config.deviceId, frame) ?? void 0;
 						if (handle && nativeCrop) this.nativeCropRegistry.register(handle, nativeCrop);
 						this.enqueueSharedDetectionFrame(config.deviceId, frame, handle);
+						this.maybeSampleThumbnail(config.deviceId, frame);
 					}
 				});
 			}
@@ -3510,14 +3610,16 @@ var PipelineRunnerAddon = class extends BaseAddon {
 		}
 		if (steps.length === 0) return null;
 		let image;
-		if (frame.format === "rgb") try {
-			image = await sharp(frame.data, { raw: {
-				width: frame.width,
-				height: frame.height,
-				channels: 3
-			} }).jpeg({ quality: DETECTION_HOP_JPEG_QUALITY }).toBuffer();
-		} catch (err) {
-			log.debug("runInference: frame JPEG encode failed — falling back to raw pixels", { meta: { error: errMsg(err) } });
+		if (!this.executorCoLocated()) {
+			if (frame.format === "rgb") try {
+				image = await sharp(frame.data, { raw: {
+					width: frame.width,
+					height: frame.height,
+					channels: 3
+				} }).jpeg({ quality: DETECTION_HOP_JPEG_QUALITY }).toBuffer();
+			} catch (err) {
+				log.debug("runInference: frame JPEG encode failed — falling back to raw pixels", { meta: { error: errMsg(err) } });
+			}
 		}
 		try {
 			return await api.pipelineExecutor.runPipeline.mutate({
@@ -3532,6 +3634,20 @@ var PipelineRunnerAddon = class extends BaseAddon {
 			return null;
 		}
 	}
+	/** Sticky true once the executor's provider shows up in THIS process' local
+	*  registry (the `detection` execution.group) — from then on the per-frame
+	*  call is in-process and raw pixels are zero-copy. Re-checks while false
+	*  (a co-located sibling may register after the runner's first frames). */
+	executorCoLocatedSticky = false;
+	executorCoLocated() {
+		if (this.executorCoLocatedSticky) return true;
+		if (this.ctx?.capabilities?.get("pipeline-executor") !== void 0) {
+			this.executorCoLocatedSticky = true;
+			this.ctx?.logger.info("executor co-located in this runner — raw in-process frame transport");
+			return true;
+		}
+		return false;
+	}
 	async runMotionAnalysis(deviceId, frame, handle) {
 		const ctx = this.ctx;
 		const runner = this.runner;
@@ -3971,12 +4087,31 @@ var PipelineRunnerAddon = class extends BaseAddon {
 					step: 1,
 					default: DEFAULT_CONFIG.maxConcurrentDecodeSpawns,
 					showValue: true
+				},
+				{
+					type: "boolean",
+					key: "thumbnailsEnabled",
+					label: "Scrub thumbnails",
+					description: "Sample the already-decoded detection frame into small JPEG scrub thumbnails (zero extra decode). The recorder packs them into 5-minute sprite sheets the viewer timeline scrubs. Disable to stop emitting thumbnail telemetry from this node.",
+					default: DEFAULT_CONFIG.thumbnailsEnabled
+				},
+				{
+					type: "slider",
+					key: "thumbnailSampleMs",
+					label: "Thumbnail cadence (ms)",
+					description: "How often (ms) each camera contributes a scrub thumbnail. Lower = denser scrub preview + more storage; a hard 1 Hz ceiling always applies. Default 5000.",
+					min: 1e3,
+					max: 3e4,
+					step: 1e3,
+					default: DEFAULT_CONFIG.thumbnailSampleMs,
+					showValue: true
 				}
 			]
 		}] });
 	}
 	async onConfigChanged() {
 		this.runner?.updateLimits(this.config);
+		this.thumbSampler = new ThumbSamplerPolicy({ intervalMs: this.config.thumbnailSampleMs });
 		this.spawnGate?.resize(Math.max(1, this.config.maxConcurrentDecodeSpawns));
 		this.ctx.logger.info("pipeline-runner tuning updated", { meta: {
 			maxQueueDepth: this.config.maxQueueDepth,