@camstack/addon-pipeline 1.1.27 → 1.1.28

package/dist/audio-analyzer/index.js

@@ -3,7 +3,8 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_model_download_service_C_IHWnXx = require("../model-download-service-C-IHWnXx-DxM2DSns.js");
-const require_dist = require("../dist-DAIlCdAx.js");
+const require_dist = require("../dist-Biq62zt4.js");
+const require_node_topology_platform = require("../node-topology-platform-CFZ7F4xW.js");
 let node_fs = require("node:fs");
 node_fs = require_model_download_service_C_IHWnXx.__toESM(node_fs);
 let node_path = require("node:path");
@@ -672,6 +673,7 @@ var AudioAnalyzerAddon = class extends require_dist.BaseAddon {
 					description: "Auto-detected best audio backend on this host. Click the refresh icon to re-run the probe.",
 					readonlyField: true,
 					default: "",
+					perNode: true,
 					actions: [{
 						action: "reprobe-audio-engine",
 						icon: "refresh-cw",
@@ -720,8 +722,7 @@ var AudioAnalyzerAddon = class extends require_dist.BaseAddon {
 	*  semantics detection-pipeline relies on.
 	*/
 	async getGlobalSettings(overlay, _cap, nodeId) {
-		const ctx = this.ctxIfReady;
-		const stored = ctx?.settings ? await ctx.settings.readAddonStore() ?? {} : {};
+		const stored = await this.resolveGlobalStore(nodeId);
 		const merged = overlay ? {
 			...stored,
 			...overlay
@@ -777,8 +778,8 @@ var AudioAnalyzerAddon = class extends require_dist.BaseAddon {
 		const localNode = this.ctxIfReady?.kernel?.localNodeId;
 		if (!nodeId || nodeId === localNode) return process.platform;
 		try {
-			const entry = (await this.ctxIfReady?.api?.nodes?.topology.query())?.find((n) => n.id === nodeId);
-			if (entry?.platform) return entry.platform;
+			const { platform } = require_node_topology_platform.pickNodePlatformArch(await this.ctxIfReady?.api?.nodes?.topology.query(), nodeId);
+			if (platform) return platform;
 		} catch {}
 		return process.platform;
 	}
@@ -789,7 +790,7 @@ var AudioAnalyzerAddon = class extends require_dist.BaseAddon {
 	*/
 	async reprobeAudioEngine() {
 		const backend = process.platform === "darwin" ? "apple-soundanalysis" : "yamnet-onnx";
-		await this.ctx.settings?.writeAddonStore({ probedBestAudioBackend: backend });
+		await this.updateGlobalSettings({ probedBestAudioBackend: backend });
 		this.ctx.logger.info("reprobeAudioEngine: wrote probedBestAudioBackend", { meta: { backend } });
 		return { backend };
 	}

package/dist/audio-analyzer/index.mjs

@@ -1,5 +1,6 @@
 import { t as __require } from "../chunk-BdkLduGY.mjs";
-import { B as errMsg, D as mapAudioLabelToMacro, V as BaseAddon, Y as hydrateSchema, _ as audioAnalyzerCapability, g as audioAnalysisCapability, n as AUDIO_BACKEND_CHOICES, o as DEFAULT_AUDIO_ANALYZER_CONFIG, u as HF_BASE_URL } from "../dist-CgEP_0OL.mjs";
+import { B as errMsg, D as mapAudioLabelToMacro, V as BaseAddon, _ as audioAnalyzerCapability, g as audioAnalysisCapability, n as AUDIO_BACKEND_CHOICES, o as DEFAULT_AUDIO_ANALYZER_CONFIG, q as hydrateSchema, u as HF_BASE_URL } from "../dist-C6_wgXqF.mjs";
+import { t as pickNodePlatformArch } from "../node-topology-platform-BkR_k6WT.mjs";
 import { r as downloadFile } from "../model-download-service-C-IHWnXx-BPy6aoAx.mjs";
 import * as fs from "node:fs";
 import * as path$1 from "node:path";
@@ -667,6 +668,7 @@ var AudioAnalyzerAddon = class extends BaseAddon {
 					description: "Auto-detected best audio backend on this host. Click the refresh icon to re-run the probe.",
 					readonlyField: true,
 					default: "",
+					perNode: true,
 					actions: [{
 						action: "reprobe-audio-engine",
 						icon: "refresh-cw",
@@ -715,8 +717,7 @@ var AudioAnalyzerAddon = class extends BaseAddon {
 	*  semantics detection-pipeline relies on.
 	*/
 	async getGlobalSettings(overlay, _cap, nodeId) {
-		const ctx = this.ctxIfReady;
-		const stored = ctx?.settings ? await ctx.settings.readAddonStore() ?? {} : {};
+		const stored = await this.resolveGlobalStore(nodeId);
 		const merged = overlay ? {
 			...stored,
 			...overlay
@@ -772,8 +773,8 @@ var AudioAnalyzerAddon = class extends BaseAddon {
 		const localNode = this.ctxIfReady?.kernel?.localNodeId;
 		if (!nodeId || nodeId === localNode) return process.platform;
 		try {
-			const entry = (await this.ctxIfReady?.api?.nodes?.topology.query())?.find((n) => n.id === nodeId);
-			if (entry?.platform) return entry.platform;
+			const { platform } = pickNodePlatformArch(await this.ctxIfReady?.api?.nodes?.topology.query(), nodeId);
+			if (platform) return platform;
 		} catch {}
 		return process.platform;
 	}
@@ -784,7 +785,7 @@ var AudioAnalyzerAddon = class extends BaseAddon {
 	*/
 	async reprobeAudioEngine() {
 		const backend = process.platform === "darwin" ? "apple-soundanalysis" : "yamnet-onnx";
-		await this.ctx.settings?.writeAddonStore({ probedBestAudioBackend: backend });
+		await this.updateGlobalSettings({ probedBestAudioBackend: backend });
 		this.ctx.logger.info("reprobeAudioEngine: wrote probedBestAudioBackend", { meta: { backend } });
 		return { backend };
 	}

package/dist/audio-codec-ffmpeg/index.js

@@ -2,7 +2,7 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_dist = require("../dist-DAIlCdAx.js");
+const require_dist = require("../dist-Biq62zt4.js");
 let node_crypto = require("node:crypto");
 let node_child_process = require("node:child_process");
 //#region src/audio-codec-ffmpeg/ffmpeg-audio-process.ts

package/dist/audio-codec-ffmpeg/index.mjs

@@ -1,4 +1,4 @@
-import { B as errMsg, V as BaseAddon, v as audioCodecCapability } from "../dist-CgEP_0OL.mjs";
+import { B as errMsg, V as BaseAddon, v as audioCodecCapability } from "../dist-C6_wgXqF.mjs";
 import { randomUUID } from "node:crypto";
 import { spawn } from "node:child_process";
 //#region src/audio-codec-ffmpeg/ffmpeg-audio-process.ts

package/dist/decoder-ffmpeg/index.js

@@ -2,8 +2,8 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_dist = require("../dist-DAIlCdAx.js");
-const require_frame_ring_sink = require("../frame-ring-sink-BbzrqTWj.js");
+const require_dist = require("../dist-Biq62zt4.js");
+const require_frame_ring_sink = require("../frame-ring-sink-9J0wCdLF.js");
 const require_frame_dropper = require("../frame-dropper-7RTo_YyG.js");
 let _camstack_shm_ring = require("@camstack/shm-ring");
 let node_crypto = require("node:crypto");
@@ -896,6 +896,18 @@ function probeGpuScaleFilters(ffmpegPath, logger) {
 //#endregion
 //#region src/decoder-ffmpeg/addon/index.ts
 var FRAME_BUFFER_CAPACITY = 32;
+var DEFAULT_DECODER_FFMPEG_ADDON_CONFIG = {
+	...require_dist.DEFAULT_DECODER_HWACCEL_CONFIG,
+	backend: require_frame_ring_sink.DEFAULT_DECODER_BACKEND
+};
+/** The two selectable decoder backends, in default-first order. */
+var DECODER_BACKEND_OPTIONS = [{
+	value: "ffmpeg",
+	label: "ffmpeg (subprocess — crash-isolated, default)"
+}, {
+	value: "nodeav",
+	label: "node-av (in-process FFmpeg bindings)"
+}];
 var DecoderFfmpegAddon = class extends require_dist.BaseAddon {
 	sessions = /* @__PURE__ */ new Map();
 	frameBuffers = /* @__PURE__ */ new Map();
@@ -926,10 +938,24 @@ var DecoderFfmpegAddon = class extends require_dist.BaseAddon {
 	*/
 	unsupportedGpuScaleFilters = /* @__PURE__ */ new Set();
 	constructor() {
-		super(require_dist.DEFAULT_DECODER_HWACCEL_CONFIG);
+		super(DEFAULT_DECODER_FFMPEG_ADDON_CONFIG);
 	}
 	globalSettingsSchema() {
 		return this.schema({ sections: [{
+			id: "backend",
+			title: "Decoder backend",
+			tab: "decoder",
+			description: "Which decoder addon provides the decoder capability on this node — per-node selection, stored centrally on the hub. Selection is decided once at addon init (registration-time, race-free), so a change applies at the next restart of the decoder addons on the node.",
+			fields: [this.field({
+				type: "select",
+				key: "backend",
+				label: "Backend",
+				options: [...DECODER_BACKEND_OPTIONS],
+				default: require_frame_ring_sink.DEFAULT_DECODER_BACKEND,
+				immediate: true,
+				perNode: true
+			})]
+		}, {
 			id: "hwaccel",
 			title: "Hardware acceleration",
 			tab: "decoder",
@@ -948,6 +974,7 @@ var DecoderFfmpegAddon = class extends require_dist.BaseAddon {
 				description: "Auto-detected best decoder backend on this host. Click the refresh icon to re-run the probe.",
 				readonlyField: true,
 				default: "",
+				perNode: true,
 				actions: [{
 					action: "reprobe-hwaccel",
 					icon: "refresh-cw",
@@ -957,7 +984,7 @@ var DecoderFfmpegAddon = class extends require_dist.BaseAddon {
 		}] });
 	}
 	async onInitialize() {
-		const backend = await require_frame_ring_sink.resolveDecoderBackend(this.ctx.settings, this.resolveLocalNodeId(), this.ctx.logger);
+		const backend = await require_frame_ring_sink.resolveDecoderBackend(this.ctx.api, this.resolveLocalNodeId(), this.ctx.logger);
 		if (backend !== "ffmpeg") {
 			this.ctx.logger.info("ffmpeg decoder: this node selects a different decoder backend — standing down (no decoder provider registered)", { meta: { selectedBackend: backend } });
 			return [];
@@ -1025,8 +1052,9 @@ var DecoderFfmpegAddon = class extends require_dist.BaseAddon {
 		if (pref === "none") return [];
 		if (pref !== "auto") return [pref];
 		try {
-			const res = await this.ctx.api.platformProbe.resolveHwAccel.query({ prefer: null });
-			const supported = await this.ctx.api.platformProbe.getHardwareDecodeAccels.query();
+			const pin = require_dist.nodePin(this.resolveLocalNodeId());
+			const res = await this.ctx.api.platformProbe.resolveHwAccel.query({ prefer: null }, pin);
+			const supported = await this.ctx.api.platformProbe.getHardwareDecodeAccels.query(void 0, pin);
 			return rankDecodeHwAccels(res.preferred, supported.methods);
 		} catch (err) {
 			this.ctx.logger.warn("ffmpeg: decode-hwaccel probe failed — software decode", { meta: { error: err instanceof Error ? err.message : String(err) } });
@@ -1037,13 +1065,13 @@ var DecoderFfmpegAddon = class extends require_dist.BaseAddon {
 		const resolver = this.ctx.kernel.hwaccel;
 		if (!resolver) {
 			this.ctx.logger.warn("reprobeHwaccel: no kernel hwaccel resolver — returning none");
-			await this.ctx.settings?.writeAddonStore({ probedBestHwaccel: "none" });
+			await this.updateGlobalSettings({ probedBestHwaccel: "none" });
 			return { backend: "none" };
 		}
 		try {
 			const res = await resolver.resolve();
 			const backend = res.preferred[0] ?? "none";
-			await this.ctx.settings?.writeAddonStore({ probedBestHwaccel: backend });
+			await this.updateGlobalSettings({ probedBestHwaccel: backend });
 			this.ctx.logger.info("reprobeHwaccel: wrote probedBestHwaccel", { meta: {
 				backend,
 				rationale: res.rationale,
@@ -1052,7 +1080,7 @@ var DecoderFfmpegAddon = class extends require_dist.BaseAddon {
 			return { backend };
 		} catch (err) {
 			this.ctx.logger.warn("reprobeHwaccel failed", { meta: { error: err instanceof Error ? err.message : String(err) } });
-			await this.ctx.settings?.writeAddonStore({ probedBestHwaccel: "none" });
+			await this.updateGlobalSettings({ probedBestHwaccel: "none" });
 			return { backend: "none" };
 		}
 	}
@@ -1119,7 +1147,7 @@ var DecoderFfmpegAddon = class extends require_dist.BaseAddon {
 		};
 	}
 	wireCallbackSink(sessionId, session) {
-		const ringBuffer = new require_dist.RingBuffer(FRAME_BUFFER_CAPACITY);
+		const ringBuffer = new require_frame_ring_sink.NotifyingRingBuffer(FRAME_BUFFER_CAPACITY);
 		this.frameBuffers.set(sessionId, ringBuffer);
 		return session.onFrame((frame) => {
 			const { format } = frame;
@@ -1137,7 +1165,7 @@ var DecoderFfmpegAddon = class extends require_dist.BaseAddon {
 		});
 	}
 	wireShmSink(sessionId, session) {
-		const handleRing = new require_dist.RingBuffer(FRAME_BUFFER_CAPACITY);
+		const handleRing = new require_frame_ring_sink.NotifyingRingBuffer(FRAME_BUFFER_CAPACITY);
 		this.handleBuffers.set(sessionId, handleRing);
 		return session.onFrameHandle((frame) => {
 			handleRing.push(frame.handle);
@@ -1149,6 +1177,8 @@ var DecoderFfmpegAddon = class extends require_dist.BaseAddon {
 		if (!session) throw new Error(`decoder-ffmpeg: unknown sessionId ${sessionId}`);
 		const unsub = this.unsubscribers.get(sessionId);
 		if (unsub) unsub();
+		this.frameBuffers.get(sessionId)?.cancel();
+		this.handleBuffers.get(sessionId)?.cancel();
 		await session.destroy();
 		this.sessions.delete(sessionId);
 		this.frameBuffers.delete(sessionId);
@@ -1186,12 +1216,14 @@ var DecoderFfmpegAddon = class extends require_dist.BaseAddon {
 		if (!this.sessions.has(input.sessionId)) throw new Error(`decoder-ffmpeg: unknown sessionId ${input.sessionId}`);
 		const ringBuffer = this.frameBuffers.get(input.sessionId);
 		if (!ringBuffer) return [];
+		if (ringBuffer.size === 0 && input.waitMs) await ringBuffer.waitForItem(input.waitMs);
 		return ringBuffer.drain(input.maxCount);
 	}
 	async pullHandles(input) {
 		if (!this.sessions.has(input.sessionId)) throw new Error(`decoder-ffmpeg: unknown sessionId ${input.sessionId}`);
 		const handleRing = this.handleBuffers.get(input.sessionId);
 		if (!handleRing) return [];
+		if (handleRing.size === 0 && input.waitMs) await handleRing.waitForItem(input.waitMs);
 		return handleRing.drain(input.maxCount);
 	}
 	async updateConfig(input) {

package/dist/decoder-ffmpeg/index.mjs

@@ -1,5 +1,5 @@
-import { B as errMsg, V as BaseAddon, d as HWACCEL_OPTIONS, p as RingBuffer, s as DEFAULT_DECODER_HWACCEL_CONFIG, x as decoderCapability } from "../dist-CgEP_0OL.mjs";
-import { i as resolveDecoderBackend, n as RING_BUDGET_MB, t as DecoderFrameRingSink } from "../frame-ring-sink-B_NvPTJZ.mjs";
+import { B as errMsg, V as BaseAddon, d as HWACCEL_OPTIONS, j as nodePin, s as DEFAULT_DECODER_HWACCEL_CONFIG, x as decoderCapability } from "../dist-C6_wgXqF.mjs";
+import { a as resolveDecoderBackend, i as NotifyingRingBuffer, n as RING_BUDGET_MB, o as DEFAULT_DECODER_BACKEND, t as DecoderFrameRingSink } from "../frame-ring-sink-Cs9vby6v.mjs";
 import { r as logBannerArgs, t as FrameDropper } from "../frame-dropper-CwkBTPGV.mjs";
 import { FrameRingReaderCache } from "@camstack/shm-ring";
 import { randomUUID } from "node:crypto";
@@ -892,6 +892,18 @@ function probeGpuScaleFilters(ffmpegPath, logger) {
 //#endregion
 //#region src/decoder-ffmpeg/addon/index.ts
 var FRAME_BUFFER_CAPACITY = 32;
+var DEFAULT_DECODER_FFMPEG_ADDON_CONFIG = {
+	...DEFAULT_DECODER_HWACCEL_CONFIG,
+	backend: DEFAULT_DECODER_BACKEND
+};
+/** The two selectable decoder backends, in default-first order. */
+var DECODER_BACKEND_OPTIONS = [{
+	value: "ffmpeg",
+	label: "ffmpeg (subprocess — crash-isolated, default)"
+}, {
+	value: "nodeav",
+	label: "node-av (in-process FFmpeg bindings)"
+}];
 var DecoderFfmpegAddon = class extends BaseAddon {
 	sessions = /* @__PURE__ */ new Map();
 	frameBuffers = /* @__PURE__ */ new Map();
@@ -922,10 +934,24 @@ var DecoderFfmpegAddon = class extends BaseAddon {
 	*/
 	unsupportedGpuScaleFilters = /* @__PURE__ */ new Set();
 	constructor() {
-		super(DEFAULT_DECODER_HWACCEL_CONFIG);
+		super(DEFAULT_DECODER_FFMPEG_ADDON_CONFIG);
 	}
 	globalSettingsSchema() {
 		return this.schema({ sections: [{
+			id: "backend",
+			title: "Decoder backend",
+			tab: "decoder",
+			description: "Which decoder addon provides the decoder capability on this node — per-node selection, stored centrally on the hub. Selection is decided once at addon init (registration-time, race-free), so a change applies at the next restart of the decoder addons on the node.",
+			fields: [this.field({
+				type: "select",
+				key: "backend",
+				label: "Backend",
+				options: [...DECODER_BACKEND_OPTIONS],
+				default: DEFAULT_DECODER_BACKEND,
+				immediate: true,
+				perNode: true
+			})]
+		}, {
 			id: "hwaccel",
 			title: "Hardware acceleration",
 			tab: "decoder",
@@ -944,6 +970,7 @@ var DecoderFfmpegAddon = class extends BaseAddon {
 				description: "Auto-detected best decoder backend on this host. Click the refresh icon to re-run the probe.",
 				readonlyField: true,
 				default: "",
+				perNode: true,
 				actions: [{
 					action: "reprobe-hwaccel",
 					icon: "refresh-cw",
@@ -953,7 +980,7 @@ var DecoderFfmpegAddon = class extends BaseAddon {
 		}] });
 	}
 	async onInitialize() {
-		const backend = await resolveDecoderBackend(this.ctx.settings, this.resolveLocalNodeId(), this.ctx.logger);
+		const backend = await resolveDecoderBackend(this.ctx.api, this.resolveLocalNodeId(), this.ctx.logger);
 		if (backend !== "ffmpeg") {
 			this.ctx.logger.info("ffmpeg decoder: this node selects a different decoder backend — standing down (no decoder provider registered)", { meta: { selectedBackend: backend } });
 			return [];
@@ -1021,8 +1048,9 @@ var DecoderFfmpegAddon = class extends BaseAddon {
 		if (pref === "none") return [];
 		if (pref !== "auto") return [pref];
 		try {
-			const res = await this.ctx.api.platformProbe.resolveHwAccel.query({ prefer: null });
-			const supported = await this.ctx.api.platformProbe.getHardwareDecodeAccels.query();
+			const pin = nodePin(this.resolveLocalNodeId());
+			const res = await this.ctx.api.platformProbe.resolveHwAccel.query({ prefer: null }, pin);
+			const supported = await this.ctx.api.platformProbe.getHardwareDecodeAccels.query(void 0, pin);
 			return rankDecodeHwAccels(res.preferred, supported.methods);
 		} catch (err) {
 			this.ctx.logger.warn("ffmpeg: decode-hwaccel probe failed — software decode", { meta: { error: err instanceof Error ? err.message : String(err) } });
@@ -1033,13 +1061,13 @@ var DecoderFfmpegAddon = class extends BaseAddon {
 		const resolver = this.ctx.kernel.hwaccel;
 		if (!resolver) {
 			this.ctx.logger.warn("reprobeHwaccel: no kernel hwaccel resolver — returning none");
-			await this.ctx.settings?.writeAddonStore({ probedBestHwaccel: "none" });
+			await this.updateGlobalSettings({ probedBestHwaccel: "none" });
 			return { backend: "none" };
 		}
 		try {
 			const res = await resolver.resolve();
 			const backend = res.preferred[0] ?? "none";
-			await this.ctx.settings?.writeAddonStore({ probedBestHwaccel: backend });
+			await this.updateGlobalSettings({ probedBestHwaccel: backend });
 			this.ctx.logger.info("reprobeHwaccel: wrote probedBestHwaccel", { meta: {
 				backend,
 				rationale: res.rationale,
@@ -1048,7 +1076,7 @@ var DecoderFfmpegAddon = class extends BaseAddon {
 			return { backend };
 		} catch (err) {
 			this.ctx.logger.warn("reprobeHwaccel failed", { meta: { error: err instanceof Error ? err.message : String(err) } });
-			await this.ctx.settings?.writeAddonStore({ probedBestHwaccel: "none" });
+			await this.updateGlobalSettings({ probedBestHwaccel: "none" });
 			return { backend: "none" };
 		}
 	}
@@ -1115,7 +1143,7 @@ var DecoderFfmpegAddon = class extends BaseAddon {
 		};
 	}
 	wireCallbackSink(sessionId, session) {
-		const ringBuffer = new RingBuffer(FRAME_BUFFER_CAPACITY);
+		const ringBuffer = new NotifyingRingBuffer(FRAME_BUFFER_CAPACITY);
 		this.frameBuffers.set(sessionId, ringBuffer);
 		return session.onFrame((frame) => {
 			const { format } = frame;
@@ -1133,7 +1161,7 @@ var DecoderFfmpegAddon = class extends BaseAddon {
 		});
 	}
 	wireShmSink(sessionId, session) {
-		const handleRing = new RingBuffer(FRAME_BUFFER_CAPACITY);
+		const handleRing = new NotifyingRingBuffer(FRAME_BUFFER_CAPACITY);
 		this.handleBuffers.set(sessionId, handleRing);
 		return session.onFrameHandle((frame) => {
 			handleRing.push(frame.handle);
@@ -1145,6 +1173,8 @@ var DecoderFfmpegAddon = class extends BaseAddon {
 		if (!session) throw new Error(`decoder-ffmpeg: unknown sessionId ${sessionId}`);
 		const unsub = this.unsubscribers.get(sessionId);
 		if (unsub) unsub();
+		this.frameBuffers.get(sessionId)?.cancel();
+		this.handleBuffers.get(sessionId)?.cancel();
 		await session.destroy();
 		this.sessions.delete(sessionId);
 		this.frameBuffers.delete(sessionId);
@@ -1182,12 +1212,14 @@ var DecoderFfmpegAddon = class extends BaseAddon {
 		if (!this.sessions.has(input.sessionId)) throw new Error(`decoder-ffmpeg: unknown sessionId ${input.sessionId}`);
 		const ringBuffer = this.frameBuffers.get(input.sessionId);
 		if (!ringBuffer) return [];
+		if (ringBuffer.size === 0 && input.waitMs) await ringBuffer.waitForItem(input.waitMs);
 		return ringBuffer.drain(input.maxCount);
 	}
 	async pullHandles(input) {
 		if (!this.sessions.has(input.sessionId)) throw new Error(`decoder-ffmpeg: unknown sessionId ${input.sessionId}`);
 		const handleRing = this.handleBuffers.get(input.sessionId);
 		if (!handleRing) return [];
+		if (handleRing.size === 0 && input.waitMs) await handleRing.waitForItem(input.waitMs);
 		return handleRing.drain(input.maxCount);
 	}
 	async updateConfig(input) {

package/dist/decoder-nodeav/index.js

@@ -2,8 +2,8 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_dist = require("../dist-DAIlCdAx.js");
-const require_frame_ring_sink = require("../frame-ring-sink-BbzrqTWj.js");
+const require_dist = require("../dist-Biq62zt4.js");
+const require_frame_ring_sink = require("../frame-ring-sink-9J0wCdLF.js");
 let _camstack_shm_ring = require("@camstack/shm-ring");
 let node_crypto = require("node:crypto");
 //#region src/decoder-nodeav/scaler-geometry.ts
@@ -927,6 +927,7 @@ var DecoderNodeAvAddon = class extends require_dist.BaseAddon {
 				description: "Auto-detected best decoder backend on this host. Click the refresh icon to re-run the probe.",
 				readonlyField: true,
 				default: "",
+				perNode: true,
 				actions: [{
 					action: "reprobe-hwaccel",
 					icon: "refresh-cw",
@@ -936,7 +937,7 @@ var DecoderNodeAvAddon = class extends require_dist.BaseAddon {
 		}] });
 	}
 	async onInitialize() {
-		const backend = await require_frame_ring_sink.resolveDecoderBackend(this.ctx.settings, this.resolveLocalNodeId(), this.ctx.logger);
+		const backend = await require_frame_ring_sink.resolveDecoderBackend(this.ctx.api, this.resolveLocalNodeId(), this.ctx.logger);
 		if (backend !== "nodeav") {
 			this.ctx.logger.info("node-av decoder: this node selects a different decoder backend — standing down (no decoder provider registered)", { meta: { selectedBackend: backend } });
 			return [];
@@ -970,13 +971,13 @@ var DecoderNodeAvAddon = class extends require_dist.BaseAddon {
 		const resolver = this.ctx.kernel.hwaccel;
 		if (!resolver) {
 			this.ctx.logger.warn("reprobeHwaccel: no kernel hwaccel resolver — returning none");
-			await this.ctx.settings?.writeAddonStore({ probedBestHwaccel: "none" });
+			await this.updateGlobalSettings({ probedBestHwaccel: "none" });
 			return { backend: "none" };
 		}
 		try {
 			const res = await resolver.resolve();
 			const backend = res.preferred[0] ?? "none";
-			await this.ctx.settings?.writeAddonStore({ probedBestHwaccel: backend });
+			await this.updateGlobalSettings({ probedBestHwaccel: backend });
 			this.ctx.logger.info("reprobeHwaccel: wrote probedBestHwaccel", { meta: {
 				backend,
 				rationale: res.rationale,
@@ -985,7 +986,7 @@ var DecoderNodeAvAddon = class extends require_dist.BaseAddon {
 			return { backend };
 		} catch (err) {
 			this.ctx.logger.warn("reprobeHwaccel failed", { meta: { error: err instanceof Error ? err.message : String(err) } });
-			await this.ctx.settings?.writeAddonStore({ probedBestHwaccel: "none" });
+			await this.updateGlobalSettings({ probedBestHwaccel: "none" });
 			return { backend: "none" };
 		}
 	}
@@ -1052,7 +1053,7 @@ var DecoderNodeAvAddon = class extends require_dist.BaseAddon {
 	* ring buffer drained by `pullFrames`.
 	*/
 	wireCallbackSink(sessionId, session) {
-		const ringBuffer = new require_dist.RingBuffer(FRAME_BUFFER_CAPACITY);
+		const ringBuffer = new require_frame_ring_sink.NotifyingRingBuffer(FRAME_BUFFER_CAPACITY);
 		this.frameBuffers.set(sessionId, ringBuffer);
 		return session.onFrame((frame) => {
 			const { format } = frame;
@@ -1075,7 +1076,7 @@ var DecoderNodeAvAddon = class extends require_dist.BaseAddon {
 	* — the broker opens the named segment and reads the pixels zero-copy.
 	*/
 	wireShmSink(sessionId, session) {
-		const handleRing = new require_dist.RingBuffer(FRAME_BUFFER_CAPACITY);
+		const handleRing = new require_frame_ring_sink.NotifyingRingBuffer(FRAME_BUFFER_CAPACITY);
 		this.handleBuffers.set(sessionId, handleRing);
 		return session.onFrameHandle((frame) => {
 			handleRing.push(frame.handle);
@@ -1087,6 +1088,8 @@ var DecoderNodeAvAddon = class extends require_dist.BaseAddon {
 		if (!session) throw new Error(`decoder-nodeav: unknown sessionId ${sessionId}`);
 		const unsub = this.unsubscribers.get(sessionId);
 		if (unsub) unsub();
+		this.frameBuffers.get(sessionId)?.cancel();
+		this.handleBuffers.get(sessionId)?.cancel();
 		await session.destroy();
 		this.sessions.delete(sessionId);
 		this.frameBuffers.delete(sessionId);
@@ -1123,12 +1126,14 @@ var DecoderNodeAvAddon = class extends require_dist.BaseAddon {
 		if (!this.sessions.has(input.sessionId)) throw new Error(`decoder-nodeav: unknown sessionId ${input.sessionId}`);
 		const ringBuffer = this.frameBuffers.get(input.sessionId);
 		if (!ringBuffer) return [];
+		if (ringBuffer.size === 0 && input.waitMs) await ringBuffer.waitForItem(input.waitMs);
 		return ringBuffer.drain(input.maxCount);
 	}
 	async pullHandles(input) {
 		if (!this.sessions.has(input.sessionId)) throw new Error(`decoder-nodeav: unknown sessionId ${input.sessionId}`);
 		const handleRing = this.handleBuffers.get(input.sessionId);
 		if (!handleRing) return [];
+		if (handleRing.size === 0 && input.waitMs) await handleRing.waitForItem(input.waitMs);
 		return handleRing.drain(input.maxCount);
 	}
 	async updateConfig(input) {

package/dist/decoder-nodeav/index.mjs

@@ -1,5 +1,5 @@
-import { B as errMsg, V as BaseAddon, d as HWACCEL_OPTIONS, p as RingBuffer, s as DEFAULT_DECODER_HWACCEL_CONFIG, x as decoderCapability } from "../dist-CgEP_0OL.mjs";
-import { i as resolveDecoderBackend, n as RING_BUDGET_MB, r as makeSegmentName, t as DecoderFrameRingSink } from "../frame-ring-sink-B_NvPTJZ.mjs";
+import { B as errMsg, V as BaseAddon, d as HWACCEL_OPTIONS, s as DEFAULT_DECODER_HWACCEL_CONFIG, x as decoderCapability } from "../dist-C6_wgXqF.mjs";
+import { a as resolveDecoderBackend, i as NotifyingRingBuffer, n as RING_BUDGET_MB, r as makeSegmentName, t as DecoderFrameRingSink } from "../frame-ring-sink-Cs9vby6v.mjs";
 import { FrameRingReaderCache } from "@camstack/shm-ring";
 import { randomUUID } from "node:crypto";
 //#region src/decoder-nodeav/scaler-geometry.ts
@@ -923,6 +923,7 @@ var DecoderNodeAvAddon = class extends BaseAddon {
 				description: "Auto-detected best decoder backend on this host. Click the refresh icon to re-run the probe.",
 				readonlyField: true,
 				default: "",
+				perNode: true,
 				actions: [{
 					action: "reprobe-hwaccel",
 					icon: "refresh-cw",
@@ -932,7 +933,7 @@ var DecoderNodeAvAddon = class extends BaseAddon {
 		}] });
 	}
 	async onInitialize() {
-		const backend = await resolveDecoderBackend(this.ctx.settings, this.resolveLocalNodeId(), this.ctx.logger);
+		const backend = await resolveDecoderBackend(this.ctx.api, this.resolveLocalNodeId(), this.ctx.logger);
 		if (backend !== "nodeav") {
 			this.ctx.logger.info("node-av decoder: this node selects a different decoder backend — standing down (no decoder provider registered)", { meta: { selectedBackend: backend } });
 			return [];
@@ -966,13 +967,13 @@ var DecoderNodeAvAddon = class extends BaseAddon {
 		const resolver = this.ctx.kernel.hwaccel;
 		if (!resolver) {
 			this.ctx.logger.warn("reprobeHwaccel: no kernel hwaccel resolver — returning none");
-			await this.ctx.settings?.writeAddonStore({ probedBestHwaccel: "none" });
+			await this.updateGlobalSettings({ probedBestHwaccel: "none" });
 			return { backend: "none" };
 		}
 		try {
 			const res = await resolver.resolve();
 			const backend = res.preferred[0] ?? "none";
-			await this.ctx.settings?.writeAddonStore({ probedBestHwaccel: backend });
+			await this.updateGlobalSettings({ probedBestHwaccel: backend });
 			this.ctx.logger.info("reprobeHwaccel: wrote probedBestHwaccel", { meta: {
 				backend,
 				rationale: res.rationale,
@@ -981,7 +982,7 @@ var DecoderNodeAvAddon = class extends BaseAddon {
 			return { backend };
 		} catch (err) {
 			this.ctx.logger.warn("reprobeHwaccel failed", { meta: { error: err instanceof Error ? err.message : String(err) } });
-			await this.ctx.settings?.writeAddonStore({ probedBestHwaccel: "none" });
+			await this.updateGlobalSettings({ probedBestHwaccel: "none" });
 			return { backend: "none" };
 		}
 	}
@@ -1048,7 +1049,7 @@ var DecoderNodeAvAddon = class extends BaseAddon {
 	* ring buffer drained by `pullFrames`.
 	*/
 	wireCallbackSink(sessionId, session) {
-		const ringBuffer = new RingBuffer(FRAME_BUFFER_CAPACITY);
+		const ringBuffer = new NotifyingRingBuffer(FRAME_BUFFER_CAPACITY);
 		this.frameBuffers.set(sessionId, ringBuffer);
 		return session.onFrame((frame) => {
 			const { format } = frame;
@@ -1071,7 +1072,7 @@ var DecoderNodeAvAddon = class extends BaseAddon {
 	* — the broker opens the named segment and reads the pixels zero-copy.
 	*/
 	wireShmSink(sessionId, session) {
-		const handleRing = new RingBuffer(FRAME_BUFFER_CAPACITY);
+		const handleRing = new NotifyingRingBuffer(FRAME_BUFFER_CAPACITY);
 		this.handleBuffers.set(sessionId, handleRing);
 		return session.onFrameHandle((frame) => {
 			handleRing.push(frame.handle);
@@ -1083,6 +1084,8 @@ var DecoderNodeAvAddon = class extends BaseAddon {
 		if (!session) throw new Error(`decoder-nodeav: unknown sessionId ${sessionId}`);
 		const unsub = this.unsubscribers.get(sessionId);
 		if (unsub) unsub();
+		this.frameBuffers.get(sessionId)?.cancel();
+		this.handleBuffers.get(sessionId)?.cancel();
 		await session.destroy();
 		this.sessions.delete(sessionId);
 		this.frameBuffers.delete(sessionId);
@@ -1119,12 +1122,14 @@ var DecoderNodeAvAddon = class extends BaseAddon {
 		if (!this.sessions.has(input.sessionId)) throw new Error(`decoder-nodeav: unknown sessionId ${input.sessionId}`);
 		const ringBuffer = this.frameBuffers.get(input.sessionId);
 		if (!ringBuffer) return [];
+		if (ringBuffer.size === 0 && input.waitMs) await ringBuffer.waitForItem(input.waitMs);
 		return ringBuffer.drain(input.maxCount);
 	}
 	async pullHandles(input) {
 		if (!this.sessions.has(input.sessionId)) throw new Error(`decoder-nodeav: unknown sessionId ${input.sessionId}`);
 		const handleRing = this.handleBuffers.get(input.sessionId);
 		if (!handleRing) return [];
+		if (handleRing.size === 0 && input.waitMs) await handleRing.waitForItem(input.waitMs);
 		return handleRing.drain(input.maxCount);
 	}
 	async updateConfig(input) {