@camstack/addon-pipeline 1.2.189 → 1.2.191

package/dist/{dist-CKr6Q6Qu.js → dist-PQArEi7A.js}

@@ -22,7 +22,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 }) : target, mod));
 //#endregion
 let node_crypto = require("node:crypto");
-//#region ../types/dist/event-category-BZL-fdNj.mjs
+//#region ../types/dist/event-category-zAv7pMUz.mjs
 var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["SystemBoot"] = "system.boot";
 	EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -394,6 +394,13 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	*/
 	EventCategory["BatteryOnStatusChanged"] = "battery.onStatusChanged";
 	/**
+	* Cap event fired by every device that registers the `network-link`
+	* capability. Mirrors the cap definition's `onStatusChanged`. Carries
+	* `{ deviceId, status: NetworkLinkStatus }` — a link switch or a signal
+	* reading that moved.
+	*/
+	EventCategory["NetworkLinkOnStatusChanged"] = "network-link.onStatusChanged";
+	/**
 	* Emitted by the battery cap provider WHEN `wakeForStream` enters the
 	* "wake in progress" window — between the Baichuan wake-up issue and
 	* the camera's first dialed-back RTP packet. The stream-broker
@@ -26013,6 +26020,39 @@ onStatusChanged: { data: object({
 	*  whether persisting is worth a SQLite commit. */
 	volatileStateFields: ["lastUpdated"]
 };
