@camstack/addon-pipeline 1.1.65 → 1.1.67

package/dist/{dist-D6tHM9GA.mjs → dist-DkGHtAaK.mjs}

@@ -7207,6 +7207,17 @@ var ModelCatalogEntrySchema = object({
 		"imagenet",
 		"none"
 	]).optional(),
+	/**
+	* The model already applies softmax IN-GRAPH — its raw output is a
+	* probability distribution, not logits. When set, the `softmax`
+	* postprocessor must NOT re-apply softmax: re-softmaxing an already-normalised
+	* probability vector collapses it toward uniform (top-1 score craters far
+	* below its true value, making every confidence gate meaningless). Absent ⇒
+	* the output is raw logits and the postprocessor applies softmax (the normal
+	* case). Set on the Google AIY Birds `bird-classifier` (softmax baked into the
+	* TF graph). Threaded to the Python pool via `PoolModelConfig.outputProbabilities`.
+	*/
+	outputProbabilities: boolean().optional(),
 	preprocessMode: _enum(["letterbox", "resize"]).optional(),
 	/**
 	* Per-MODEL postprocessor override. Absent ⇒ the step's own
@@ -12081,7 +12092,14 @@ var pipelineExecutorCapability = {
 			* (inputClasses ≠ null) are skipped and served per-track via
 			* pipelineRunner.runDetailSubtree (two-plane design).
 			*/
-			plane: _enum(["full", "frame"]).optional()
+			plane: _enum(["full", "frame"]).optional(),
+			/**
+			* Inference-device selector (Phase 2 multi-device). Format
+			* `<backend>:<device>` (e.g. `openvino:gpu`, `edgetpu:usb`, `cpu`).
+			* Omitted ⇒ the runner's default device (current single-engine
+			* behaviour). Selects WHICH device pool of the node runs the call.
+			*/
+			deviceKey: string().optional()
 		}), PipelineRunResultBridge, { kind: "mutation" }),
 		/**
 		* Batched run — N raw frames packed into one cap call. The provider
@@ -12099,7 +12117,20 @@ var pipelineExecutorCapability = {
 			steps: array(PipelineStepInputSchema).min(1),
 			frames: array(FrameInputSchema).min(1).max(255),
 			deviceId: number().optional(),
-			sessionId: string().optional()
+			sessionId: string().optional(),
+			/**
+			* Pure-inference benchmark hint. A NONZERO uint32 pins every frame in
+			* the batch to the Python pool's bench preprocess cache
+			* (`_bench_frame_id`) so a REPEATED benchmark frame is decoded +
+			* preprocessed ONCE and every later inference is a pure-inference cache
+			* hit — the sustained-throughput run measures inference, not
+			* decode+preprocess+infer. Omitted/0 for live frames (all different →
+			* full preprocess every call, correct). Fresh per sustained run;
+			* released via `uncacheFrame`.
+			*/
+			frameId: number().int().nonnegative().optional(),
+			/** Inference-device selector (Phase 2 multi-device); see runPipeline. */
+			deviceKey: string().optional()
 		}), object({ results: array(PipelineRunResultBridge).readonly() }), { kind: "mutation" }),
 		/**
 		* Cache a raw frame inside the Python inference pool's memory.
@@ -12516,7 +12547,14 @@ var RunnerCameraConfigSchema = object({
 	* camera's detect node differs from its source-owner (P2d, gated by the
 	* `remoteSourcingNodes` rollout setting).
 	*/
