@camstack/addon-post-analysis 1.2.302 → 1.2.303

package/dist/pipeline-analytics/index.js

@@ -67320,6 +67320,22 @@ function messageOf(err) {
 function isDetailNotAttachedRefusal(err) {
 	return messageOf(err).includes(DETAIL_NOT_ATTACHED_MARKER);
 }
+/**
+* The runner's TYPED handle-expired refusal (D688): the frame handle a dispatch
+* named is past the native lease age bound, and the registry will refuse it on
+* every later ask. TWIN of `addon-pipeline/src/pipeline-runner/detail-park.ts`
+* `DETAIL_HANDLE_EXPIRED_MARKER` — keep the two identical.
+*
+* Why the dispatcher cares: unlike not-attached this is about ONE handle, not
+* the session — the parked frame still serves — but the handle itself is
+* finished. Naming it again (next tick, or through the native-strict crop rung)
+* can only be refused again; on the live fleet that was ~7 refusals per handle.
+*/
+var DETAIL_HANDLE_EXPIRED_MARKER = "runDetailSubtree-refused:handle-expired";
+/** Did this `runDetailSubtree` error carry the runner's handle-expired marker? */
+function isDetailHandleExpiredRefusal(err) {
+	return messageOf(err).includes(DETAIL_HANDLE_EXPIRED_MARKER);
+}
 //#endregion
 //#region src/pipeline-analytics/detail-scheduler.ts
 /** Default backoff/period when a step's cadence omits `minIntervalMs`. */
@@ -67776,6 +67792,7 @@ var TrackDetailDispatcher = class {
 			className: frame.className
 		};
 		const steps = composeDetailSteps(req, (trackId) => this.deps.hasTrackLabel?.(trackId) ?? false);
+		let handleRefused = false;
 		if (frame.frameHandle !== void 0) try {
 			const primary = await this.deps.runDetailSubtree({
 				deviceId,
@@ -67789,7 +67806,10 @@ var TrackDetailDispatcher = class {
 				this.warnNotAttachedThrottled(deviceId, dev, req);
 				return null;
 			}
-			this.deps.logger.debug("detail primary call failed — trying frame fallback", {
+			if (isDetailHandleExpiredRefusal(err)) {
+				handleRefused = true;
+				this.retireRefusedHandle(deviceId, dev, req, frame);
+			} else this.deps.logger.debug("detail primary call failed — trying frame fallback", {
 				tags: { deviceId },
 				meta: {
 					trackId: req.trackId,
@@ -67839,7 +67859,7 @@ var TrackDetailDispatcher = class {
 				}
 			});
 		}
-		if (this.deps.captureCropBase64 !== void 0) try {
+		if (this.deps.captureCropBase64 !== void 0 && frame.frameHandle !== void 0 && !handleRefused) try {
 			const cropJpeg = await this.deps.captureCropBase64(frame);
 			if (cropJpeg !== null) {
 				const retry = await this.deps.runDetailSubtree({
@@ -67868,6 +67888,35 @@ var TrackDetailDispatcher = class {
 		return null;
 	}
 	/**
+	* The runner refused `frame`'s handle as past the lease age bound (D688).
+	* That verdict is final for the handle, so the track's stored association
+	* loses it: later dispatches skip rung 1 and the native-strict crop rung
+	* (both would name the same handle and be refused again — ~7 times per
+	* handle on the live fleet) and go straight to the parked frame, until a
+	* newly OBSERVED frame brings a fresh handle via {@link onFrame}.
+	*
+	* Only the refused handle is dropped: if a newer frame replaced it while the
+	* dispatch was in flight, that one stands. The line is therefore emitted once
+	* per (track, handle) — a concurrent dispatch refused on the same handle
+	* finds it already gone and says nothing.
+	*/
+	retireRefusedHandle(deviceId, dev, req, frame) {
+		const current = dev.tracks.get(req.trackId);
+		if (current === void 0 || current.frameHandle !== frame.frameHandle) return;
+		const { frameHandle: refused, ...withoutHandle } = current;
+		dev.tracks.set(req.trackId, withoutHandle);
+		this.deps.logger.info("detail dispatch: frame handle refused as expired — retired for this track, parked frame only until a fresh observation", {
+			tags: { deviceId },
+			meta: {
+				trackId: req.trackId,
+				stepId: req.stepId,
+				reason: "handle-expired",
+				handle: refused === void 0 ? null : `${refused.shmId}#${refused.slot}#${refused.seq}`,
+				parkedFrameRung: this.deps.captureParkedFrame !== void 0
+			}
+		});
+	}
+	/**
 	* The typed refusal is EXPECTED for a track that outlives the runner's
 	* detail park grace (a closing track's last dispatches), so it logs its own
 	* line — the reason is knowable, unlike the every-rung-missed warn — and

package/dist/pipeline-analytics/index.mjs

@@ -67228,6 +67228,22 @@ function messageOf(err) {
 function isDetailNotAttachedRefusal(err) {
 	return messageOf(err).includes(DETAIL_NOT_ATTACHED_MARKER);
 }
+/**
+* The runner's TYPED handle-expired refusal (D688): the frame handle a dispatch
+* named is past the native lease age bound, and the registry will refuse it on
+* every later ask. TWIN of `addon-pipeline/src/pipeline-runner/detail-park.ts`
+* `DETAIL_HANDLE_EXPIRED_MARKER` — keep the two identical.
+*
+* Why the dispatcher cares: unlike not-attached this is about ONE handle, not
+* the session — the parked frame still serves — but the handle itself is
+* finished. Naming it again (next tick, or through the native-strict crop rung)
+* can only be refused again; on the live fleet that was ~7 refusals per handle.
+*/
+var DETAIL_HANDLE_EXPIRED_MARKER = "runDetailSubtree-refused:handle-expired";
+/** Did this `runDetailSubtree` error carry the runner's handle-expired marker? */
+function isDetailHandleExpiredRefusal(err) {
+	return messageOf(err).includes(DETAIL_HANDLE_EXPIRED_MARKER);
+}
 //#endregion
 //#region src/pipeline-analytics/detail-scheduler.ts
 /** Default backoff/period when a step's cadence omits `minIntervalMs`. */
@@ -67684,6 +67700,7 @@ var TrackDetailDispatcher = class {
 			className: frame.className
 		};
 		const steps = composeDetailSteps(req, (trackId) => this.deps.hasTrackLabel?.(trackId) ?? false);
+		let handleRefused = false;
 		if (frame.frameHandle !== void 0) try {
 			const primary = await this.deps.runDetailSubtree({
 				deviceId,
@@ -67697,7 +67714,10 @@ var TrackDetailDispatcher = class {
 				this.warnNotAttachedThrottled(deviceId, dev, req);
 				return null;
 			}
-			this.deps.logger.debug("detail primary call failed — trying frame fallback", {
+			if (isDetailHandleExpiredRefusal(err)) {
+				handleRefused = true;
+				this.retireRefusedHandle(deviceId, dev, req, frame);
+			} else this.deps.logger.debug("detail primary call failed — trying frame fallback", {
 				tags: { deviceId },
 				meta: {
 					trackId: req.trackId,
@@ -67747,7 +67767,7 @@ var TrackDetailDispatcher = class {
 				}
 			});
 		}
-		if (this.deps.captureCropBase64 !== void 0) try {
+		if (this.deps.captureCropBase64 !== void 0 && frame.frameHandle !== void 0 && !handleRefused) try {
 			const cropJpeg = await this.deps.captureCropBase64(frame);
 			if (cropJpeg !== null) {
 				const retry = await this.deps.runDetailSubtree({
@@ -67776,6 +67796,35 @@ var TrackDetailDispatcher = class {
 		return null;
 	}
 	/**
+	* The runner refused `frame`'s handle as past the lease age bound (D688).
+	* That verdict is final for the handle, so the track's stored association
+	* loses it: later dispatches skip rung 1 and the native-strict crop rung
+	* (both would name the same handle and be refused again — ~7 times per
+	* handle on the live fleet) and go straight to the parked frame, until a
+	* newly OBSERVED frame brings a fresh handle via {@link onFrame}.
+	*
+	* Only the refused handle is dropped: if a newer frame replaced it while the
+	* dispatch was in flight, that one stands. The line is therefore emitted once
+	* per (track, handle) — a concurrent dispatch refused on the same handle
+	* finds it already gone and says nothing.
+	*/
+	retireRefusedHandle(deviceId, dev, req, frame) {
+		const current = dev.tracks.get(req.trackId);
+		if (current === void 0 || current.frameHandle !== frame.frameHandle) return;
+		const { frameHandle: refused, ...withoutHandle } = current;
+		dev.tracks.set(req.trackId, withoutHandle);
+		this.deps.logger.info("detail dispatch: frame handle refused as expired — retired for this track, parked frame only until a fresh observation", {
+			tags: { deviceId },
+			meta: {
+				trackId: req.trackId,
+				stepId: req.stepId,
+				reason: "handle-expired",
+				handle: refused === void 0 ? null : `${refused.shmId}#${refused.slot}#${refused.seq}`,
+				parkedFrameRung: this.deps.captureParkedFrame !== void 0
+			}
+		});
+	}
+	/**
 	* The typed refusal is EXPECTED for a track that outlives the runner's
 	* detail park grace (a closing track's last dispatches), so it logs its own
 	* line — the reason is knowable, unlike the every-rung-missed warn — and

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-post-analysis",
-  "version": "1.2.302",
+  "version": "1.2.303",
   "description": "Post-Analysis bundle — enrichment, embedding-encoder, pipeline-analytics. Multi-entry npm package shipping addons that consume pipeline output.",
   "keywords": [
     "camstack",