@camstack/addon-pipeline 1.2.181 → 1.2.183

package/dist/detection-pipeline/index.js

@@ -3019,6 +3019,42 @@ async function samplePool(pool, log, reportedDead) {
 }
 //#endregion
 //#region src/detection-pipeline/engine/inference-timeout-guard.ts
+/**
+* Inference-timeout regression guard — "did this update make the GPU time
+* out more than the last one did?", asked by the node itself.
+*
+* ## Why
+*
+* `@camstack/server` 1.2.218 reintroduced the inference timeouts 1.2.216 had
+* fixed: ~3 760 `inference request timed out` an hour for 4 h 19 min (16 215
+* lines, ~19 000 `runInference failed`), on a cluster whose previous hour had
+* seen ~5. Nothing said so. 1.2.219 fixed it again as a side effect of the
+* next deploy, and the regression was found a day later by an audit that
+* counted log lines per version by hand (2026-09-05). A green typecheck, a
+* green suite and a 200 on `/health` all held throughout.
+*
+* ## What it does
+*
+* Every five minutes the guard records how many inference requests timed out
+* on this node under the current FINGERPRINT (the closure version). The last
+* hour of buckets is persisted in the addon store, so a restart hands the
+* previous fingerprint's rate to the next one. Once the new fingerprint has a
+* quarter hour of its own, the two hourly rates are compared:
+*
+*  - ≥ `TIMEOUT_GUARD_RATIO`× worse AND above `TIMEOUT_GUARD_FLOOR_PER_HOUR`
+*    → `system.liveness-failed` (AlertCenter raises a persistent alert keyed
+*    on the finding id) and an ERROR line naming both versions and rates;
+*  - ≥ `TIMEOUT_GUARD_RATIO`× better → an INFO line, no alert;
+*  - the same fingerprint (a plain restart) → nothing to compare.
+*
+* The rate is per hour, not per frame: it is the unit the audit measured and
+* the unit an operator reads. A traffic doubling doubles the rate, which is
+* why the ratio is five and not two.
+*
+* Pure core (`recordTimeoutBucket`, `evaluateTimeoutRegression`) tested in
+* `__tests__/inference-timeout-guard.spec.ts`; the runtime wrapper owns the
+* timer, the store and the emit.
+*/
 var TIMEOUT_GUARD_BUCKET_MS = 5 * 6e4;
 /** Addon-store key the ledger persists under (the addon's own settings blob). */
 var INFERENCE_TIMEOUT_LEDGER_KEY = "_inferenceTimeoutLedger";
@@ -3062,6 +3098,40 @@ function evaluateTimeoutRegression(input) {
 		...base
 	};
 }