-	frameSource: RunnerFrameSourceSchema.default({ kind: "local-broker" })
+	frameSource: RunnerFrameSourceSchema.default({ kind: "local-broker" }),
+	/**
+	* Inference-device selector for this camera's sessions (Phase 2 multi-device).
+	* Format `<backend>:<device>` (e.g. `openvino:gpu`, `edgetpu:usb`, `cpu`);
+	* omitted ⇒ the runner's default device. The engine itself stays node-local —
+	* this only selects WHICH device pool of that node runs the session.
+	*/
+	deviceKey: string().optional()
 });
 motionFpsField.min, motionFpsField.max, motionFpsField.step, motionFpsField.default, detectionFpsField.min, detectionFpsField.max, detectionFpsField.step, detectionFpsField.default, motionCooldownMsField.min, motionCooldownMsField.max, motionCooldownMsField.step, motionCooldownMsField.default, occupancyRecheckSecField.min, occupancyRecheckSecField.max, occupancyRecheckSecField.step, occupancyRecheckSecField.default, occupancyRecheckFramesField.min, occupancyRecheckFramesField.max, occupancyRecheckFramesField.step, occupancyRecheckFramesField.default;
 /**
@@ -14087,6 +14125,8 @@ method(_void(), _void(), { kind: "mutation" }), method(_void(), _void(), { kind:
 	kind: "mutation",
 	auth: "admin"
 });
+DeviceType.Cover, DeviceType.Valve, DeviceType.Humidifier, DeviceType.WaterHeater, DeviceType.Camera, DeviceType.Hub, DeviceType.Switch, DeviceType.Siren, DeviceType.Light, DeviceType.Fan, DeviceType.Sensor, DeviceType.Thermostat, DeviceType.Climate, DeviceType.Button, DeviceType.EventEmitter, DeviceType.Update, DeviceType.Generic, DeviceType.Notifier, DeviceType.Script, DeviceType.Automation, DeviceType.Lock, DeviceType.MediaPlayer, DeviceType.AlarmPanel, DeviceType.Control, DeviceType.Presence, DeviceType.Weather, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.Container, DeviceType.Image, DeviceType.PetFeeder;
+new Set(Object.values(DeviceType));
 /**
 * Evaluate `rules` against `items`. Returns the items partitioned
 * into `passed` (kept by the gate) and `excluded` (dropped). When
@@ -21000,17 +21040,28 @@ var PlatformScoreSchema = object({
 	format: _enum([
 		"onnx",
 		"coreml",
-		"openvino"
+		"openvino",
+		"tflite"
 	]),
 	score: number(),
 	reason: string(),
 	available: boolean()
 });
+var InferenceDeviceDescriptorSchema = object({
+	key: string(),
+	backend: string(),
+	device: string(),
+	format: ModelFormatSchema,
+	runtime: literal("python"),
+	score: number(),
+	available: boolean()
+});
 var PlatformCapabilitiesSchema = object({
 	hardware: HardwareInfoSchema,
 	scores: array(PlatformScoreSchema).readonly(),
 	bestScore: PlatformScoreSchema,
-	pythonPath: string().nullable()
+	pythonPath: string().nullable(),
+	devices: array(InferenceDeviceDescriptorSchema).readonly()
 });
 var ModelRequirementSchema = object({
 	modelId: string(),

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-WW3gH8hF.js");
+const require_dist = require("../dist-BxxVKcnw.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 { C as evaluateZoneRules, K as hydrateSchema, O as motionDetectionCapability, V as BaseAddon, W as DeviceType } from "../dist-D6tHM9GA.mjs";
+import { C as evaluateZoneRules, K as hydrateSchema, O as motionDetectionCapability, V as BaseAddon, W as DeviceType } from "../dist-DkGHtAaK.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-WW3gH8hF.js");
+const require_dist = require("../dist-BxxVKcnw.js");
 const require_remote_restream = require("../remote-restream-CO36Sr30.js");
 const require_sheet_geometry = require("../sheet-geometry-BR-ip0CP.js");
 const require_worker_protocol = require("../worker-protocol-PP4jKHHJ.js");
-const require_step_definitions = require("../step-definitions-CXZpwwT0.js");
+const require_step_definitions = require("../step-definitions-CAs0RD2N.js");
 let node_child_process = require("node:child_process");
 let node_url = require("node:url");
 let sharp = require("sharp");
@@ -1248,23 +1248,39 @@ 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) : 32;
+	return Number.isFinite(raw) && raw > 0 ? Math.floor(raw) : 96;
 })() * 1024 * 1024;
+/**
+* How many of each device's MOST RECENT frames are protected from a busy
+* neighbour's budget eviction. Sized to cover the late two-plane / cross-process
+* enrichment horizon (~150-500 ms): 6 frames ≈ 0.6 s @10 fps of guaranteed
+* survival for every active camera. Read ONCE from
+* `CAMSTACK_SESSION_RETAIN_FLOOR`; `0` disables the floor (pure global FIFO — the
+* pre-2026-07-19 behaviour). The hard byte ceiling always overrides the floor,
+* so this can never push retention past {@link RETAINED_FRAME_BUDGET_BYTES}.
+*/
+var RETAINED_FRAME_PER_DEVICE_FLOOR = (() => {
+	const raw = Number(process.env["CAMSTACK_SESSION_RETAIN_FLOOR"]);
+	return Number.isFinite(raw) && raw >= 0 ? Math.floor(raw) : 6;
+})();
 /** 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. */
 function keyOf(handle) {
 	return `${handle.shmId}#${handle.slot}#${handle.seq}`;
 }
