@camstack/addon-pipeline 1.2.187 → 1.2.189

package/dist/audio-analyzer/index.js

@@ -2,8 +2,8 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_dist = require("../dist-e2OKAUGI.js");
-const require_process_memory = require("../process-memory-einpgBTr.js");
+const require_dist = require("../dist-CKr6Q6Qu.js");
+const require_process_memory = require("../process-memory-BW7XFoPY.js");
 let node_fs = require("node:fs");
 node_fs = require_dist.__toESM(node_fs);
 let node_path = require("node:path");

package/dist/audio-analyzer/index.mjs

@@ -1,6 +1,6 @@
 import { n as __require } from "../chunk-DnnnRqeS.mjs";
-import { A as audioAnalysisCapability, It as hydrateSchema, S as PoolMemoryWatchdog, _t as resolvePoolMemoryPolicy, j as audioAnalyzerCapability, jt as BaseAddon, n as AUDIO_BACKEND_CHOICES, nt as mapAudioLabelToMacro, s as DEFAULT_AUDIO_ANALYZER_CONFIG, v as HF_BASE_URL, wt as errMsg } from "../dist-HWdaHLLK.mjs";
-import { n as pickNodePlatformArch, t as readProcessMemory } from "../process-memory-CnTmyk9s.mjs";
+import { A as audioAnalysisCapability, It as hydrateSchema, S as PoolMemoryWatchdog, _t as resolvePoolMemoryPolicy, j as audioAnalyzerCapability, jt as BaseAddon, n as AUDIO_BACKEND_CHOICES, nt as mapAudioLabelToMacro, s as DEFAULT_AUDIO_ANALYZER_CONFIG, v as HF_BASE_URL, wt as errMsg } from "../dist-CxYG8IUX.mjs";
+import { n as pickNodePlatformArch, t as readProcessMemory } from "../process-memory-L6mHI28P.mjs";
 import * as fs from "node:fs";
 import * as path$1 from "node:path";
 import { downloadFile } from "@camstack/system/addon-utils";

package/dist/detection-pipeline/index.js

@@ -2,12 +2,12 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_dist = require("../dist-e2OKAUGI.js");
-const require_node = require("../node-Dw6FrDFS.js");
-const require_local_frame_registry = require("../local-frame-registry-Cl1VUpx_.js");
-const require_lazy_sharp = require("../lazy-sharp-AJ7newgl.js");
+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_lazy_sharp = require("../lazy-sharp-D-HdRPo5.js");
 const require_event_loop_stall_monitor = require("../event-loop-stall-monitor-DaUBcb13.js");
-const require_process_memory = require("../process-memory-einpgBTr.js");
+const require_process_memory = require("../process-memory-BW7XFoPY.js");
 let node_fs = require("node:fs");
 node_fs = require_dist.__toESM(node_fs);
 let node_path = require("node:path");

package/dist/detection-pipeline/index.mjs

@@ -1,10 +1,10 @@
 import { n as __require } from "../chunk-DnnnRqeS.mjs";