+/**
+* The closure version, read from the closure the runner was started from.
+*
+* The forked runner script is `<closure>/node_modules/@camstack/system/dist/
+* addon-runner.js` (hub: `/data/server-root/current/…`); the closure's own
+* `@camstack/server/package.json` sits two directories up. This is read from
+* disk rather than asked of `server-management` because that cap is
+* server-provided and the parent refuses to route it for a forked addon —
+* "no provider registered for cap server-management", measured on all
+* three nodes on 2026-09-05. A file the process was started from cannot
+* be refused.
+*/
+function closureVersionFromRunnerPath(runnerScript, fs) {
+	if (runnerScript === void 0 || runnerScript.length === 0) return null;
+	let dir = (0, node_path.dirname)(runnerScript);
+	for (let depth = 0; depth < 12; depth += 1) {
+		const candidate = (0, node_path.join)(dir, "node_modules", "@camstack", "server", "package.json");
+		const raw = fs.readFile(candidate);
+		if (raw !== null) {
+			try {
+				const parsed = JSON.parse(raw);
+				const version = typeof parsed === "object" && parsed !== null ? parsed.version : void 0;
+				if (typeof version === "string" && version.length > 0) return `server@${version}`;
+			} catch {
+				return null;
+			}
+			return null;
+		}
+		const parent = (0, node_path.dirname)(dir);
+		if (parent === dir) break;
+		dir = parent;
+	}
+	return null;
+}
 function readStoredLedgers(blob) {
 	const raw = blob[INFERENCE_TIMEOUT_LEDGER_KEY];
 	if (typeof raw !== "object" || raw === null) return {};
@@ -6891,12 +6961,13 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 				readTotalTimeouts: () => this.listGuardedPools().reduce((sum, pool) => sum + pool.factory.getPoolBacklog().timedOut, 0),
 				readStore: () => this.readStore(),
 				writeStore: (patch) => this.writeStore(patch),
-				resolveFingerprint: async () => {
-					const ctx = this.addonCtx;
-					if (!ctx) return null;
-					const status = await ctx.api.serverManagement.getServerPackageStatus.query({ nodeId });
-					return status.runningVersion === null ? null : `server@${status.runningVersion}`;
-				},
+				resolveFingerprint: async () => closureVersionFromRunnerPath(process.argv[1], { readFile: (path) => {
+					try {
+						return node_fs.readFileSync(path, "utf8");
+					} catch {
+						return null;
+					}
+				} }),
 				emitFailed: (finding) => {
 					this.eventBus?.emit(require_dist.createEvent(require_dist.EventCategory.SystemLivenessFailed, TIMEOUT_GUARD_SOURCE, finding));
 				},

package/dist/detection-pipeline/index.mjs

@@ -7,6 +7,7 @@ import { n as startEventLoopStallMonitor } from "../event-loop-stall-monitor-DXL
 import { n as pickNodePlatformArch, t as readProcessMemory } from "../process-memory-zLBrzuFc.mjs";
 import * as fs from "node:fs";
 import * as path$1 from "node:path";
+import { dirname, join } from "node:path";
 import { spawn } from "node:child_process";
 import sharp from "sharp";
 import * as os from "node:os";
@@ -3012,6 +3013,42 @@ async function samplePool(pool, log, reportedDead) {
 }
 //#endregion
 //#region src/detection-pipeline/engine/inference-timeout-guard.ts
+/**
+* Inference-timeout regression guard — "did this update make the GPU time
+* out more than the last one did?", asked by the node itself.
+*
+* ## Why
+*
+* `@camstack/server` 1.2.218 reintroduced the inference timeouts 1.2.216 had
+* fixed: ~3 760 `inference request timed out` an hour for 4 h 19 min (16 215
+* lines, ~19 000 `runInference failed`), on a cluster whose previous hour had
+* seen ~5. Nothing said so. 1.2.219 fixed it again as a side effect of the
+* next deploy, and the regression was found a day later by an audit that
+* counted log lines per version by hand (2026-09-05). A green typecheck, a
+* green suite and a 200 on `/health` all held throughout.
+*
+* ## What it does
+*
+* Every five minutes the guard records how many inference requests timed out
+* on this node under the current FINGERPRINT (the closure version). The last
+* hour of buckets is persisted in the addon store, so a restart hands the
+* previous fingerprint's rate to the next one. Once the new fingerprint has a
+* quarter hour of its own, the two hourly rates are compared:
+*
+*  - ≥ `TIMEOUT_GUARD_RATIO`× worse AND above `TIMEOUT_GUARD_FLOOR_PER_HOUR`
+*    → `system.liveness-failed` (AlertCenter raises a persistent alert keyed
+*    on the finding id) and an ERROR line naming both versions and rates;
+*  - ≥ `TIMEOUT_GUARD_RATIO`× better → an INFO line, no alert;
+*  - the same fingerprint (a plain restart) → nothing to compare.
+*
+* The rate is per hour, not per frame: it is the unit the audit measured and
+* the unit an operator reads. A traffic doubling doubles the rate, which is
+* why the ratio is five and not two.
+*
+* Pure core (`recordTimeoutBucket`, `evaluateTimeoutRegression`) tested in
+* `__tests__/inference-timeout-guard.spec.ts`; the runtime wrapper owns the
+* timer, the store and the emit.
+*/
 var TIMEOUT_GUARD_BUCKET_MS = 5 * 6e4;
 /** Addon-store key the ledger persists under (the addon's own settings blob). */
 var INFERENCE_TIMEOUT_LEDGER_KEY = "_inferenceTimeoutLedger";
@@ -3055,6 +3092,40 @@ function evaluateTimeoutRegression(input) {
 		...base
 	};
 }