+/**
+* Network-link snapshot. Same shape for every provider (a Reolink wifi
+* camera, a Home Assistant device with a signal-strength sensor, a Tapo
+* plug): one slice under `device.runtimeState['network-link']`, one badge,
+* one Home Assistant projection.
+*/
+var NetworkLinkStatusSchema = object({
+	/** The link the device is on. `'unknown'` = not read yet, not "no link". */
+	type: _enum([
+		"wifi",
+		"ethernet",
+		"cellular",
+		"unknown"
+	]),
+	/**
+	* Link quality, 0..100 inclusive, normalised by the provider from whatever
+	* the firmware reports (bars, RSSI, a vendor scale). **`null` means NOT
+	* KNOWN or NOT APPLICABLE** — a wired link has no signal, and a wireless
+	* one whose reading has not landed must not be drawn at 0 %. Consumers
+	* SKIP a null rather than coerce it.
+	*/
+	signalPercent: number().min(0).max(100).nullable(),
+	/** Raw received signal strength in dBm, when the firmware reports one. */
+	rssiDbm: number().optional(),
+	/** Network name of a wireless link, when the firmware reports it. */
+	ssid: string().optional(),
+	/** Ms epoch of the last observation. Lets consumers reason about freshness. */
+	lastUpdated: number()
+});
+DeviceType.Camera, DeviceType.Sensor, DeviceType.Button, DeviceType.Switch, DeviceType.Light, DeviceType.Lock, DeviceType.Siren, object({
+	deviceId: number(),
+	status: NetworkLinkStatusSchema
+});
 object({
 	on: boolean(),
 	/** Ms epoch of the last transition. 0 if never observed. */
@@ -29607,6 +29647,203 @@ DeviceType.Camera, method(object({ deviceId: number() }), PtzAutotrackStatusSche
 	deviceId: number(),
 	status: PtzAutotrackStatusSchema
 });
+/**
+* `navigation` — a device-scoped capability that natively expresses the FULL
+* navigation / action surface of a robot that DRIVES ITSELF and carries an
+* on-board camera (the Dreame robot-vacuum camera is the first provider).
+*
+* Why a NEW cap rather than overloading `ptz`:
+*   - `ptz` moves a *gimbal* on a fixed camera (pan/tilt/zoom of the lens). A
+*     robot vacuum has no gimbal — the whole chassis drives, turns and spins.
+*     The two are different physical models: PTZ is absolute-position + presets,
+*     navigation is momentary drive nudges + discrete robot ACTIONS
+*     (dock / spot-clean / follow-pet / go-to-point / …).
+*   - This cap is the SOURCE OF TRUTH. Two consumers adapt from it rather than
+*     the reverse:
+*       1. a native CamStack navigation panel (data-driven from `listActions`
+*          / `getOptions`), and
+*       2. the PTZ surface — a thin adapter mimics `ptz` from `navigation` so a
+*          robot camera shows up in the existing PTZ control path without every
+*          PTZ provider learning about robots. The mapping lives in the adapter,
+*          not here (see the addon design note):
+*            ptz.continuousMove({pan,tilt}) → navigation.move({pan,tilt})
+*            ptz.stop()                      → navigation.stop()
+*            ptz.goHome()                    → navigation.runAction('goHome')
+*            ptz.getPresets()                → navigation.listActions()  (id→preset)
+*            ptz.goToPreset(id)              → navigation.runAction(id)
+*
+* ## Continuous drive
+*
+* `move` is MOMENTARY. Fluid navigation comes from the UI (or the PTZ adapter)
+* sending `move({pan,tilt})` REPEATEDLY at ~1 Hz while a direction is held, and
+* one `stop()` on release — exactly like the robot app's remote-drive joystick.
+* The provider forwards EACH `move` to one drive write; it must NOT debounce or
+* coalesce them. The UI owns the cadence.
+*
+* ## The action dictionary
+*
+* The discrete controls (dock / locate / spot-clean / follow / flash / sounds)
+* are a DATA-DRIVEN dictionary the cap exposes via `listActions()`. Each entry
+* carries `{ id, kind, label, icon }` (plus `soundId` for sound entries) so the
+* native panel AND the PTZ mimic render buttons WITHOUT hardcoding a
+* vendor-specific list. `kind: 'action'` entries are triggered with
+* `runAction({ actionId })`; `kind: 'sound'` entries with `playSound({ soundId })`
+* (the entry carries the `soundId` to pass). The general primitives — `move`,
+* `stop`, `goToPoint` — stay as first-class methods, not dictionary entries.
+*
+* NOTE (provider wiring): the first provider (Dreame) drives this with the RAW
+* `callAction(siid,aiid,in)` / `setProperty({siid,piid,value})` MIoT primitives
+* that the currently-published `@apocaliss92/nodedreame` already exposes on
+* every device handle. A future nodedreame publish adds a typed
+* `DreameCameraController` (drive / playPetSound / spotClean / findPet / …); the
+* provider can then swap the raw calls for the typed methods with no change to
+* THIS contract.
+*/
+/**
+* A momentary drive nudge. The robot MOVES (no gimbal) for as long as the caller
+* keeps sending nudges (~1 Hz); an explicit `stop` (or letting the nudges lapse)
+* halts it.
+*
+*   - `pan`   — turn: negative = left, positive = right, 0 = straight.
+*   - `tilt`  — throttle: positive = forward, negative = spin / turn-around.
+*   - `speed` — optional intensity hint [0, 1]; the provider may scale the drive
+*               vector by it (drivers without proportional drive ignore it).
+*
+* `pan` / `tilt` are normalized [-1, 1]. Both optional so a caller can nudge one
+* axis alone; an all-undefined nudge is a no-op.
+*/
+var NavigationMoveCommandSchema = object({
+	pan: number().min(-1).max(1).optional(),
+	tilt: number().min(-1).max(1).optional(),
+	speed: number().min(0).max(1).optional()
+});
+/**
+* The enumerated discrete actions a navigation-capable robot can perform via
+* `runAction`. This is the CLOSED vocabulary; a given device advertises the
+* subset it supports through `listActions`. Sounds are NOT here — they go through
+* `playSound` (see the `sound` dictionary entries).
+*/
+var NavigationActionIdSchema = _enum([
+	"goHome",
+	"locate",
+	"spotClean",
+	"findPet",
+	"personFollow",
+	"stop",
+	"startClean",
+	"pauseClean",
+	"dockWash",
+	"autoEmpty",
+	"flashOn",
+	"flashOff"
+]);
+/** Whether a dictionary entry is a `runAction` action or a `playSound` sound. */
+var NavigationEntryKindSchema = _enum(["action", "sound"]);
+/**
+* One entry in the navigation action dictionary — the DATA-DRIVEN unit both the
+* native panel and the PTZ mimic render as a button.
+*
+*   - `id`      — stable id. For `kind:'action'` it is a {@link NavigationActionId}
+*                 (pass to `runAction`); for `kind:'sound'` it is a namespaced id
+*                 (`sound:meow`) whose `soundId` is passed to `playSound`.
+*   - `icon`    — icon HINT (lucide-style name; the UI maps it to its own set).
+*   - `label`   — operator-facing English label.
+*   - `soundId` — wire sound id, present only on `kind:'sound'` entries.
+*   - `enabled` — per-device FEATURE FLAG. `listActions` reports it so the UI /
+*                 PTZ render ONLY enabled entries. Data-driven: the provider
+*                 flips it from config, never by editing code.
+*/
+var NavigationActionEntrySchema = object({
+	id: string(),
+	kind: NavigationEntryKindSchema,
+	label: string(),
+	icon: string(),
+	/** Present only on `kind:'sound'` entries — the id to pass to `playSound`. */
+	soundId: number().int().optional(),
+	/** Per-device feature flag — render this entry only when true. */
+	enabled: boolean()
+});
+/** Coordinates for `goToPoint` — a point on the robot's live map. */
+var NavigationPointSchema = object({
+	x: number(),
+	y: number()
+});
+/**
+* Per-device FEATURE-FLAG report for the general (non-dictionary) primitives.
+* The cap reports which are enabled so the UI / PTZ render only the controls
+* that are turned on for THIS device. Data-driven: the provider derives these
+* from config + probe, never hardcoded in the UI. The per-DICTIONARY-entry flags
+* live on {@link NavigationActionEntrySchema.enabled}; these gate the primitives
+* that are not dictionary entries.
+*
+*   - `move` / `stop`   — the momentary drive joystick.
+*   - `goToPoint`       — send-to-map-coordinate. Ships OFF on Dreame until the
+*                         map-coordinate plumbing is wired.
+*   - `runAction`       — the discrete action buttons (dictionary `kind:'action'`).
+*   - `playSound`       — the sound buttons (dictionary `kind:'sound'`).
+*   - `light`           — the on/off fill-light toggle (works anytime).
+*   - `lightMode`       — the auto/manual selector + manual level slider (a
+*                         camera-service control; needs an active stream).
+*/
+var NavigationFeaturesSchema = object({
+	move: boolean(),
+	stop: boolean(),
+	goToPoint: boolean(),
+	runAction: boolean(),
+	playSound: boolean(),
+	light: boolean(),
+	lightMode: boolean()
+});
+/** Light mode: `auto` lets the camera choose brightness; `manual` uses `level`. */
+var NavigationLightModeSchema = _enum(["auto", "manual"]);
+/**
+* Live navigation state so the UI can reflect what the robot is doing:
+*   - `mode`       — coarse activity (idle / cleaning / following / …).
+*   - `following`  — person/pet follow is currently armed.
+*   - `flash`      — the on-camera fill light is on.
+*   - `lightMode`  — auto vs manual fill-light mode.
+*   - `lightLevel` — manual fill-light level (40..100); meaningful when
+*                    `lightMode === 'manual'`.
+*/
+var NavigationStatusSchema = object({
+	mode: _enum([
+		"idle",
+		"cleaning",
+		"spot",
+		"following",
+		"goto",
+		"returning",
+		"paused",
+		"unknown"
+	]),
+	following: boolean(),
+	flash: boolean(),
+	lightMode: NavigationLightModeSchema,
+	lightLevel: number().min(40).max(100),
+	/** Ms epoch when the slice was last updated. */
+	lastChangedAt: number()
+});
+NavigationStatusSchema.extend({ lastFetchedAt: number() });
+DeviceType.Camera, method(NavigationMoveCommandSchema.extend({ deviceId: number() }), _void(), { kind: "mutation" }), method(object({ deviceId: number() }), _void(), { kind: "mutation" }), method(NavigationPointSchema.extend({ deviceId: number() }), _void(), { kind: "mutation" }), method(object({ deviceId: number() }), array(NavigationActionEntrySchema)), method(object({
+	deviceId: number(),
+	actionId: NavigationActionIdSchema
+}), _void(), { kind: "mutation" }), method(object({
+	deviceId: number(),
+	soundId: number().int()
+}), _void(), { kind: "mutation" }), method(object({
+	deviceId: number(),
+	on: boolean()
+}), _void(), { kind: "mutation" }), method(object({
+	deviceId: number(),
+	mode: NavigationLightModeSchema,
+	level: number().min(40).max(100).optional()
+}), _void(), { kind: "mutation" }), method(object({
+	deviceId: number(),
+	level: number().min(40).max(100)
+}), _void(), { kind: "mutation" }), method(object({ deviceId: number() }), NavigationFeaturesSchema), object({
+	deviceId: number(),
+	status: NavigationStatusSchema
+});
 DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceId: number().int().nonnegative() }), object({ success: literal(true) }), {
 	kind: "mutation",
 	auth: "admin"
@@ -35055,6 +35292,66 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"navigation.getFeatures": {
+		capName: "navigation",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
+	"navigation.goToPoint": {
+		capName: "navigation",
+		capScope: "device",
+		addonId: null,
+		access: "create"
+	},
+	"navigation.listActions": {
+		capName: "navigation",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
+	"navigation.move": {
+		capName: "navigation",
+		capScope: "device",
+		addonId: null,
+		access: "create"
+	},
+	"navigation.playSound": {
+		capName: "navigation",
+		capScope: "device",
+		addonId: null,
+		access: "create"
+	},
+	"navigation.runAction": {
+		capName: "navigation",
+		capScope: "device",
+		addonId: null,
+		access: "create"
+	},
+	"navigation.setLightLevel": {
+		capName: "navigation",
+		capScope: "device",
+		addonId: null,
+		access: "create"
+	},
+	"navigation.setLightMode": {
+		capName: "navigation",
+		capScope: "device",
+		addonId: null,
+		access: "create"
+	},
+	"navigation.setLightOn": {
+		capName: "navigation",
+		capScope: "device",
+		addonId: null,
+		access: "create"
+	},
+	"navigation.stop": {
+		capName: "navigation",
+		capScope: "device",
+		addonId: null,
+		access: "create"
+	},
 	"networkAccess.getEndpoint": {
 		capName: "network-access",
 		capScope: "system",
@@ -39150,6 +39447,56 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"navigation.getFeatures": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"navigation.goToPoint": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"navigation.listActions": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"navigation.move": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"navigation.playSound": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"navigation.runAction": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"navigation.setLightLevel": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"navigation.setLightMode": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"navigation.setLightOn": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"navigation.stop": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"networkQuality.getDeviceStats": [{
 		name: "deviceId",
 		form: "single",

package/dist/{lazy-sharp-D-HdRPo5.js → lazy-sharp-DfnnPeG5.js}

@@ -1,4 +1,4 @@
-const require_dist = require("./dist-CKr6Q6Qu.js");
+const require_dist = require("./dist-PQArEi7A.js");
 let node_path = require("node:path");
 node_path = require_dist.__toESM(node_path);
 let node_url = require("node:url");

package/dist/{local-frame-registry-DP5yyEWE.mjs → local-frame-registry-CrLITJ5O.mjs}

@@ -1,4 +1,4 @@
-import { M as audioKindId, Z as hfModelUrl, a as COCO_80_LABELS, o as COCO_TO_MACRO, r as AUDIO_MACRO_LABELS } from "./dist-CxYG8IUX.mjs";
+import { M as audioKindId, Z as hfModelUrl, a as COCO_80_LABELS, o as COCO_TO_MACRO, r as AUDIO_MACRO_LABELS } from "./dist-Cjazw3T-.mjs";
 import { randomUUID } from "node:crypto";
 //#region src/detection-pipeline/registry/model-catalogs.ts
 var HF_REPO = "camstack/camstack-models";

package/dist/{local-frame-registry-B4Bd4tnU.js → local-frame-registry-DNVTAOrZ.js}

@@ -1,4 +1,4 @@
-const require_dist = require("./dist-CKr6Q6Qu.js");
+const require_dist = require("./dist-PQArEi7A.js");
 let node_crypto = require("node:crypto");
 //#region src/detection-pipeline/registry/model-catalogs.ts
 var HF_REPO = "camstack/camstack-models";

package/dist/motion-wasm/index.js

@@ -2,8 +2,8 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_dist = require("../dist-CKr6Q6Qu.js");
-const require_lazy_sharp = require("../lazy-sharp-D-HdRPo5.js");
+const require_dist = require("../dist-PQArEi7A.js");
+const require_lazy_sharp = require("../lazy-sharp-DfnnPeG5.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 { It as hydrateSchema, Pt as DeviceType, Y as evaluateZoneRules, it as motionDetectionCapability, jt as BaseAddon } from "../dist-CxYG8IUX.mjs";
+import { It as hydrateSchema, Pt as DeviceType, Y as evaluateZoneRules, it as motionDetectionCapability, jt as BaseAddon } from "../dist-Cjazw3T-.mjs";
 import { t as getSharp } from "../lazy-sharp-DXsqwpph.mjs";
 import { readFileSync } from "node:fs";
 import { join } from "node:path";

package/dist/{node-DhccO0of.mjs → node-KFUZT2L-.mjs}

@@ -1,4 +1,4 @@
-import { Dt as buildFfmpegArgs, Et as Fmp4BoxSplitter, kt as isSoftwareDecode, wt as errMsg } from "./dist-CxYG8IUX.mjs";
+import { Dt as buildFfmpegArgs, Et as Fmp4BoxSplitter, kt as isSoftwareDecode, wt as errMsg } from "./dist-Cjazw3T-.mjs";
 import { randomUUID } from "node:crypto";
 import "node:fs";
 import "node:path";

package/dist/{node-CmRTB9W4.js → node-wFmd_eR_.js}

@@ -1,4 +1,4 @@
-const require_dist = require("./dist-CKr6Q6Qu.js");
+const require_dist = require("./dist-PQArEi7A.js");
 let node_crypto = require("node:crypto");
 let node_fs = require("node:fs");
 node_fs = require_dist.__toESM(node_fs, 1);

package/dist/pipeline-runner/index.js

@@ -2,12 +2,12 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_dist = require("../dist-CKr6Q6Qu.js");
-const require_node = require("../node-CmRTB9W4.js");
-const require_local_frame_registry = require("../local-frame-registry-B4Bd4tnU.js");
-const require_worker_protocol = require("../worker-protocol-C8ZBUm08.js");
+const require_dist = require("../dist-PQArEi7A.js");
+const require_node = require("../node-wFmd_eR_.js");
+const require_local_frame_registry = require("../local-frame-registry-DNVTAOrZ.js");
+const require_worker_protocol = require("../worker-protocol-BulRQMSK.js");
 const require_hub_hostname = require("../hub-hostname-DAJXlOgV.js");
-const require_lazy_sharp = require("../lazy-sharp-D-HdRPo5.js");
+const require_lazy_sharp = require("../lazy-sharp-DfnnPeG5.js");
 const require_restream_intent = require("../restream-intent-Cv9x3jmu.js");
 const require_event_loop_stall_monitor = require("../event-loop-stall-monitor-DaUBcb13.js");
 const require_remote_restream = require("../remote-restream-CO36Sr30.js");
@@ -928,6 +928,55 @@ function cropRgb(frame, bbox, maxWidth) {
 	};
 }
 //#endregion
+//#region src/pipeline-runner/frame-cutter-binding.ts
+/** The per-frame binding key — the same identity the retention handle carries. */
+function frameCutterKey(handle) {
+	return `${handle.shmId}#${handle.slot}#${handle.seq}`;
+}
+var FrameCutterBinding = class {
+	max;
+	map = /* @__PURE__ */ new Map();
+	constructor(max) {
+		this.max = max;
+	}
+	/** Bind at delivery. Re-binding the same handle replaces without stranding the first. */
+	bind(handle, cutter) {
+		const key = frameCutterKey(handle);
+		this.map.delete(key);
+		this.map.set(key, cutter);
+		while (this.map.size > this.max) {
+			const oldest = this.map.keys().next().value;
+			if (oldest === void 0) break;
+			const stale = this.map.get(oldest);
+			this.map.delete(oldest);
+			release(stale);
+		}
+	}
+	/** Consume the binding for a frame whose result arrived. `undefined` when already ended. */
+	take(handle) {
+		const key = frameCutterKey(handle);
+		const cutter = this.map.get(key);
+		this.map.delete(key);
+		return cutter;
+	}
+	/**
+	* End the hold of a frame the runner let go without a result. A no-op for a
+	* frame whose result already consumed the binding, so the two paths cannot
+	* double-release.
+	*/
+	drop(handle) {
+		release(this.take(handle));
+	}
+	get size() {
+		return this.map.size;
+	}
+};
+function release(cutter) {
+	try {
+		cutter?.release();
+	} catch {}
+}
+//#endregion
 //#region src/session-decode/session-decode-coordinator.ts
 /** How long to wait after `kill()` before escalating to `kill('SIGKILL')`. */
 var SIGKILL_FALLBACK_MS = 1e3;
@@ -5237,10 +5286,6 @@ var PACKAGE_ZONE_UNION_TTL_MS = 6e4;
 var MAX_BOUND_FRAME_CUTTERS = 256;
 /** How often a camera reports its undispatched cuts. */
 var TILE_CUT_DROP_LOG_INTERVAL_MS = 6e4;
-/** The per-frame binding key — the same identity the retention handle carries. */
-function frameCutterKey(handle) {
-	return `${handle.shmId}#${handle.slot}#${handle.seq}`;
-}
 var DEFAULT_CONFIG = {
 	maxQueueDepth: 30,
 	maxConcurrentInferences: 16,
@@ -5593,16 +5638,11 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends require_dist.BaseAdd
 	*/
 	nativeCropRegistry = new NativeCropRegistry();
 	/**
-	* Per-frame cutter bindings — handle key → the requester that can cut this
-	* frame's subject tiles and end its hold.
-	*
-	* Deliberately NOT `nativeCropRegistry`. That one is a node-wide LRU capped
-	* at 256 and shared by every camera to serve LATE cross-process crops; on the
-	* live hub it sits pinned at its cap, so an entry's lifetime depends on how
-	* busy the OTHER cameras are. Ending a frame's hold is a per-frame lifecycle
-	* event and cannot be allowed to depend on that.
+	* Per-frame cutter bindings — the requester that can cut a frame's subject
+	* tiles and end its hold, ended by its result, by a drop, or by the bound.
+	* See `frame-cutter-binding.ts` for why this is not `nativeCropRegistry`.
 	*/
-	frameCutters = /* @__PURE__ */ new Map();
+	frameCutters = new FrameCutterBinding(MAX_BOUND_FRAME_CUTTERS);
 	/** Per-camera tally of cuts that could not be dispatched, and why. */
 	tileCutDrops = /* @__PURE__ */ new Map();
 	tileCutDropLoggedAt = /* @__PURE__ */ new Map();
@@ -5829,7 +5869,10 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends require_dist.BaseAdd
 			processFrame: (deviceId, frame, handle) => this.runInference(deviceId, frame, handle),
 			analyzeMotion: (deviceId, frame, handle) => this.runMotionAnalysis(deviceId, frame, handle),
 			releaseFrameRef: (ref, reason) => require_local_frame_registry.localFrameRegistry.release(ref, reason),
-			releaseRetention: (handle, reason) => this.retention?.release(handle, reason),
+			releaseRetention: (handle, reason) => {
+				this.retention?.release(handle, reason);
+				this.frameCutters.drop(handle);
+			},
 			hydrateRetainedFrame: (handle) => this.retainedFrames?.ensureContent(handle) ?? Promise.resolve(null),
 			onPhaseChanged: (deviceId, phase, meta) => this.handlePhaseChanged(deviceId, phase, meta),
 			logger: this.ctx.logger,
@@ -6813,9 +6856,7 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends require_dist.BaseAdd
 	*/
 	dispatchSubjectTiles(result, handle) {
 		if (!handle) return "handleless";
-		const key = frameCutterKey(handle);
-		const cutter = this.frameCutters.get(key);
-		this.frameCutters.delete(key);
+		const cutter = this.frameCutters.take(handle);
 		if (!cutter) return "unbound";
 		const boxes = planTileCuts(result.detections ?? [], {
 			width: result.width,
@@ -6839,18 +6880,7 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends require_dist.BaseAdd
 	* runner stopped answering" rather than "the runner forgot".
 	*/
 	bindFrameCutter(handle, cutter) {
-		const key = frameCutterKey(handle);
-		this.frameCutters.delete(key);
-		this.frameCutters.set(key, cutter);
-		while (this.frameCutters.size > MAX_BOUND_FRAME_CUTTERS) {
-			const oldest = this.frameCutters.keys().next().value;
-			if (oldest === void 0) break;
-			const stale = this.frameCutters.get(oldest);
-			this.frameCutters.delete(oldest);
-			try {
-				stale?.release();
-			} catch {}
-		}
+		this.frameCutters.bind(handle, cutter);
 	}
 	/**
 	* The native-lease half of {@link getNativeCrop}, extracted so the DETAIL path