-import { Bt as nodePin, Ft as createEvent, It as hydrateSchema, Kt as array, O as YAMNET_TO_MACRO, Q as inferModelProvider, Qt as object, S as PoolMemoryWatchdog, St as supportedRuntimes$1, Vt as parseJsonUnknown, W as detectionPipelineCapability, Wt as sleep, Y as evaluateZoneRules, _t as resolvePoolMemoryPolicy, at as overlayClusterStepSettings, c as DEFAULT_CLUSTER_STEP_MODELS, ct as pickClusterStepSettings, dt as pipelineExecutorCapability, en as string, et as loadContributionCapability, ht as resolveClusterStepModelId, jt as BaseAddon, l as DEFAULT_CLUSTER_STEP_SETTINGS, m as DEVICE_BACKEND_TO_FORMAT, nn as EventCategory, q as enumerateInferenceDevices, st as pickClusterStepModels, t as APPLE_SA_TO_MACRO, tn as union, wt as errMsg, yt as runtimeDevices$1, z as defaultDeviceFor$1 } from "../dist-HWdaHLLK.mjs";
-import { a as readProcessCost } from "../node-CwSBH-3M.mjs";
-import { a as getDefaultModelForFormat, c as getStepDefinition, i as ALL_STEPS, l as resolveModelForFormat, o as getDefaultModelForFormatFromDef, r as ALL_PIPELINE_STEPS, s as getStep, t as localFrameRegistry, u as landmarkPrecisionVerdict } from "../local-frame-registry-Bki81rM0.mjs";
+import { Bt as nodePin, Ft as createEvent, It as hydrateSchema, Kt as array, O as YAMNET_TO_MACRO, Q as inferModelProvider, Qt as object, S as PoolMemoryWatchdog, St as supportedRuntimes$1, Vt as parseJsonUnknown, W as detectionPipelineCapability, Wt as sleep, Y as evaluateZoneRules, _t as resolvePoolMemoryPolicy, at as overlayClusterStepSettings, c as DEFAULT_CLUSTER_STEP_MODELS, ct as pickClusterStepSettings, dt as pipelineExecutorCapability, en as string, et as loadContributionCapability, ht as resolveClusterStepModelId, jt as BaseAddon, l as DEFAULT_CLUSTER_STEP_SETTINGS, m as DEVICE_BACKEND_TO_FORMAT, nn as EventCategory, q as enumerateInferenceDevices, st as pickClusterStepModels, t as APPLE_SA_TO_MACRO, tn as union, wt as errMsg, yt as runtimeDevices$1, z as defaultDeviceFor$1 } from "../dist-CxYG8IUX.mjs";
+import { a as readProcessCost } from "../node-DhccO0of.mjs";
+import { a as getDefaultModelForFormat, c as getStepDefinition, i as ALL_STEPS, l as resolveModelForFormat, o as getDefaultModelForFormatFromDef, r as ALL_PIPELINE_STEPS, s as getStep, t as localFrameRegistry, u as landmarkPrecisionVerdict } from "../local-frame-registry-DP5yyEWE.mjs";
 import { t as getSharp } from "../lazy-sharp-DXsqwpph.mjs";
 import { n as startEventLoopStallMonitor } from "../event-loop-stall-monitor-DXLNBMkY.mjs";
-import { n as pickNodePlatformArch, t as readProcessMemory } from "../process-memory-CnTmyk9s.mjs";
+import { n as pickNodePlatformArch, t as readProcessMemory } from "../process-memory-L6mHI28P.mjs";
 import * as fs from "node:fs";
 import * as path$1 from "node:path";
 import { dirname, join } from "node:path";

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

@@ -21542,6 +21542,33 @@ var RecentTracksQueryInput = object({
 	*/
 	classes: array(string()).optional()
 });
