@camstack/addon-pipeline 1.2.186 → 1.2.188

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-CiVhPNTB.js");
-const require_process_memory = require("../process-memory-C7f66zUT.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-yaetDPpW.mjs";
-import { n as pickNodePlatformArch, t as readProcessMemory } from "../process-memory-BIy4e_mZ.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-CiVhPNTB.js");
-const require_node = require("../node-DGzZLg-c.js");
-const require_local_frame_registry = require("../local-frame-registry-D5d1W1Vf.js");
-const require_lazy_sharp = require("../lazy-sharp-D1PX1Psd.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-C7f66zUT.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-yaetDPpW.mjs";
-import { a as readProcessCost } from "../node-CCRb0fqW.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-CANBpRSg.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-BIy4e_mZ.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-CiVhPNTB.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({
@@ -23019,6 +23046,14 @@ var AgentPipelineSettingsSchema = object({
 	/** Node is eligible to be the ingest / source-owner (serve the restream). */
 	ingest: boolean().optional(),
 	/**
+	* This node's decode RAM budget, MB. Wins over the cluster
+	* `nodeDecodeBudgetMb`; absent, the runner derives a share of the node's
+	* own RAM unless the operator moved the cluster value (D365).
+	*/
+	decodeBudgetMb: number().int().min(1024).max(65536).optional(),
+	/** This node's live decode-worker cap. Wins over the cluster `maxLiveDecodeWorkers`. */
+	maxLiveDecodeWorkers: number().int().min(1).max(32).optional(),
+	/**
 	* Operator override for the LAN host a cross-node decoder dials to reach
 	* THIS node's restream (Cluster UI). Absent → auto-detect: a remote runner
 	* falls back to its `CAMSTACK_HUB_URL`-derived host (the Moleculer address
@@ -23480,6 +23515,13 @@ method(StorageMigrationLeaseInputSchema, object({ paused: literal(true) }), {
 }), object({ success: literal(true) }), {
 	kind: "mutation",
 	auth: "admin"
+}), method(object({
+	agentNodeId: string(),
+	decodeBudgetMb: number().int().min(1024).max(65536).nullable().optional(),
+	maxLiveDecodeWorkers: number().int().min(1).max(32).nullable().optional()
+}), object({ success: literal(true) }), {
+	kind: "mutation",
+	auth: "admin"
 }), method(object({
 	agentNodeId: string(),
 	reachableHost: string().nullable()
@@ -35577,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",
@@ -35655,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",
@@ -36213,6 +36267,12 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"pipelineOrchestrator.setAgentDecodeLimits": {
+		capName: "pipeline-orchestrator",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"pipelineOrchestrator.setAgentDetectWeight": {
 		capName: "pipeline-orchestrator",
 		capScope: "system",
@@ -39344,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-yaetDPpW.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({
@@ -22996,6 +23023,14 @@ var AgentPipelineSettingsSchema = object({
 	/** Node is eligible to be the ingest / source-owner (serve the restream). */
 	ingest: boolean().optional(),
 	/**
+	* This node's decode RAM budget, MB. Wins over the cluster
+	* `nodeDecodeBudgetMb`; absent, the runner derives a share of the node's
+	* own RAM unless the operator moved the cluster value (D365).
+	*/
+	decodeBudgetMb: number().int().min(1024).max(65536).optional(),
+	/** This node's live decode-worker cap. Wins over the cluster `maxLiveDecodeWorkers`. */
+	maxLiveDecodeWorkers: number().int().min(1).max(32).optional(),
+	/**
 	* Operator override for the LAN host a cross-node decoder dials to reach
 	* THIS node's restream (Cluster UI). Absent → auto-detect: a remote runner
 	* falls back to its `CAMSTACK_HUB_URL`-derived host (the Moleculer address
@@ -23457,6 +23492,13 @@ method(StorageMigrationLeaseInputSchema, object({ paused: literal(true) }), {
 }), object({ success: literal(true) }), {
 	kind: "mutation",
 	auth: "admin"
+}), method(object({
+	agentNodeId: string(),
+	decodeBudgetMb: number().int().min(1024).max(65536).nullable().optional(),
+	maxLiveDecodeWorkers: number().int().min(1).max(32).nullable().optional()
+}), object({ success: literal(true) }), {
+	kind: "mutation",
+	auth: "admin"
 }), method(object({
 	agentNodeId: string(),
 	reachableHost: string().nullable()
@@ -35554,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",
@@ -35632,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",
@@ -36190,6 +36244,12 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"pipelineOrchestrator.setAgentDecodeLimits": {
+		capName: "pipeline-orchestrator",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"pipelineOrchestrator.setAgentDetectWeight": {
 		capName: "pipeline-orchestrator",
 		capScope: "system",
@@ -39321,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-D1PX1Psd.js → lazy-sharp-D-HdRPo5.js}

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

@@ -1,4 +1,4 @@
-const require_dist = require("./dist-CiVhPNTB.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-CANBpRSg.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-yaetDPpW.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-CiVhPNTB.js");
-const require_lazy_sharp = require("../lazy-sharp-D1PX1Psd.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-yaetDPpW.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-DGzZLg-c.js → node-CmRTB9W4.js}

@@ -1,4 +1,4 @@
-const require_dist = require("./dist-CiVhPNTB.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-CCRb0fqW.mjs → node-DhccO0of.mjs}

@@ -1,4 +1,4 @@
-import { Dt as buildFfmpegArgs, Et as Fmp4BoxSplitter, kt as isSoftwareDecode, wt as errMsg } from "./dist-yaetDPpW.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-CiVhPNTB.js");
-const require_node = require("../node-DGzZLg-c.js");
-const require_local_frame_registry = require("../local-frame-registry-D5d1W1Vf.js");
-const require_worker_protocol = require("../worker-protocol-Db6BWHr-.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-D1PX1Psd.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");
@@ -1535,7 +1535,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,
@@ -3381,6 +3381,115 @@ var NativeLeaseSettingsSource = class {
 		}
 	}
 };
+function pickLimits(settings) {
+	if (settings === null) return {};
+	const budget = settings.decodeBudgetMb;
+	const workers = settings.maxLiveDecodeWorkers;
+	return {
+		...typeof budget === "number" && Number.isFinite(budget) ? { decodeBudgetMb: budget } : {},
+		...typeof workers === "number" && Number.isFinite(workers) ? { maxLiveDecodeWorkers: workers } : {}
+	};
+}
+function sameLimits(a, b) {
+	return a.decodeBudgetMb === b.decodeBudgetMb && a.maxLiveDecodeWorkers === b.maxLiveDecodeWorkers;
+}
+var NodeDecodeLimitsSource = class {
+	limits = {};
+	lastReadAtMs = Number.NEGATIVE_INFINITY;
+	inFlight = null;
+	logger;
+	nodeId;
+	now;
+	ttlMs;
+	constructor(options) {
+		this.logger = options.logger;
+		this.nodeId = options.nodeId;
+		this.now = options.now ?? (() => Date.now());
+		this.ttlMs = options.ttlMs ?? 3e4;
+	}
+	current() {
+		return this.limits;
+	}
+	async refresh(api) {
+		if (api === void 0) return this.limits;
+		if (this.now() - this.lastReadAtMs < this.ttlMs) return this.limits;
+		this.inFlight ??= this.read(api).finally(() => {
+			this.inFlight = null;
+		});
+		await this.inFlight;
+		return this.limits;
+	}
+	async read(api) {
+		try {
+			const next = pickLimits(await api.pipelineOrchestrator.getAgentSettings.query({ agentNodeId: this.nodeId }));
+			this.lastReadAtMs = this.now();
+			if (sameLimits(next, this.limits)) return;
+			this.logger.info("node decode limits changed — the admission resizes on the next dial", { meta: {
+				nodeId: this.nodeId,
+				from: { ...this.limits },
+				to: { ...next }
+			} });
+			this.limits = next;
+		} catch (err) {
+			this.logger.warn("node decode limits read failed — keeping the last known value", { meta: {
+				nodeId: this.nodeId,
+				inUse: { ...this.limits },
+				error: err instanceof Error ? err.message : String(err)
+			} });
+		}
+	}
+};
+//#endregion
+//#region src/session-decode/node-decode-budget.ts
+/**
+* The decode RAM budget and worker cap THIS node runs under.
+*
+* `nodeDecodeBudgetMb` and `maxLiveDecodeWorkers` are cluster settings — one
+* number for a 64 GB hub and a 16 GB Mac alike. Until 2026-09-05 the shipped
+* 8192 MB was the hub's number applied everywhere; with the footprint fixed
+* (D361) that admits 8 workers on the Mac, whose workers measure RSS p90
+* 952 MB on a machine already at 80% — 7.6 GB of decode on 16 GB is a swap
+* away from a stall — while the hub leaves 56 GB idle.
+*
+* Three sources, in order, and the winner is NAMED so a log line can say why:
+*  1. the node's own agent setting (`decodeBudgetMb` / `maxLiveDecodeWorkers`
+*     in `AgentPipelineSettings`) — the operator sized this node;
+*  2. the cluster setting when the operator MOVED it off the shipped default
+*     (a value equal to the default reads as "nobody chose", the same rule the
+*     native-lease knobs use, `readKnob`);
+*  3. otherwise a share of the node's RAM, clamped — the shipped default
+*     becomes a per-node derivation instead of the hub's number.
+*/
+var DECODE_BUDGET_RAM_SHARE = .5;
+var DECODE_BUDGET_MIN_MB = 2048;
+var DECODE_BUDGET_MAX_MB = 16384;
+function derivedDecodeBudgetMb(totalMemMb) {
+	const share = Math.round(totalMemMb * DECODE_BUDGET_RAM_SHARE);
+	return Math.max(DECODE_BUDGET_MIN_MB, Math.min(DECODE_BUDGET_MAX_MB, share));
+}
+function resolveNodeDecodeLimits(input) {
+	const budget = input.node.decodeBudgetMb !== void 0 ? {
+		budgetMb: input.node.decodeBudgetMb,
+		budgetSource: "node"
+	} : input.clusterBudgetMb !== input.defaultBudgetMb ? {
+		budgetMb: input.clusterBudgetMb,
+		budgetSource: "cluster"
+	} : {
+		budgetMb: derivedDecodeBudgetMb(input.totalMemMb),
+		budgetSource: "derived"
+	};
+	const workers = input.node.maxLiveDecodeWorkers !== void 0 ? {
+		maxWorkers: input.node.maxLiveDecodeWorkers,
+		maxWorkersSource: "node"
+	} : {
+		maxWorkers: input.clusterMaxWorkers,
+		maxWorkersSource: "cluster"
+	};
+	return {
+		...budget,
+		...workers
+	};
+}
 //#endregion
 //#region src/session-decode/on-demand-jpeg-fallback.ts
 /** Single content-sized JPEG requested after a detection, never a continuous raw. */
@@ -4508,6 +4617,18 @@ 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) {
+		if (!this.cameras.has(deviceId)) return true;
+		return this.semaphore.available <= 0;
+	}
 	enqueueReservedDetectionFrame(deviceId, frame, handle) {
 		const state = this.cameras.get(deviceId);
 		if (!state || state.phase !== "active") return false;
@@ -5652,6 +5773,13 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends require_dist.BaseAdd
 	async onInitialize() {
 		const raw = this.ctx.kernel.localNodeId ?? this.ctx.id;
 		this.nodeId = raw.includes("/") ? raw.split("/")[0] : raw;
+		this.nodeLimits = new NodeDecodeLimitsSource({
+			logger: {
+				info: (message, extras) => this.ctxIfReady?.logger.info(message, extras),
+				warn: (message, extras) => this.ctxIfReady?.logger.warn(message, extras)
+			},
+			nodeId: this.nodeId
+		});
 		this.retainedFrames = new RetainedFrameStore({
 			nodeId: this.nodeId,
 			logger: this.ctx.logger.child("retained-frames"),
@@ -5682,10 +5810,20 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends require_dist.BaseAdd
 			noteInferenceOutcome: (deviceId, reason) => this.failureReport.noteInference(deviceId, reason)
 		});
 		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: this.config.maxLiveDecodeWorkers,
+			limit: decodeLimits.maxWorkers,
 			logger: this.ctx.logger,
-			nodeBudgetMb: this.config.nodeDecodeBudgetMb,
+			nodeBudgetMb: decodeLimits.budgetMb,
 			workerFootprintMb: decodeWorkerFootprintMb(this.nativeLease.current())
 		});
 		this.runner.timingSampler.setLogger(this.ctx.logger.child("timing"));
@@ -6907,6 +7045,45 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends require_dist.BaseAdd
 	async refreshNativeLeaseSettings() {
 		await this.nativeLease.refresh(this.ctxIfReady?.api);
 		this.liveWorkers?.resizeFootprint(decodeWorkerFootprintMb(this.nativeLease.current()));
+		await this.nodeLimits?.refresh(this.ctxIfReady?.api);
+		this.applyNodeDecodeLimits("lease-refresh");
+	}
+	nodeLimits = null;
+	lastAppliedDecodeLimits = null;
+	/**
+	* The budget and worker cap THIS node runs under (D365): its own agent
+	* setting, else the cluster value the operator moved, else a share of its
+	* RAM. One resolver for construction, the lease refresh and a settings
+	* change — computing it in two places is how the count and the budget
+	* drifted apart before.
+	*/
+	resolvedNodeDecodeLimits() {
+		return resolveNodeDecodeLimits({
+			clusterBudgetMb: this.config.nodeDecodeBudgetMb,
+			clusterMaxWorkers: this.config.maxLiveDecodeWorkers,
+			defaultBudgetMb: DEFAULT_CONFIG.nodeDecodeBudgetMb,
+			defaultMaxWorkers: DEFAULT_CONFIG.maxLiveDecodeWorkers,
+			node: this.nodeLimits?.current() ?? {},
+			totalMemMb: Math.round(node_os.totalmem() / 1048576)
+		});
+	}
+	/** Resize the admission to the resolved limits; one info line per change. */
+	applyNodeDecodeLimits(reason) {
+		const limits = this.resolvedNodeDecodeLimits();
+		const last = this.lastAppliedDecodeLimits;
+		this.liveWorkers?.resize(limits.maxWorkers);
+		this.liveWorkers?.resizeBudget(limits.budgetMb);
+		if (last !== null && last.budgetMb === limits.budgetMb && last.maxWorkers === limits.maxWorkers && last.budgetSource === limits.budgetSource) return;
+		this.lastAppliedDecodeLimits = limits;
+		this.ctxIfReady?.logger.info("node decode limits in force", { meta: {
+			reason,
+			budgetMb: limits.budgetMb,
+			budgetSource: limits.budgetSource,
+			maxWorkers: limits.maxWorkers,
+			maxWorkersSource: limits.maxWorkersSource,
+			totalMemMb: Math.round(node_os.totalmem() / 1048576),
+			decodeCeilingInForce: this.liveWorkers?.ceiling
+		} });
 	}
 	/** A warn sink that survives a not-yet-ready ctx (boot-order dispatches). */
 	detailSubtreeLogger() {
@@ -7576,6 +7753,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;
@@ -8258,6 +8437,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);
@@ -8456,7 +8637,7 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends require_dist.BaseAdd
 					type: "slider",
 					key: "nodeDecodeBudgetMb",
 					label: "Decode worker RAM budget (MB)",
-					description: "RAM this node lets live decode workers commit. The number of workers admitted is derived from it: budget divided by one worker's worst case — what the lease store can hold (the smaller of the lease budget and held frames × 25 MB, one 4K frame), plus the tile and scene budgets, plus ~350 MB of baseline. At the shipped lease knobs (8 held frames) that is ~660 MB and the default admits 8, the count cap. Raising held frames or the lease budget per worker therefore LOWERS how many run at once, instead of silently authorising more memory.",
+					description: "Cluster-wide fallback for the RAM a node lets live decode workers commit. Each node resolves its own number: its agent setting (decodeBudgetMb) wins; otherwise this value when moved off the default; otherwise half the node's RAM (2-16 GB). The number of workers admitted is derived from it: budget divided by one worker's worst case — what the lease store can hold (the smaller of the lease budget and held frames × 25 MB, one 4K frame), plus the tile and scene budgets, plus ~350 MB of baseline, ~660 MB at the shipped knobs. Raising held frames or the lease budget per worker therefore LOWERS how many run at once, instead of silently authorising more memory.",
 					min: 1024,
 					max: 32768,
 					step: 512,
@@ -8469,8 +8650,7 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends require_dist.BaseAdd
 	async onConfigChanged() {
 		this.runner?.updateLimits(this.config);
 		this.spawnGate?.resize(Math.max(1, this.config.maxConcurrentDecodeSpawns));
-		this.liveWorkers?.resize(this.config.maxLiveDecodeWorkers);
-		this.liveWorkers?.resizeBudget(this.config.nodeDecodeBudgetMb);
+		this.applyNodeDecodeLimits("settings");
 		this.ctx.logger.info("pipeline-runner tuning updated", { meta: {
 			maxQueueDepth: this.config.maxQueueDepth,
 			maxConcurrentInferences: this.config.maxConcurrentInferences,