+/**
+* The closure version, read from the closure the runner was started from.
+*
+* The forked runner script is `<closure>/node_modules/@camstack/system/dist/
+* addon-runner.js` (hub: `/data/server-root/current/…`); the closure's own
+* `@camstack/server/package.json` sits two directories up. This is read from
+* disk rather than asked of `server-management` because that cap is
+* server-provided and the parent refuses to route it for a forked addon —
+* "no provider registered for cap server-management", measured on all
+* three nodes on 2026-09-05. A file the process was started from cannot
+* be refused.
+*/
+function closureVersionFromRunnerPath(runnerScript, fs) {
+	if (runnerScript === void 0 || runnerScript.length === 0) return null;
+	let dir = dirname(runnerScript);
+	for (let depth = 0; depth < 12; depth += 1) {
+		const candidate = join(dir, "node_modules", "@camstack", "server", "package.json");
+		const raw = fs.readFile(candidate);
+		if (raw !== null) {
+			try {
+				const parsed = JSON.parse(raw);
+				const version = typeof parsed === "object" && parsed !== null ? parsed.version : void 0;
+				if (typeof version === "string" && version.length > 0) return `server@${version}`;
+			} catch {
+				return null;
+			}
+			return null;
+		}
+		const parent = dirname(dir);
+		if (parent === dir) break;
+		dir = parent;
+	}
+	return null;
+}
 function readStoredLedgers(blob) {
 	const raw = blob[INFERENCE_TIMEOUT_LEDGER_KEY];
 	if (typeof raw !== "object" || raw === null) return {};
@@ -6884,12 +6955,13 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 				readTotalTimeouts: () => this.listGuardedPools().reduce((sum, pool) => sum + pool.factory.getPoolBacklog().timedOut, 0),
 				readStore: () => this.readStore(),
 				writeStore: (patch) => this.writeStore(patch),
-				resolveFingerprint: async () => {
-					const ctx = this.addonCtx;
-					if (!ctx) return null;
-					const status = await ctx.api.serverManagement.getServerPackageStatus.query({ nodeId });
-					return status.runningVersion === null ? null : `server@${status.runningVersion}`;
-				},
+				resolveFingerprint: async () => closureVersionFromRunnerPath(process.argv[1], { readFile: (path) => {
+					try {
+						return fs.readFileSync(path, "utf8");
+					} catch {
+						return null;
+					}
+				} }),
 				emitFailed: (finding) => {
 					this.eventBus?.emit(createEvent(EventCategory.SystemLivenessFailed, TIMEOUT_GUARD_SOURCE, finding));
 				},

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

@@ -1774,6 +1774,8 @@ var DecodeWorkerChild = class {
 	* key frame that can never be captured again.
 	*/
 	sceneRefused = 0;
+	/** Scenes planned and cut that no tile in the cut was classified as. */
+	sceneUnclassified = 0;
 	/**
 	* Native frame dimensions the retained tiles were cut from. A session's
 	* resolution does not change (a re-dial clears the store), so ONE pair is
@@ -2005,7 +2007,7 @@ var DecodeWorkerChild = class {
 		const skipped = this.framesSkipped + this.frames.droppedCount;
 		const rssMb = Math.round(process.memoryUsage().rss / 1048576);
 		const ageS = Math.round((now - this.startedAt) / 1e3);
-		this.emitStderr(`session-decode metrics {framesDecoded:${this.framesDecoded}, framesSkipped:${skipped}, deliveredFps:${deliveredFps}, nativeCropHits:${this.nativeCropHits}, nativeCropMisses:${this.nativeCropMisses}, leaseOffered:${this.admission.offered}, leaseAdmitted:${this.admission.admitted}, leaseMarks:${this.admission.marks}, leaseUnmarkedCrops:${this.admission.unmarkedCrops}, leaseAdmission:${NATIVE_LEASE_KNOBS.values.admission}, leaseMb:${Math.round(this.leaseStore.totalBytes / 1048576)}, leaseFrames:${this.leaseStore.size}, holdOverflow:${this.leaseStore.overflowCount}, tilesCut:${this.tilesCut}, tileHits:${this.tileHits}, tileMisses:${this.tileMisses}, tileCutFailures:${this.tileCutFailures}, tileMb:${Math.round(this.tileStore.totalBytes / 1048576)}, tileFrames:${this.tileStore.frameCount}, scenesCut:${this.scenesCut}, sceneHits:${this.sceneHits}, sceneRefused:${this.sceneRefused}, sceneEvicted:${this.sceneStore.evictedCount}, sceneMb:${Math.round(this.sceneStore.totalBytes / 1048576)}, sceneFrames:${this.sceneStore.frameCount}, rssMb:${rssMb}, ageS:${ageS}}${final ? " (final)" : ""}\n`);
+		this.emitStderr(`session-decode metrics {framesDecoded:${this.framesDecoded}, framesSkipped:${skipped}, deliveredFps:${deliveredFps}, nativeCropHits:${this.nativeCropHits}, nativeCropMisses:${this.nativeCropMisses}, leaseOffered:${this.admission.offered}, leaseAdmitted:${this.admission.admitted}, leaseMarks:${this.admission.marks}, leaseUnmarkedCrops:${this.admission.unmarkedCrops}, leaseAdmission:${NATIVE_LEASE_KNOBS.values.admission}, leaseMb:${Math.round(this.leaseStore.totalBytes / 1048576)}, leaseFrames:${this.leaseStore.size}, holdOverflow:${this.leaseStore.overflowCount}, tilesCut:${this.tilesCut}, tileHits:${this.tileHits}, tileMisses:${this.tileMisses}, tileCutFailures:${this.tileCutFailures}, tileMb:${Math.round(this.tileStore.totalBytes / 1048576)}, tileFrames:${this.tileStore.frameCount}, scenesCut:${this.scenesCut}, sceneHits:${this.sceneHits}, sceneRefused:${this.sceneRefused}, sceneUnclassified:${this.sceneUnclassified}, sceneEvicted:${this.sceneStore.evictedCount}, sceneMb:${Math.round(this.sceneStore.totalBytes / 1048576)}, sceneFrames:${this.sceneStore.frameCount}, rssMb:${rssMb}, ageS:${ageS}}${final ? " (final)" : ""}\n`);
 		this.lastMetricsAt = now;
 		this.lastDeliveredSnapshot = this.framesDelivered;
 		if (!this.warnedLarge && rssMb >= WORKER_RSS_WARN_MB) {
@@ -2171,6 +2173,7 @@ var DecodeWorkerChild = class {
 		if (!this.tileStore.enabled && !this.sceneStore.enabled) return `frame ${frameId} released and retention is DISABLED (tileBudgetMb 0, sceneBudgetMb 0)`;
 		if (!this.sceneStore.enabled) return `frame ${frameId} released and no retained subject tile contains the requested rectangle; scene tiles are DISABLED (sceneBudgetMb 0), so a full-frame request cannot be served at all`;
 		if (!this.tileStore.enabled) return `frame ${frameId} released and subject tiles are DISABLED (tileBudgetMb 0)`;
+		if (this.tileStore.get(frameId).length === 0 && this.sceneStore.get(frameId).length === 0) return `frame ${frameId} released and no retained tile for this frame`;
 		return `frame ${frameId} released and no retained subject or scene tile contains the requested rectangle`;
 	}
 	/** The GPU-ring or reserved-slot frame for `frameId` (hold-disabled / newest paths). */
@@ -2265,10 +2268,11 @@ var DecodeWorkerChild = class {
 				}
 			});
 			this.tileCutFailures += plan.bboxes.length - cut.length;