+/**
+* A Summary (D359): the per-camera session envelope that references tracks.
+* `groupShotKey` is the media key of its group shot (`ownerKind: 'summary'`,
+* served by the event-media plane by key), null until the first frame with a
+* member visible has been materialised.
+*/
+var SummarySchema = object({
+	id: string(),
+	deviceId: number(),
+	openedAt: number(),
+	lastActiveAt: number(),
+	sealedAt: number().nullable(),
+	memberCount: number().int().nonnegative(),
+	groupShotKey: string().nullable()
+});
+var SummariesQueryInput = object({
+	deviceIds: array(number()).min(1),
+	since: number().optional(),
+	until: number().optional(),
+	limit: number().int().min(1).max(200).default(50)
+});
+var SummariesPageSchema = object({ summaries: array(SummarySchema).readonly() });
+var SummaryDetailSchema = object({
+	summary: SummarySchema,
+	/** Member track ids, in absorption order. */
+	trackIds: array(string()).readonly()
+});
 var RecentTracksPageSchema = object({
 	/** Merged page, ordered by (`lastSeen` DESC, `trackId` DESC). */
 	tracks: array(TrackSchema).readonly(),
@@ -21942,7 +21969,7 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
 	* timeline would read as a camera that saw nothing.
 	*/
 	classes: array(string()).optional()
-}), array(TrackSchema).readonly()), method(RecentTracksQueryInput, RecentTracksPageSchema), method(object({ deviceId: number() }), _void(), {
+}), array(TrackSchema).readonly()), method(RecentTracksQueryInput, RecentTracksPageSchema), method(SummariesQueryInput, SummariesPageSchema), method(object({ id: string() }), SummaryDetailSchema.nullable()), method(object({ deviceId: number() }), _void(), {
 	kind: "mutation",
 	auth: "admin"
 }), method(DeviceEventQueryInput, array(MotionEventSchema).readonly()), method(ObjectEventQueryInput, array(ObjectEventSchema).readonly()), method(DeviceEventQueryInput, array(AudioEventSchema).readonly()), method(object({ deviceId: number() }), array(EventKindDescriptorSchema).readonly()), method(object({ deviceIds: array(number()).min(1).max(200) }), array(EventKindsForDeviceSchema).readonly()), method(object({
@@ -35592,6 +35619,12 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"pipelineAnalytics.getSummary": {
+		capName: "pipeline-analytics",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
 	"pipelineAnalytics.getTrack": {
 		capName: "pipeline-analytics",
 		capScope: "device",
@@ -35670,6 +35703,12 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"pipelineAnalytics.listSummaries": {
+		capName: "pipeline-analytics",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
 	"pipelineAnalytics.listTrackMedia": {
 		capName: "pipeline-analytics",
 		capScope: "device",
@@ -39365,6 +39404,11 @@ Object.freeze({
 		form: "array",
 		optional: true
 	}],
+	"pipelineAnalytics.listSummaries": [{
+		name: "deviceIds",
+		form: "array",
+		optional: false
+	}],
 	"pipelineAnalytics.listTrackMedia": [{
 		name: "deviceId",
 		form: "single",

package/dist/{dist-HWdaHLLK.mjs → dist-CxYG8IUX.mjs}

@@ -21519,6 +21519,33 @@ var RecentTracksQueryInput = object({
 	*/
 	classes: array(string()).optional()
 });
+/**
+* A Summary (D359): the per-camera session envelope that references tracks.
+* `groupShotKey` is the media key of its group shot (`ownerKind: 'summary'`,
+* served by the event-media plane by key), null until the first frame with a
+* member visible has been materialised.
+*/
+var SummarySchema = object({
+	id: string(),
+	deviceId: number(),
+	openedAt: number(),
+	lastActiveAt: number(),
+	sealedAt: number().nullable(),
+	memberCount: number().int().nonnegative(),
+	groupShotKey: string().nullable()
+});
+var SummariesQueryInput = object({
+	deviceIds: array(number()).min(1),
+	since: number().optional(),
+	until: number().optional(),
+	limit: number().int().min(1).max(200).default(50)
+});
+var SummariesPageSchema = object({ summaries: array(SummarySchema).readonly() });
+var SummaryDetailSchema = object({
+	summary: SummarySchema,
+	/** Member track ids, in absorption order. */
+	trackIds: array(string()).readonly()
+});
 var RecentTracksPageSchema = object({
 	/** Merged page, ordered by (`lastSeen` DESC, `trackId` DESC). */
 	tracks: array(TrackSchema).readonly(),
@@ -21919,7 +21946,7 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
 	* timeline would read as a camera that saw nothing.
 	*/
 	classes: array(string()).optional()
-}), array(TrackSchema).readonly()), method(RecentTracksQueryInput, RecentTracksPageSchema), method(object({ deviceId: number() }), _void(), {
+}), array(TrackSchema).readonly()), method(RecentTracksQueryInput, RecentTracksPageSchema), method(SummariesQueryInput, SummariesPageSchema), method(object({ id: string() }), SummaryDetailSchema.nullable()), method(object({ deviceId: number() }), _void(), {
 	kind: "mutation",
 	auth: "admin"
 }), method(DeviceEventQueryInput, array(MotionEventSchema).readonly()), method(ObjectEventQueryInput, array(ObjectEventSchema).readonly()), method(DeviceEventQueryInput, array(AudioEventSchema).readonly()), method(object({ deviceId: number() }), array(EventKindDescriptorSchema).readonly()), method(object({ deviceIds: array(number()).min(1).max(200) }), array(EventKindsForDeviceSchema).readonly()), method(object({
@@ -35569,6 +35596,12 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"pipelineAnalytics.getSummary": {
+		capName: "pipeline-analytics",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
 	"pipelineAnalytics.getTrack": {
 		capName: "pipeline-analytics",
 		capScope: "device",
@@ -35647,6 +35680,12 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"pipelineAnalytics.listSummaries": {
+		capName: "pipeline-analytics",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
 	"pipelineAnalytics.listTrackMedia": {
 		capName: "pipeline-analytics",
 		capScope: "device",
@@ -39342,6 +39381,11 @@ Object.freeze({
 		form: "array",
 		optional: true
 	}],
+	"pipelineAnalytics.listSummaries": [{
+		name: "deviceIds",
+		form: "array",
+		optional: false
+	}],
 	"pipelineAnalytics.listTrackMedia": [{
 		name: "deviceId",
 		form: "single",

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

@@ -1,4 +1,4 @@
-const require_dist = require("./dist-e2OKAUGI.js");
+const require_dist = require("./dist-CKr6Q6Qu.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-Cl1VUpx_.js → local-frame-registry-B4Bd4tnU.js}

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

package/dist/{local-frame-registry-Bki81rM0.mjs → local-frame-registry-DP5yyEWE.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-HWdaHLLK.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-CxYG8IUX.mjs";
 import { randomUUID } from "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-e2OKAUGI.js");
-const require_lazy_sharp = require("../lazy-sharp-AJ7newgl.js");
+const require_dist = require("../dist-CKr6Q6Qu.js");
+const require_lazy_sharp = require("../lazy-sharp-D-HdRPo5.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-HWdaHLLK.mjs";
+import { It as hydrateSchema, Pt as DeviceType, Y as evaluateZoneRules, it as motionDetectionCapability, jt as BaseAddon } from "../dist-CxYG8IUX.mjs";
 import { t as getSharp } from "../lazy-sharp-DXsqwpph.mjs";
 import { readFileSync } from "node:fs";
 import { join } from "node:path";

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

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

package/dist/{node-CwSBH-3M.mjs → node-DhccO0of.mjs}

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

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-e2OKAUGI.js");
-const require_node = require("../node-Dw6FrDFS.js");
-const require_local_frame_registry = require("../local-frame-registry-Cl1VUpx_.js");
-const require_worker_protocol = require("../worker-protocol-Bva8nEZO.js");
+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_hub_hostname = require("../hub-hostname-DAJXlOgV.js");
-const require_lazy_sharp = require("../lazy-sharp-AJ7newgl.js");
+const require_lazy_sharp = require("../lazy-sharp-D-HdRPo5.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");
@@ -301,6 +301,16 @@ var DEFAULT_NODE_DECODE_BUDGET_MB = 8192;
 * `native-lease-config.ts` on why "unset" includes a knob sitting at its
 * default); anything absent falls back to what the worker ships with.
 */
+/**
+* How many frames of one camera the runner may have in inference at once:
+* the worker's hold minus one, never below one. The hold evicts oldest-first
+* when a newer marked frame lands, so the (hold)th outstanding ref is the one
+* that makes the first unreadable. See `runner.ts` `maxInflightPerCamera`.
+*/
+function maxInflightPerCamera(override) {
+	const holdFrames = override.holdFrames ?? require_dist.DEFAULT_NATIVE_LEASE_SETTINGS.holdFrames;
+	return Math.max(1, holdFrames - 1);
+}
 function decodeWorkerFootprintMb(override) {
 	const budgetMb = override.budgetMb ?? require_dist.DEFAULT_NATIVE_LEASE_SETTINGS.budgetMb;
 	const holdFrames = override.holdFrames ?? require_dist.DEFAULT_NATIVE_LEASE_SETTINGS.holdFrames;
@@ -1535,7 +1545,7 @@ function startSessionDecodePump(deps) {
 						release: () => image.releaseNativeLease?.(),
 						markInferred: () => image.markInferred?.()
 					}) : void 0;
-					if (deps.frameRegistry && deps.onFrameRef) {
+					if (deps.frameRegistry && deps.onFrameRef && deps.inlineWhen?.() !== true) {
 						const capturedAt = Date.now();
 						const ref = deps.frameRegistry.register(image, {
 							timestamp: frame.timestamp,
@@ -4520,6 +4530,7 @@ var PipelineRunner = class {
 			detectionQueue,
 			inferenceTimes: [],
 			shedFrames: 0,
+			inflight: 0,
 			processedCount: 0,
 			startTime: Date.now(),
 			phase: initialPhase,
@@ -4617,6 +4628,33 @@ var PipelineRunner = class {
 	* {@link reserveDetectionFrame}. Kept separate so the ordinary public path
 	* cannot accidentally count one source frame twice.
 	*/
+	/**
+	* True when a frame enqueued NOW would wait for an inference slot before
+	* the executor reads its pixels — the window in which a lazy `frameRef` is
+	* a gamble on the worker's 8-slot hold. The detection queue keeps only the
+	* latest frame, so the queue can never be "deep": the semaphore is the one
+	* live signal (the shm passthrough reads the same one). Asked at enqueue
+	* time so the pump can copy the pixels while the frame is still reserved.
+	*/
+	detectionBackpressure(deviceId) {
+		const state = this.cameras.get(deviceId);
+		if (!state) return true;
+		return this.semaphore.available <= 0 || state.inflight >= this.maxInflightPerCamera();
+	}
+	/** The per-camera in-flight cap in force (config, else the shipped hold minus one). */
+	maxInflightPerCamera() {
+		return Math.max(1, this.config.maxInflightPerCamera ?? require_dist.DEFAULT_NATIVE_LEASE_SETTINGS.holdFrames - 1);
+	}
+	/**
+	* Follow a resized native-frame hold. Running inferences are untouched; the
+	* next pick is measured against the new cap.
+	*/
+	setMaxInflightPerCamera(cap) {
+		this.config = {
+			...this.config,
+			maxInflightPerCamera: cap
+		};
+	}
 	enqueueReservedDetectionFrame(deviceId, frame, handle) {
 		const state = this.cameras.get(deviceId);
 		if (!state || state.phase !== "active") return false;
@@ -4900,6 +4938,7 @@ var PipelineRunner = class {
 	async processWithSemaphore(deviceId, entry, frameInput, state, streamType) {
 		const pickedAt = Date.now();
 		const { frame, handle } = entry;
+		state.inflight += 1;
 		const enqueuedAt = frame._enqueuedAt ?? pickedAt;
 		const rawRelease = await this.semaphore.acquire();
 		let released = false;
@@ -4941,6 +4980,7 @@ var PipelineRunner = class {
 		} catch {
 			frameReleaseReason = "error";
 		} finally {
+			state.inflight -= 1;
 			release();
 			try {
 				if (frameReleaseReason === "success" && handle && isContinuousRetainEnabled()) await this.config.hydrateRetainedFrame?.(handle);
@@ -5040,7 +5080,7 @@ var PipelineRunner = class {
 		} catch {}
 	}
 	pickNextDetectionFrame() {
-		for (const [deviceId, state] of this.cameras) if (state.registration.detectionMode === "always-on" && state.detectionQueue.size > 0) return {
+		for (const [deviceId, state] of this.cameras) if (state.registration.detectionMode === "always-on" && state.detectionQueue.size > 0 && state.inflight < this.maxInflightPerCamera()) return {
 			deviceId,
 			entry: state.detectionQueue.dequeue(),
 			state
@@ -5053,7 +5093,7 @@ var PipelineRunner = class {
 			if (!deviceId) continue;
 			const state = this.cameras.get(deviceId);
 			if (!state) continue;
-			if (state.phase === "active" && state.detectionQueue.size > 0) {
+			if (state.phase === "active" && state.detectionQueue.size > 0 && state.inflight < this.maxInflightPerCamera()) {
 				this.defaultRoundRobinIndex = (idx + 1) % this.defaultRoundRobinKeys.length;
 				const entry = state.detectionQueue.dequeue();
 				if (!entry) continue;
@@ -5783,6 +5823,7 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends require_dist.BaseAdd
 		this.runner = new PipelineRunner({
 			maxQueueDepth: this.config.maxQueueDepth,
 			maxConcurrentInferences: this.config.maxConcurrentInferences,
+			maxInflightPerCamera: maxInflightPerCamera(this.nativeLease.current()),
 			targetLoadPercent: this.config.targetLoadPercent,
 			minThrottledFps: this.config.minThrottledFps,
 			processFrame: (deviceId, frame, handle) => this.runInference(deviceId, frame, handle),
@@ -5800,6 +5841,14 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends require_dist.BaseAdd
 		this.spawnGate = new Semaphore(Math.max(1, this.config.maxConcurrentDecodeSpawns));
 		const decodeLimits = this.resolvedNodeDecodeLimits();
 		this.lastAppliedDecodeLimits = decodeLimits;
+		this.ctx.logger.info("node decode limits in force", { meta: {
+			reason: "boot",
+			budgetMb: decodeLimits.budgetMb,
+			budgetSource: decodeLimits.budgetSource,
+			maxWorkers: decodeLimits.maxWorkers,
+			maxWorkersSource: decodeLimits.maxWorkersSource,
+			totalMemMb: Math.round(node_os.totalmem() / 1048576)
+		} });
 		this.liveWorkers = new LiveDecodeWorkerAdmission({
 			limit: decodeLimits.maxWorkers,
 			logger: this.ctx.logger,
@@ -7025,6 +7074,7 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends require_dist.BaseAdd
 	async refreshNativeLeaseSettings() {
 		await this.nativeLease.refresh(this.ctxIfReady?.api);
 		this.liveWorkers?.resizeFootprint(decodeWorkerFootprintMb(this.nativeLease.current()));
+		this.runner?.setMaxInflightPerCamera(maxInflightPerCamera(this.nativeLease.current()));
 		await this.nodeLimits?.refresh(this.ctxIfReady?.api);
 		this.applyNodeDecodeLimits("lease-refresh");
 	}
@@ -7733,6 +7783,8 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends require_dist.BaseAdd
 					},
 					...useLocalFrameRef ? {
 						frameRegistry: require_local_frame_registry.localFrameRegistry,
+						inlineWhen: () => runner.detectionBackpressure(config.deviceId),
+						inlineViewSpec: SPLIT_DETECTION_VIEW,
 						onFrameRef: async (frame, nativeCrop) => {
 							const current = reservation;
 							reservation = null;
@@ -8415,6 +8467,8 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends require_dist.BaseAdd
 					},
 					...useLocalFrameRef ? {
 						frameRegistry: require_local_frame_registry.localFrameRegistry,
+						inlineWhen: () => runner.detectionBackpressure(config.deviceId),
+						inlineViewSpec: SPLIT_DETECTION_VIEW,
 						onFrameRef: (frame, nativeCrop) => {
 							if (settled) return false;
 							const handle = writeRetainedDetectionFrame(retainedFrames, config.deviceId, frame, this.retention);

package/dist/pipeline-runner/index.mjs

@@ -1,7 +1,7 @@
-import { B as defineCustomActions, Bt as nodePin, Ft as createEvent, Gt as _enum, H as deriveDetailCropRect, Kt as array, L as customAction, Qt as object, X as failureContributionCapability, Xt as literal, Yt as lazy, Zt as number, _ as FailureCounters, en as string, et as loadContributionCapability, ft as pipelineRunnerCapability, jt as BaseAddon, lt as pickDetailCropConvention, m as DEVICE_BACKEND_TO_FORMAT, nn as EventCategory, p as DEFAULT_NATIVE_LEASE_SETTINGS, qt as boolean, u as DEFAULT_DETAIL_CROP_CONVENTION, ut as pickNativeLeaseOverride, wt as errMsg } from "../dist-HWdaHLLK.mjs";
-import { i as NO_COST_CLAIM, t as ChildCostRegistry } from "../node-CwSBH-3M.mjs";
-import { c as getStepDefinition, n as resolveFrameViewGeometry, t as localFrameRegistry } from "../local-frame-registry-Bki81rM0.mjs";
-import { a as nativeLeaseSettingEnv, t as isWorkerReply } from "../worker-protocol-DN1y2Vyk.mjs";
+import { B as defineCustomActions, Bt as nodePin, Ft as createEvent, Gt as _enum, H as deriveDetailCropRect, Kt as array, L as customAction, Qt as object, X as failureContributionCapability, Xt as literal, Yt as lazy, Zt as number, _ as FailureCounters, en as string, et as loadContributionCapability, ft as pipelineRunnerCapability, jt as BaseAddon, lt as pickDetailCropConvention, m as DEVICE_BACKEND_TO_FORMAT, nn as EventCategory, p as DEFAULT_NATIVE_LEASE_SETTINGS, qt as boolean, u as DEFAULT_DETAIL_CROP_CONVENTION, ut as pickNativeLeaseOverride, wt as errMsg } from "../dist-CxYG8IUX.mjs";
+import { i as NO_COST_CLAIM, t as ChildCostRegistry } from "../node-DhccO0of.mjs";
+import { c as getStepDefinition, n as resolveFrameViewGeometry, t as localFrameRegistry } from "../local-frame-registry-DP5yyEWE.mjs";
+import { a as nativeLeaseSettingEnv, t as isWorkerReply } from "../worker-protocol-Br-omhiX.mjs";
 import { t as resolveHubHostname } from "../hub-hostname-cCknRYKj.mjs";
 import { t as getSharp } from "../lazy-sharp-DXsqwpph.mjs";
 import { n as withDetectionIntent } from "../restream-intent-B4BXZra7.mjs";
@@ -295,6 +295,16 @@ var DEFAULT_NODE_DECODE_BUDGET_MB = 8192;
 * `native-lease-config.ts` on why "unset" includes a knob sitting at its
 * default); anything absent falls back to what the worker ships with.
 */
+/**
+* How many frames of one camera the runner may have in inference at once:
+* the worker's hold minus one, never below one. The hold evicts oldest-first
+* when a newer marked frame lands, so the (hold)th outstanding ref is the one
+* that makes the first unreadable. See `runner.ts` `maxInflightPerCamera`.
+*/
+function maxInflightPerCamera(override) {
+	const holdFrames = override.holdFrames ?? DEFAULT_NATIVE_LEASE_SETTINGS.holdFrames;
+	return Math.max(1, holdFrames - 1);
+}
 function decodeWorkerFootprintMb(override) {
 	const budgetMb = override.budgetMb ?? DEFAULT_NATIVE_LEASE_SETTINGS.budgetMb;
 	const holdFrames = override.holdFrames ?? DEFAULT_NATIVE_LEASE_SETTINGS.holdFrames;
@@ -1529,7 +1539,7 @@ function startSessionDecodePump(deps) {
 						release: () => image.releaseNativeLease?.(),
 						markInferred: () => image.markInferred?.()
 					}) : void 0;
-					if (deps.frameRegistry && deps.onFrameRef) {
+					if (deps.frameRegistry && deps.onFrameRef && deps.inlineWhen?.() !== true) {
 						const capturedAt = Date.now();
 						const ref = deps.frameRegistry.register(image, {
 							timestamp: frame.timestamp,
@@ -4513,6 +4523,7 @@ var PipelineRunner = class {
 			detectionQueue,
 			inferenceTimes: [],
 			shedFrames: 0,
+			inflight: 0,
 			processedCount: 0,
 			startTime: Date.now(),
 			phase: initialPhase,
@@ -4610,6 +4621,33 @@ var PipelineRunner = class {
 	* {@link reserveDetectionFrame}. Kept separate so the ordinary public path
 	* cannot accidentally count one source frame twice.
 	*/
+	/**
+	* True when a frame enqueued NOW would wait for an inference slot before
+	* the executor reads its pixels — the window in which a lazy `frameRef` is
+	* a gamble on the worker's 8-slot hold. The detection queue keeps only the
+	* latest frame, so the queue can never be "deep": the semaphore is the one
+	* live signal (the shm passthrough reads the same one). Asked at enqueue
+	* time so the pump can copy the pixels while the frame is still reserved.
+	*/
+	detectionBackpressure(deviceId) {
+		const state = this.cameras.get(deviceId);
+		if (!state) return true;
+		return this.semaphore.available <= 0 || state.inflight >= this.maxInflightPerCamera();
+	}
+	/** The per-camera in-flight cap in force (config, else the shipped hold minus one). */
+	maxInflightPerCamera() {
+		return Math.max(1, this.config.maxInflightPerCamera ?? DEFAULT_NATIVE_LEASE_SETTINGS.holdFrames - 1);
+	}
+	/**
+	* Follow a resized native-frame hold. Running inferences are untouched; the
+	* next pick is measured against the new cap.
+	*/
+	setMaxInflightPerCamera(cap) {
+		this.config = {
+			...this.config,
+			maxInflightPerCamera: cap
+		};
+	}
 	enqueueReservedDetectionFrame(deviceId, frame, handle) {
 		const state = this.cameras.get(deviceId);
 		if (!state || state.phase !== "active") return false;
@@ -4893,6 +4931,7 @@ var PipelineRunner = class {
 	async processWithSemaphore(deviceId, entry, frameInput, state, streamType) {
 		const pickedAt = Date.now();
 		const { frame, handle } = entry;
+		state.inflight += 1;
 		const enqueuedAt = frame._enqueuedAt ?? pickedAt;
 		const rawRelease = await this.semaphore.acquire();
 		let released = false;
@@ -4934,6 +4973,7 @@ var PipelineRunner = class {
 		} catch {
 			frameReleaseReason = "error";
 		} finally {
+			state.inflight -= 1;
 			release();
 			try {
 				if (frameReleaseReason === "success" && handle && isContinuousRetainEnabled()) await this.config.hydrateRetainedFrame?.(handle);
@@ -5033,7 +5073,7 @@ var PipelineRunner = class {
 		} catch {}
 	}
 	pickNextDetectionFrame() {
-		for (const [deviceId, state] of this.cameras) if (state.registration.detectionMode === "always-on" && state.detectionQueue.size > 0) return {
+		for (const [deviceId, state] of this.cameras) if (state.registration.detectionMode === "always-on" && state.detectionQueue.size > 0 && state.inflight < this.maxInflightPerCamera()) return {
 			deviceId,
 			entry: state.detectionQueue.dequeue(),
 			state
@@ -5046,7 +5086,7 @@ var PipelineRunner = class {
 			if (!deviceId) continue;
 			const state = this.cameras.get(deviceId);
 			if (!state) continue;
-			if (state.phase === "active" && state.detectionQueue.size > 0) {
+			if (state.phase === "active" && state.detectionQueue.size > 0 && state.inflight < this.maxInflightPerCamera()) {
 				this.defaultRoundRobinIndex = (idx + 1) % this.defaultRoundRobinKeys.length;
 				const entry = state.detectionQueue.dequeue();
 				if (!entry) continue;
@@ -5776,6 +5816,7 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends BaseAddon {
 		this.runner = new PipelineRunner({
 			maxQueueDepth: this.config.maxQueueDepth,
 			maxConcurrentInferences: this.config.maxConcurrentInferences,
+			maxInflightPerCamera: maxInflightPerCamera(this.nativeLease.current()),
 			targetLoadPercent: this.config.targetLoadPercent,
 			minThrottledFps: this.config.minThrottledFps,
 			processFrame: (deviceId, frame, handle) => this.runInference(deviceId, frame, handle),
@@ -5793,6 +5834,14 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends BaseAddon {
 		this.spawnGate = new Semaphore(Math.max(1, this.config.maxConcurrentDecodeSpawns));
 		const decodeLimits = this.resolvedNodeDecodeLimits();
 		this.lastAppliedDecodeLimits = decodeLimits;
+		this.ctx.logger.info("node decode limits in force", { meta: {
+			reason: "boot",
+			budgetMb: decodeLimits.budgetMb,
+			budgetSource: decodeLimits.budgetSource,
+			maxWorkers: decodeLimits.maxWorkers,
+			maxWorkersSource: decodeLimits.maxWorkersSource,
+			totalMemMb: Math.round(os.totalmem() / 1048576)
+		} });
 		this.liveWorkers = new LiveDecodeWorkerAdmission({
 			limit: decodeLimits.maxWorkers,
 			logger: this.ctx.logger,
@@ -7018,6 +7067,7 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends BaseAddon {
 	async refreshNativeLeaseSettings() {
 		await this.nativeLease.refresh(this.ctxIfReady?.api);
 		this.liveWorkers?.resizeFootprint(decodeWorkerFootprintMb(this.nativeLease.current()));
+		this.runner?.setMaxInflightPerCamera(maxInflightPerCamera(this.nativeLease.current()));
 		await this.nodeLimits?.refresh(this.ctxIfReady?.api);
 		this.applyNodeDecodeLimits("lease-refresh");
 	}
@@ -7726,6 +7776,8 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends BaseAddon {
 					},
 					...useLocalFrameRef ? {
 						frameRegistry: localFrameRegistry,
+						inlineWhen: () => runner.detectionBackpressure(config.deviceId),
+						inlineViewSpec: SPLIT_DETECTION_VIEW,
 						onFrameRef: async (frame, nativeCrop) => {
 							const current = reservation;
 							reservation = null;
@@ -8408,6 +8460,8 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends BaseAddon {
 					},
 					...useLocalFrameRef ? {
 						frameRegistry: localFrameRegistry,
+						inlineWhen: () => runner.detectionBackpressure(config.deviceId),
+						inlineViewSpec: SPLIT_DETECTION_VIEW,
 						onFrameRef: (frame, nativeCrop) => {
 							if (settled) return false;
 							const handle = writeRetainedDetectionFrame(retainedFrames, config.deviceId, frame, this.retention);

package/dist/{process-memory-einpgBTr.js → process-memory-BW7XFoPY.js}

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

package/dist/{process-memory-CnTmyk9s.mjs → process-memory-L6mHI28P.mjs}

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

package/dist/recorder/index.js

@@ -2,8 +2,8 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_dist = require("../dist-e2OKAUGI.js");
-const require_node = require("../node-Dw6FrDFS.js");
+const require_dist = require("../dist-CKr6Q6Qu.js");
+const require_node = require("../node-CmRTB9W4.js");
 const require_hub_hostname = require("../hub-hostname-DAJXlOgV.js");
 const require_restream_intent = require("../restream-intent-Cv9x3jmu.js");
 const require_event_loop_stall_monitor = require("../event-loop-stall-monitor-DaUBcb13.js");
@@ -10329,6 +10329,7 @@ Object.freeze({
 		"getObjectEvents": { "limit": 1e3 },
 		"getSensorEvents": { "limit": 1e3 },
 		"listRecentTracks": { "limit": 200 },
+		"listSummaries": { "limit": 50 },
 		"reclaimDebugMedia": { "mode": "report" },
 		"searchObjectEvents": {
 			"limit": 50,