@camstack/addon-pipeline 1.2.327 → 1.2.328

package/dist/pipeline-runner/index.mjs

@@ -1,6 +1,6 @@
-import { D as NativeLeaseAdmissionSchema, En as nodePin, Fn as lazy, In as literal, It as pipelineRunnerCapability, Ln as number, Mn as array, Nn as boolean, Nt as pickDetailCropConvention, O as NativeLeaseSettingsSchema, Pt as pickNativeLeaseOverride, Rn as object, Un as EventCategory, Vn as string, a as BackgroundRunRegistry, bn as defineCustomActions, bt as loadContributionCapability, fn as errMsg, ft as failureContributionCapability, g as DEFAULT_DETAIL_CROP_CONVENTION, jn as _enum, mn as BaseAddon, nt as deriveDetailCropRect, q as cameraOwnsMotionViaSensor, v as DEFAULT_NATIVE_LEASE_SETTINGS, vn as createEvent, w as FailureCounters, yn as customAction } from "../dist-B9LnBPz9.mjs";
-import { i as NO_COST_CLAIM, t as ChildCostRegistry } from "../node-Ci0E-0VP.mjs";
-import { c as macroGateVerdict, d as isSessionDecodeReadGone, f as createSessionDecodeCoordinator, l as rootObjectGate, o as placeDetailStep, p as resolveFrameViewGeometry, r as CustomModelCatalog, s as stepsForElectedPool, u as localFrameRegistry, v as getStepDefinition } from "../default-detection-model-hql6BX9-.mjs";
+import { Bn as array, Bt as pickDetailCropConvention, D as FailureCounters, Dn as customAction, Dt as loadContributionCapability, En as createEvent, Et as linkedStepOf, Gn as number, Kn as object, M as NativeLeaseAdmissionSchema, N as NativeLeaseSettingsSchema, On as defineCustomActions, Pn as nodePin, Q as cameraOwnsMotionViaSensor, Qt as resolveLabelLink, Sn as BaseAddon, Un as lazy, Ut as pipelineRunnerCapability, Vn as boolean, Vt as pickNativeLeaseOverride, Wn as literal, Yn as string, Zn as EventCategory, _t as failureContributionCapability, a as BackgroundRunRegistry, bn as errMsg, g as DEFAULT_DETAIL_CROP_CONVENTION, st as deriveDetailCropRect, y as DEFAULT_NATIVE_LEASE_SETTINGS, zn as _enum } from "../dist-Bpub2VcJ.mjs";
+import { i as NO_COST_CLAIM, t as ChildCostRegistry } from "../node-BjCSgD4M.mjs";
+import { _ as getStep, c as macroGateVerdict, d as isSessionDecodeReadGone, f as createSessionDecodeCoordinator, l as rootObjectGate, o as placeDetailStep, p as resolveFrameViewGeometry, r as CustomModelCatalog, s as stepsForElectedPool, u as localFrameRegistry, v as getStepDefinition } from "../default-detection-model-CMeVTcPZ.mjs";
 import { t as resolveHubHostname } from "../hub-hostname-cCknRYKj.mjs";
 import { t as getSharp } from "../lazy-sharp-DXsqwpph.mjs";
 import { c as withDetectionIntent, o as preRollRequestOf, t as DETECTION_PRE_ROLL_REQUEST_MS } from "../restream-intent-DyGmLAU9.mjs";
@@ -896,10 +896,12 @@ function classifyNativeCropLeaseAge(ageMs, maxAgeMs = NATIVE_CROP_LEASE_MAX_AGE_
 }
 //#endregion
 //#region src/session-decode/native-crop-registry.ts
-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) : 4096;
-})();
+/**
+* Default max entries retained across all active decode sessions on a node
+* (64 → 256 → 4096; see the class doc for the two windows the cap has been
+* sized to).
+*/
+var DEFAULT_NATIVE_CROP_REGISTRY_CAP = 4096;
 /** Invoke a requester's best-effort `release()`, swallowing any transport error. */
 function safeRelease(request) {
 	try {
@@ -1166,20 +1168,6 @@ function createRetainedContentFallback(registry, ref) {
 		}
 	} };
 }
-//#endregion
-//#region src/session-decode/parked-frame-store.ts
-/** Per-camera parcel bound. 24 live tracks × two kinds on one camera is a
-*  crowd scene; past that the camera's oldest parcel leaves first. Read ONCE
-*  from `CAMSTACK_PARKED_FRAMES_PER_DEVICE`. */
-var PARKED_FRAMES_PER_DEVICE_MAX = (() => {
-	const raw = Number(process.env["CAMSTACK_PARKED_FRAMES_PER_DEVICE"]);
-	return Number.isFinite(raw) && raw > 0 ? Math.floor(raw) : 48;
-})();
-/** {@link PARKED_FRAME_BUDGET_MB} in bytes. */
-var PARKED_FRAME_BUDGET_BYTES = (() => {
-	const raw = Number(process.env["CAMSTACK_PARKED_FRAME_MB"]);
-	return Number.isFinite(raw) && raw > 0 ? Math.floor(raw) : 64;
-})() * 1024 * 1024;
 function keyOf$1(deviceId, trackId, kind) {
 	return `${deviceId}|${trackId}|${kind}`;
 }