-			const { subjects, scene } = plan.scene ? partitionSceneTile(cut, frame.width, frame.height) : {
+			const { subjects, scene } = plan.scene ? partitionSceneTile(cut, this.tileFrameWidth, this.tileFrameHeight) : {
 				subjects: cut,
 				scene: null
 			};
+			if (plan.scene && scene === null && cut.length > 0) this.sceneUnclassified += 1;
 			if (subjects.length > 0) {
 				this.tilesCut += subjects.length;
 				this.tileStore.put(frameId, subjects);

package/dist/session-decode/decode-worker-child.mjs

@@ -1773,6 +1773,8 @@ var DecodeWorkerChild = class {
 	* key frame that can never be captured again.
 	*/
 	sceneRefused = 0;
+	/** Scenes planned and cut that no tile in the cut was classified as. */
+	sceneUnclassified = 0;
 	/**
 	* Native frame dimensions the retained tiles were cut from. A session's
 	* resolution does not change (a re-dial clears the store), so ONE pair is
@@ -2004,7 +2006,7 @@ var DecodeWorkerChild = class {
 		const skipped = this.framesSkipped + this.frames.droppedCount;
 		const rssMb = Math.round(process.memoryUsage().rss / 1048576);
 		const ageS = Math.round((now - this.startedAt) / 1e3);
-		this.emitStderr(`session-decode metrics {framesDecoded:${this.framesDecoded}, framesSkipped:${skipped}, deliveredFps:${deliveredFps}, nativeCropHits:${this.nativeCropHits}, nativeCropMisses:${this.nativeCropMisses}, leaseOffered:${this.admission.offered}, leaseAdmitted:${this.admission.admitted}, leaseMarks:${this.admission.marks}, leaseUnmarkedCrops:${this.admission.unmarkedCrops}, leaseAdmission:${NATIVE_LEASE_KNOBS.values.admission}, leaseMb:${Math.round(this.leaseStore.totalBytes / 1048576)}, leaseFrames:${this.leaseStore.size}, holdOverflow:${this.leaseStore.overflowCount}, tilesCut:${this.tilesCut}, tileHits:${this.tileHits}, tileMisses:${this.tileMisses}, tileCutFailures:${this.tileCutFailures}, tileMb:${Math.round(this.tileStore.totalBytes / 1048576)}, tileFrames:${this.tileStore.frameCount}, scenesCut:${this.scenesCut}, sceneHits:${this.sceneHits}, sceneRefused:${this.sceneRefused}, sceneEvicted:${this.sceneStore.evictedCount}, sceneMb:${Math.round(this.sceneStore.totalBytes / 1048576)}, sceneFrames:${this.sceneStore.frameCount}, rssMb:${rssMb}, ageS:${ageS}}${final ? " (final)" : ""}\n`);
+		this.emitStderr(`session-decode metrics {framesDecoded:${this.framesDecoded}, framesSkipped:${skipped}, deliveredFps:${deliveredFps}, nativeCropHits:${this.nativeCropHits}, nativeCropMisses:${this.nativeCropMisses}, leaseOffered:${this.admission.offered}, leaseAdmitted:${this.admission.admitted}, leaseMarks:${this.admission.marks}, leaseUnmarkedCrops:${this.admission.unmarkedCrops}, leaseAdmission:${NATIVE_LEASE_KNOBS.values.admission}, leaseMb:${Math.round(this.leaseStore.totalBytes / 1048576)}, leaseFrames:${this.leaseStore.size}, holdOverflow:${this.leaseStore.overflowCount}, tilesCut:${this.tilesCut}, tileHits:${this.tileHits}, tileMisses:${this.tileMisses}, tileCutFailures:${this.tileCutFailures}, tileMb:${Math.round(this.tileStore.totalBytes / 1048576)}, tileFrames:${this.tileStore.frameCount}, scenesCut:${this.scenesCut}, sceneHits:${this.sceneHits}, sceneRefused:${this.sceneRefused}, sceneUnclassified:${this.sceneUnclassified}, sceneEvicted:${this.sceneStore.evictedCount}, sceneMb:${Math.round(this.sceneStore.totalBytes / 1048576)}, sceneFrames:${this.sceneStore.frameCount}, rssMb:${rssMb}, ageS:${ageS}}${final ? " (final)" : ""}\n`);
 		this.lastMetricsAt = now;
 		this.lastDeliveredSnapshot = this.framesDelivered;
 		if (!this.warnedLarge && rssMb >= WORKER_RSS_WARN_MB) {
@@ -2170,6 +2172,7 @@ var DecodeWorkerChild = class {
 		if (!this.tileStore.enabled && !this.sceneStore.enabled) return `frame ${frameId} released and retention is DISABLED (tileBudgetMb 0, sceneBudgetMb 0)`;
 		if (!this.sceneStore.enabled) return `frame ${frameId} released and no retained subject tile contains the requested rectangle; scene tiles are DISABLED (sceneBudgetMb 0), so a full-frame request cannot be served at all`;
 		if (!this.tileStore.enabled) return `frame ${frameId} released and subject tiles are DISABLED (tileBudgetMb 0)`;
+		if (this.tileStore.get(frameId).length === 0 && this.sceneStore.get(frameId).length === 0) return `frame ${frameId} released and no retained tile for this frame`;
 		return `frame ${frameId} released and no retained subject or scene tile contains the requested rectangle`;
 	}
 	/** The GPU-ring or reserved-slot frame for `frameId` (hold-disabled / newest paths). */
@@ -2264,10 +2267,11 @@ var DecodeWorkerChild = class {
 				}
 			});
 			this.tileCutFailures += plan.bboxes.length - cut.length;
-			const { subjects, scene } = plan.scene ? partitionSceneTile(cut, frame.width, frame.height) : {
+			const { subjects, scene } = plan.scene ? partitionSceneTile(cut, this.tileFrameWidth, this.tileFrameHeight) : {
 				subjects: cut,
 				scene: null
 			};
+			if (plan.scene && scene === null && cut.length > 0) this.sceneUnclassified += 1;
 			if (subjects.length > 0) {
 				this.tilesCut += subjects.length;
 				this.tileStore.put(frameId, subjects);

package/dist/stream-broker/{_virtual_mf-localSharedImportMap___mfe_internal__addon_stream_broker_widgets-U-2ES6SY.mjs → _virtual_mf-localSharedImportMap___mfe_internal__addon_stream_broker_widgets-4NEhUNJS.mjs}

@@ -33,7 +33,7 @@ var e = {
 	},
 	"@camstack/ui-library": {
 		name: "@camstack/ui-library",
-		version: "1.2.114",
+		version: "1.2.115",
 		scope: ["default"],
 		loaded: !1,
 		from: "addon_stream_broker_widgets",

package/dist/stream-broker/{hostInit-pj_S4rLR.mjs → hostInit-BWI_flla.mjs}

@@ -81,7 +81,7 @@ async function r() {
 				}
 			},
 			"@camstack/ui-library": {
-				version: "1.2.114",
+				version: "1.2.115",
 				scope: "default",
 				shareConfig: {
 					singleton: !0,

package/dist/stream-broker/remoteEntry.js

@@ -30,7 +30,7 @@ async function d(e) {
 	}
 }
 async function f() {
-	return l ||= d(() => import("./_virtual_mf-localSharedImportMap___mfe_internal__addon_stream_broker_widgets-U-2ES6SY.mjs")).catch((e) => {
+	return l ||= d(() => import("./_virtual_mf-localSharedImportMap___mfe_internal__addon_stream_broker_widgets-4NEhUNJS.mjs")).catch((e) => {
 		throw l = void 0, e;
 	}), l;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-pipeline",
-  "version": "1.2.181",
+  "version": "1.2.183",
   "description": "Pipeline bundle — runner, detection, motion, audio + stream broker. Multi-entry npm package shipping pipeline addons under a single bundle.",
   "keywords": [
     "camstack",