@camstack/addon-pipeline 1.1.28 → 1.1.30

package/dist/{dist-Biq62zt4.js → dist-Cwc0TUQr.js}

@@ -16403,7 +16403,10 @@ var AgentLoadSummarySchema = object({
 	online: boolean(),
 	load: RunnerLocalLoadSchema,
 	/** Computed score used by the L2 capacity balancer (lower = less loaded). */
-	score: number()
+	score: number(),
+	/** This node's decode hwaccel backend (per-node `probedBestHwaccel`), or null
+	*  when not yet probed — for the cluster Pipeline table UI (P0.2). */
+	decodeHwaccel: string().nullable()
 });
 /**
 * Aggregate metrics across the whole detection cluster. Replaces the legacy
@@ -19034,7 +19037,7 @@ var HardwareEncoderIdSchema = _enum([
 	"libx264",
 	"libx265"
 ]);
-var HardwareEncodersSchema = object({
+object({
 	encoders: array(object({
 		encoder: HardwareEncoderIdSchema,
 		codec: _enum(["H264", "H265"]),
@@ -19053,15 +19056,7 @@ var HardwareEncodersSchema = object({
 	defaultH265: HardwareEncoderIdSchema,
 	probedAt: number()
 });
-/**
-* Decode-side companion to {@link HardwareEncodersSchema}: the `-hwaccel`
-* methods the configured ffmpeg binary actually supports (parsed from
-* `ffmpeg -hwaccels`). Used to gate decode-hwaccel attempts so the transcode
-* egress never spends a spawn on a backend this build cannot offer. Per-stream
-* decode fragility (e.g. VideoToolbox HEVC) is still handled by the egress's
-* software fallback — this only filters out wholly-unsupported backends.
-*/
-var HardwareDecodeAccelsSchema = object({
+object({
 	methods: array(string()).readonly(),
 	probedAt: number()
 });
@@ -19124,13 +19119,7 @@ var ResolvedInferenceConfigSchema = object({
 	format: ModelFormatSchema,
 	reason: string()
 });
-method(_void(), PlatformCapabilitiesSchema), method(_void(), HardwareInfoSchema), method(object({ requirements: array(ModelRequirementSchema).readonly() }), ResolvedInferenceConfigSchema), method(object({ prefer: HwAccelBackendInputSchema }), HwAccelResolutionSchema), method(_void(), HardwareEncodersSchema), method(_void(), HardwareEncodersSchema, {
-	kind: "mutation",
-	auth: "admin"
-}), method(_void(), HardwareDecodeAccelsSchema), method(_void(), HardwareDecodeAccelsSchema, {
-	kind: "mutation",
-	auth: "admin"
-});
+method(_void(), PlatformCapabilitiesSchema), method(_void(), HardwareInfoSchema), method(object({ requirements: array(ModelRequirementSchema).readonly() }), ResolvedInferenceConfigSchema), method(object({ prefer: HwAccelBackendInputSchema }), HwAccelResolutionSchema);
 var PtzPresetSchema = object({
 	id: string(),
 	name: string()
@@ -22788,30 +22777,6 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
-	"platformProbe.getHardwareDecodeAccels": {
-		capName: "platform-probe",
-		capScope: "system",
-		addonId: null,
-		access: "view"
-	},
-	"platformProbe.getHardwareEncoders": {
-		capName: "platform-probe",
-		capScope: "system",
-		addonId: null,
-		access: "view"
-	},
-	"platformProbe.refreshHardwareDecodeAccels": {
-		capName: "platform-probe",
-		capScope: "system",
-		addonId: null,
-		access: "create"
-	},
-	"platformProbe.refreshHardwareEncoders": {
-		capName: "platform-probe",
-		capScope: "system",
-		addonId: null,
-		access: "create"
-	},
 	"platformProbe.resolveHwAccel": {
 		capName: "platform-probe",
 		capScope: "system",

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

@@ -16403,7 +16403,10 @@ var AgentLoadSummarySchema = object({
 	online: boolean(),
 	load: RunnerLocalLoadSchema,
 	/** Computed score used by the L2 capacity balancer (lower = less loaded). */
-	score: number()
+	score: number(),
+	/** This node's decode hwaccel backend (per-node `probedBestHwaccel`), or null
+	*  when not yet probed — for the cluster Pipeline table UI (P0.2). */
+	decodeHwaccel: string().nullable()
 });
 /**
 * Aggregate metrics across the whole detection cluster. Replaces the legacy
@@ -19034,7 +19037,7 @@ var HardwareEncoderIdSchema = _enum([
 	"libx264",
 	"libx265"
 ]);
-var HardwareEncodersSchema = object({
+object({
 	encoders: array(object({
 		encoder: HardwareEncoderIdSchema,
 		codec: _enum(["H264", "H265"]),
@@ -19053,15 +19056,7 @@ var HardwareEncodersSchema = object({
 	defaultH265: HardwareEncoderIdSchema,
 	probedAt: number()
 });
-/**
-* Decode-side companion to {@link HardwareEncodersSchema}: the `-hwaccel`
-* methods the configured ffmpeg binary actually supports (parsed from
-* `ffmpeg -hwaccels`). Used to gate decode-hwaccel attempts so the transcode
-* egress never spends a spawn on a backend this build cannot offer. Per-stream
-* decode fragility (e.g. VideoToolbox HEVC) is still handled by the egress's
-* software fallback — this only filters out wholly-unsupported backends.
-*/
-var HardwareDecodeAccelsSchema = object({
+object({
 	methods: array(string()).readonly(),
 	probedAt: number()
 });
@@ -19124,13 +19119,7 @@ var ResolvedInferenceConfigSchema = object({
 	format: ModelFormatSchema,
 	reason: string()
 });
-method(_void(), PlatformCapabilitiesSchema), method(_void(), HardwareInfoSchema), method(object({ requirements: array(ModelRequirementSchema).readonly() }), ResolvedInferenceConfigSchema), method(object({ prefer: HwAccelBackendInputSchema }), HwAccelResolutionSchema), method(_void(), HardwareEncodersSchema), method(_void(), HardwareEncodersSchema, {
-	kind: "mutation",
-	auth: "admin"
-}), method(_void(), HardwareDecodeAccelsSchema), method(_void(), HardwareDecodeAccelsSchema, {
-	kind: "mutation",
-	auth: "admin"
-});
+method(_void(), PlatformCapabilitiesSchema), method(_void(), HardwareInfoSchema), method(object({ requirements: array(ModelRequirementSchema).readonly() }), ResolvedInferenceConfigSchema), method(object({ prefer: HwAccelBackendInputSchema }), HwAccelResolutionSchema);
 var PtzPresetSchema = object({
 	id: string(),
 	name: string()
@@ -22788,30 +22777,6 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
-	"platformProbe.getHardwareDecodeAccels": {
-		capName: "platform-probe",
-		capScope: "system",
-		addonId: null,
-		access: "view"
-	},
-	"platformProbe.getHardwareEncoders": {
-		capName: "platform-probe",
-		capScope: "system",
-		addonId: null,
-		access: "view"
-	},
-	"platformProbe.refreshHardwareDecodeAccels": {
-		capName: "platform-probe",
-		capScope: "system",
-		addonId: null,
-		access: "create"
-	},
-	"platformProbe.refreshHardwareEncoders": {
-		capName: "platform-probe",
-		capScope: "system",
-		addonId: null,
-		access: "create"
-	},
 	"platformProbe.resolveHwAccel": {
 		capName: "platform-probe",
 		capScope: "system",

package/dist/ffmpeg-args-C5GPp8Cw.mjs

@@ -0,0 +1,323 @@
+//#region src/stream-broker/stream-broker/ffmpeg-args-common.ts
+var AUDIO_ENCODER_BY_CODEC = {
+	opus: "libopus",
+	aac: "aac",
+	pcmu: "pcm_mulaw",
+	pcma: "pcm_alaw",
+	copy: "copy"
+};
+/**
+* Build the audio-encode args `-c:a <enc> [-b:a Nk] [-ar N] [-ac N]`. Each knob
+* is emitted only when provided, in this fixed order — matching what every
+* broker site already emitted by hand.
+*/
+function audioEncoderArgs(codec, opts = {}) {
+	const args = ["-c:a", AUDIO_ENCODER_BY_CODEC[codec]];
+	if (opts.bitrateKbps !== void 0) args.push("-b:a", `${opts.bitrateKbps}k`);
+	if (opts.sampleRateHz !== void 0) args.push("-ar", String(opts.sampleRateHz));
+	if (opts.channels !== void 0) args.push("-ac", String(opts.channels));
+	return args;
+}
+/** The `-hide_banner -loglevel <level>` preamble every broker ffmpeg site opens with. */
+function logBannerArgs(level) {
+	return [
+		"-hide_banner",
+		"-loglevel",
+		level
+	];
+}
+//#endregion
+//#region src/decoder-ffmpeg/ffmpeg-args.ts
+/**
+* Pure, side-effect-free ffmpeg argument construction for the
+* `decoder-ffmpeg` addon.
+*
+* The addon decodes video in an **ffmpeg subprocess** (unlike `decoder-nodeav`
+* which decodes in-process via node-av's native bindings). On the Intel hub,
+* node-av's VA-API decode path SIGBUSes (uncatchable) on 8MP h264 and takes the
+* whole decoder runner down; ffmpeg-as-subprocess decodes the same hardware
+* cleanly because a crash is isolated to the child process.
+*
+* These helpers are extracted from the session so the argument shape is
+* unit-testable without spawning a real ffmpeg binary.
+*
+* Validated working command on the Intel hub (renderD128, 8MP h264, ~50fps,
+* exit 0):
+*
+*   ffmpeg -hwaccel vaapi -hwaccel_device /dev/dri/renderD128 \
+*     -hwaccel_output_format vaapi -f h264 -i <in> \
+*     -vf hwdownload,format=nv12,scale=640:360,format=gray \
+*     -f rawvideo -y /dev/null
+*/
+/** Default DRM render node used for the VA-API / QSV hardware decode path. */
+var DEFAULT_VAAPI_RENDER_DEVICE = "/dev/dri/renderD128";
+/** Whether a resolved hwaccel value means "decode in software" (no `-hwaccel`). */
+function isSoftwareHwAccel(hwaccel) {
+	return hwaccel === null || hwaccel === "" || hwaccel === "none";
+}
+/** Backends whose decoded frames stay on the GPU and need an explicit
+*  `-hwaccel_output_format <m>` + `hwdownload,format=nv12` chain. */
+function needsHwDownload(hwaccel) {
+	return hwaccel === "vaapi" || hwaccel === "qsv";
+}
+/** Decode backend → its GPU scaler filter. */
+var GPU_SCALE_FILTER_BY_BACKEND = {
+	vaapi: "scale_vaapi",
+	qsv: "scale_qsv",
+	videotoolbox: "scale_vt"
+};
+/** Every GPU scaler this addon knows how to drive — used to scan `-filters`. */
+var KNOWN_GPU_SCALE_FILTERS = [
+	"scale_vaapi",
+	"scale_qsv",
+	"scale_vt"
+];
+/**
+* The GPU scaler that pairs with a decode backend, ignoring build support — a
+* static hwaccel → filter map. Returns null for software / a backend with no
+* GPU scaler (e.g. `cuda`, `drm`). Case-insensitive.
+*/
+function gpuScaleFilterForBackend(hwaccel) {
+	if (hwaccel === null) return null;
+	return GPU_SCALE_FILTER_BY_BACKEND[hwaccel.toLowerCase()] ?? null;
+}
+/**
+* Resolve the GPU scaler to use for a decode backend GIVEN the filters the
+* configured ffmpeg build actually offers ({@link parseAvailableGpuScaleFilters}).
+* Returns the filter when the backend maps to one AND the build has it; null
+* otherwise — the caller then emits the CPU-scale chain (graceful fallback).
+*/
+function resolveGpuScaleFilter(hwaccel, availableFilters) {
+	const filter = gpuScaleFilterForBackend(hwaccel);
+	if (filter === null) return null;
+	return availableFilters.has(filter) ? filter : null;
+}
+/**
+* Parse `ffmpeg -filters` stdout into the set of {@link KNOWN_GPU_SCALE_FILTERS}
+* the build offers. Matches whole filter tokens (word-boundary) so the plain
+* `scale` filter is never mistaken for a GPU scaler. PURE — the spawn lives in
+* the addon; only the parse is here so it is unit-tested.
+*/
+function parseAvailableGpuScaleFilters(filtersStdout) {
+	const present = /* @__PURE__ */ new Set();
+	for (const filter of KNOWN_GPU_SCALE_FILTERS) if (new RegExp(`\\b${filter}\\b`).test(filtersStdout)) present.add(filter);
+	return present;
+}
+/**
+* Whether the decode keeps frames on the GPU — needs `-hwaccel_output_format`
+* and an `hwdownload` in the filtergraph. VA-API / QSV always do (their decoded
+* surfaces live on the GPU); another backend only when a GPU scaler will run on
+* those surfaces (e.g. `videotoolbox` + `scale_vt`).
+*/
+function keepFramesOnGpu(hwaccel, gpuScaleFilter) {
+	return needsHwDownload(hwaccel) || gpuScaleFilter !== null;
+}
+/** Map a cap codec string to the ffmpeg `-f` input demuxer/format. */
+function codecToInputFormat(codec) {
+	switch (codec.toLowerCase()) {
+		case "h265":
+		case "hevc": return "hevc";
+		default: return "h264";
+	}
+}
+/** Map the cap-level output format to a raw ffmpeg pixel format. */
+function rawPixelForFormat(outputFormat) {
+	return outputFormat === "gray" ? "gray" : "rgb24";
+}
+/** Packed bytes-per-pixel for a raw output format (rgb24 = 3, gray = 1). */
+function channelsForPixel(pixel) {
+	return pixel === "gray" ? 1 : 3;
+}
+/**
+* The maximum output width for a given `scale` divisor — matches the node-av
+* scaler's `maxW = floor(640 / scale)` rule so both decoders produce
+* comparably-sized frames for the motion / detection pipeline.
+*/
+function maxDecodeWidth(scale) {
+	return Math.max(2, Math.floor(640 / (scale > 1 ? scale : 1)));
+}
+/**
+* Compute exact output geometry from a known source resolution — the node-av
+* rule (`outWidth = min(srcW, floor(640/scale))`, `outHeight =
+* round(outWidth*srcH/srcW)`). Provided for callers that DO know the source
+* dimensions; the live broker path leaves them to ffmpeg (`-2` height).
+*/
+function computeOutputGeometry(srcWidth, srcHeight, scale) {
+	const width = Math.min(srcWidth, maxDecodeWidth(scale));
+	return {
+		width,
+		height: Math.round(width * srcHeight / srcWidth)
+	};
+}
+/** Build the `-vf` filtergraph string for the requested hwaccel + pixel format. */
+function buildVideoFilter(hwaccel, pixel, outWidth, outHeight, maxW, gpuScaleFilter) {
+	const exact = outWidth !== void 0 && outWidth > 0 && outHeight !== void 0 && outHeight > 0;
+	if (gpuScaleFilter !== null) return `${gpuScaleFilter}=${exact ? `w=${outWidth}:h=${outHeight}` : `w=min(iw\\,${maxW}):h=-2`},hwdownload,format=nv12,format=${pixel}`;
+	const scaleAndFormat = `scale=${exact ? `${outWidth}:${outHeight}` : `min(iw\\,${maxW}):-2`},format=${pixel}`;
+	return needsHwDownload(hwaccel) ? `hwdownload,format=nv12,${scaleAndFormat}` : scaleAndFormat;
+}
+/**
+* Build the full ffmpeg argv for a decode session. PURE — no spawn, no env
+* access — so the argument shape is asserted in unit tests.
+*
+* Notes:
+* - `-loglevel info -nostats`: the session parses the muxer's `Output #0`
+*   stream line from stderr to learn the exact output W×H (the broker does not
+*   pass source geometry for the shm path). `-nostats` suppresses the periodic
+*   `frame= …` counter while keeping the one-shot Output block.
+* - The input is `pipe:0` (Annex-B packets written to stdin) in push mode, or
+*   `options.inputUrl` (the owner's restream, dialed by ffmpeg itself —
+*   `-rtsp_transport tcp` for rtsp URLs) in pull mode; the output is raw video
+*   on `pipe:1` either way.
+*/
+function buildFfmpegDecodeArgs(config, options) {
+	const inputFormat = codecToInputFormat(config.codec);
+	const pixel = rawPixelForFormat(config.outputFormat);
+	const maxW = maxDecodeWidth(config.scale);
+	const { hwaccel } = options;
+	const gpuScaleFilter = options.gpuScaleFilter ?? null;
+	const vf = buildVideoFilter(hwaccel, pixel, options.outWidth, options.outHeight, maxW, gpuScaleFilter);
+	let hwaccelArgs;
+	if (isSoftwareHwAccel(hwaccel) || hwaccel === null) hwaccelArgs = [];
+	else {
+		hwaccelArgs = ["-hwaccel", hwaccel];
+		if (needsHwDownload(hwaccel)) hwaccelArgs.push("-hwaccel_device", options.renderDevice ?? "/dev/dri/renderD128");
+		if (keepFramesOnGpu(hwaccel, gpuScaleFilter)) hwaccelArgs.push("-hwaccel_output_format", hwaccel);
+	}
+	const inputArgs = options.inputUrl !== void 0 ? [
+		...options.inputUrl.startsWith("rtsp") ? ["-rtsp_transport", "tcp"] : [],
+		"-i",
+		options.inputUrl
+	] : [
+		"-f",
+		inputFormat,
+		"-i",
+		"pipe:0"
+	];
+	return [
+		...logBannerArgs("info"),
+		"-nostats",
+		"-fflags",
+		"+nobuffer+flush_packets",
+		"-flags",
+		"low_delay",
+		"-probesize",
+		"1M",
+		"-analyzeduration",
+		"0",
+		...hwaccelArgs,
+		...inputArgs,
+		"-vf",
+		vf,
+		"-f",
+		"rawvideo",
+		"-pix_fmt",
+		pixel,
+		"pipe:1"
+	];
+}
+/**
+* Parse the exact output geometry from ffmpeg's stderr. The muxer prints an
+* `Output #0, rawvideo …` block whose `Stream #0:0: Video: rawvideo …, <fmt>,
+* WIDTHxHEIGHT …` line carries the scaled dimensions. Gating on the `Output #`
+* marker avoids picking up the INPUT stream's (source) resolution, which is
+* printed earlier.
+*
+* Returns `null` until the Output block with a `WxH` token has been seen.
+*/
+function parseFfmpegOutputDims(stderr) {
+	const outputIdx = stderr.indexOf("Output #");
+	if (outputIdx < 0) return null;
+	const match = stderr.slice(outputIdx).match(/(\d{2,5})x(\d{2,5})/);
+	if (!match) return null;
+	const width = Number(match[1]);
+	const height = Number(match[2]);
+	if (!Number.isInteger(width) || !Number.isInteger(height) || width <= 0 || height <= 0) return null;
+	return {
+		width,
+		height
+	};
+}
+/**
+* Pick the first kernel-preferred `-hwaccel` method the configured ffmpeg build
+* actually supports, or `null` (software) when it supports none. Mirrors the
+* broker's `pickDecodeHwAccel` (`ffmpeg-invocation.ts`) so the decoder gates
+* decode-hwaccel against the same probed evidence:
+* - empty `preferred` → `null` (software);
+* - empty `supportedMethods` (probe miss) → keep the top preference and let the
+*   session's per-child software fallback cover a genuine failure;
+* - otherwise the first preference the build supports, or `null`.
+*/
+function pickDecodeHwAccel(preferred, supportedMethods) {
+	if (preferred.length === 0) return null;
+	if (supportedMethods.length === 0) return preferred[0] ?? null;
+	const supported = new Set(supportedMethods.map((m) => m.toLowerCase()));
+	return preferred.find((name) => supported.has(name.toLowerCase())) ?? null;
+}
+/**
+* Canonical decode-hwaccel preference order for the ffmpeg-subprocess decoder.
+*
+* `vaapi` is ranked ABOVE `qsv` deliberately: on the Intel hub the `qsv` decode
+* child exits early (`code=171`, no frames) while the `vaapi` path decodes 8MP
+* h264 cleanly at ~50fps. The kernel probe (`resolveHwAccel`) tends to surface
+* `qsv` first on Intel, so we re-rank its result through this table before
+* building the attempt chain. `videotoolbox` leads for macOS; `cuda` / `nvdec`
+* trail for NVIDIA. A method not listed here keeps its incoming relative order,
+* placed AFTER every ranked one.
+*/
+var DECODE_HWACCEL_RANK = [
+	"videotoolbox",
+	"vaapi",
+	"qsv",
+	"cuda",
+	"nvdec",
+	"d3d11va",
+	"dxva2",
+	"amf",
+	"vdpau",
+	"drm"
+];
+/** Rank index for {@link DECODE_HWACCEL_RANK} — unranked methods sort last. */
+function decodeHwAccelRankIndex(method) {
+	const idx = DECODE_HWACCEL_RANK.indexOf(method.toLowerCase());
+	return idx < 0 ? DECODE_HWACCEL_RANK.length : idx;
+}
+/**
+* Build the ORDERED list of hardware `-hwaccel` methods to attempt for an
+* `'auto'` decode session, best-first. The session walks this chain on an
+* early-exit-with-no-frames and only falls to software once it is exhausted.
+*
+* Strategy:
+* - Seed candidates from the kernel-preferred order UNION the canonical rank
+*   UNION the build's supported list, so a method the kernel omitted but the
+*   build supports (the Intel `vaapi` case — kernel surfaces only `qsv`) is
+*   still attempted.
+* - When the build's supported-method list is known (non-empty), keep only
+*   methods it actually offers; on a probe miss (empty) keep just the kernel
+*   preferences (avoid blindly spawning every backend).
+* - Re-rank the survivors by {@link DECODE_HWACCEL_RANK} so `vaapi` precedes
+*   `qsv`. A supported method not in the rank table keeps its position AFTER
+*   every ranked one (stable sort). Returns lowercased method names; empty ⇒
+*   pure software.
+*/
+function rankDecodeHwAccels(preferred, supportedMethods) {
+	const supported = new Set(supportedMethods.map((m) => m.toLowerCase()));
+	const hasSupportList = supported.size > 0;
+	const pool = hasSupportList ? [
+		...preferred,
+		...DECODE_HWACCEL_RANK,
+		...supportedMethods
+	] : [...preferred];
+	const seen = /* @__PURE__ */ new Set();
+	const candidates = [];
+	for (const raw of pool) {
+		const method = raw.toLowerCase();
+		if (seen.has(method)) continue;
+		seen.add(method);
+		if (hasSupportList && !supported.has(method)) continue;
+		candidates.push(method);
+	}
+	return candidates.sort((a, b) => decodeHwAccelRankIndex(a) - decodeHwAccelRankIndex(b));
+}
+//#endregion
+export { codecToInputFormat as a, maxDecodeWidth as c, pickDecodeHwAccel as d, rankDecodeHwAccels as f, logBannerArgs as g, audioEncoderArgs as h, channelsForPixel as i, parseAvailableGpuScaleFilters as l, resolveGpuScaleFilter as m, DEFAULT_VAAPI_RENDER_DEVICE as n, computeOutputGeometry as o, rawPixelForFormat as p, buildFfmpegDecodeArgs as r, isSoftwareHwAccel as s, DECODE_HWACCEL_RANK as t, parseFfmpegOutputDims as u };