@@ -1196,8 +1184,8 @@ var ParkedFrameStore = class {
 	perDeviceKeys = /* @__PURE__ */ new Map();
 	totalBytes = 0;
 	constructor(options = {}) {
-		this.budgetBytes = options.budgetBytes ?? PARKED_FRAME_BUDGET_BYTES;
-		this.perDeviceMax = options.perDeviceMax ?? PARKED_FRAMES_PER_DEVICE_MAX;
+		this.budgetBytes = options.budgetBytes ?? 67108864;
+		this.perDeviceMax = options.perDeviceMax ?? 48;
 		this.maxAgeMs = options.maxAgeMs ?? 6e5;
 		this.now = options.now ?? Date.now;
 		this.onEvict = options.onEvict;
@@ -1382,47 +1370,6 @@ var PartitionedParkedFrameStore = class {
 		this.faceSource.clear();
 	}
 };
-/** {@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) : 160;
-})() * 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) at the REAL delivered rate: the store writes
-* every DELIVERED rgb frame, and a high-fps camera delivers ~25 fps (observed on
-* the 4K outdoor cams), so the old floor of 6 protected only ~240 ms there and
-* its late captures hit "frame recycled before resolve" (2026-07-22 triage —
-* missing thumbnails/firstFrames concentrated on exactly those cameras).
-* 16 frames ≈ 0.64 s @25 fps (1.6 s @10 fps). Only ACTIVE cameras hold frames,
-* so the worst-case protected footprint stays well inside the byte budget for
-* realistic concurrency (4 active cams ≈ 44 MB of 160); the hard ceiling always
-* overrides the floor regardless. Read ONCE from `CAMSTACK_SESSION_RETAIN_FLOOR`;
-* `0` disables the floor (pure global FIFO — the pre-2026-07-19 behaviour).
-*/
-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. */
@@ -1461,9 +1408,9 @@ var RetainedFrameStore = class RetainedFrameStore {
 	static SLOT_SPREAD = 1024;
 	constructor(options) {
 		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.budgetBytes = options.budgetBytes ?? 167772160;
+		this.perDeviceFloor = options.perDeviceFloor ?? 16;
+		this.timeFloorMs = options.timeFloorMs ?? 3e3;
 		this.now = options.now ?? Date.now;
 		this.onEvict = options.onEvict;
 	}
@@ -2022,6 +1969,154 @@ function onboardRootDetections(slot, frame, gate) {
 	};
 }
 //#endregion
+//#region src/pipeline-runner/label-link.ts
+/**
+* The runner's half of the detector ↔ step label link (D715).
+*
+* The runner holds the camera's WHOLE step tree (the attach config), so it is
+* the one place that can answer "who writes this effect?" for a camera: the
+* root model's declaration (`fillsClassifierEffects`) against the filled
+* step's own `labelLink` policy and class list (`resolveLabelLink`). Three
+* consumers read that one answer:
+*
+*  - the frame result — a linked label the executor wrote at score 0 is raised
+*    to the detection's score when the detector is authoritative;
+*  - the `detailSteps` announce — a skipped classifier is announced with
+*    `filledBy`, so post-analysis does not dispatch it for a subject the
+*    detector already named;
+*  - `package-detection` — when the root fills it, the package root is not
+*    dispatched at all and the root's own `package` boxes ARE the package
+*    result (the operator's package threshold moves onto the root's gate, and
+*    the frame says it looked).
+*
+* Pure: the caller passes the model resolver; no I/O, no clock.
+*/
+/** The root step the fills are read from — the always-on camera root. */
+var LABEL_LINK_ROOT_STEP_ID = "object-detection";
+var PACKAGE_STEP_ID = "package-detection";
+var PACKAGE_THRESHOLD_KEY = "minConfidencePackage";
+var EMPTY_LABEL_LINK_PLAN = { decisions: /* @__PURE__ */ new Map() };
+function findStep(steps, addonId) {
+	for (const step of steps) {
+		if (step.addonId === addonId) return step;
+		const nested = step.children !== void 0 ? findStep(step.children, addonId) : void 0;
+		if (nested !== void 0) return nested;
+	}
+}
+/**
+* Plan a camera's label links from its configured tree. A root with no pinned
+* model runs the static default — a COCO model, which fills nothing.
+*/
+function planLabelLinks(steps, resolveModel) {
+	if (steps === void 0) return EMPTY_LABEL_LINK_PLAN;
+	const root = steps.find((s) => s.addonId === "object-detection" && s.enabled !== false);
+	if (root?.modelId === void 0) return EMPTY_LABEL_LINK_PLAN;
+	const fills = resolveModel("object-detection", root.modelId)?.fillsClassifierEffects ?? [];
+	if (fills.length === 0) return {
+		rootModelId: root.modelId,
+		decisions: /* @__PURE__ */ new Map()
+	};
+	const decisions = /* @__PURE__ */ new Map();
+	for (const fill of fills) {
+		const step = findStep(steps, fill.stepId);
+		decisions.set(fill.stepId, resolveLabelLink(fill, step === void 0 ? void 0 : {
+			enabled: step.enabled !== false,
+			...step.settings !== void 0 ? { settings: step.settings } : {}
+		}));
+	}
+	return {
+		rootModelId: root.modelId,
+		decisions
+	};
+}
+/** Steps this plan says must not be dispatched, with the model that fills them. */
+function filledStepIds(plan) {
+	const out = /* @__PURE__ */ new Map();
+	if (plan.rootModelId === void 0) return out;
+	for (const [stepId, decision] of plan.decisions) if (decision.skip) out.set(stepId, plan.rootModelId);
+	return out;
+}
+function raiseLinkedLabels(detection, plan) {
+	let changed = false;
+	const labels = detection.labels.map((label) => {
+		const stepId = linkedStepOf(label.stepId);
+		if (stepId === void 0 || plan.decisions.get(stepId)?.authoritative !== true) return label;
+		if (label.score === detection.score) return label;
+		changed = true;
+		return {
+			...label,
+			score: detection.score
+		};
+	});
+	return changed ? labels : void 0;
+}
+/**
+* Raise each linked label to its detection's score where the detector is the
+* authoritative writer of that effect. Every other linked label stays the
+* score-0 fallback the executor wrote. Never mutates; returns the input when
+* nothing changes.
+*/
+function applyLabelLinkAuthority(result, plan) {
+	if (plan.decisions.size === 0) return result;
+	let changed = false;
+	const detections = result.detections.map((d) => {
+		const labels = raiseLinkedLabels(d, plan);
+		if (labels === void 0) return d;
+		changed = true;
+		return {
+			...d,
+			labels
+		};
+	});
+	return changed ? {
+		...result,
+		detections
+	} : result;
+}
+/** The root step's schema default for its class allow-list. */
+function rootDefaultMacroClasses() {
+	const field = getStep(LABEL_LINK_ROOT_STEP_ID).getConfigSchema().find((f) => "key" in f && f.key === "enabledMacroClasses");
+	const value = field !== void 0 && "default" in field ? field.default : void 0;
+	return Array.isArray(value) ? value : [];
+}
+function withPackageAdmitted(root, packageStep) {
+	const settings = root.settings ?? {};
+	const stored = settings["enabledMacroClasses"];
+	const enabled = Array.isArray(stored) ? stored : rootDefaultMacroClasses();
+	const admitted = enabled.length > 0 && !enabled.includes("package") ? { enabledMacroClasses: [...enabled, "package"] } : {};
+	const threshold = packageStep.settings?.[PACKAGE_THRESHOLD_KEY];
+	const gate = typeof threshold === "number" ? { [PACKAGE_THRESHOLD_KEY]: threshold } : {};
+	return {
+		...root,
+		settings: {
+			...settings,
+			...admitted,
+			...gate
+		}
+	};
+}
+/**
+* When the root fills `package-detection` and that step's policy lets it be
+* skipped, drop the package root from the dispatch and let the camera root
+* report packages: its gate admits `package` at the package step's threshold.
+* Otherwise the tree is returned untouched.
+*/
+function applyPackageFill(steps, plan) {
+	if (plan.decisions.get(PACKAGE_STEP_ID)?.skip !== true) return {
+		steps,
+		filledByRoot: false
+	};
+	const packageStep = steps.find((s) => s.addonId === PACKAGE_STEP_ID);
+	if (packageStep === void 0) return {
+		steps,
+		filledByRoot: false
+	};
+	return {
+		steps: steps.filter((s) => s.addonId !== PACKAGE_STEP_ID).map((s) => s.addonId === "object-detection" && s.enabled !== false ? withPackageAdmitted(s, packageStep) : s),
+		filledByRoot: true
+	};
+}
+//#endregion
 //#region src/pipeline-runner/bench-step-schema.ts
 /**
 * Shared bench-facing schemas: the minimal recursive step tree. Extracted from
@@ -4537,9 +4632,9 @@ var PACKAGE_DETECTION_STEP_ID = "package-detection";
 * through) and the frame was not shed. Post-analysis reads it as "an empty
 * doormat on this frame is an ABSENCE, not silence" (D687). Never mutates.
 */
-function withPackageLook(result, dispatched) {
+function withPackageLook(result, dispatched, filledByRoot = false) {
 	if (result.shed === true) return result;
-	return dispatched.some((s) => s.addonId === "package-detection" && s.enabled !== false) ? {
+	return filledByRoot || dispatched.some((s) => s.addonId === "package-detection" && s.enabled !== false) ? {
 		...result,
 		packageLooked: true
 	} : result;
@@ -7239,20 +7334,23 @@ function isDetailPlaneStepId(stepId) {
 * Extracted as a pure function so the unit suite can exercise the
 * derivation without instantiating the full addon.
 */
-function deriveDetailSteps(steps) {
+function deriveDetailSteps(steps, plan = EMPTY_LABEL_LINK_PLAN) {
 	const stepIds = /* @__PURE__ */ new Set();
 	collectEnabledStepIds(steps, stepIds);
+	const filled = filledStepIds(plan);
 	const announces = [];
 	for (const stepId of stepIds) {
 		const def = tryGetStepDefinition(stepId);
 		if (!def || def.inputClasses === null) continue;
+		const filledBy = filled.get(def.id);
 		announces.push({
 			stepId: def.id,
 			inputClasses: def.inputClasses,
 			cadence: def.cadence ?? {
 				trigger: "once",
 				maxPerTrack: 3
-			}
+			},
+			...filledBy !== void 0 ? { filledBy } : {}
 		});
 	}
 	return announces;
@@ -9568,6 +9666,42 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends BaseAddon {
 	* read synchronously by the placement.
 	*/
 	customModels = new CustomModelCatalog({ warn: (message, extras) => this.ctxIfReady?.logger.warn(message, extras) });
+	/**
+	* Per camera, the label-link plan (D715) and the announce derived from it,
+	* keyed on the two inputs it reads: the attach tree and the custom-model
+	* snapshot (a Frigate+ root is a custom model). Recomputed when either
+	* changes identity — at most once per catalog refresh.
+	*/
+	labelLinkCache = /* @__PURE__ */ new Map();
+	/** The camera's label-link plan; logs once per change of what is filled. */
+	labelLinkPlanFor(deviceId, steps) {
+		const byStep = this.customModels.current();
+		const cached = this.labelLinkCache.get(deviceId);
+		if (cached !== void 0 && cached.steps === steps && cached.byStep === byStep) return cached.plan;
+		const plan = planLabelLinks(steps, (stepId, modelId) => this.customModels.stepDefinition(stepId)?.models.find((m) => m.id === modelId));
+		const announces = deriveDetailSteps(steps, plan);
+		this.labelLinkCache.set(deviceId, {
+			steps,
+			byStep,
+			plan,
+			announces
+		});
+		const describe = (p) => p === void 0 ? "" : [...p.decisions].map(([id, d]) => `${id}:${d.skip ? "skip" : d.authoritative ? "sole" : "fallback"}`).join(",");
+		if (describe(cached?.plan) !== describe(plan) && plan.decisions.size > 0) this.ctxIfReady?.logger.info("label link: the root model fills pipeline steps", {
+			tags: { deviceId },
+			meta: {
+				rootModelId: plan.rootModelId ?? null,
+				steps: [...plan.decisions].map(([stepId, d]) => ({
+					stepId,
+					policy: d.policy,
+					authoritative: d.authoritative,
+					skip: d.skip,
+					openGaps: d.openGaps
+				}))
+			}
+		});
+		return plan;
+	}
 	cropConvention = new CropConventionSource({ logger: {
 		info: (message, extras) => this.ctxIfReady?.logger.info(message, extras),
 		warn: (message, extras) => this.ctxIfReady?.logger.warn(message, extras)
@@ -9963,6 +10097,7 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends BaseAddon {
 		this.lastDecodeUnexpectedEndAt.delete(deviceId);
 		this.packageGovernor.forget(deviceId);
 		this.packageGateSkips.delete(deviceId);
+		this.labelLinkCache.delete(deviceId);
 		this.packageZoneUnionByDevice.delete(deviceId);
 		this.packageZoneUnionAt.delete(deviceId);
 		this.lastMotionNearPackageZone.delete(deviceId);
@@ -10359,7 +10494,7 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends BaseAddon {
 			acquire: () => this.acquireSessionDecodeRestream(api, config.deviceId, config.detectionStreamId, `session-decode:detect:${config.deviceId}`, resolveSessionDecodeHostname(config, process.env["CAMSTACK_HUB_URL"]), resolveSessionDecodeOwnerNodeId(config), true),
 			startPump: (source, hooks) => {
 				const dialMs = Date.now() - requestedAt;
-				const useLocalFrameRef = this.executorCoLocated() && process.env["CAMSTACK_DISABLE_LOCAL_FRAME_REF"] !== "1";
+				const useLocalFrameRef = this.executorCoLocated();
 				log.info("session-decode: detection routed through per-session decode worker (rgb)", { meta: {
 					streamId: config.detectionStreamId,
 					codec: source.codec,
@@ -10678,8 +10813,10 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends BaseAddon {
 			return null;
 		}
 		if (steps.length === 0) return null;
-		let dispatchSteps = steps;
-		if (steps.some((s) => s.addonId === "package-detection" && s.enabled !== false)) {
+		const labelLinkPlan = this.labelLinkPlanFor(deviceId, steps);
+		const packageFill = applyPackageFill(steps, labelLinkPlan);
+		let dispatchSteps = packageFill.steps;
+		if (dispatchSteps.some((s) => s.addonId === "package-detection" && s.enabled !== false)) {
 			this.refreshPackageZoneUnion(deviceId);
 			const motionInZone = this.lastMotionNearPackageZone.get(deviceId) ?? this.lastAnalyzerDetected.get(deviceId) ?? false;
 			const decision = this.packageGovernor.evaluate({
@@ -10689,7 +10826,7 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends BaseAddon {
 			});
 			const skipped = this.packageGateSkips.get(deviceId) ?? 0;
 			if (!decision.run) {
-				dispatchSteps = steps.filter((s) => s.addonId !== PACKAGE_DETECTION_STEP_ID);
+				dispatchSteps = dispatchSteps.filter((s) => s.addonId !== PACKAGE_DETECTION_STEP_ID);
 				if (skipped === 0) log.info("package-detection gated off by the motion-settle governor", {
 					tags: { deviceId },
 					meta: { motionInZone: this.lastAnalyzerDetected.get(deviceId) ?? false }
@@ -10766,7 +10903,7 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends BaseAddon {
 			return null;
 		}
 		if (result === null) return null;
-		const looked = withPackageLook(result, dispatchSteps);
+		const looked = withPackageLook(applyLabelLinkAuthority(result, labelLinkPlan), dispatchSteps, packageFill.filledByRoot);
 		return this.recoverSmallSubjects(deviceId, frame, looked, dispatchSteps, camConfig?.deviceKey);
 	}
 	/**
@@ -11413,7 +11550,7 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends BaseAddon {
 			...this.liveWorkerSlotWaiter(deviceId),
 			acquire: () => this.acquireSessionDecodeRestream(api, config.deviceId, config.detectionStreamId, `session-decode:occupancy:${config.deviceId}`, resolveSessionDecodeHostname(config, process.env["CAMSTACK_HUB_URL"]), resolveSessionDecodeOwnerNodeId(config)),
 			startPump: (source, hooks) => {
-				const useLocalFrameRef = this.executorCoLocated() && process.env["CAMSTACK_DISABLE_LOCAL_FRAME_REF"] !== "1";
+				const useLocalFrameRef = this.executorCoLocated();
 				return startSessionDecodePump({
 					fork: this.forkDecodeWorkerWithLease,
 					lease: this.resolveSessionLeaseKnobs,
@@ -11463,7 +11600,7 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends BaseAddon {
 	emitInferenceResult(deviceId, frame, result, handle, source, occasion) {
 		if (!this.ctx?.eventBus) return;
 		const capturedAt = frame.capturedAt;
-		const detailSteps = this.attached.get(deviceId)?.detailSteps;
+		const detailSteps = this.labelLinkCache.get(deviceId)?.announces ?? this.attached.get(deviceId)?.detailSteps;
 		const payload = {
 			deviceId,
 			frame: result,

package/dist/{process-memory-B63Jlpev.mjs → process-memory-BaKQ8u2G.mjs}

@@ -1,4 +1,4 @@
-import { jt as parseProcStatus } from "./dist-B9LnBPz9.mjs";
+import { Rt as parseProcStatus } from "./dist-Bpub2VcJ.mjs";
 import * as fs from "node:fs";
 import { execFile } from "node:child_process";
 //#region src/shared/node-topology-platform.ts

package/dist/{process-memory-DgEfKdtC.js → process-memory-iUJuTpXs.js}

@@ -1,5 +1,5 @@
 const require_chunk = require("./chunk-emK7D4bc.js");
-const require_dist = require("./dist-BBZwYfSN.js");
+const require_dist = require("./dist-wJO7mXeO.js");
 let node_fs = require("node:fs");
 node_fs = require_chunk.__toESM(node_fs);
 let node_child_process = require("node:child_process");

package/dist/recorder/index.js

@@ -3,8 +3,8 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../chunk-emK7D4bc.js");
-const require_dist = require("../dist-BBZwYfSN.js");
-const require_node = require("../node-mJQBUiEc.js");
+const require_dist = require("../dist-wJO7mXeO.js");
+const require_node = require("../node-BCrqaejt.js");
 const require_hub_hostname = require("../hub-hostname-DAJXlOgV.js");
 const require_restream_intent = require("../restream-intent-7uDNqMKs.js");
 const require_retire_root_keys = require("../retire-root-keys-Csb8z2f3.js");

package/dist/recorder/index.mjs

@@ -1,5 +1,5 @@
-import { $t as stripRetiredBandPreBufferSec, An as sleep$1, B as VISIT_MERGE_GAP_MS, Bn as record, Bt as recordingExportCapability, C as ExportRecordSchema, Dt as migrateLegacyDeviceSignalConfig, En as nodePin, Et as memoizePinnedFfmpeg, F as RECORDING_SOURCE_CAMSTACK_ADDON, Gt as resolveLocationMode, I as RecordingConfigSchema, K as batteryCapability, L as RecordingSignalStatusSchema, Ln as number, Mn as array, N as RECORDING_EXPORT_MAX_READ_BYTES, Nn as boolean, Ot as modeMayWrite, P as RECORDING_SOURCE_CAMSTACK, Rn as object, Rt as recordingArchiveCapability, Sn as hydrateSchema, Tt as mayWriteToLocation, Un as EventCategory, Ut as resolveCreateExportSubject, Vn as string, Vt as recordingSignalCapability, X as clipExportFailureOf, Xt as storageEvictableCapability, Y as clipExportFailure, Zt as storageOccupancyCapability, _ as DEFAULT_EVENTS_BAND_BUFFER_SEC, b as EVENT_OWNER_TYPES, bn as defineCustomActions, bt as loadContributionCapability, dn as DeviceType, dt as exportSubjectOf, fn as errMsg$1, jn as _enum, k as OpsLogEntrySchema, kn as selectAssignedProfileSlots, lt as evictionPolicyForMode, mn as BaseAddon, mt as gbToBytes, o as BatteryStatusSchema, qt as resolveRecordingProfiles, rt as deriveRecordingMode, s as CLIP_BROKER_PACED_RATES, sn as evaluateSensorEdge, tn as videoclipsCapability, tt as deriveBatteryPresence, un as DeviceFeature, ut as evictionPolicyOfLocation, wt as mayReadLocation, x as EVENT_PAD_MS, yn as customAction, yt as isFirstLevelMacroClass, z as VIDEOCLIPS_MAX_OFFER_BYTES, zn as preprocess, zt as recordingCapability } from "../dist-B9LnBPz9.mjs";
-import { a as physicalRootOf, i as NO_COST_CLAIM, t as ChildCostRegistry } from "../node-Ci0E-0VP.mjs";
+import { $t as resolveLocationMode, An as hydrateSchema, B as RECORDING_SOURCE_CAMSTACK_ADDON, Bn as array, Dn as customAction, Dt as loadContributionCapability, Ft as modeMayWrite, G as VISIT_MERGE_GAP_MS, Gn as number, Gt as recordingArchiveCapability, H as RecordingSignalStatusSchema, Jn as record, Jt as recordingSignalCapability, Kn as object, Kt as recordingCapability, Ln as selectAssignedProfileSlots, Mt as mayWriteToLocation, Nt as memoizePinnedFfmpeg, On as defineCustomActions, P as OpsLogEntrySchema, Pn as nodePin, Pt as migrateLegacyDeviceSignalConfig, R as RECORDING_EXPORT_MAX_READ_BYTES, Rn as sleep$1, S as EVENT_PAD_MS, Sn as BaseAddon, V as RecordingConfigSchema, Vn as boolean, W as VIDEOCLIPS_MAX_OFFER_BYTES, Xt as resolveCreateExportSubject, Yn as string, Z as batteryCapability, Zn as EventCategory, _ as DEFAULT_EVENTS_BAND_BUFFER_SEC, an as storageOccupancyCapability, bn as errMsg$1, ct as deriveRecordingMode, et as clipExportFailure, gt as exportSubjectOf, hn as evaluateSensorEdge, ht as evictionPolicyOfLocation, in as storageEvictableCapability, jt as mayReadLocation, ln as videoclipsCapability, mt as evictionPolicyForMode, o as BatteryStatusSchema, ot as deriveBatteryPresence, qn as preprocess, qt as recordingExportCapability, s as CLIP_BROKER_PACED_RATES, sn as stripRetiredBandPreBufferSec, tn as resolveRecordingProfiles, tt as clipExportFailureOf, vn as DeviceFeature, w as ExportRecordSchema, wt as isFirstLevelMacroClass, x as EVENT_OWNER_TYPES, yn as DeviceType, yt as gbToBytes, z as RECORDING_SOURCE_CAMSTACK, zn as _enum } from "../dist-Bpub2VcJ.mjs";
+import { a as physicalRootOf, i as NO_COST_CLAIM, t as ChildCostRegistry } from "../node-BjCSgD4M.mjs";
 import { t as resolveHubHostname } from "../hub-hostname-cCknRYKj.mjs";
 import { d as PREBUFFER_MAX_MS, l as withRecordingIntent, r as RECORDING_PRE_ROLL_REQUEST_MS } from "../restream-intent-DyGmLAU9.mjs";
 import { n as RowMapStore, t as retireRootKeys } from "../retire-root-keys-DZvlso2l.mjs";

package/dist/{segment-demux-js-DzwHW4Ey.mjs → segment-demux-js-C5ez9LYG.mjs}

@@ -1,5 +1,5 @@
 import { r as __toESM, t as __commonJSMin } from "./chunk-DnnnRqeS.mjs";
-import { fn as errMsg } from "./dist-B9LnBPz9.mjs";
+import { bn as errMsg } from "./dist-Bpub2VcJ.mjs";
 import { spawn } from "node:child_process";
 //#region src/stream-broker/recorded/avcc-annexb.ts
 /**

package/dist/{segment-demux-js-C2ufKMu0.js → segment-demux-js-Opx6Hv9G.js}

@@ -1,5 +1,5 @@
 const require_chunk = require("./chunk-emK7D4bc.js");
-const require_dist = require("./dist-BBZwYfSN.js");
+const require_dist = require("./dist-wJO7mXeO.js");
 let node_child_process = require("node:child_process");
 //#region src/stream-broker/recorded/avcc-annexb.ts
 /**

package/dist/session-decode/decode-worker-main.js

@@ -1494,7 +1494,7 @@ function resolvePlanarCropSource(kind, planes, strides, region) {
 //#region src/session-decode/pinned-rgb-crop.ts
 /**
 * Pure decision/plumbing helpers for the `pinnedRgbCrop` native-crop color fix
-* (DEFAULT OFF — see `CAMSTACK_SESSION_PINNED_RGB_CROP` in `decode-worker-child.ts`).
+* (always on since 2026-07-20 — see `decode-worker-child.ts`).
 *
 * ## The bug this fixes
 *
@@ -2292,14 +2292,10 @@ var NATIVE_TILE_JPEG_QUALITY = 90;
 * 500 ms deliberately, not more: the confirmation gate bounds each crop attempt
 * at 300 ms and the capture scheduler drops an enrichment request older than
 * 3 s, so a miss held too long stops being a fast retryable `null` and becomes
-* an upstream timeout. Widen it via `CAMSTACK_SESSION_TILE_CUT_WAIT_MS` only
-* once `cutLatencyMs` on the metrics line says what the encode window really
-* is; `0` disables the wait and restores the pre-2026-09-07 miss profile.
+* an upstream timeout. Change it only once `cutLatencyMs` on the metrics line
+* says what the encode window really is.
 */
-var TILE_CUT_WAIT_MS = (() => {
-	const raw = Number(process.env["CAMSTACK_SESSION_TILE_CUT_WAIT_MS"]);
-	return Number.isFinite(raw) && raw >= 0 ? Math.floor(raw) : 500;
-})();
+var TILE_CUT_WAIT_MS = 500;
 /** How many early-withdrawn frame ids the worker remembers for the miss line. */
 var UNMARKED_MEMORY = 256;
 /**
@@ -2322,8 +2318,8 @@ var UNMARKED_MEMORY = 256;
 var LEASE_DOWNLOAD_COOLDOWN_BASE_MS = 6e4;
 var LEASE_DOWNLOAD_COOLDOWN_MAX_MS = 6e5;
 /**
-* `pinnedRgbCrop` — pinned-color RGB24 native-crop retention. DEFAULT **ON**
-* (2026-07-20 rollout); set `CAMSTACK_SESSION_PINNED_RGB_CROP=0` to opt out.
+* Pinned-color RGB24 native-crop retention — the only lease download since the
+* 2026-07-20 rollout (its opt-out env was removed on 2026-10-06).
 *
 * ## What it fixes
 * On a HARDWARE session the full-frame download pins its YUV→RGB conversion to
@@ -2336,7 +2332,7 @@ var LEASE_DOWNLOAD_COOLDOWN_MAX_MS = 6e5;
 * crop (CPU-sws default) can resolve DIFFERENTLY → the crop gets a wrong hue /
 * desaturation while the full frame looks right.
 *
-* ## What it does when ON
+* ## What it does
 * The HW→system lease download converts to RGB24 ONCE, pinned to the SAME
 * resolved color the full-frame path uses (see {@link buildLeaseDownloadDescription});
 * the later crop is then a pure SPATIAL RGB24→RGB24 crop + resize with no color
@@ -2349,7 +2345,6 @@ var LEASE_DOWNLOAD_COOLDOWN_MAX_MS = 6e5;
 * software-DEGRADE path is left on YUV420P (its full frame + crop both use the
 * CPU-sws default, so there is no mismatch to fix there).
 */
-var PINNED_RGB_CROP = process.env["CAMSTACK_SESSION_PINNED_RGB_CROP"] !== "0";
 /**
 * The libav GPU scale filter for a hwaccel backend, or `null` when none is
 * known here — those backends fall back to the software crop+scale path.
@@ -2803,8 +2798,6 @@ var DecodeWorkerChild = class {
 	*  2026-07-23) — each emit differs from the previous one and every frame logs
 	*  as a "TRANSITION", flooding the log ring (~40 lines/s per camera). */
 	lastColorProvenanceKeyByPath = /* @__PURE__ */ new Map();
-	/** Per-frame color provenance logging (opt-in; the transition marker is always on). */
-	colorDebug = process.env["CAMSTACK_DECODE_COLOR_DEBUG"] === "1";
 	/** Throughput counters (plain integers, no per-frame allocation). */
 	framesDecoded = 0;
 	/** Releases that found a held frame / that found nothing to release. */
@@ -3516,14 +3509,13 @@ var DecodeWorkerChild = class {
 	* Emit the color-provenance marker: which decode/scale path produced this
 	* frame + its raw and resolved source color. Always logs on a TRANSITION (the
 	* path or the frame's raw color tags changed vs the last emit — rare, and the
-	* exact signal a desaturation recurrence leaves); logs every frame only under
-	* the `CAMSTACK_DECODE_COLOR_DEBUG` flag.
+	* exact signal a desaturation recurrence leaves).
 	*/
 	logColorProvenance(path, color) {
 		const key = `${color.rawColorSpace}|${color.rawColorRange}`;
 		const transition = this.lastColorProvenanceKeyByPath.get(path) !== key;
 		if (transition) this.lastColorProvenanceKeyByPath.set(path, key);
-		if (transition || this.colorDebug) this.emitStderr(colorProvenanceLine(path, color, transition));
+		if (transition) this.emitStderr(colorProvenanceLine(path, color, transition));
 	}
 	/**
 	* Retain a just-superseded DELIVERED frame for later native crops. Transfers
@@ -3582,7 +3574,7 @@ var DecodeWorkerChild = class {
 	* ## What it costs / saves
 	*
 	* One 4K frame is ~24.9 MB on the default pinned-RGB24 lease path
-	* ({@link PINNED_RGB_CROP}), ~12.4 MB as YUV420P. At the ~25 delivered fps of
+	* (pinned RGB24), ~12.4 MB as YUV420P. At the ~25 delivered fps of
 	* `all` mode that is ~620 MB/s of GPU→RAM download while the gate is open and
 	* a steady-state resident set of roughly `frameBytes × deliveredFps ×
 	* ttlSeconds`. `inferred` cuts both by the governor's admit ratio — ~5 of 25
@@ -3651,7 +3643,7 @@ var DecodeWorkerChild = class {
 				this.settlePreRoll(frameId, "download-failed");
 				return true;
 			}
-			this.leaseStore.put(frameId, PINNED_RGB_CROP ? toLeasedRgbNavFrame(software) : toLeasedNavFrame(software));
+			this.leaseStore.put(frameId, toLeasedRgbNavFrame(software));
 			return true;
 		}
 		this.leaseStore.put(frameId, toLeasedNavFrame(frame));
@@ -3668,8 +3660,8 @@ var DecodeWorkerChild = class {
 		const scaleFilter = this.gpuScaleFilter;
 		if (!nav || !scaleFilter || !this.hwContext) return null;
 		try {
-			const color = PINNED_RGB_CROP ? this.resolveFrameColor(frame) : null;
-			if (color) this.logColorProvenance("hw-crop", color);
+			const color = this.resolveFrameColor(frame);
+			this.logColorProvenance("hw-crop", color);
 			const outputs = this.ensureLeaseDownloadFilter(nav, scaleFilter, frame.width, frame.height, color).processAllSync(frame);
 			const first = outputs[0] ?? null;
 			for (let i = 1; i < outputs.length; i++) outputs[i]?.free();