@camstack/addon-pipeline 1.2.38 → 1.2.39

package/dist/audio-analyzer/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../chunk-emK7D4bc.js");
-const require_dist = require("../dist-BvFLZyhW.js");
+const require_dist = require("../dist-BtAvtroH.js");
 const require_node_topology_platform = require("../node-topology-platform-CFZ7F4xW.js");
 const require_model_download_service_Cp9f4dk6 = require("../model-download-service-Cp9f4dk6-fsdDExML.js");
 let node_fs = require("node:fs");

package/dist/audio-analyzer/index.mjs

@@ -1,5 +1,5 @@
 import { n as __require } from "../chunk-DnnnRqeS.mjs";
-import { B as errMsg, K as hydrateSchema, O as mapAudioLabelToMacro, V as BaseAddon, _ as audioAnalysisCapability, d as HF_BASE_URL, n as AUDIO_BACKEND_CHOICES, o as DEFAULT_AUDIO_ANALYZER_CONFIG, v as audioAnalyzerCapability } from "../dist-Du7_SNiR.mjs";
+import { B as errMsg, K as hydrateSchema, O as mapAudioLabelToMacro, V as BaseAddon, _ as audioAnalysisCapability, d as HF_BASE_URL, n as AUDIO_BACKEND_CHOICES, o as DEFAULT_AUDIO_ANALYZER_CONFIG, v as audioAnalyzerCapability } from "../dist-COgGdFMv.mjs";
 import { t as pickNodePlatformArch } from "../node-topology-platform-BkR_k6WT.mjs";
 import { i as downloadFile } from "../model-download-service-Cp9f4dk6-CwUb5v3Y.mjs";
 import * as fs from "node:fs";

package/dist/detection-pipeline/index.js

@@ -3,20 +3,20 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../chunk-emK7D4bc.js");
-const require_dist = require("../dist-BvFLZyhW.js");
-const require_step_definitions = require("../step-definitions-i8O-hxyI.js");
+const require_dist = require("../dist-BtAvtroH.js");
+const require_event_loop_stall_monitor = require("../event-loop-stall-monitor-shfwi1_b.js");
+const require_lazy_sharp = require("../lazy-sharp-CcYuXtsa.js");
 const require_node_topology_platform = require("../node-topology-platform-CFZ7F4xW.js");
 const require_model_download_service_Cp9f4dk6 = require("../model-download-service-Cp9f4dk6-fsdDExML.js");
-let node_os = require("node:os");
-node_os = require_chunk.__toESM(node_os);
-let node_child_process = require("node:child_process");
 let sharp = require("sharp");
 sharp = require_chunk.__toESM(sharp);
+let node_child_process = require("node:child_process");
+let node_os = require("node:os");
+node_os = require_chunk.__toESM(node_os);
 let node_fs = require("node:fs");
 node_fs = require_chunk.__toESM(node_fs);
 let node_path = require("node:path");
 node_path = require_chunk.__toESM(node_path);
