@camstack/addon-pipeline 1.1.32 → 1.1.34

package/dist/{dist-DjuGmyG9.mjs → dist-CfSORkv2.mjs}

@@ -16328,7 +16328,17 @@ var AgentAddonConfigSchema = object({
 });
 var AgentPipelineSettingsSchema = object({
 	addonDefaults: record(string(), AgentAddonConfigSchema).readonly(),
-	maxCameras: number().int().nonnegative().nullable().default(null)
+	maxCameras: number().int().nonnegative().nullable().default(null),
+	/** Per-node detection weight (relative share for the quota balancer). */
+	detectWeight: number().positive().optional(),
+	/** Node is eligible to run the detection pipeline (decode + inference). */
+	detect: boolean().optional(),
+	/** Node is eligible to host decoder sessions. */
+	decode: boolean().optional(),
+	/** Node is eligible to run audio-analyzer sessions. */
+	audio: boolean().optional(),
+	/** Node is eligible to be the ingest / source-owner (serve the restream). */
+	ingest: boolean().optional()
 });
 var CameraPipelineForAgentSchema = object({
 	steps: array(PipelineStepInputSchema).readonly(),
@@ -16634,6 +16644,21 @@ method(object({
 }), object({ success: literal(true) }), {
 	kind: "mutation",
 	auth: "admin"
+}), method(object({
+	agentNodeId: string(),
+	detectWeight: number().positive().nullable()
+}), object({ success: literal(true) }), {
+	kind: "mutation",
+	auth: "admin"
+}), method(object({
+	agentNodeId: string(),
+	detect: boolean().nullable().optional(),
+	decode: boolean().nullable().optional(),
+	audio: boolean().nullable().optional(),
+	ingest: boolean().nullable().optional()
+}), object({ success: literal(true) }), {
+	kind: "mutation",
+	auth: "admin"
 }), method(object({ deviceId: number() }), CameraPipelineSettingsSchema.nullable()), method(object({
 	deviceId: number(),
 	addonId: string(),
@@ -22621,6 +22646,18 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"pipelineOrchestrator.setAgentCapabilities": {
+		capName: "pipeline-orchestrator",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
+	"pipelineOrchestrator.setAgentDetectWeight": {
+		capName: "pipeline-orchestrator",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"pipelineOrchestrator.setAgentMaxCameras": {
 		capName: "pipeline-orchestrator",
 		capScope: "system",

package/dist/{ffmpeg-args-C5GPp8Cw.mjs → ffmpeg-args-CpeRWwL4.mjs}

@@ -194,6 +194,12 @@ function buildFfmpegDecodeArgs(config, options) {
 		"-i",
 		"pipe:0"
 	];
+	const probeArgs = options.inputUrl !== void 0 ? [] : [
+		"-probesize",
+		"1M",
+		"-analyzeduration",
+		"0"
+	];
 	return [
 		...logBannerArgs("info"),
 		"-nostats",
@@ -201,10 +207,7 @@ function buildFfmpegDecodeArgs(config, options) {
 		"+nobuffer+flush_packets",
 		"-flags",
 		"low_delay",
-		"-probesize",
-		"1M",
-		"-analyzeduration",
-		"0",
+		...probeArgs,
 		...hwaccelArgs,
 		...inputArgs,
 		"-vf",

package/dist/{ffmpeg-args-D6h1edXK.js → ffmpeg-args-Dl9mLcOC.js}

@@ -194,6 +194,12 @@ function buildFfmpegDecodeArgs(config, options) {
 		"-i",
 		"pipe:0"
 	];
+	const probeArgs = options.inputUrl !== void 0 ? [] : [
+		"-probesize",
+		"1M",
+		"-analyzeduration",
+		"0"
+	];
 	return [
 		...logBannerArgs("info"),
 		"-nostats",
@@ -201,10 +207,7 @@ function buildFfmpegDecodeArgs(config, options) {
 		"+nobuffer+flush_packets",
 		"-flags",
 		"low_delay",
-		"-probesize",
-		"1M",
-		"-analyzeduration",
-		"0",
+		...probeArgs,
 		...hwaccelArgs,
 		...inputArgs,
 		"-vf",

package/dist/{frame-handle-plane-Bkxz-TTD.mjs → frame-handle-plane-C05rq9Zs.mjs}

@@ -1,4 +1,4 @@
-import { B as errMsg, p as RingBuffer } from "./dist-DjuGmyG9.mjs";
+import { B as errMsg, p as RingBuffer } from "./dist-CfSORkv2.mjs";
 import { randomUUID } from "node:crypto";
 //#region src/stream-broker/stream-broker/decoder-session-proxy.ts
 /**
@@ -189,6 +189,7 @@ var FrameHandlePlane = class {
 	resolveStreamInfo;
 	localNodeId;
 	sessionRetryCooldownMs;
+	getSeedPackets;
 	subscriptions = /* @__PURE__ */ new Map();
 	sessions = /* @__PURE__ */ new Map();
 	/** Per-format retry gate set when a session lands on a non-local node:
@@ -203,6 +204,9 @@ var FrameHandlePlane = class {
 	/** Re-entrancy guard for `armPendingSessions` — collapses the per-packet
 	*  `pushPacket` calls into a single in-flight deferred-arm pass. */
 	armInFlight = false;
+	/** DIAG(592): P-frames skipped on an un-bootstrapped session before its
+	*  first live keyframe. Reset when a keyframe bootstraps the session. */
+	unbootstrappedSkips = 0;
 	/** Aggregate decoded-frame rate state — frames fanned out in the current
 	*  rolling window, the window's start epoch, and the last computed fps. */
 	framesInWindow = 0;
@@ -214,6 +218,7 @@ var FrameHandlePlane = class {
 		this.resolveStreamInfo = options.resolveStreamInfo;
 		this.localNodeId = options.localNodeId;
 		this.sessionRetryCooldownMs = options.sessionRetryCooldownMs ?? SESSION_RETRY_COOLDOWN_MS;
+		this.getSeedPackets = options.getSeedPackets;
 	}
 	/** Number of active handle subscriptions — surfaced for diagnostics. */
 	get subscriberCount() {
@@ -278,6 +283,7 @@ var FrameHandlePlane = class {
 		};
 		this.subscriptions.set(subscriptionId, subscription);
 		await this.ensureSession(input.format, subscriptionId);
+		this.reconcileSessionFps(input.format);
 		this.logger?.info("frame-handle subscription added", { meta: {
 			subscriptionId,
 			format: input.format,
@@ -290,6 +296,37 @@ var FrameHandlePlane = class {
 		};
 	}
 	/**
+	* The emit `maxFps` a format's decoder session should run at — the MAX of all
+	* current subscribers' `maxFps` for that format (fallback `DEFAULT_HINT_FPS`
+	* when none, e.g. mid-teardown). The decoder emits at this rate; each
+	* subscriber then down-samples to its own `maxFps` on read (latest-wins).
+	*/
+	computeFormatFps(format) {
+		let max = 0;
+		for (const sub of this.subscriptions.values()) if (sub.format === format && sub.maxFps > max) max = sub.maxFps;
+		return max > 0 ? max : DEFAULT_HINT_FPS;
+	}
+	/**
+	* Recompute a format session's emit `maxFps` after a subscriber joins/leaves
+	* and push it to the live decoder via `updateConfig` when it changed — so the
+	* decoder emits only as fast as the busiest reader needs (saving the
+	* scale+convert+shm-write for frames nobody reads).
+	*/
+	reconcileSessionFps(format) {
+		const session = this.sessions.get(format);
+		if (!session || !session.proxy) return;
+		const target = this.computeFormatFps(format);
+		if (target === session.targetFps) return;
+		session.targetFps = target;
+		session.proxy.updateConfig({ maxFps: target }).catch((err) => {
+			this.logger?.warn("frame-handle plane: updateConfig(maxFps) failed", { meta: {
+				format,
+				maxFps: target,
+				error: errMsg(err)
+			} });
+		});
+	}
+	/**
 	* Drain up to `maxCount` `FrameHandle`s for a subscription, latest-wins.
 	* An unknown subscription id returns `[]` (the consumer may have been
 	* torn down concurrently).
@@ -320,6 +357,7 @@ var FrameHandlePlane = class {
 				this.sessions.delete(subscription.format);
 				await this.destroySession(session);
 			} else this.scheduleLinger(session);
+			else this.reconcileSessionFps(subscription.format);
 		}
 		this.logger?.info("frame-handle subscription removed", { meta: {
 			subscriptionId,
@@ -373,10 +411,23 @@ var FrameHandlePlane = class {
 		});
 		this.feedSessions(packet);
 	}
-	/** Forward a video `EncodedPacket` to every live shm decoder session. */
+	/** Forward a video `EncodedPacket` to every live PUSH-mode shm decoder session. */
 	feedSessions(packet) {
 		for (const session of this.sessions.values()) {
 			if (!session.proxy) continue;
+			if (session.pullMode) continue;
+			if (!session.bootstrapped) {
+				if (!packet.keyframe) {
+					this.unbootstrappedSkips = (this.unbootstrappedSkips ?? 0) + 1;
+					continue;
+				}
+				this.logger?.debug("frame-handle plane: session bootstrapped from live keyframe", { meta: {
+					format: session.format,
+					pFramesSkippedBefore: this.unbootstrappedSkips ?? 0
+				} });
+				this.unbootstrappedSkips = 0;
+				session.bootstrapped = true;
+			}
 			session.proxy.pushPacket(packet).catch((err) => {
 				const msg = errMsg(err);
 				this.logger?.warn("frame-handle plane: decoder push error", { meta: {
@@ -404,10 +455,14 @@ var FrameHandlePlane = class {
 	*
 	* `triggerPacket` is the packet whose arrival armed the pass. Because
 	* `ensureSession` is async, the synchronous `feedSessions` in `pushPacket`
-	* runs before the session lands in `this.sessions` — so this method feeds
-	* the triggering packet to each session it just created, otherwise that
-	* first (keyframe-carrying) packet would be lost and a push-mode H264/H265
-	* decoder would stall waiting for SPS/PPS.
+	* runs before the session lands in `this.sessions`, so the triggering packet
+	* would be lost to the new session. `startSessionDecoder` normally bootstraps
+	* it by replaying the broker's keyframe-aligned seed GOP; only when NO seed
+	* was available (no `getSeedPackets`, or the ring held no keyframe yet) is the
+	* session left un-bootstrapped — and then this method hands it the triggering
+	* packet, but ONLY if that packet is a keyframe. A P-frame trigger is left for
+	* `feedSessions` to skip until the first live keyframe, so a push-mode decoder
+	* never sees a slice referencing an unseen param set.
 	*/
 	async armPendingSessions(triggerPacket) {
 		if (this.disposed || this.armInFlight) return;
@@ -423,12 +478,15 @@ var FrameHandlePlane = class {
 				if (this.disposed) return;
 				await this.ensureSession(format, subscriptionId);
 				const armed = this.sessions.get(format);
-				if (armed?.proxy) armed.proxy.pushPacket(triggerPacket).catch((err) => {
-					this.logger?.warn("frame-handle plane: decoder push error", { meta: {
-						format,
-						error: errMsg(err)
-					} });
-				});
+				if (armed?.proxy && !armed.bootstrapped && triggerPacket.keyframe) {
+					armed.bootstrapped = true;
+					armed.proxy.pushPacket(triggerPacket).catch((err) => {
+						this.logger?.warn("frame-handle plane: decoder push error", { meta: {
+							format,
+							error: errMsg(err)
+						} });
+					});
+				}
 			}
 		} finally {
 			this.armInFlight = false;
@@ -522,6 +580,9 @@ var FrameHandlePlane = class {
 				proxy: null,
 				nodeId: null,
 				subscriberIds,
+				bootstrapped: false,
+				pullMode: false,
+				targetFps: this.computeFormatFps(format),
 				lingerTimer: null
 			};
 			let started = false;
@@ -561,9 +622,11 @@ var FrameHandlePlane = class {
 			} });
 			return false;
 		}
+		const targetFps = this.computeFormatFps(format);
+		session.targetFps = targetFps;
 		const { sessionId, nodeId } = await this.decoderApi.createSession({
 			codec: info.codec,
-			maxFps: 0,
+			maxFps: targetFps,
 			outputFormat: format,
 			scale: 1,
 			frameSink: "shm",
@@ -592,6 +655,8 @@ var FrameHandlePlane = class {
 		const proxy = new DecoderSessionProxy(this.decoderApi, sessionId);
 		session.proxy = proxy;
 		session.nodeId = nodeId;
+		session.bootstrapped = false;
+		session.pullMode = false;
 		proxy.startHandlePolling((handle) => {
 			this.fanoutHandle(format, handle);
 		}).catch((err) => {
@@ -600,12 +665,38 @@ var FrameHandlePlane = class {
 				error: errMsg(err)
 			} });
 		});
-		if (info.pullModeUrl) proxy.openStream(info.pullModeUrl).catch((err) => {
-			this.logger?.error("frame-handle plane: pull-mode openStream failed", { meta: {
+		if (info.pullModeUrl) {
+			session.pullMode = true;
+			session.bootstrapped = true;
+			proxy.openStream(info.pullModeUrl).catch((err) => {
+				this.logger?.error("frame-handle plane: pull-mode openStream failed", { meta: {
+					format,
+					error: errMsg(err)
+				} });
+			});
+			this.logger?.info("frame-handle plane: shm decoder session created (pull-mode RTSP)", { meta: {
 				format,
-				error: errMsg(err)
+				codec: info.codec,
+				sessionId,
+				nodeId,
+				pullModeUrl: info.pullModeUrl
 			} });
-		});
+			return true;
+		}
+		const seed = this.getSeedPackets?.() ?? [];
+		if (seed.length > 0) {
+			for (const seedPacket of seed) await proxy.pushPacket(seedPacket).catch((err) => {
+				this.logger?.warn("frame-handle plane: seed-replay push error", { meta: {
+					format,
+					error: errMsg(err)
+				} });
+			});
+			session.bootstrapped = true;
+			this.logger?.debug("frame-handle plane: session bootstrapped from seed GOP", { meta: {
+				format,
+				seedPackets: seed.length
+			} });
+		}
 		this.logger?.info("frame-handle plane: shm decoder session created", { meta: {
 			format,
 			codec: info.codec,

package/dist/{frame-handle-plane-DQNCTrpC.js → frame-handle-plane-zMju9vmk.js}

@@ -1,4 +1,4 @@
-const require_dist = require("./dist-Cwc0TUQr.js");
+const require_dist = require("./dist-BrIE85BG.js");
 let node_crypto = require("node:crypto");
 //#region src/stream-broker/stream-broker/decoder-session-proxy.ts
 /**
@@ -189,6 +189,7 @@ var FrameHandlePlane = class {
 	resolveStreamInfo;
 	localNodeId;
 	sessionRetryCooldownMs;
+	getSeedPackets;
 	subscriptions = /* @__PURE__ */ new Map();
 	sessions = /* @__PURE__ */ new Map();
 	/** Per-format retry gate set when a session lands on a non-local node:
@@ -203,6 +204,9 @@ var FrameHandlePlane = class {
 	/** Re-entrancy guard for `armPendingSessions` — collapses the per-packet
 	*  `pushPacket` calls into a single in-flight deferred-arm pass. */
 	armInFlight = false;
+	/** DIAG(592): P-frames skipped on an un-bootstrapped session before its
+	*  first live keyframe. Reset when a keyframe bootstraps the session. */
+	unbootstrappedSkips = 0;
 	/** Aggregate decoded-frame rate state — frames fanned out in the current
 	*  rolling window, the window's start epoch, and the last computed fps. */
 	framesInWindow = 0;
@@ -214,6 +218,7 @@ var FrameHandlePlane = class {
 		this.resolveStreamInfo = options.resolveStreamInfo;
 		this.localNodeId = options.localNodeId;
 		this.sessionRetryCooldownMs = options.sessionRetryCooldownMs ?? SESSION_RETRY_COOLDOWN_MS;
+		this.getSeedPackets = options.getSeedPackets;
 	}
 	/** Number of active handle subscriptions — surfaced for diagnostics. */
 	get subscriberCount() {
@@ -278,6 +283,7 @@ var FrameHandlePlane = class {
 		};
 		this.subscriptions.set(subscriptionId, subscription);
 		await this.ensureSession(input.format, subscriptionId);
+		this.reconcileSessionFps(input.format);
 		this.logger?.info("frame-handle subscription added", { meta: {
 			subscriptionId,
 			format: input.format,
@@ -290,6 +296,37 @@ var FrameHandlePlane = class {
 		};
 	}
 	/**
+	* The emit `maxFps` a format's decoder session should run at — the MAX of all
+	* current subscribers' `maxFps` for that format (fallback `DEFAULT_HINT_FPS`
+	* when none, e.g. mid-teardown). The decoder emits at this rate; each
+	* subscriber then down-samples to its own `maxFps` on read (latest-wins).
+	*/
+	computeFormatFps(format) {
+		let max = 0;
+		for (const sub of this.subscriptions.values()) if (sub.format === format && sub.maxFps > max) max = sub.maxFps;
+		return max > 0 ? max : DEFAULT_HINT_FPS;
+	}
+	/**
+	* Recompute a format session's emit `maxFps` after a subscriber joins/leaves
+	* and push it to the live decoder via `updateConfig` when it changed — so the
+	* decoder emits only as fast as the busiest reader needs (saving the
+	* scale+convert+shm-write for frames nobody reads).
+	*/
+	reconcileSessionFps(format) {
+		const session = this.sessions.get(format);
+		if (!session || !session.proxy) return;
+		const target = this.computeFormatFps(format);
+		if (target === session.targetFps) return;
+		session.targetFps = target;
+		session.proxy.updateConfig({ maxFps: target }).catch((err) => {
+			this.logger?.warn("frame-handle plane: updateConfig(maxFps) failed", { meta: {
+				format,
+				maxFps: target,
+				error: require_dist.errMsg(err)
+			} });
+		});
+	}
+	/**
 	* Drain up to `maxCount` `FrameHandle`s for a subscription, latest-wins.
 	* An unknown subscription id returns `[]` (the consumer may have been
 	* torn down concurrently).
@@ -320,6 +357,7 @@ var FrameHandlePlane = class {
 				this.sessions.delete(subscription.format);
 				await this.destroySession(session);
 			} else this.scheduleLinger(session);
+			else this.reconcileSessionFps(subscription.format);
 		}
 		this.logger?.info("frame-handle subscription removed", { meta: {
 			subscriptionId,
@@ -373,10 +411,23 @@ var FrameHandlePlane = class {
 		});
 		this.feedSessions(packet);
 	}
-	/** Forward a video `EncodedPacket` to every live shm decoder session. */
+	/** Forward a video `EncodedPacket` to every live PUSH-mode shm decoder session. */
 	feedSessions(packet) {
 		for (const session of this.sessions.values()) {
 			if (!session.proxy) continue;
+			if (session.pullMode) continue;
+			if (!session.bootstrapped) {
+				if (!packet.keyframe) {
+					this.unbootstrappedSkips = (this.unbootstrappedSkips ?? 0) + 1;
+					continue;
+				}
+				this.logger?.debug("frame-handle plane: session bootstrapped from live keyframe", { meta: {
+					format: session.format,
+					pFramesSkippedBefore: this.unbootstrappedSkips ?? 0
+				} });
+				this.unbootstrappedSkips = 0;
+				session.bootstrapped = true;
+			}
 			session.proxy.pushPacket(packet).catch((err) => {
 				const msg = require_dist.errMsg(err);
 				this.logger?.warn("frame-handle plane: decoder push error", { meta: {
@@ -404,10 +455,14 @@ var FrameHandlePlane = class {
 	*
 	* `triggerPacket` is the packet whose arrival armed the pass. Because
 	* `ensureSession` is async, the synchronous `feedSessions` in `pushPacket`
-	* runs before the session lands in `this.sessions` — so this method feeds
-	* the triggering packet to each session it just created, otherwise that
-	* first (keyframe-carrying) packet would be lost and a push-mode H264/H265
-	* decoder would stall waiting for SPS/PPS.
+	* runs before the session lands in `this.sessions`, so the triggering packet
+	* would be lost to the new session. `startSessionDecoder` normally bootstraps
+	* it by replaying the broker's keyframe-aligned seed GOP; only when NO seed
+	* was available (no `getSeedPackets`, or the ring held no keyframe yet) is the
+	* session left un-bootstrapped — and then this method hands it the triggering
+	* packet, but ONLY if that packet is a keyframe. A P-frame trigger is left for
+	* `feedSessions` to skip until the first live keyframe, so a push-mode decoder
+	* never sees a slice referencing an unseen param set.
 	*/
 	async armPendingSessions(triggerPacket) {
 		if (this.disposed || this.armInFlight) return;
@@ -423,12 +478,15 @@ var FrameHandlePlane = class {
 				if (this.disposed) return;
 				await this.ensureSession(format, subscriptionId);
 				const armed = this.sessions.get(format);
-				if (armed?.proxy) armed.proxy.pushPacket(triggerPacket).catch((err) => {
-					this.logger?.warn("frame-handle plane: decoder push error", { meta: {
-						format,
-						error: require_dist.errMsg(err)
-					} });
-				});
+				if (armed?.proxy && !armed.bootstrapped && triggerPacket.keyframe) {
+					armed.bootstrapped = true;
+					armed.proxy.pushPacket(triggerPacket).catch((err) => {
+						this.logger?.warn("frame-handle plane: decoder push error", { meta: {
+							format,
+							error: require_dist.errMsg(err)
+						} });
+					});
+				}
 			}
 		} finally {
 			this.armInFlight = false;
@@ -522,6 +580,9 @@ var FrameHandlePlane = class {
 				proxy: null,
 				nodeId: null,
 				subscriberIds,
+				bootstrapped: false,
+				pullMode: false,
+				targetFps: this.computeFormatFps(format),
 				lingerTimer: null
 			};
 			let started = false;
@@ -561,9 +622,11 @@ var FrameHandlePlane = class {
 			} });
 			return false;
 		}
+		const targetFps = this.computeFormatFps(format);
+		session.targetFps = targetFps;
 		const { sessionId, nodeId } = await this.decoderApi.createSession({
 			codec: info.codec,
-			maxFps: 0,
+			maxFps: targetFps,
 			outputFormat: format,
 			scale: 1,
 			frameSink: "shm",
@@ -592,6 +655,8 @@ var FrameHandlePlane = class {
 		const proxy = new DecoderSessionProxy(this.decoderApi, sessionId);
 		session.proxy = proxy;
 		session.nodeId = nodeId;
+		session.bootstrapped = false;
+		session.pullMode = false;
 		proxy.startHandlePolling((handle) => {
 			this.fanoutHandle(format, handle);
 		}).catch((err) => {
@@ -600,12 +665,38 @@ var FrameHandlePlane = class {
 				error: require_dist.errMsg(err)
 			} });
 		});
-		if (info.pullModeUrl) proxy.openStream(info.pullModeUrl).catch((err) => {
-			this.logger?.error("frame-handle plane: pull-mode openStream failed", { meta: {
+		if (info.pullModeUrl) {
+			session.pullMode = true;
+			session.bootstrapped = true;
+			proxy.openStream(info.pullModeUrl).catch((err) => {
+				this.logger?.error("frame-handle plane: pull-mode openStream failed", { meta: {
+					format,
+					error: require_dist.errMsg(err)
+				} });
+			});
+			this.logger?.info("frame-handle plane: shm decoder session created (pull-mode RTSP)", { meta: {
 				format,
-				error: require_dist.errMsg(err)
+				codec: info.codec,
+				sessionId,
+				nodeId,
+				pullModeUrl: info.pullModeUrl
 			} });
-		});
+			return true;
+		}
+		const seed = this.getSeedPackets?.() ?? [];
+		if (seed.length > 0) {
+			for (const seedPacket of seed) await proxy.pushPacket(seedPacket).catch((err) => {
+				this.logger?.warn("frame-handle plane: seed-replay push error", { meta: {
+					format,
+					error: require_dist.errMsg(err)
+				} });
+			});
+			session.bootstrapped = true;
+			this.logger?.debug("frame-handle plane: session bootstrapped from seed GOP", { meta: {
+				format,
+				seedPackets: seed.length
+			} });
+		}
 		this.logger?.info("frame-handle plane: shm decoder session created", { meta: {
 			format,
 			codec: info.codec,