@camstack/addon-pipeline 1.1.39 → 1.1.40

package/dist/audio-analyzer/index.js

@@ -3,7 +3,7 @@ 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-DbGdZ8Nr.js");
+const require_dist = require("../dist-BJTPkJFw.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);
@@ -415,6 +415,7 @@ var AUDIO_MODEL_OPTIONS = [
 */
 var CLASSIFY_ERROR_SUPPRESS_MS = 3e4;
 var CLASSIFY_MIN_INTERVAL_MS = 500;
+var PIPELINE_IDLE_DISPOSE_MS = 5 * 6e4;
 var GLOBAL_DEVICE_KEY = -1;
 /**
 * Reconstruct a Float32 view over f32le PCM bytes carried in a Uint8Array.
@@ -431,7 +432,7 @@ function float32FromBytes(raw) {
 	return new Float32Array(bytes.buffer, bytes.byteOffset, Math.floor(bytes.byteLength / 4));
 }
 var AudioAnalyzerProvider = class {
-	pipeline;
+	pipelineFactory;
 	deviceSettingsResolver;
 	deviceContributionResolver;
 	deviceSettingsPatcher;
@@ -451,14 +452,98 @@ var AudioAnalyzerProvider = class {
 	*  run at a time. Without this, concurrent calls from different cameras overwrite the
 	*  single pendingResolve slot in AppleSoundAnalysisPipeline, causing 30s timeouts. */
 	pipelineBusy = false;
-	constructor(logger, pipeline, backendName, deviceSettingsResolver, deviceContributionResolver, deviceSettingsPatcher, reprobeImpl) {
-		this.pipeline = pipeline;
+	/** Live inference pipeline. LAZY: null until the first classify() spawns it
+	*  (see `ensurePipeline`); idle-disposed back to null after a long quiet
+	*  window so a node hosting the addon with no consumer never keeps the
+	*  YAMNet Python / Apple SoundAnalysis subprocess resident. */
+	pipeline = null;
+	/** Single-flight guard for the lazy spawn — concurrent first-calls await the
+	*  same build instead of spawning the subprocess twice. */
+	pipelineInitPromise = null;
+	/** Backend the NEXT lazy init will build (kept in sync with the operator's
+	*  effective choice via `reconfigureBackend`). */
+	desiredBackend;
+	/** Idle-dispose timer — (re)armed after every classify. */
+	idleTimer = null;
+	/** Set on `dispose()` (addon stop) so a late classify/idle-timer never
+	*  re-spawns the subprocess after teardown. */
+	disposed = false;
+	constructor(logger, pipelineFactory, initialBackend, deviceSettingsResolver, deviceContributionResolver, deviceSettingsPatcher, reprobeImpl) {
+		this.pipelineFactory = pipelineFactory;
 		this.deviceSettingsResolver = deviceSettingsResolver;
 		this.deviceContributionResolver = deviceContributionResolver;
 		this.deviceSettingsPatcher = deviceSettingsPatcher;
 		this.reprobeImpl = reprobeImpl;
 		this.log = logger;
-		this.backendName = backendName;
+		this.backendName = initialBackend;
+		this.desiredBackend = initialBackend;
+	}
+	/**
+	* Lazily spawn + initialize the inference pipeline on first use. The
+	* subprocess (YAMNet Python / Apple SoundAnalysis CLI, resident model) is NOT
+	* booted at addon start — only when the first classify() actually lands, so a
+	* node hosting the addon with no audio-classification consumer never spawns
+	* it. Concurrent first-calls single-flight through `pipelineInitPromise` so
+	* the subprocess is spawned exactly once.
+	*/
+	async ensurePipeline() {
+		if (this.disposed) throw new Error("audio-analyzer: provider disposed");
+		const live = this.pipeline;
+		if (live) return live;
+		if (this.pipelineInitPromise) return this.pipelineInitPromise;
+		const backend = this.desiredBackend;
+		const init = (async () => {
+			this.log.info("audio pipeline lazy init (first classify)", { meta: { backend } });
+			const built = await this.pipelineFactory(backend);
+			if (this.disposed) {
+				await built.dispose().catch(() => {});
+				throw new Error("audio-analyzer: provider disposed during init");
+			}
+			this.pipeline = built;
+			this.backendName = backend;
+			return built;
+		})();
+		this.pipelineInitPromise = init;
+		try {
+			return await init;
+		} finally {
+			this.pipelineInitPromise = null;
+		}
+	}
+	/** (Re)arm the idle-dispose timer. Called after every classify. */
+	scheduleIdleDispose() {
+		if (this.disposed) return;
+		if (this.idleTimer) clearTimeout(this.idleTimer);
+		const timer = setTimeout(() => {
+			this.idleTimer = null;
+			this.disposeIdlePipeline();
+		}, PIPELINE_IDLE_DISPOSE_MS);
+		if (typeof timer.unref === "function") timer.unref();
+		this.idleTimer = timer;
+	}
+	/**
+	* Tear the inference subprocess down after a long idle window, freeing the
+	* resident model. The next classify lazily re-spawns it. No-op (and re-arms)
+	* if a classify is in flight; no-op if nothing is spawned.
+	*/
+	async disposeIdlePipeline() {
+		if (this.disposed) return;
+		if (this.pipelineBusy || this.pipelineInitPromise) {
+			this.scheduleIdleDispose();
+			return;
+		}
+		const live = this.pipeline;
+		if (!live) return;
+		this.pipeline = null;
+		try {
+			await live.dispose();
+			this.log.info("audio pipeline idle-disposed — freed inference subprocess", { meta: {
+				backend: this.backendName,
+				idleMs: PIPELINE_IDLE_DISPOSE_MS
+			} });
+		} catch (err) {
+			this.log.warn("audio pipeline idle-dispose failed", { meta: { error: require_dist.errMsg(err) } });
+		}
 	}
 	async getDeviceSettingsContribution(input) {
 		return this.deviceContributionResolver(input.deviceId);
@@ -568,61 +653,88 @@ var AudioAnalyzerProvider = class {
 			lastEndMs: state?.lastEndMs ?? 0
 		});
 		this.pipelineBusy = true;
-		const f32Data = float32FromBytes(chunk.data);
-		const result = await this.pipeline.classify({
-			data: f32Data,
-			sampleRate: chunk.sampleRate,
-			channels: chunk.channels
-		}).finally(() => {
+		try {
+			const pipeline = await this.ensurePipeline();
+			const f32Data = float32FromBytes(chunk.data);
+			const result = await pipeline.classify({
+				data: f32Data,
+				sampleRate: chunk.sampleRate,
+				channels: chunk.channels
+			});
+			if (this.debugClassifySamples && (this.classifyCount < 3 || this.classifyCount % 100 === 0)) {
+				const rawTop = result.classifications.slice(0, 5).map((c) => `"${c.className}"(${(c.score * 100).toFixed(0)}%)`).join(", ");
+				this.log.info("classify debug sample", {
+					tags: chunk.deviceId !== void 0 ? { deviceId: chunk.deviceId } : void 0,
+					meta: {
+						index: this.classifyCount,
+						engine: this.backendName,
+						rawLabelCount: result.classifications.length,
+						top: rawTop,
+						inferenceMs: result.inferenceMs
+					}
+				});
+			}
+			this.classifyCount++;
+			const macroAccum = /* @__PURE__ */ new Map();
+			for (const c of result.classifications) {
+				const macro = require_dist.mapAudioLabelToMacro(c.className);
+				if (!macro) continue;
+				const prev = macroAccum.get(macro);
+				if (!prev || c.score > prev.score) macroAccum.set(macro, {
+					score: c.score,
+					rawTop: c.className
+				});
+			}
+			return {
+				labels: [...macroAccum.entries()].toSorted((a, b) => b[1].score - a[1].score).map(([className, { score, rawTop }]) => ({
+					className,
+					originalClass: rawTop,
+					score
+				})),
+				rawLabels: [...result.classifications].toSorted((a, b) => b.score - a.score).map((c) => ({
+					className: c.className,
+					originalClass: c.className,
+					score: c.score
+				})),
+				inferenceMs: result.inferenceMs
+			};
+		} finally {
 			this.pipelineBusy = false;
 			this.cameraState.set(camKey, {
 				inProgress: false,
 				lastEndMs: Date.now()
 			});
-		});
-		if (this.debugClassifySamples && (this.classifyCount < 3 || this.classifyCount % 100 === 0)) {
-			const rawTop = result.classifications.slice(0, 5).map((c) => `"${c.className}"(${(c.score * 100).toFixed(0)}%)`).join(", ");
-			this.log.info("classify debug sample", {
-				tags: chunk.deviceId !== void 0 ? { deviceId: chunk.deviceId } : void 0,
-				meta: {
-					index: this.classifyCount,
-					engine: this.backendName,
-					rawLabelCount: result.classifications.length,
-					top: rawTop,
-					inferenceMs: result.inferenceMs
-				}
-			});
-		}
-		this.classifyCount++;
-		const macroAccum = /* @__PURE__ */ new Map();
-		for (const c of result.classifications) {
-			const macro = require_dist.mapAudioLabelToMacro(c.className);
-			if (!macro) continue;
-			const prev = macroAccum.get(macro);
-			if (!prev || c.score > prev.score) macroAccum.set(macro, {
-				score: c.score,
-				rawTop: c.className
-			});
+			this.scheduleIdleDispose();
 		}
-		return {
-			labels: [...macroAccum.entries()].toSorted((a, b) => b[1].score - a[1].score).map(([className, { score, rawTop }]) => ({
-				className,
-				originalClass: rawTop,
-				score
-			})),
-			rawLabels: [...result.classifications].toSorted((a, b) => b.score - a.score).map((c) => ({
-				className: c.className,
-				originalClass: c.className,
-				score: c.score
-			})),
-			inferenceMs: result.inferenceMs
-		};
 	}
 	isReady() {
-		return this.pipeline !== null;
+		return !this.disposed;
 	}
 	async dispose() {
-		await this.pipeline.dispose();
+		this.disposed = true;
+		if (this.idleTimer) {
+			clearTimeout(this.idleTimer);
+			this.idleTimer = null;
+		}
+		const live = this.pipeline;
+		this.pipeline = null;
+		if (live) await live.dispose();
+	}
+	/**
+	* Apply a backend/model change. Records the backend the NEXT lazy init will
+	* build; if a pipeline is already live it rebuilds IN PLACE (via
+	* `swapPipeline`), otherwise the subprocess stays unspawned until the next
+	* classify. Lets the audio engine settings apply without an addon restart,
+	* mirroring the detection-pipeline's in-place engine swap.
+	*/
+	async reconfigureBackend(next) {
+		this.desiredBackend = next;
+		if (!this.pipeline) {
+			this.backendName = next;
+			return;
+		}
+		const rebuilt = await this.pipelineFactory(next);
+		await this.swapPipeline(rebuilt, next);
 	}
 	/**
 	* Swap the live pipeline in place (optimistic backend/model change) — disposes
@@ -651,9 +763,9 @@ var AudioAnalyzerProvider = class {
 var AudioAnalyzerAddon = class extends require_dist.BaseAddon {
 	id = "audio-analyzer";
 	provider = null;
-	pipeline = null;
-	/** Backend the live `pipeline` actually runs — drives the optimistic in-place
-	*  rebuild in `onConfigChanged` (rebuild only when it genuinely flips). */
+	/** Backend the provider's pipeline is configured for — drives the optimistic
+	*  in-place rebuild in `onConfigChanged` (rebuild only when it genuinely
+	*  flips). The provider owns the (lazy) pipeline itself. */
 	activeBackend = null;
 	constructor() {
 		super(require_dist.DEFAULT_AUDIO_ANALYZER_CONFIG);
@@ -804,8 +916,6 @@ var AudioAnalyzerAddon = class extends require_dist.BaseAddon {
 	async onInitialize() {
 		const logger = this.ctx.logger;
 		const backend = this.resolveAudioBackend();
-		const p = await this.buildPipeline(backend);
-		this.pipeline = p;
 		this.activeBackend = backend;
 		if (!this.config.probedBestAudioBackend) this.reprobeAudioEngine().catch((err) => {
 			logger.warn("audio: auto-reprobe failed", { meta: { error: err instanceof Error ? err.message : String(err) } });
@@ -829,7 +939,7 @@ var AudioAnalyzerAddon = class extends require_dist.BaseAddon {
 			return null;
 		};
 		const deviceSettingsPatcher = async (_deviceId, _patch) => {};
-		this.provider = new AudioAnalyzerProvider(logger, this.pipeline, backend, deviceSettingsResolver, deviceContributionResolver, deviceSettingsPatcher, () => this.reprobeAudioEngine());
+		this.provider = new AudioAnalyzerProvider(logger, (b) => this.buildPipeline(b), backend, deviceSettingsResolver, deviceContributionResolver, deviceSettingsPatcher, () => this.reprobeAudioEngine());
 		return [{
 			capability: require_dist.audioAnalyzerCapability,
 			provider: this.provider
@@ -843,7 +953,6 @@ var AudioAnalyzerAddon = class extends require_dist.BaseAddon {
 			await this.provider.dispose();
 			this.provider = null;
 		}
-		this.pipeline = null;
 		this.activeBackend = null;
 	}
 	/**
@@ -878,13 +987,11 @@ var AudioAnalyzerAddon = class extends require_dist.BaseAddon {
 		if (!this.provider) return;
 		const backend = this.resolveAudioBackend();
 		if (backend === this.activeBackend) return;
-		this.ctx.logger.info("audio backend changed — rebuilding pipeline in place", { meta: {
+		this.ctx.logger.info("audio backend changed — applying to pipeline", { meta: {
 			from: this.activeBackend,
 			to: backend
 		} });
-		const next = await this.buildPipeline(backend);
-		await this.provider.swapPipeline(next, backend);
-		this.pipeline = next;
+		await this.provider.reconfigureBackend(backend);
 		this.activeBackend = backend;
 	}
 	buildDeviceSchema() {

package/dist/audio-analyzer/index.mjs

@@ -1,5 +1,5 @@
 import { t as __require } from "../chunk-BdkLduGY.mjs";
-import { C as mapAudioLabelToMacro, I as errMsg, L as BaseAddon, U as hydrateSchema, h as audioAnalyzerCapability, l as HF_BASE_URL, m as audioAnalysisCapability, n as AUDIO_BACKEND_CHOICES, o as DEFAULT_AUDIO_ANALYZER_CONFIG } from "../dist-DvvYzO58.mjs";
+import { C as mapAudioLabelToMacro, I as errMsg, L as BaseAddon, U as hydrateSchema, h as audioAnalyzerCapability, l as HF_BASE_URL, m as audioAnalysisCapability, n as AUDIO_BACKEND_CHOICES, o as DEFAULT_AUDIO_ANALYZER_CONFIG } from "../dist-v6cKLmU3.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";
@@ -410,6 +410,7 @@ var AUDIO_MODEL_OPTIONS = [
 */
 var CLASSIFY_ERROR_SUPPRESS_MS = 3e4;
 var CLASSIFY_MIN_INTERVAL_MS = 500;
+var PIPELINE_IDLE_DISPOSE_MS = 5 * 6e4;
 var GLOBAL_DEVICE_KEY = -1;
 /**
 * Reconstruct a Float32 view over f32le PCM bytes carried in a Uint8Array.
@@ -426,7 +427,7 @@ function float32FromBytes(raw) {
 	return new Float32Array(bytes.buffer, bytes.byteOffset, Math.floor(bytes.byteLength / 4));
 }
 var AudioAnalyzerProvider = class {
-	pipeline;
+	pipelineFactory;
 	deviceSettingsResolver;
 	deviceContributionResolver;
 	deviceSettingsPatcher;
@@ -446,14 +447,98 @@ var AudioAnalyzerProvider = class {
 	*  run at a time. Without this, concurrent calls from different cameras overwrite the
 	*  single pendingResolve slot in AppleSoundAnalysisPipeline, causing 30s timeouts. */
 	pipelineBusy = false;
-	constructor(logger, pipeline, backendName, deviceSettingsResolver, deviceContributionResolver, deviceSettingsPatcher, reprobeImpl) {
-		this.pipeline = pipeline;
+	/** Live inference pipeline. LAZY: null until the first classify() spawns it
+	*  (see `ensurePipeline`); idle-disposed back to null after a long quiet
+	*  window so a node hosting the addon with no consumer never keeps the
+	*  YAMNet Python / Apple SoundAnalysis subprocess resident. */
+	pipeline = null;
+	/** Single-flight guard for the lazy spawn — concurrent first-calls await the
+	*  same build instead of spawning the subprocess twice. */
+	pipelineInitPromise = null;
+	/** Backend the NEXT lazy init will build (kept in sync with the operator's
+	*  effective choice via `reconfigureBackend`). */
+	desiredBackend;
+	/** Idle-dispose timer — (re)armed after every classify. */
+	idleTimer = null;
+	/** Set on `dispose()` (addon stop) so a late classify/idle-timer never
+	*  re-spawns the subprocess after teardown. */
+	disposed = false;
+	constructor(logger, pipelineFactory, initialBackend, deviceSettingsResolver, deviceContributionResolver, deviceSettingsPatcher, reprobeImpl) {
+		this.pipelineFactory = pipelineFactory;
 		this.deviceSettingsResolver = deviceSettingsResolver;
 		this.deviceContributionResolver = deviceContributionResolver;
 		this.deviceSettingsPatcher = deviceSettingsPatcher;
 		this.reprobeImpl = reprobeImpl;
 		this.log = logger;
-		this.backendName = backendName;
+		this.backendName = initialBackend;
+		this.desiredBackend = initialBackend;
+	}
+	/**
+	* Lazily spawn + initialize the inference pipeline on first use. The
+	* subprocess (YAMNet Python / Apple SoundAnalysis CLI, resident model) is NOT
+	* booted at addon start — only when the first classify() actually lands, so a
+	* node hosting the addon with no audio-classification consumer never spawns
+	* it. Concurrent first-calls single-flight through `pipelineInitPromise` so
+	* the subprocess is spawned exactly once.
+	*/
+	async ensurePipeline() {
+		if (this.disposed) throw new Error("audio-analyzer: provider disposed");
+		const live = this.pipeline;
+		if (live) return live;
+		if (this.pipelineInitPromise) return this.pipelineInitPromise;
+		const backend = this.desiredBackend;
+		const init = (async () => {
+			this.log.info("audio pipeline lazy init (first classify)", { meta: { backend } });
+			const built = await this.pipelineFactory(backend);
+			if (this.disposed) {
+				await built.dispose().catch(() => {});
+				throw new Error("audio-analyzer: provider disposed during init");
+			}
+			this.pipeline = built;
+			this.backendName = backend;
+			return built;
+		})();
+		this.pipelineInitPromise = init;
+		try {
+			return await init;
+		} finally {
+			this.pipelineInitPromise = null;
+		}
+	}
+	/** (Re)arm the idle-dispose timer. Called after every classify. */
+	scheduleIdleDispose() {
+		if (this.disposed) return;
+		if (this.idleTimer) clearTimeout(this.idleTimer);
+		const timer = setTimeout(() => {
+			this.idleTimer = null;
+			this.disposeIdlePipeline();
+		}, PIPELINE_IDLE_DISPOSE_MS);
+		if (typeof timer.unref === "function") timer.unref();
+		this.idleTimer = timer;
+	}
+	/**
+	* Tear the inference subprocess down after a long idle window, freeing the
+	* resident model. The next classify lazily re-spawns it. No-op (and re-arms)
+	* if a classify is in flight; no-op if nothing is spawned.
+	*/
+	async disposeIdlePipeline() {
+		if (this.disposed) return;
+		if (this.pipelineBusy || this.pipelineInitPromise) {
+			this.scheduleIdleDispose();
+			return;
+		}
+		const live = this.pipeline;
+		if (!live) return;
+		this.pipeline = null;
+		try {
+			await live.dispose();
+			this.log.info("audio pipeline idle-disposed — freed inference subprocess", { meta: {
+				backend: this.backendName,
+				idleMs: PIPELINE_IDLE_DISPOSE_MS
+			} });
+		} catch (err) {
+			this.log.warn("audio pipeline idle-dispose failed", { meta: { error: errMsg(err) } });
+		}
 	}
 	async getDeviceSettingsContribution(input) {
 		return this.deviceContributionResolver(input.deviceId);
@@ -563,61 +648,88 @@ var AudioAnalyzerProvider = class {
 			lastEndMs: state?.lastEndMs ?? 0
 		});
 		this.pipelineBusy = true;
-		const f32Data = float32FromBytes(chunk.data);
-		const result = await this.pipeline.classify({
-			data: f32Data,
-			sampleRate: chunk.sampleRate,
-			channels: chunk.channels
-		}).finally(() => {
+		try {
+			const pipeline = await this.ensurePipeline();
+			const f32Data = float32FromBytes(chunk.data);
+			const result = await pipeline.classify({
+				data: f32Data,
+				sampleRate: chunk.sampleRate,
+				channels: chunk.channels
+			});
+			if (this.debugClassifySamples && (this.classifyCount < 3 || this.classifyCount % 100 === 0)) {
+				const rawTop = result.classifications.slice(0, 5).map((c) => `"${c.className}"(${(c.score * 100).toFixed(0)}%)`).join(", ");
+				this.log.info("classify debug sample", {
+					tags: chunk.deviceId !== void 0 ? { deviceId: chunk.deviceId } : void 0,
+					meta: {
+						index: this.classifyCount,
+						engine: this.backendName,
+						rawLabelCount: result.classifications.length,
+						top: rawTop,
+						inferenceMs: result.inferenceMs
+					}
+				});
+			}
+			this.classifyCount++;
+			const macroAccum = /* @__PURE__ */ new Map();
+			for (const c of result.classifications) {
+				const macro = mapAudioLabelToMacro(c.className);
+				if (!macro) continue;
+				const prev = macroAccum.get(macro);
+				if (!prev || c.score > prev.score) macroAccum.set(macro, {
+					score: c.score,
+					rawTop: c.className
+				});
+			}
+			return {
+				labels: [...macroAccum.entries()].toSorted((a, b) => b[1].score - a[1].score).map(([className, { score, rawTop }]) => ({
+					className,
+					originalClass: rawTop,
+					score
+				})),
+				rawLabels: [...result.classifications].toSorted((a, b) => b.score - a.score).map((c) => ({
+					className: c.className,
+					originalClass: c.className,
+					score: c.score
+				})),
+				inferenceMs: result.inferenceMs
+			};
+		} finally {
 			this.pipelineBusy = false;
 			this.cameraState.set(camKey, {
 				inProgress: false,
 				lastEndMs: Date.now()
 			});
-		});
-		if (this.debugClassifySamples && (this.classifyCount < 3 || this.classifyCount % 100 === 0)) {
-			const rawTop = result.classifications.slice(0, 5).map((c) => `"${c.className}"(${(c.score * 100).toFixed(0)}%)`).join(", ");
-			this.log.info("classify debug sample", {
-				tags: chunk.deviceId !== void 0 ? { deviceId: chunk.deviceId } : void 0,
-				meta: {
-					index: this.classifyCount,
-					engine: this.backendName,
-					rawLabelCount: result.classifications.length,
-					top: rawTop,
-					inferenceMs: result.inferenceMs
-				}
-			});
-		}
-		this.classifyCount++;
-		const macroAccum = /* @__PURE__ */ new Map();
-		for (const c of result.classifications) {
-			const macro = mapAudioLabelToMacro(c.className);
-			if (!macro) continue;
-			const prev = macroAccum.get(macro);
-			if (!prev || c.score > prev.score) macroAccum.set(macro, {
-				score: c.score,
-				rawTop: c.className
-			});
+			this.scheduleIdleDispose();
 		}
-		return {
-			labels: [...macroAccum.entries()].toSorted((a, b) => b[1].score - a[1].score).map(([className, { score, rawTop }]) => ({
-				className,
-				originalClass: rawTop,
-				score
-			})),
-			rawLabels: [...result.classifications].toSorted((a, b) => b.score - a.score).map((c) => ({
-				className: c.className,
-				originalClass: c.className,
-				score: c.score
-			})),
-			inferenceMs: result.inferenceMs
-		};
 	}
 	isReady() {
-		return this.pipeline !== null;
+		return !this.disposed;
 	}
 	async dispose() {
-		await this.pipeline.dispose();
+		this.disposed = true;
+		if (this.idleTimer) {
+			clearTimeout(this.idleTimer);
+			this.idleTimer = null;
+		}
+		const live = this.pipeline;
+		this.pipeline = null;
+		if (live) await live.dispose();
+	}
+	/**
+	* Apply a backend/model change. Records the backend the NEXT lazy init will
+	* build; if a pipeline is already live it rebuilds IN PLACE (via
+	* `swapPipeline`), otherwise the subprocess stays unspawned until the next
+	* classify. Lets the audio engine settings apply without an addon restart,
+	* mirroring the detection-pipeline's in-place engine swap.
+	*/
+	async reconfigureBackend(next) {
+		this.desiredBackend = next;
+		if (!this.pipeline) {
+			this.backendName = next;
+			return;
+		}
+		const rebuilt = await this.pipelineFactory(next);
+		await this.swapPipeline(rebuilt, next);
 	}
 	/**
 	* Swap the live pipeline in place (optimistic backend/model change) — disposes
@@ -646,9 +758,9 @@ var AudioAnalyzerProvider = class {
 var AudioAnalyzerAddon = class extends BaseAddon {
 	id = "audio-analyzer";
 	provider = null;
-	pipeline = null;
-	/** Backend the live `pipeline` actually runs — drives the optimistic in-place
-	*  rebuild in `onConfigChanged` (rebuild only when it genuinely flips). */
+	/** Backend the provider's pipeline is configured for — drives the optimistic
+	*  in-place rebuild in `onConfigChanged` (rebuild only when it genuinely
+	*  flips). The provider owns the (lazy) pipeline itself. */
 	activeBackend = null;
 	constructor() {
 		super(DEFAULT_AUDIO_ANALYZER_CONFIG);
@@ -799,8 +911,6 @@ var AudioAnalyzerAddon = class extends BaseAddon {
 	async onInitialize() {
 		const logger = this.ctx.logger;
 		const backend = this.resolveAudioBackend();
-		const p = await this.buildPipeline(backend);
-		this.pipeline = p;
 		this.activeBackend = backend;
 		if (!this.config.probedBestAudioBackend) this.reprobeAudioEngine().catch((err) => {
 			logger.warn("audio: auto-reprobe failed", { meta: { error: err instanceof Error ? err.message : String(err) } });
@@ -824,7 +934,7 @@ var AudioAnalyzerAddon = class extends BaseAddon {
 			return null;
 		};
 		const deviceSettingsPatcher = async (_deviceId, _patch) => {};
-		this.provider = new AudioAnalyzerProvider(logger, this.pipeline, backend, deviceSettingsResolver, deviceContributionResolver, deviceSettingsPatcher, () => this.reprobeAudioEngine());
+		this.provider = new AudioAnalyzerProvider(logger, (b) => this.buildPipeline(b), backend, deviceSettingsResolver, deviceContributionResolver, deviceSettingsPatcher, () => this.reprobeAudioEngine());
 		return [{
 			capability: audioAnalyzerCapability,
 			provider: this.provider
@@ -838,7 +948,6 @@ var AudioAnalyzerAddon = class extends BaseAddon {
 			await this.provider.dispose();
 			this.provider = null;
 		}
-		this.pipeline = null;
 		this.activeBackend = null;
 	}
 	/**
@@ -873,13 +982,11 @@ var AudioAnalyzerAddon = class extends BaseAddon {
 		if (!this.provider) return;
 		const backend = this.resolveAudioBackend();
 		if (backend === this.activeBackend) return;
-		this.ctx.logger.info("audio backend changed — rebuilding pipeline in place", { meta: {
+		this.ctx.logger.info("audio backend changed — applying to pipeline", { meta: {
 			from: this.activeBackend,
 			to: backend
 		} });
-		const next = await this.buildPipeline(backend);
-		await this.provider.swapPipeline(next, backend);
-		this.pipeline = next;
+		await this.provider.reconfigureBackend(backend);
 		this.activeBackend = backend;
 	}
 	buildDeviceSchema() {

package/dist/detection-pipeline/index.js

@@ -3,16 +3,16 @@ 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-DbGdZ8Nr.js");
+const require_dist = require("../dist-BJTPkJFw.js");
 const require_node_topology_platform = require("../node-topology-platform-CFZ7F4xW.js");
 let _camstack_shm_ring = require("@camstack/shm-ring");
+let node_child_process = require("node:child_process");
 let node_fs = require("node:fs");
 node_fs = require_model_download_service_C_IHWnXx.__toESM(node_fs);
 let node_path = require("node:path");
 node_path = require_model_download_service_C_IHWnXx.__toESM(node_path);
 let node_os = require("node:os");
 node_os = require_model_download_service_C_IHWnXx.__toESM(node_os);
-let node_child_process = require("node:child_process");
 let sharp = require("sharp");
 sharp = require_model_download_service_C_IHWnXx.__toESM(sharp);
 //#region src/detection-pipeline/runtimes.ts

package/dist/detection-pipeline/index.mjs

@@ -1,12 +1,12 @@
 import { t as __require } from "../chunk-BdkLduGY.mjs";
-import { H as createEvent, I as errMsg, K as parseJsonUnknown, L as BaseAddon, O as pipelineExecutorCapability, P as supportedRuntimes$1, S as hfModelUrl, U as hydrateSchema, V as EventCategory, Y as sleep, a as COCO_TO_MACRO, b as detectionPipelineCapability, f as YAMNET_TO_MACRO, i as COCO_80_LABELS, j as runtimeDevices$1, r as AUDIO_MACRO_LABELS, t as APPLE_SA_TO_MACRO, v as defaultDeviceFor$1, x as evaluateZoneRules } from "../dist-DvvYzO58.mjs";
+import { H as createEvent, I as errMsg, K as parseJsonUnknown, L as BaseAddon, O as pipelineExecutorCapability, P as supportedRuntimes$1, S as hfModelUrl, U as hydrateSchema, V as EventCategory, Y as sleep, a as COCO_TO_MACRO, b as detectionPipelineCapability, f as YAMNET_TO_MACRO, i as COCO_80_LABELS, j as runtimeDevices$1, r as AUDIO_MACRO_LABELS, t as APPLE_SA_TO_MACRO, v as defaultDeviceFor$1, x as evaluateZoneRules } from "../dist-v6cKLmU3.mjs";
 import { t as pickNodePlatformArch } from "../node-topology-platform-BkR_k6WT.mjs";
 import { a as isModelDownloaded, i as ensureModel, n as deleteModelFromDisk } from "../model-download-service-C-IHWnXx-BPy6aoAx.mjs";
 import { FrameRingReaderCache } from "@camstack/shm-ring";
+import { spawn } from "node:child_process";
 import * as fs from "node:fs";
 import * as path$1 from "node:path";
 import * as os from "node:os";
-import { spawn } from "node:child_process";
 import sharp from "sharp";
 //#region src/detection-pipeline/runtimes.ts
 var KNOWN_PLATFORMS = [