@camstack/addon-pipeline 1.2.7 → 1.2.9

package/dist/{sheet-geometry-DcpuGTCm.mjs → hub-hostname-DAJXlOgV.js}

@@ -45,43 +45,10 @@ function extractHost(raw) {
 	const host = authority.split(":")[0] ?? "";
 	return host.length > 0 ? host : void 0;
 }
-/**
-* Compute the grid + sheet dimensions for `tileCount` tiles. `tileCount` must
-* be ≥ 1 (an empty window produces no sheet). Columns = min(tileCount, maxCols)
-* so a partial window packs tightly instead of leaving a full-width row.
-*/
-function computeSheetGeometry(tileCount, options = {}) {
-	if (!Number.isInteger(tileCount) || tileCount < 1) throw new Error(`computeSheetGeometry: tileCount must be a positive integer, got ${tileCount}`);
-	const tileWidth = options.tileWidth ?? 480;
-	const tileHeight = options.tileHeight ?? 270;
-	const maxCols = Math.max(1, options.maxCols ?? 10);
-	const cols = Math.min(tileCount, maxCols);
-	const rows = Math.ceil(tileCount / cols);
-	return {
-		cols,
-		rows,
-		tileWidth,
-		tileHeight,
-		sheetWidth: cols * tileWidth,
-		sheetHeight: rows * tileHeight
-	};
-}
-/** Pixel placement of tile `index` (0-based) in row-major order. */
-function tilePlacement(index, geometry) {
-	if (!Number.isInteger(index) || index < 0) throw new Error(`tilePlacement: index must be a non-negative integer, got ${index}`);
-	const col = index % geometry.cols;
-	const row = Math.floor(index / geometry.cols);
-	return {
-		index,
-		x: col * geometry.tileWidth,
-		y: row * geometry.tileHeight
-	};
-}
-/** All tile placements for a full sheet, index 0..tileCount-1. */
-function allTilePlacements(tileCount, geometry) {
-	const out = [];
-	for (let i = 0; i < tileCount; i += 1) out.push(tilePlacement(i, geometry));
-	return out;
-}
 //#endregion
-export { computeSheetGeometry as n, resolveHubHostname as r, allTilePlacements as t };
+Object.defineProperty(exports, "resolveHubHostname", {
+	enumerable: true,
+	get: function() {
+		return resolveHubHostname;
+	}
+});

package/dist/{sheet-geometry-BR-ip0CP.js → hub-hostname-cCknRYKj.mjs}

@@ -45,60 +45,5 @@ function extractHost(raw) {
 	const host = authority.split(":")[0] ?? "";
 	return host.length > 0 ? host : void 0;
 }
-/**
-* Compute the grid + sheet dimensions for `tileCount` tiles. `tileCount` must
-* be ≥ 1 (an empty window produces no sheet). Columns = min(tileCount, maxCols)
-* so a partial window packs tightly instead of leaving a full-width row.
-*/
-function computeSheetGeometry(tileCount, options = {}) {
-	if (!Number.isInteger(tileCount) || tileCount < 1) throw new Error(`computeSheetGeometry: tileCount must be a positive integer, got ${tileCount}`);
-	const tileWidth = options.tileWidth ?? 480;
-	const tileHeight = options.tileHeight ?? 270;
-	const maxCols = Math.max(1, options.maxCols ?? 10);
-	const cols = Math.min(tileCount, maxCols);
-	const rows = Math.ceil(tileCount / cols);
-	return {
-		cols,
-		rows,
-		tileWidth,
-		tileHeight,
-		sheetWidth: cols * tileWidth,
-		sheetHeight: rows * tileHeight
-	};
-}
-/** Pixel placement of tile `index` (0-based) in row-major order. */
-function tilePlacement(index, geometry) {
-	if (!Number.isInteger(index) || index < 0) throw new Error(`tilePlacement: index must be a non-negative integer, got ${index}`);
-	const col = index % geometry.cols;
-	const row = Math.floor(index / geometry.cols);
-	return {
-		index,
-		x: col * geometry.tileWidth,
-		y: row * geometry.tileHeight
-	};
-}
-/** All tile placements for a full sheet, index 0..tileCount-1. */
-function allTilePlacements(tileCount, geometry) {
-	const out = [];
-	for (let i = 0; i < tileCount; i += 1) out.push(tilePlacement(i, geometry));
-	return out;
-}
 //#endregion
-Object.defineProperty(exports, "allTilePlacements", {
-	enumerable: true,
-	get: function() {
-		return allTilePlacements;
-	}
-});
-Object.defineProperty(exports, "computeSheetGeometry", {
-	enumerable: true,
-	get: function() {
-		return computeSheetGeometry;
-	}
-});
-Object.defineProperty(exports, "resolveHubHostname", {
-	enumerable: true,
-	get: function() {
-		return resolveHubHostname;
-	}
-});
+export { resolveHubHostname as t };

package/dist/{model-download-service-Cp9f4dk6-CwUb5v3Y.mjs → model-download-service-Cp9f4dk6-WO-foD7W.mjs}