-let node_perf_hooks = require("node:perf_hooks");
 //#region src/detection-pipeline/runtimes.ts
 var KNOWN_PLATFORMS = [
 	"darwin",
@@ -313,7 +313,7 @@ function classifyAccelerator(backend, device) {
 * missing-build fallback branch is unit-testable without a live catalog —
 * mirrors `collectZeroBuildIssues`' injection seam.
 */
-function resolveDefaultDetectionModel(backend, device, format, getStepDef = require_step_definitions.getStepDefinition) {
+function resolveDefaultDetectionModel(backend, device, format, getStepDef = require_event_loop_stall_monitor.getStepDefinition) {
 	let def;
 	try {
 		def = getStepDef(OBJECT_DETECTION_STEP_ID$1);
@@ -325,7 +325,7 @@ function resolveDefaultDetectionModel(backend, device, format, getStepDef = requ
 		const entry = def.models.find((m) => m.id === candidate);
 		if (entry && entry.formats[format] !== void 0) return candidate;
 	}
-	return require_step_definitions.getDefaultModelForFormatFromDef(def, format);
+	return require_event_loop_stall_monitor.getDefaultModelForFormatFromDef(def, format);
 }
 //#endregion
 //#region src/detection-pipeline/engine/shared-inference-pool.ts
@@ -1875,7 +1875,7 @@ var EngineFactory = class {
 		await this.poolManager.applyConfig(steps);
 	}
 	buildPoolModelConfig(stepId, modelId, poolRuntime) {
-		const def = require_step_definitions.getStepDefinition(stepId);
+		const def = require_event_loop_stall_monitor.getStepDefinition(stepId);
 		const modelEntry = def.models.find((m) => m.id === modelId);
 		if (!modelEntry) throw new Error(`Model "${modelId}" not found in step "${stepId}" catalog`);
 		const format = RUNTIME_TO_FORMAT[poolRuntime];
@@ -2246,6 +2246,89 @@ function normalizeOutput(output) {
 	};
 }
 //#endregion
+//#region src/detection-pipeline/pipeline/drop-sampler.ts
+/**
+* drop-sampler — keep the record of a dropped detection without the flood.
+*
+* ## Why
+*
+* The full-frame phantom guard logs every detection it removes, on purpose: a
+* branch that drops work silently reads as "never happened", and this repo has
+* paid for that twice. Its own comment set the bound honestly — *"Bounded by
+* how rare full-frame phantoms are, which is the point: if this floods, that is
+* itself the finding."*
+*
+* It flooded. Camera 615 emits a persistent full-frame `vehicle` phantom
+* (score ~0.62, areaRatio 0.949) and the guard was writing **dozens of INFO
+* lines a second** on 2026-08-02. So the finding stands — that camera has a
+* standing phantom worth investigating — but the log volume is now costing more
+* than the record is worth, and it drowns everything else in the same stream.
+*
+* ## The shape
+*
+* FIRST occurrence of each `(deviceId, macroClass)` logs in full: the example
+* is what makes the finding actionable — the bbox, the score, the ratios.
+* After that the pair is counted and a SUMMARY is emitted per interval, so the
+* question "how often does this fire, and on what?" is still answerable — from
+* a counter rather than from N identical lines.
+*
+* Deliberately per `(device, class)` and not global: a phantom on one camera
+* must not mask a new one appearing on another, which a single global counter
+* would do.
+*/
+/** How often an active drop pattern re-reports, with its count. */
+var DROP_SUMMARY_INTERVAL_MS = 6e4;
+/**
+* Decides, per `(deviceId, class)`, whether this drop is worth a line.
+*
+* Pure-ish and clock-injected so the interval logic is testable without
+* waiting a minute.
+*/
+var DropSampler = class {
+	seen = /* @__PURE__ */ new Map();
+	now;
+	intervalMs;
+	constructor(intervalMs = DROP_SUMMARY_INTERVAL_MS, now = () => Date.now()) {
+		this.intervalMs = intervalMs;
+		this.now = now;
+	}
+	/**
+	* Record one drop. Returns what to log.
+	*
+	* The first sighting of a pair yields the example. Afterwards the count
+	* accumulates and a summary is released once per interval — carrying the
+	* number suppressed, so nothing about the RATE is lost even though the lines
+	* are.
+	*/
+	record(deviceId, macroClass) {
+		const key = `${deviceId}:${macroClass}`;
+		const at = this.now();
+		const prev = this.seen.get(key);
+		if (prev === void 0) {
+			this.seen.set(key, {
+				count: 0,
+				lastReportedAt: at
+			});
+			return {
+				logExample: true,
+				summaryCount: null
+			};
+		}
+		prev.count += 1;
+		if (at - prev.lastReportedAt < this.intervalMs) return {
+			logExample: false,
+			summaryCount: null
+		};
+		const n = prev.count;
+		prev.count = 0;
+		prev.lastReportedAt = at;
+		return {
+			logExample: false,
+			summaryCount: n
+		};
+	}
+};
+//#endregion
 //#region src/detection-pipeline/pipeline/execution-trace.ts
 var traceCounter = 0;
 var ExecutionTraceBuilder = class {
@@ -3302,6 +3385,10 @@ function buildFrameResult(input) {
 		height: input.height,
 		detections,
 		...input.discarded !== void 0 && input.discarded.length > 0 ? { discarded: input.discarded } : {},
+		...input.shed !== void 0 ? {
+			shed: true,
+			shedReason: input.shed.reason
+		} : {},
 		debug: frameDebug
 	};
 }
@@ -3424,6 +3511,9 @@ function reprojectCropZoneDetections(output, cropOrigin) {
 }
 var PipelineExecutor = class {
 	opts;
+	/** Bounds the full-frame-guard drop log: first example per (device,
+	*  class), then a counted summary per minute. See `drop-sampler.ts`. */
+	dropSampler = new DropSampler();
 	constructor(opts) {
 		this.opts = opts;
 	}
@@ -3495,11 +3585,15 @@ var PipelineExecutor = class {
 			details
 		};
 		let discarded;
+		const rootShed = {
+			count: 0,
+			reasons: []
+		};
 		for (const rootStep of tree.roots) {
 			if (debug) console.log(`[executor] rootStep=${rootStep.stepId} settings=${JSON.stringify(rootStep.settings ?? {})}`);
 			const cropPrep = rootStep.definition.extractMode === "crop-zone" && cropZoneBbox !== void 0 ? await this.prepareCropZoneInput(cropZoneBbox, fullFrameJpegProvider, imageWidth, imageHeight, deviceId) : null;
 			const rootStart = Date.now();
-			const rawRootOutput = await this.executeStep(rootStep, cropPrep?.input ?? rootInput, cropPrep?.width ?? imageWidth, cropPrep?.height ?? imageHeight, "full-frame", void 0, void 0, traceBuilder, stepTimings, poolAgg);
+			const rawRootOutput = await this.executeStep(rootStep, cropPrep?.input ?? rootInput, cropPrep?.width ?? imageWidth, cropPrep?.height ?? imageHeight, "full-frame", void 0, void 0, traceBuilder, stepTimings, poolAgg, rootShed);
 			const rootMs = Date.now() - rootStart;
 			if (rawRootOutput === null) continue;
 			const rootOutput = cropPrep && rawRootOutput.kind === "detections" ? reprojectCropZoneDetections(rawRootOutput, cropPrep.origin) : rawRootOutput;
@@ -3565,7 +3659,17 @@ var PipelineExecutor = class {
 				const fullFrameBar = rootStep.settings?.["fullFrameGuardMaxConfidence"];
 				const fullFrameHardArea = rootStep.settings?.["fullFrameGuardHardAreaRatio"];
 				if (isFullFramePhantomDetection(mutable.bbox, imageWidth, imageHeight, mutable.score, typeof fullFrameBar === "number" ? fullFrameBar : void 0, typeof fullFrameHardArea === "number" ? fullFrameHardArea : void 0)) {
-					this.opts.logger?.info("full-frame phantom guard: detection dropped", {
+					const sample = this.dropSampler.record(deviceId, String(mutable.macroClass));
+					if (sample.summaryCount !== null) this.opts.logger?.info("full-frame phantom guard: still dropping", {
+						tags: { deviceId },
+						meta: {
+							macroClass: mutable.macroClass,
+							suppressed: sample.summaryCount,
+							windowMs: DROP_SUMMARY_INTERVAL_MS,
+							hint: "a standing full-frame phantom — check the camera framing / model, not the guard"
+						}
+					});
+					if (sample.logExample) this.opts.logger?.info("full-frame phantom guard: detection dropped", {
 						tags: { deviceId },
 						meta: {
 							macroClass: mutable.macroClass,
@@ -3627,6 +3731,7 @@ var PipelineExecutor = class {
 				firstLevel,
 				details,
 				discarded,
+				...rootShed.count > 0 ? { shed: { reason: rootShed.reasons[0] ?? "pool-overload" } } : {},
 				stepTimings,
 				totalMs,
 				engine: this.opts.engineRuntime,
@@ -3697,7 +3802,7 @@ var PipelineExecutor = class {
 			return null;
 		}
 	}
-	async executeStep(step, input, inputWidth, inputHeight, inputType, _parentBbox, parentClass, traceBuilder, stepTimings, poolAgg) {
+	async executeStep(step, input, inputWidth, inputHeight, inputType, _parentBbox, parentClass, traceBuilder, stepTimings, poolAgg, shedAgg) {
 		const preprocessStart = Date.now();
 		const preprocessMs = Date.now() - preprocessStart;
 		const inferenceStart = Date.now();
@@ -3734,6 +3839,10 @@ var PipelineExecutor = class {
 			throw new Error(`Inference failed for step "${step.stepId}": ${errorMsg}`, { cause: err });
 		}
 		if (engineOutput.dropped === true) {
+			if (shedAgg) {
+				shedAgg.count += 1;
+				shedAgg.reasons.push(engineOutput.shedReason ?? "pool-overload");
+			}
 			stepTimings.push({
 				source: step.stepId,
 				modelId: step.modelId,
@@ -4018,7 +4127,7 @@ function buildExecutableTree(steps, getEngine) {
 	return { roots: steps.filter((s) => s.enabled).filter((s) => s.slot !== "audio-classifier").map((s) => buildNode(s, getEngine)) };
 }
 function buildNode(step, getEngine) {
-	const definition = require_step_definitions.getStepDefinition(step.addonId);
+	const definition = require_event_loop_stall_monitor.getStepDefinition(step.addonId);
 	const engine = getEngine(step.addonId);
 	const children = (step.children ?? []).filter((c) => c.enabled).map((c) => buildNode(c, getEngine));
 	const mergedSettings = {
@@ -4043,7 +4152,7 @@ function buildNode(step, getEngine) {
 * entered recursively. Fields without a declared default are skipped.
 */
 function collectSchemaDefaults(stepId) {
-	const schema = require_step_definitions.getStep(stepId).getConfigSchema();
+	const schema = require_event_loop_stall_monitor.getStep(stepId).getConfigSchema();
 	const out = {};
 	walkFieldsForDefaults(schema, out);
 	return out;
@@ -4108,7 +4217,7 @@ function collectSubstitutions(steps, format) {
 	for (const step of steps) {
 		const chosen = step.modelId;
 		if (chosen != null) {
-			const running = require_step_definitions.resolveModelForFormat(step.addonId, chosen, format);
+			const running = require_event_loop_stall_monitor.resolveModelForFormat(step.addonId, chosen, format);
 			if (running !== chosen) result.push({
 				addonId: step.addonId,
 				chosen,
@@ -4134,7 +4243,7 @@ function collectSubstitutions(steps, format) {
 * black-box test. Unknown/custom addonIds (no registered `StepDefinition`)
 * are skipped, never thrown.
 */
-function collectZeroBuildIssues(steps, format, getStepDef = require_step_definitions.getStepDefinition) {
+function collectZeroBuildIssues(steps, format, getStepDef = require_event_loop_stall_monitor.getStepDefinition) {
 	const result = [];
 	for (const step of steps) {
 		let def;
@@ -4160,7 +4269,7 @@ function collectZeroBuildIssues(steps, format, getStepDef = require_step_definit
 * tests can exercise the unknown-addon branch with a fabricated resolver
 * without `vi.mock`.
 */
-function collectUnknownAddonIssues(steps, getStepDef = require_step_definitions.getStepDefinition) {
+function collectUnknownAddonIssues(steps, getStepDef = require_event_loop_stall_monitor.getStepDefinition) {
 	const result = [];
 	for (const step of steps) {
 		try {
@@ -4200,13 +4309,13 @@ function resolveInputSteps(steps, format, engine) {
 	for (const s of steps) {
 		let def;
 		try {
-			def = require_step_definitions.getStepDefinition(s.addonId);
+			def = require_event_loop_stall_monitor.getStepDefinition(s.addonId);
 		} catch {
 			unknownAddonIds.push(s.addonId);
 			continue;
 		}
 		const chosenModelId = s.modelId ?? null;
-		const runningModelId = chosenModelId === null && engine !== void 0 && s.addonId === "object-detection" ? resolveDefaultDetectionModel(engine.backend, engine.device, format) : require_step_definitions.resolveModelForFormat(s.addonId, chosenModelId, format);
+		const runningModelId = chosenModelId === null && engine !== void 0 && s.addonId === "object-detection" ? resolveDefaultDetectionModel(engine.backend, engine.device, format) : require_event_loop_stall_monitor.resolveModelForFormat(s.addonId, chosenModelId, format);
 		if (chosenModelId !== null && runningModelId !== chosenModelId) substitutions.push({
 			addonId: s.addonId,
 			chosen: chosenModelId,
@@ -5076,7 +5185,7 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 	* first, then the custom registry. Returns undefined if neither has it.
 	*/
 	async resolveModelEntry(addonId, modelId) {
-		const fromCatalog = require_step_definitions.getStepDefinition(addonId).models.find((m) => m.id === modelId);
+		const fromCatalog = require_event_loop_stall_monitor.getStepDefinition(addonId).models.find((m) => m.id === modelId);
 		if (fromCatalog) return fromCatalog;
 		return (await this.getCustomModels()).get(addonId)?.find((m) => m.id === modelId);
 	}
@@ -5172,7 +5281,7 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 	/** Pure recursive resolver — builds the resolved step tree without touching `modelSubstitutions`. */
 	resolveStepModelTree(steps, format) {
 		return steps.map((step) => {
-			const resolved = require_step_definitions.resolveModelForFormat(step.addonId, step.modelId ?? null, format);
+			const resolved = require_event_loop_stall_monitor.resolveModelForFormat(step.addonId, step.modelId ?? null, format);
 			const children = step.children?.length ? this.resolveStepModelTree([...step.children], format) : step.children;
 			return resolved === step.modelId && children === step.children ? step : {
 				...step,
@@ -5320,7 +5429,7 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 			for (const step of nodes) {
 				if (!step.enabled) continue;
 				try {
-					if (require_step_definitions.getStepDefinition(step.addonId).slot === "audio-classifier") continue;
+					if (require_event_loop_stall_monitor.getStepDefinition(step.addonId).slot === "audio-classifier") continue;
 				} catch {
 					continue;
 				}
@@ -5340,7 +5449,7 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 	async getCapabilities(_forceRefresh) {
 		const agentId = (this.addonCtx?.kernel?.cluster?.broker)?.nodeID ?? node_os.hostname();
 		const agentName = agentId;
-		const addons = require_step_definitions.ALL_PIPELINE_STEPS.map((s) => ({
+		const addons = require_event_loop_stall_monitor.ALL_PIPELINE_STEPS.map((s) => ({
 			id: s.definition.id,
 			name: s.definition.name,
 			models: s.definition.models.filter((m) => m.legacy !== true).map((m) => {
@@ -5621,8 +5730,7 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 				jpegProvider = async () => data;
 			} else if (frame.format === "rgb" || frame.format === "bgr" || frame.format === "gray") {
 				const channels = frame.format === "gray" ? 1 : 3;
-				const sharp$5 = (await import("sharp")).default;
-				const jpeg = await sharp$5(data, { raw: {
+				const jpeg = await (await require_lazy_sharp.getSharp())(data, { raw: {
 					width: frame.width,
 					height: frame.height,
 					channels
@@ -5636,8 +5744,7 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 				};
 				jpegProvider = async () => jpeg;
 			} else {
-				const sharp$6 = (await import("sharp")).default;
-				const encoded = await sharp$6(data, { raw: {
+				const encoded = await (await require_lazy_sharp.getSharp())(data, { raw: {
 					width: frame.width,
 					height: frame.height,
 					channels: 3
@@ -6250,8 +6357,7 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 	/** Parse JPEG/PNG dimensions without decoding the full image */
 	async getJpegDimensions(buf) {
 		try {
-			const sharp$7 = (await import("sharp")).default;
-			const { width, height } = await sharp$7(buf).metadata();
+			const { width, height } = await (await require_lazy_sharp.getSharp())(buf).metadata();
 			return {
 				width: width ?? 640,
 				height: height ?? 640
@@ -7008,7 +7114,7 @@ var DetectionPipelineProvider = class DetectionPipelineProvider {
 function buildSchemaSlots(formats, modelsDir, customByStep) {
 	const slotMap = /* @__PURE__ */ new Map();
 	const formatList = [...formats];
-	for (const pipelineStep of require_step_definitions.ALL_PIPELINE_STEPS) {
+	for (const pipelineStep of require_event_loop_stall_monitor.ALL_PIPELINE_STEPS) {
 		const step = pipelineStep.definition;
 		const availableModels = mergeCustomModels(step.models, customByStep?.get(step.id) ?? []).filter((m) => m.legacy !== true && formatList.some((f) => m.formats[f]));
 		if (availableModels.length === 0) continue;
@@ -7095,7 +7201,7 @@ function resolveChildSlots(slot) {
 */
 function buildDefaultStepTree(format, objectDetectionModelId) {
 	const makeStep = (stepId, children, opts) => {
-		const def = require_step_definitions.getStepDefinition(stepId);
+		const def = require_event_loop_stall_monitor.getStepDefinition(stepId);
 		if (!def.models.some((m) => m.formats[format])) return null;
 		return {
 			addonId: def.id,
@@ -7104,7 +7210,7 @@ function buildDefaultStepTree(format, objectDetectionModelId) {
 			inputClasses: def.inputClasses ?? [],
 			outputClasses: def.outputClasses,
 			enabled: opts?.enabled ?? true,
-			modelId: opts?.modelId ?? require_step_definitions.getDefaultModelForFormat(stepId, format),
+			modelId: opts?.modelId ?? require_event_loop_stall_monitor.getDefaultModelForFormat(stepId, format),
 			children,
 			...def.group ? { group: def.group } : {}
 		};
@@ -7161,7 +7267,7 @@ function flattenSteps(steps) {
 */
 function isDetailPlaneStep(addonId) {
 	try {
-		return require_step_definitions.getStepDefinition(addonId).inputClasses !== null;
+		return require_event_loop_stall_monitor.getStepDefinition(addonId).inputClasses !== null;
 	} catch {
 		return false;
 	}
@@ -7182,7 +7288,7 @@ function stepHasZeroBuildsFor(addonId, format) {
 */
 function availableFormatsForStep(addonId) {
 	try {
-		const def = require_step_definitions.getStepDefinition(addonId);
+		const def = require_event_loop_stall_monitor.getStepDefinition(addonId);
 		const formats = /* @__PURE__ */ new Set();
 		for (const model of def.models) for (const format of Object.keys(model.formats)) formats.add(format);
 		return Array.from(formats).toSorted();
@@ -7206,142 +7312,6 @@ function applyDeviceOverridesToTree(tree, rootStepId, overrides) {
 	} : root) };
 }
 //#endregion
-//#region src/detection-pipeline/diagnostics/event-loop-stall-monitor.ts
-/**
-* event-loop-stall-monitor — names the thing that freezes the detection process.
-*
-* ## What this exists to settle
-*
-* On 2026-08-01/02 inference across the whole fleet stalled in bursts: 759
-* calls in 90 minutes crossed the runner's 20s deadline, p50 41s and max 80s,
-* and EVERY one of them eventually resolved. Six explanations were killed with
-* telemetry alone:
-*
-*  - not a slow GPU or a wedged pool — the work completes, just enormously late;
-*  - not CPU starvation — hosts sat at 8-48% during the freezes;
-*  - not swap — `pswpin/pswpout` are flat zero on every host;
-*  - not a logging artifact — Loki's timestamp trails the in-process one by
-*    0.1-1.0s at p95, so the gaps are real, not buffered delivery;
-*  - not the v1.2.30 release — the stalls predate it by a day;
-*  - not only the idle-pool recompile — that is real and hub-side, but the
-*    agent stalls with no eviction and no compile at all.
-*
-* What IS established: the 10s stats timer — which touches no inference code —
-* stops firing for 22-88s and resumes at the same instant the abandoned calls
-* settle. The event loop itself freezes. From outside the process, GC and a
-* synchronous block are indistinguishable, and guessing between them is how
-* this investigation would go wrong. So measure it.
-*
-* ## How
-*
-* A 1s interval whose LATENESS is the freeze: a tick that arrives 40s late means
-* the loop was blocked ~39s, whatever blocked it. In the same window the GC
-* observer accumulates pause time. The two numbers together answer the question
-* outright:
-*
-*  - `gcMs` ≈ `stallMs` → garbage collection. Look at heap growth.
-*  - `gcMs` ≈ 0 → something SYNCHRONOUS blocked the loop, and GC is innocent.
-*
-* Heap and RSS ride along because if it is GC, the next question is always
-* "growing since when?".
-*
-* Deliberately not a histogram (`monitorEventLoopDelay`): that reports a
-* distribution, and the question here is about ONE outlier and what coincided
-* with it.
-*/
-/** Tick period. Small enough to bound attribution error, large enough to cost
-*  nothing on a process already doing frame work. */
-var STALL_TICK_MS = 1e3;
-/**
-* Report a freeze only past this. The runner's own inference deadline is 20s
-* and the observed freezes run 22-88s, so this is far below the signal while
-* staying clear of ordinary scheduling jitter (a busy frame path routinely
-* overruns a 1s timer by tens of ms).
-*/
-var STALL_REPORT_MS = 2e3;
-/**
-* Attribute a freeze. Pure, because this is the ONE judgement the whole module
-* exists to make and it must be testable without freezing a real event loop.
-*
-* `gc` when garbage collection accounts for most of the stall; a
-* `synchronous-block` when it accounts for almost none — that verdict points
-* away from the heap entirely and at whatever ran without yielding.
-*/
-function attributeStall(stallMs, gcMs, gcCount, longestGcMs) {
-	const share = stallMs > 0 ? gcMs / stallMs : 0;
-	return {
-		stallMs,
-		gcMs,
-		gcCount,
-		longestGcMs,
-		cause: share >= .7 ? "gc" : share <= .2 ? "synchronous-block" : "mixed"
-	};
-}
-/**
-* Start watching. Returns a stop function; safe to call twice.
-*
-* Never throws into the caller: a diagnostic that can take the detection
-* process down is worse than no diagnostic. `PerformanceObserver` for `gc` is
-* unavailable in some embedded runtimes, and that must degrade to
-* stall-detection-without-attribution rather than a boot failure.
-*/
-function startEventLoopStallMonitor(logger, reportThresholdMs = STALL_REPORT_MS) {
-	let gc = {
-		totalMs: 0,
-		count: 0,
-		longestMs: 0
-	};
-	let observer = null;
-	try {
-		observer = new node_perf_hooks.PerformanceObserver((list) => {
-			for (const entry of list.getEntries()) {
-				gc.totalMs += entry.duration;
-				gc.count += 1;
-				if (entry.duration > gc.longestMs) gc.longestMs = entry.duration;
-			}
-		});
-		observer.observe({ entryTypes: ["gc"] });
-	} catch {
-		observer = null;
-	}
-	let expected = Date.now() + STALL_TICK_MS;
-	const timer = setInterval(() => {
-		const now = Date.now();
-		const lateBy = now - expected;
-		const window = gc;
-		gc = {
-			totalMs: 0,
-			count: 0,
-			longestMs: 0
-		};
-		expected = now + STALL_TICK_MS;
-		if (lateBy < reportThresholdMs) return;
-		const verdict = attributeStall(lateBy, Math.round(window.totalMs), window.count, Math.round(window.longestMs));
-		const mem = process.memoryUsage();
-		logger.warn("event loop stalled", { meta: {
-			stallMs: verdict.stallMs,
-			cause: verdict.cause,
-			gcMs: verdict.gcMs,
-			gcCount: verdict.gcCount,
-			longestGcMs: verdict.longestGcMs,
-			gcObserved: observer !== null,
-			heapUsedMb: Math.round(mem.heapUsed / 1e6),
-			heapTotalMb: Math.round(mem.heapTotal / 1e6),
-			rssMb: Math.round(mem.rss / 1e6),
-			externalMb: Math.round(mem.external / 1e6),
-			arrayBuffersMb: Math.round(mem.arrayBuffers / 1e6)
-		} });
-	}, STALL_TICK_MS);
-	timer.unref?.();
-	let stopped = false;
-	return () => {
-		if (stopped) return;
-		stopped = true;
-		clearInterval(timer);
-		observer?.disconnect();
-	};
-}
-//#endregion
 //#region src/detection-pipeline/python-readiness.ts
 /**
 * Resolve the embedded Python once, turning the null/throw failure modes into
@@ -7802,7 +7772,7 @@ var DetectionPipelineAddon = class extends require_dist.BaseAddon {
 	async onInitialize() {
 		const modelsDir = await this.resolveModelsDir();
 		if (!this.ctx.settings) throw new Error("DetectionPipelineAddon: ctx.settings not available");
-		this.stopStallMonitor = startEventLoopStallMonitor(this.ctx.logger);
+		this.stopStallMonitor = require_event_loop_stall_monitor.startEventLoopStallMonitor(this.ctx.logger);
 		this.pythonAddonDir = resolveAddonPythonDir();
 		const py = await ensurePythonReady(this.ctx.deps, this.ctx.logger);
 		if (py.ok && py.pythonPath) this.pythonPath = py.pythonPath;
@@ -7855,7 +7825,7 @@ var DetectionPipelineAddon = class extends require_dist.BaseAddon {
 		}).catch(() => {});
 	}
 	getModelCatalog() {
-		return require_step_definitions.ALL_STEPS.flatMap((s) => s.models.filter((m) => m.legacy !== true));
+		return require_event_loop_stall_monitor.ALL_STEPS.flatMap((s) => s.models.filter((m) => m.legacy !== true));
 	}
 	/**
 	* Proactively install the OpenVINO Python package when Intel hardware
@@ -7941,9 +7911,9 @@ var DetectionPipelineAddon = class extends require_dist.BaseAddon {
 	}
 };
 //#endregion
-exports.ALL_STEPS = require_step_definitions.ALL_STEPS;
+exports.ALL_STEPS = require_event_loop_stall_monitor.ALL_STEPS;
 exports.DetectionPipelineProvider = DetectionPipelineProvider;
 exports.default = DetectionPipelineAddon;
-exports.getDefaultModelForFormat = require_step_definitions.getDefaultModelForFormat;
-exports.getStepDefinition = require_step_definitions.getStepDefinition;
+exports.getDefaultModelForFormat = require_event_loop_stall_monitor.getDefaultModelForFormat;
+exports.getStepDefinition = require_event_loop_stall_monitor.getStepDefinition;
 exports.shouldInstallOpenvino = shouldInstallOpenvino;