@camstack/addon-pipeline 1.2.186 → 1.2.187

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-e2OKAUGI.js");
+const require_process_memory = require("../process-memory-einpgBTr.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-HWdaHLLK.mjs";
+import { n as pickNodePlatformArch, t as readProcessMemory } from "../process-memory-CnTmyk9s.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-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_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-einpgBTr.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-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 { 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-CnTmyk9s.mjs";
 import * as fs from "node:fs";
 import * as path$1 from "node:path";
 import { dirname, join } from "node:path";

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

@@ -22996,6 +22996,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 +23465,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()
@@ -36190,6 +36205,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",

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

@@ -23019,6 +23019,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 +23488,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()
@@ -36213,6 +36228,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",

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

@@ -1,4 +1,4 @@
-const require_dist = require("./dist-CiVhPNTB.js");
+const require_dist = require("./dist-e2OKAUGI.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-CANBpRSg.mjs → local-frame-registry-Bki81rM0.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-HWdaHLLK.mjs";
 import { randomUUID } from "node:crypto";
 //#region src/detection-pipeline/registry/model-catalogs.ts
 var HF_REPO = "camstack/camstack-models";

package/dist/{local-frame-registry-D5d1W1Vf.js → local-frame-registry-Cl1VUpx_.js}

@@ -1,4 +1,4 @@
-const require_dist = require("./dist-CiVhPNTB.js");
+const require_dist = require("./dist-e2OKAUGI.js");
 let node_crypto = require("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-e2OKAUGI.js");
+const require_lazy_sharp = require("../lazy-sharp-AJ7newgl.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-HWdaHLLK.mjs";
 import { t as getSharp } from "../lazy-sharp-DXsqwpph.mjs";
 import { readFileSync } from "node:fs";
 import { join } from "node:path";

package/dist/{node-CCRb0fqW.mjs → node-CwSBH-3M.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-HWdaHLLK.mjs";
 import { randomUUID } from "node:crypto";
 import "node:fs";
 import "node:path";

package/dist/{node-DGzZLg-c.js → node-Dw6FrDFS.js}

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

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-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_hub_hostname = require("../hub-hostname-DAJXlOgV.js");
-const require_lazy_sharp = require("../lazy-sharp-D1PX1Psd.js");
+const require_lazy_sharp = require("../lazy-sharp-AJ7newgl.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");
@@ -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. */
@@ -5652,6 +5761,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 +5798,12 @@ 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.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 +7025,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() {
@@ -8456,7 +8613,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 +8626,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,

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-yaetDPpW.mjs";
-import { i as NO_COST_CLAIM, t as ChildCostRegistry } from "../node-CCRb0fqW.mjs";
-import { c as getStepDefinition, n as resolveFrameViewGeometry, t as localFrameRegistry } from "../local-frame-registry-CANBpRSg.mjs";
-import { a as nativeLeaseSettingEnv, t as isWorkerReply } from "../worker-protocol-BcKW7xgG.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-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 { 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";
@@ -3374,6 +3374,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. */
@@ -5645,6 +5754,13 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends BaseAddon {
 	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"),
@@ -5675,10 +5791,12 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends BaseAddon {
 			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.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"));
@@ -6900,6 +7018,45 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends BaseAddon {
 	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(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(os.totalmem() / 1048576),
+			decodeCeilingInForce: this.liveWorkers?.ceiling
+		} });
 	}
 	/** A warn sink that survives a not-yet-ready ctx (boot-order dispatches). */
 	detailSubtreeLogger() {
@@ -8449,7 +8606,7 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends BaseAddon {
 					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,
@@ -8462,8 +8619,7 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends BaseAddon {
 	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,

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

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