@@ -1,8 +1,33 @@
+import { createRequire } from "node:module";
 import * as fs from "node:fs";
 import { createReadStream, promises } from "node:fs";
 import * as path$1 from "node:path";
 import path from "node:path";
 import "node:crypto";
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __commonJSMin = (cb, mod) => () => (mod || (cb((mod = { exports: {} }).exports, mod), cb = null), mod.exports);
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+//#endregion
 //#region ../system/dist/model-download-service-Cp9f4dk6.mjs
 /**
 * Map a rel path to one candidate absolute path PER root, keeping only roots the
@@ -328,4 +353,4 @@ function deleteModelFromDisk(modelsDir, entry, format) {
 	return true;
 }
 //#endregion
-export { ensureModel as a, downloadFile as i, createFileDataPlaneHandler as n, isModelDownloaded as o, deleteModelFromDisk as r, parseRangeHeader as s, contentTypeFor as t };
+export { ensureModel as a, __commonJSMin as c, downloadFile as i, __require as l, createFileDataPlaneHandler as n, isModelDownloaded as o, deleteModelFromDisk as r, parseRangeHeader as s, contentTypeFor as t, __toESM as u };

package/dist/{model-download-service-Cp9f4dk6-Dv-oFwjN.js → model-download-service-Cp9f4dk6-fsdDExML.js}

@@ -1,4 +1,4 @@
-const require_chunk = require("./chunk-D6vf50IK.js");
+const require_chunk = require("./chunk-emK7D4bc.js");
 let node_fs = require("node:fs");
 node_fs = require_chunk.__toESM(node_fs, 1);
 let node_path = require("node:path");

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-CAT3VF7A.js");
+const require_dist = require("../dist-DNjy_sr4.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 { A as motionDetectionCapability, J as hydrateSchema, K as DeviceType, T as evaluateZoneRules, U as BaseAddon } from "../dist-BwyGTnMu.mjs";
+import { A as motionDetectionCapability, G as DeviceType, H as BaseAddon, T as evaluateZoneRules, q as hydrateSchema } from "../dist-owmpaeIY.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

@@ -2,12 +2,12 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_chunk = require("../chunk-D6vf50IK.js");
-const require_dist = require("../dist-CAT3VF7A.js");
+const require_chunk = require("../chunk-emK7D4bc.js");
+const require_dist = require("../dist-DNjy_sr4.js");
 const require_remote_restream = require("../remote-restream-CO36Sr30.js");
-const require_sheet_geometry = require("../sheet-geometry-BR-ip0CP.js");
+const require_hub_hostname = require("../hub-hostname-DAJXlOgV.js");
 const require_worker_protocol = require("../worker-protocol-DextwlTX.js");
-const require_step_definitions = require("../step-definitions-BPEExRug.js");
+const require_step_definitions = require("../step-definitions-C2bNlww3.js");
 let node_child_process = require("node:child_process");
 let node_url = require("node:url");
 let sharp = require("sharp");
@@ -1279,7 +1279,7 @@ function startGuardedSessionDecode(deps) {
 /** {@link RETAINED_FRAME_BUDGET_MB} in bytes. */
 var RETAINED_FRAME_BUDGET_BYTES = (() => {
 	const raw = Number(process.env["CAMSTACK_SESSION_RETAIN_MB"]);
-	return Number.isFinite(raw) && raw > 0 ? Math.floor(raw) : 96;
+	return Number.isFinite(raw) && raw > 0 ? Math.floor(raw) : 160;
 })() * 1024 * 1024;
 /**
 * How many of each device's MOST RECENT frames are protected from a busy
@@ -1299,6 +1299,24 @@ var RETAINED_FRAME_PER_DEVICE_FLOOR = (() => {
 	const raw = Number(process.env["CAMSTACK_SESSION_RETAIN_FLOOR"]);
 	return Number.isFinite(raw) && raw >= 0 ? Math.floor(raw) : 16;
 })();
+/**
+* TIME-based per-device protection (2026-07-23 cold-window fix): a frame
+* YOUNGER than this survives budget eviction regardless of how many frames
+* its device holds. The COUNT floor above protects a fixed number of frames —
+* but the wall-clock window that buys depends on the delivered fps (16 frames
+* = 1.6 s @10 fps but only 0.64 s @25 fps, and the 4K street cams deliver
+* ~25). The late-capture horizon is TIME (session attach + enrichment +
+* round-trip ≈ 0.5–1.5 s, worst on cold on-motion dials), so the guarantee
+* must be time-denominated: 12/13 of the zero-media/missing-firstFrame tracks
+* in the 2026-07-23 audit were ≤6 s cold-session subjects whose handles were
+* recycled before their first captures ran. Bounded by the hard byte ceiling
+* (pass 2) exactly like the count floor — worst case ~26 MB per ACTIVE camera
+* @25 fps. `CAMSTACK_SESSION_RETAIN_FLOOR_MS`; `0` disables (count floor only).
+*/
+var RETAINED_FRAME_TIME_FLOOR_MS = (() => {
+	const raw = Number(process.env["CAMSTACK_SESSION_RETAIN_FLOOR_MS"]);
+	return Number.isFinite(raw) && raw >= 0 ? Math.floor(raw) : 3e3;
+})();
 /** Opaque RAM-key prefix stamped into a retained frame's `FrameHandle.shmId`. */
 var RETAINED_FRAME_KEY_PREFIX = "ram:";
 /** A retention frame is uniquely identified by its key + slot + committed seq. */