-/**
-* Node-level RAM store of retained rgb detection frames, keyed by
-* `FrameHandle` identity. Latest-wins with a byte budget.
-*/
 var RetainedFrameStore = class RetainedFrameStore {
 	nodeId;
 	budgetBytes;
-	/** Insertion-ordered (Map) → oldest is `keys().next()`. */
+	perDeviceFloor;
+	/** Insertion-ordered (Map) → globally oldest is `keys().next()`. */
 	entries = /* @__PURE__ */ new Map();
+	/**
+	* Per-device insertion-ordered keys (oldest→newest). Mirrors {@link entries}
+	* so the floor can be enforced in O(1) per eviction candidate without scanning
+	* the global map for a device's frame count.
+	*/
+	perDeviceKeys = /* @__PURE__ */ new Map();
 	bytes = 0;
 	seq = 0;
 	/** Ring width used only to spread the `slot` field; the map key is authoritative. */
@@ -1272,6 +1288,7 @@ var RetainedFrameStore = class RetainedFrameStore {
 	constructor(options) {
 		this.nodeId = options.nodeId;
 		this.budgetBytes = options.budgetBytes ?? RETAINED_FRAME_BUDGET_BYTES;
+		this.perDeviceFloor = options.perDeviceFloor ?? RETAINED_FRAME_PER_DEVICE_FLOOR;
 	}
 	/** Number of retained frames (tests / metrics). */
 	get size() {
@@ -1304,14 +1321,21 @@ var RetainedFrameStore = class RetainedFrameStore {
 			nodeId: this.nodeId,
 			slotCount: RetainedFrameStore.SLOT_SPREAD
 		};
-		this.entries.set(keyOf(handle), frame);
+		const key = keyOf(handle);
+		this.entries.set(key, {
+			frame,
+			deviceId
+		});
+		const deviceKeys = this.perDeviceKeys.get(deviceId);
+		if (deviceKeys) deviceKeys.push(key);
+		else this.perDeviceKeys.set(deviceId, [key]);
 		this.bytes += byteLength;
 		this.evictToBudget();
 		return handle;
 	}
 	/** The retained frame for `handle`, or `null` if never retained / already evicted. */
 	getFrame(handle) {
-		return this.entries.get(keyOf(handle)) ?? null;
+		return this.entries.get(keyOf(handle))?.frame ?? null;
 	}
 	/**
 	* Crop (and optionally downscale) the retained rgb frame for `handle` to the
@@ -1322,26 +1346,56 @@ var RetainedFrameStore = class RetainedFrameStore {
 	* decode worker's surface (`getNativeCrop`), not here.
 	*/
 	crop(handle, bbox, maxWidth) {
-		const frame = this.entries.get(keyOf(handle));
-		if (!frame || frame.format !== "rgb") return null;
-		return cropRgb(frame, bbox, maxWidth);
+		const entry = this.entries.get(keyOf(handle));
+		if (!entry || entry.frame.format !== "rgb") return null;
+		return cropRgb(entry.frame, bbox, maxWidth);
 	}
 	/** Drop every retained frame (node/addon shutdown). */
 	clear() {
 		this.entries.clear();
+		this.perDeviceKeys.clear();
 		this.bytes = 0;
 	}
-	/** Evict oldest frames until the retained bytes fit the budget (keep ≥1). */
+	/**
+	* Evict frames until the retained bytes fit the budget (keep ≥1).
+	*
+	* Pass 1 (fairness): walk globally oldest→newest and drop only frames whose
+	* device still holds MORE than {@link perDeviceFloor} frames — so a busy
+	* camera's excess is reclaimed before any camera's protected recent window.
+	* Pass 2 (OOM guard): if still over budget (every remaining frame is
+	* floor-protected yet the ceiling is exhausted), drop globally oldest-first
+	* regardless of the floor. The ceiling ALWAYS wins over fairness.
+	*/
 	evictToBudget() {
-		while (this.bytes > this.budgetBytes && this.entries.size > 1) {
-			const oldest = this.entries.keys().next().value;
-			if (oldest === void 0) break;
-			const evicted = this.entries.get(oldest);
-			this.entries.delete(oldest);
-			if (evicted) this.bytes -= evicted.data.byteLength;
+		if (this.bytes <= this.budgetBytes) return;
+		const oldestFirst = [...this.entries.keys()];
+		for (const key of oldestFirst) {
+			if (this.bytes <= this.budgetBytes || this.entries.size <= 1) break;
+			const entry = this.entries.get(key);
+			if (!entry) 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;
+			this.dropKey(key);
 		}
 		if (this.bytes < 0) this.bytes = 0;
 	}
+	/** Remove one frame by key, keeping the byte tally + per-device index exact. */
+	dropKey(key) {
+		const entry = this.entries.get(key);
+		if (!entry) return;
+		this.entries.delete(key);
+		this.bytes -= entry.frame.data.byteLength;
+		const deviceKeys = this.perDeviceKeys.get(entry.deviceId);
+		if (deviceKeys) {
+			const idx = deviceKeys.indexOf(key);
+			if (idx >= 0) deviceKeys.splice(idx, 1);
+			if (deviceKeys.length === 0) this.perDeviceKeys.delete(entry.deviceId);
+		}
+	}
 };
 /**
 * Nearest-neighbour crop + optional downscale of a packed RGB24 frame to a
@@ -1931,6 +1985,18 @@ function startSessionDecodePump(deps) {
 		iterator.return().catch(() => {});
 	};
 }
+//#endregion
+//#region src/session-decode/native-crop-registry.ts
+/**
+* Default max entries retained across all active decode sessions on a node. Read
+* ONCE from `CAMSTACK_NATIVE_CROP_REGISTRY_CAP`; a non-finite / non-positive
+* value falls back to 256 (was a fixed 64 — too small for a busy multi-camera
+* node, see class doc).
+*/
+var DEFAULT_NATIVE_CROP_REGISTRY_CAP = (() => {
+	const raw = Number(process.env["CAMSTACK_NATIVE_CROP_REGISTRY_CAP"]);
+	return Number.isFinite(raw) && raw > 0 ? Math.floor(raw) : 256;
+})();
 /** Invoke a requester's best-effort `release()`, swallowing any transport error. */
 function safeRelease(request) {
 	try {
@@ -1940,7 +2006,7 @@ function safeRelease(request) {
 var NativeCropRegistry = class {
 	capacity;
 	entries = /* @__PURE__ */ new Map();
-	constructor(capacity = 64) {
+	constructor(capacity = DEFAULT_NATIVE_CROP_REGISTRY_CAP) {
 		this.capacity = capacity;
 	}
 	/** Number of registered handles (tests / metrics). */
@@ -3106,7 +3172,7 @@ var PipelineRunnerAddon = class extends require_dist.BaseAddon {
 	*/
 	async getNativeCrop(input) {
 		const b = input.bbox;
-		if (!(b.x <= .001 && b.y <= .001 && b.w >= .999 && b.h >= .999)) {
+		if (!(b.x <= .001 && b.y <= .001 && b.w >= .999 && b.h >= .999 && input.maxWidth === void 0)) {
 			const requester = this.nativeCropRegistry.get(input.handle);
 			if (requester) {
 				const result = await requester(input.bbox, input.maxWidth);

package/dist/pipeline-runner/index.mjs

@@ -1,8 +1,8 @@
-import { B as errMsg, G as createEvent, V as BaseAddon, dt as EventCategory, et as _enum, it as lazy, j as pipelineRunnerCapability, k as nodePin, lt as string, nt as boolean, ot as number, st as object, tt as array, x as defineCustomActions, y as customAction } from "../dist-D6tHM9GA.mjs";
+import { B as errMsg, G as createEvent, V as BaseAddon, dt as EventCategory, et as _enum, it as lazy, j as pipelineRunnerCapability, k as nodePin, lt as string, nt as boolean, ot as number, st as object, tt as array, x as defineCustomActions, y as customAction } from "../dist-DkGHtAaK.mjs";
 import { n as profileForStreamId, t as isRemoteRestream } from "../remote-restream-BeHi78PZ.mjs";
 import { r as resolveHubHostname } from "../sheet-geometry-DcpuGTCm.mjs";
 import { t as isWorkerReply } from "../worker-protocol-CyVJTZEO.mjs";
-import { a as getStepDefinition } from "../step-definitions-Dbsm64_I.mjs";
+import { a as getStepDefinition } from "../step-definitions-Delhq28w.mjs";
 import { fork } from "node:child_process";
 import { fileURLToPath } from "node:url";
 import sharp from "sharp";
@@ -1242,23 +1242,39 @@ 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) : 32;
+	return Number.isFinite(raw) && raw > 0 ? Math.floor(raw) : 96;
 })() * 1024 * 1024;
+/**
+* How many of each device's MOST RECENT frames are protected from a busy
+* neighbour's budget eviction. Sized to cover the late two-plane / cross-process
+* enrichment horizon (~150-500 ms): 6 frames ≈ 0.6 s @10 fps of guaranteed
+* survival for every active camera. Read ONCE from
+* `CAMSTACK_SESSION_RETAIN_FLOOR`; `0` disables the floor (pure global FIFO — the
+* pre-2026-07-19 behaviour). The hard byte ceiling always overrides the floor,
+* so this can never push retention past {@link RETAINED_FRAME_BUDGET_BYTES}.
+*/
+var RETAINED_FRAME_PER_DEVICE_FLOOR = (() => {
+	const raw = Number(process.env["CAMSTACK_SESSION_RETAIN_FLOOR"]);
+	return Number.isFinite(raw) && raw >= 0 ? Math.floor(raw) : 6;
+})();
 /** 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. */
 function keyOf(handle) {
 	return `${handle.shmId}#${handle.slot}#${handle.seq}`;
 }
-/**
-* Node-level RAM store of retained rgb detection frames, keyed by
-* `FrameHandle` identity. Latest-wins with a byte budget.
-*/
 var RetainedFrameStore = class RetainedFrameStore {
 	nodeId;
 	budgetBytes;
-	/** Insertion-ordered (Map) → oldest is `keys().next()`. */
+	perDeviceFloor;
+	/** Insertion-ordered (Map) → globally oldest is `keys().next()`. */
 	entries = /* @__PURE__ */ new Map();
+	/**
+	* Per-device insertion-ordered keys (oldest→newest). Mirrors {@link entries}
+	* so the floor can be enforced in O(1) per eviction candidate without scanning
+	* the global map for a device's frame count.
+	*/
+	perDeviceKeys = /* @__PURE__ */ new Map();
 	bytes = 0;
 	seq = 0;
 	/** Ring width used only to spread the `slot` field; the map key is authoritative. */
@@ -1266,6 +1282,7 @@ var RetainedFrameStore = class RetainedFrameStore {
 	constructor(options) {
 		this.nodeId = options.nodeId;
 		this.budgetBytes = options.budgetBytes ?? RETAINED_FRAME_BUDGET_BYTES;
+		this.perDeviceFloor = options.perDeviceFloor ?? RETAINED_FRAME_PER_DEVICE_FLOOR;
 	}
 	/** Number of retained frames (tests / metrics). */
 	get size() {
@@ -1298,14 +1315,21 @@ var RetainedFrameStore = class RetainedFrameStore {
 			nodeId: this.nodeId,
 			slotCount: RetainedFrameStore.SLOT_SPREAD
 		};
-		this.entries.set(keyOf(handle), frame);
+		const key = keyOf(handle);
+		this.entries.set(key, {
+			frame,
+			deviceId
+		});
+		const deviceKeys = this.perDeviceKeys.get(deviceId);
+		if (deviceKeys) deviceKeys.push(key);
+		else this.perDeviceKeys.set(deviceId, [key]);
 		this.bytes += byteLength;
 		this.evictToBudget();
 		return handle;
 	}
 	/** The retained frame for `handle`, or `null` if never retained / already evicted. */
 	getFrame(handle) {
-		return this.entries.get(keyOf(handle)) ?? null;
+		return this.entries.get(keyOf(handle))?.frame ?? null;
 	}
 	/**
 	* Crop (and optionally downscale) the retained rgb frame for `handle` to the
@@ -1316,26 +1340,56 @@ var RetainedFrameStore = class RetainedFrameStore {
 	* decode worker's surface (`getNativeCrop`), not here.
 	*/
 	crop(handle, bbox, maxWidth) {
-		const frame = this.entries.get(keyOf(handle));
-		if (!frame || frame.format !== "rgb") return null;
-		return cropRgb(frame, bbox, maxWidth);
+		const entry = this.entries.get(keyOf(handle));
+		if (!entry || entry.frame.format !== "rgb") return null;
+		return cropRgb(entry.frame, bbox, maxWidth);
 	}
 	/** Drop every retained frame (node/addon shutdown). */
 	clear() {
 		this.entries.clear();
+		this.perDeviceKeys.clear();
 		this.bytes = 0;
 	}
-	/** Evict oldest frames until the retained bytes fit the budget (keep ≥1). */
+	/**
+	* Evict frames until the retained bytes fit the budget (keep ≥1).
+	*
+	* Pass 1 (fairness): walk globally oldest→newest and drop only frames whose
+	* device still holds MORE than {@link perDeviceFloor} frames — so a busy
+	* camera's excess is reclaimed before any camera's protected recent window.
+	* Pass 2 (OOM guard): if still over budget (every remaining frame is
+	* floor-protected yet the ceiling is exhausted), drop globally oldest-first
+	* regardless of the floor. The ceiling ALWAYS wins over fairness.
+	*/
 	evictToBudget() {
-		while (this.bytes > this.budgetBytes && this.entries.size > 1) {
-			const oldest = this.entries.keys().next().value;
-			if (oldest === void 0) break;
-			const evicted = this.entries.get(oldest);
-			this.entries.delete(oldest);
-			if (evicted) this.bytes -= evicted.data.byteLength;
+		if (this.bytes <= this.budgetBytes) return;
+		const oldestFirst = [...this.entries.keys()];
+		for (const key of oldestFirst) {
+			if (this.bytes <= this.budgetBytes || this.entries.size <= 1) break;
+			const entry = this.entries.get(key);
+			if (!entry) 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;
+			this.dropKey(key);
 		}
 		if (this.bytes < 0) this.bytes = 0;
 	}
+	/** Remove one frame by key, keeping the byte tally + per-device index exact. */
+	dropKey(key) {
+		const entry = this.entries.get(key);
+		if (!entry) return;
+		this.entries.delete(key);
+		this.bytes -= entry.frame.data.byteLength;
+		const deviceKeys = this.perDeviceKeys.get(entry.deviceId);
+		if (deviceKeys) {
+			const idx = deviceKeys.indexOf(key);
+			if (idx >= 0) deviceKeys.splice(idx, 1);
+			if (deviceKeys.length === 0) this.perDeviceKeys.delete(entry.deviceId);
+		}
+	}
 };
 /**
 * Nearest-neighbour crop + optional downscale of a packed RGB24 frame to a
@@ -1925,6 +1979,18 @@ function startSessionDecodePump(deps) {
 		iterator.return().catch(() => {});
 	};
 }
+//#endregion
+//#region src/session-decode/native-crop-registry.ts
+/**
+* Default max entries retained across all active decode sessions on a node. Read
+* ONCE from `CAMSTACK_NATIVE_CROP_REGISTRY_CAP`; a non-finite / non-positive
+* value falls back to 256 (was a fixed 64 — too small for a busy multi-camera
+* node, see class doc).
+*/
+var DEFAULT_NATIVE_CROP_REGISTRY_CAP = (() => {
+	const raw = Number(process.env["CAMSTACK_NATIVE_CROP_REGISTRY_CAP"]);
+	return Number.isFinite(raw) && raw > 0 ? Math.floor(raw) : 256;
+})();
 /** Invoke a requester's best-effort `release()`, swallowing any transport error. */
 function safeRelease(request) {
 	try {
@@ -1934,7 +2000,7 @@ function safeRelease(request) {
 var NativeCropRegistry = class {
 	capacity;
 	entries = /* @__PURE__ */ new Map();
-	constructor(capacity = 64) {
+	constructor(capacity = DEFAULT_NATIVE_CROP_REGISTRY_CAP) {
 		this.capacity = capacity;
 	}
 	/** Number of registered handles (tests / metrics). */
@@ -3100,7 +3166,7 @@ var PipelineRunnerAddon = class extends BaseAddon {
 	*/
 	async getNativeCrop(input) {
 		const b = input.bbox;
-		if (!(b.x <= .001 && b.y <= .001 && b.w >= .999 && b.h >= .999)) {
+		if (!(b.x <= .001 && b.y <= .001 && b.w >= .999 && b.h >= .999 && input.maxWidth === void 0)) {
 			const requester = this.nativeCropRegistry.get(input.handle);
 			if (requester) {
 				const result = await requester(input.bbox, input.maxWidth);