@@ -1309,6 +1327,8 @@ var RetainedFrameStore = class RetainedFrameStore {
 	nodeId;
 	budgetBytes;
 	perDeviceFloor;
+	timeFloorMs;
+	now;
 	/** Insertion-ordered (Map) → globally oldest is `keys().next()`. */
 	entries = /* @__PURE__ */ new Map();
 	/**
@@ -1325,6 +1345,8 @@ var RetainedFrameStore = class RetainedFrameStore {
 		this.nodeId = options.nodeId;
 		this.budgetBytes = options.budgetBytes ?? RETAINED_FRAME_BUDGET_BYTES;
 		this.perDeviceFloor = options.perDeviceFloor ?? RETAINED_FRAME_PER_DEVICE_FLOOR;
+		this.timeFloorMs = options.timeFloorMs ?? RETAINED_FRAME_TIME_FLOOR_MS;
+		this.now = options.now ?? Date.now;
 	}
 	/** Number of retained frames (tests / metrics). */
 	get size() {
@@ -1360,7 +1382,8 @@ var RetainedFrameStore = class RetainedFrameStore {
 		const key = keyOf(handle);
 		this.entries.set(key, {
 			frame,
-			deviceId
+			deviceId,
+			writtenAt: this.now()
 		});
 		const deviceKeys = this.perDeviceKeys.get(deviceId);
 		if (deviceKeys) deviceKeys.push(key);
@@ -1405,6 +1428,16 @@ var RetainedFrameStore = class RetainedFrameStore {
 	evictToBudget() {
 		if (this.bytes <= this.budgetBytes) return;
 		const oldestFirst = [...this.entries.keys()];
+		const nowMs = this.now();
+		for (const key of oldestFirst) {
+			if (this.bytes <= this.budgetBytes || this.entries.size <= 1) break;
+			const entry = this.entries.get(key);
+			if (!entry) continue;
+			if (this.timeFloorMs > 0 && nowMs - entry.writtenAt < this.timeFloorMs) continue;
+			const deviceKeys = this.perDeviceKeys.get(entry.deviceId);
+			if (deviceKeys && deviceKeys.length > this.perDeviceFloor) this.dropKey(key);
+		}
+		if (this.bytes <= this.budgetBytes) return;
 		for (const key of oldestFirst) {
 			if (this.bytes <= this.budgetBytes || this.entries.size <= 1) break;
 			const entry = this.entries.get(key);
@@ -1472,40 +1505,6 @@ 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')`. */
@@ -2364,8 +2363,6 @@ function resolveStepDevice(input) {
 //#region src/pipeline-runner/index.ts
 var DEFAULT_CONFIG = {
 	maxQueueDepth: 30,
-	thumbnailsEnabled: true,
-	thumbnailSampleMs: 5e3,
 	maxConcurrentInferences: 16,
 	targetLoadPercent: 80,
 	minThrottledFps: 1,
@@ -2581,7 +2578,7 @@ function resolveSessionDecodeOwnerNodeId(config) {
 function resolveOwnerRestreamHost(frameSource, hubUrl) {
 	const reachable = frameSource.ownerReachableHost?.trim();
 	if (reachable !== void 0 && reachable.length > 0) return reachable;
-	return require_sheet_geometry.resolveHubHostname(frameSource.hubHostnameOverride, hubUrl);
+	return require_hub_hostname.resolveHubHostname(frameSource.hubHostnameOverride, hubUrl);
 }
 /**
 * Acquire the broker's COMPRESSED passthrough restream for one camStream and
@@ -2687,12 +2684,6 @@ 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;
@@ -2820,7 +2811,6 @@ 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,
@@ -2911,8 +2901,6 @@ 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;
@@ -3479,59 +3467,6 @@ 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(480, 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, stepDeviceKey, nativeCropRef) {
 		const api = this.ctxIfReady?.api;
@@ -3612,7 +3547,6 @@ var PipelineRunnerAddon = class extends require_dist.BaseAddon {
 		attachment.detectionUnsubscribe?.();
 		this.lastMotionFrameAt.delete(deviceId);
 		this.lastDecodeUnexpectedEndAt.delete(deviceId);
-		this.thumbSampler?.forget(deviceId);
 		this.packageGovernor.forget(deviceId);
 		const warnPrefix = `${deviceId}:`;
 		for (const key of this.warnedNoJumpDevice) if (key.startsWith(warnPrefix)) this.warnedNoJumpDevice.delete(key);
@@ -3859,7 +3793,6 @@ 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);
 					}
 				});
 			}
@@ -4527,31 +4460,12 @@ 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,