@camstack/addon-pipeline 1.1.42 → 1.1.43

package/dist/detection-pipeline/index.js

@@ -3935,12 +3935,15 @@ var PipelineExecutor = class {
 				try {
 					await this.executeChildren(rootStep.children, mutable, fullFrameJpegProvider, imageWidth, imageHeight, traceBuilder, stepTimings, ctx, poolAgg);
 				} catch (err) {
-					this.opts.logger?.warn("Pipeline child execution failed — keeping parent detection", { meta: {
-						rootStepId: rootStep.stepId,
-						parentClass: mutable.macroClass,
-						parentScore: mutable.score,
-						error: require_dist.errMsg(err)
-					} });
+					this.opts.logger?.warn("Pipeline child execution failed — keeping parent detection", {
+						tags: { deviceId },
+						meta: {
+							rootStepId: rootStep.stepId,
+							parentClass: mutable.macroClass,
+							parentScore: mutable.score,
+							error: require_dist.errMsg(err)
+						}
+					});
 				}
 				firstLevel.push(mutable);
 			}

package/dist/detection-pipeline/index.mjs

@@ -3928,12 +3928,15 @@ var PipelineExecutor = class {
 				try {
 					await this.executeChildren(rootStep.children, mutable, fullFrameJpegProvider, imageWidth, imageHeight, traceBuilder, stepTimings, ctx, poolAgg);
 				} catch (err) {
-					this.opts.logger?.warn("Pipeline child execution failed — keeping parent detection", { meta: {
-						rootStepId: rootStep.stepId,
-						parentClass: mutable.macroClass,
-						parentScore: mutable.score,
-						error: errMsg(err)
-					} });
+					this.opts.logger?.warn("Pipeline child execution failed — keeping parent detection", {
+						tags: { deviceId },
+						meta: {
+							rootStepId: rootStep.stepId,
+							parentClass: mutable.macroClass,
+							parentScore: mutable.score,
+							error: errMsg(err)
+						}
+					});
 				}
 				firstLevel.push(mutable);
 			}

package/dist/recorder/index.js

@@ -448,13 +448,16 @@ async function runRedundancyJanitor(deps) {
 				files += vrows.length;
 				bytes += reclaimed;
 			} catch (err) {
-				deps.logger.warn("janitor: evict failed (skipping)", { meta: {
-					deviceId,
-					profile,
-					location,
-					count: vrows.length,
-					error: err instanceof Error ? err.message : String(err)
-				} });
+				deps.logger.warn("janitor: evict failed (skipping)", {
+					tags: { deviceId },
+					meta: {
+						deviceId,
+						profile,
+						location,
+						count: vrows.length,
+						error: err instanceof Error ? err.message : String(err)
+					}
+				});
 			}
 		}
 	}
@@ -1091,9 +1094,12 @@ function buildRecordingProvider(deps) {
 			return require_dist.hydrateSchema(buildRecordingDeviceSchema(), {});
 		},
 		getDeviceLiveContribution: async () => null,
-		applyDeviceSettingsPatch: async ({ patch }) => {
+		applyDeviceSettingsPatch: async ({ deviceId, patch }) => {
 			const keys = Object.keys(patch ?? {});
-			if (keys.length > 0) deps.logger.debug("recorder: ignoring legacy settings patch (widget owns settings)", { meta: { keys } });
+			if (keys.length > 0) deps.logger.debug("recorder: ignoring legacy settings patch (widget owns settings)", {
+				tags: { deviceId },
+				meta: { keys }
+			});
 			return { success: true };
 		}
 	};
@@ -1880,13 +1886,14 @@ var RecordingController = class {
 		}));
 		const outDir = node_path.default.join(placement.root, STAGING_DIR_NAME, String(deviceId), profile);
 		await node_fs.promises.mkdir(outDir, { recursive: true });
+		const deviceLog = this.deps.logger.withTags({ deviceId });
 		const writer = new SegmentWriter({
 			rtspUrl: source.url,
 			outDir,
 			segmentSeconds
 		}, {
 			spawn: this.deps.spawn,
-			logger: this.deps.logger,
+			logger: deviceLog,
 			onGaveUp: () => {
 				this.recoverWriterGaveUp(deviceId);
 			}
@@ -1901,7 +1908,7 @@ var RecordingController = class {
 				onFinalized: (startMs, durMs, flatAbsPath) => {
 					this.handleFinalizedSegment(deviceId, profile, placement, startMs, durMs, flatAbsPath);
 				},
-				logger: this.deps.logger
+				logger: deviceLog
 			}),
 			pipelineKey: source.pipelineKey,
 			outDir

package/dist/recorder/index.mjs

@@ -447,13 +447,16 @@ async function runRedundancyJanitor(deps) {
 				files += vrows.length;
 				bytes += reclaimed;
 			} catch (err) {
-				deps.logger.warn("janitor: evict failed (skipping)", { meta: {
-					deviceId,
-					profile,
-					location,
-					count: vrows.length,
-					error: err instanceof Error ? err.message : String(err)
-				} });
+				deps.logger.warn("janitor: evict failed (skipping)", {
+					tags: { deviceId },
+					meta: {
+						deviceId,
+						profile,
+						location,
+						count: vrows.length,
+						error: err instanceof Error ? err.message : String(err)
+					}
+				});
 			}
 		}
 	}
@@ -1090,9 +1093,12 @@ function buildRecordingProvider(deps) {
 			return hydrateSchema(buildRecordingDeviceSchema(), {});
 		},
 		getDeviceLiveContribution: async () => null,
-		applyDeviceSettingsPatch: async ({ patch }) => {
+		applyDeviceSettingsPatch: async ({ deviceId, patch }) => {
 			const keys = Object.keys(patch ?? {});
-			if (keys.length > 0) deps.logger.debug("recorder: ignoring legacy settings patch (widget owns settings)", { meta: { keys } });
+			if (keys.length > 0) deps.logger.debug("recorder: ignoring legacy settings patch (widget owns settings)", {
+				tags: { deviceId },
+				meta: { keys }
+			});
 			return { success: true };
 		}
 	};
@@ -1879,13 +1885,14 @@ var RecordingController = class {
 		}));
 		const outDir = path.join(placement.root, STAGING_DIR_NAME, String(deviceId), profile);
 		await promises.mkdir(outDir, { recursive: true });
+		const deviceLog = this.deps.logger.withTags({ deviceId });
 		const writer = new SegmentWriter({
 			rtspUrl: source.url,
 			outDir,
 			segmentSeconds
 		}, {
 			spawn: this.deps.spawn,
-			logger: this.deps.logger,
+			logger: deviceLog,
 			onGaveUp: () => {
 				this.recoverWriterGaveUp(deviceId);
 			}
@@ -1900,7 +1907,7 @@ var RecordingController = class {
 				onFinalized: (startMs, durMs, flatAbsPath) => {
 					this.handleFinalizedSegment(deviceId, profile, placement, startMs, durMs, flatAbsPath);
 				},
-				logger: this.deps.logger
+				logger: deviceLog
 			}),
 			pipelineKey: source.pipelineKey,
 			outDir

package/dist/session-decode/decode-worker-child.js

@@ -318,6 +318,16 @@ var DecodeWorkerChild = class {
 	abortController = null;
 	started = false;
 	stopped = false;
+	/**
+	* The numeric device id this worker decodes for — learned from the `start`
+	* message's {@link VideoFrameSource}. The child's stderr is INHERITED by the
+	* pipeline-runner (silent:false fork), so these lines land in the runner's
+	* raw stderr WITHOUT passing through a scoped logger; prefixing every line
+	* with `[dev:<id>]` (see {@link emitStderr}) is what lets the per-device log
+	* UI attribute the forked worker's output to its camera. `null` only for the
+	* brief pre-`start` window (e.g. a malformed first message).
+	*/
+	deviceId = null;
 	sessionFormat = "rgb";
 	minIntervalMs = 0;
 	/**
@@ -390,16 +400,17 @@ var DecodeWorkerChild = class {
 		const deliveredDelta = this.framesDelivered - this.lastDeliveredSnapshot;
 		const deliveredFps = Math.round(deliveredDelta / windowMs * 1e3 * 10) / 10;
 		const skipped = this.framesSkipped + this.frames.droppedCount;
-		process.stderr.write(`session-decode metrics {framesDecoded:${this.framesDecoded}, framesSkipped:${skipped}, deliveredFps:${deliveredFps}}${final ? " (final)" : ""}\n`);
+		this.emitStderr(`session-decode metrics {framesDecoded:${this.framesDecoded}, framesSkipped:${skipped}, deliveredFps:${deliveredFps}}${final ? " (final)" : ""}\n`);
 		this.lastMetricsAt = now;
 		this.lastDeliveredSnapshot = this.framesDelivered;
 	}
 	handleStart(source, opts) {
 		if (this.started) {
-			process.stderr.write("decode-worker-child: duplicate start ignored\n");
+			this.emitStderr("decode-worker-child: duplicate start ignored\n");
 			return;
 		}
 		this.started = true;
+		this.deviceId = source.deviceId;
 		this.sessionFormat = opts.format ?? "rgb";
 		this.minIntervalMs = opts.fps && opts.fps > 0 ? 1e3 / opts.fps : 0;
 		this.lastMetricsAt = Date.now();
@@ -456,7 +467,7 @@ var DecodeWorkerChild = class {
 				await this.dialAndDecode(nav, C, url);
 			} catch (err) {
 				if (this.stopped) break;
-				process.stderr.write(`decode-worker-child: dial ended — re-dial scheduled: ${errMessage(err)}\n`);
+				this.emitStderr(`decode-worker-child: dial ended — re-dial scheduled: ${errMessage(err)}\n`);
 			} finally {
 				this.closeInput();
 			}
@@ -549,7 +560,7 @@ var DecodeWorkerChild = class {
 				return;
 			}
 			this.hwFilterDecision = "hardware";
-			process.stderr.write(`decode-worker-child: GPU crop+scale path active (${this.gpuScaleFilter})\n`);
+			this.emitStderr(`decode-worker-child: GPU crop+scale path active (${this.gpuScaleFilter})\n`);
 		}
 		this.publishFrame(frame);
 	}
@@ -587,7 +598,7 @@ var DecodeWorkerChild = class {
 			for (const out of outputs) out.free();
 			return ok;
 		} catch (err) {
-			process.stderr.write(`decode-worker-child: GPU filter probe failed — using software decode: ${errMessage(err)}\n`);
+			this.emitStderr(`decode-worker-child: GPU filter probe failed — using software decode: ${errMessage(err)}\n`);
 			return false;
 		} finally {
 			filter?.close();
@@ -764,7 +775,7 @@ var DecodeWorkerChild = class {
 			if (deviceType === null) continue;
 			const hw = nav.HardwareContext.create(deviceType);
 			if (!hw) {
-				process.stderr.write(`decode-worker-child: hwaccel candidate '${backend}' failed — trying next\n`);
+				this.emitStderr(`decode-worker-child: hwaccel candidate '${backend}' failed — trying next\n`);
 				continue;
 			}
 			this.hwContext = hw;
@@ -772,7 +783,7 @@ var DecodeWorkerChild = class {
 			this.hwFilterDecision = this.gpuScaleFilter !== null ? "undecided" : "software";
 			return;
 		}
-		process.stderr.write("decode-worker-child: no hwaccel backend available — using software decode\n");
+		this.emitStderr("decode-worker-child: no hwaccel backend available — using software decode\n");
 	}
 	/** Interruptible re-dial backoff — `teardown` clears the pending timer. */
 	sleep(ms) {
@@ -803,8 +814,19 @@ var DecodeWorkerChild = class {
 	send(reply) {
 		process.send?.(reply);
 	}
+	/**
+	* Write one diagnostic line to the (inherited) stderr, prefixed with the
+	* device tag so the per-device log UI can attribute the forked worker's
+	* output. Public so the module-level process handlers — which only hold the
+	* `worker` instance — emit device-tagged lines too. Callers pass the line
+	* INCLUDING its trailing newline (unchanged from the prior direct writes).
+	*/
+	emitStderr(line) {
+		const tag = this.deviceId === null ? "[dev:?]" : `[dev:${this.deviceId}]`;
+		process.stderr.write(`${tag} ${line}`);
+	}
 	sendError(message, frameId) {
-		process.stderr.write(`${message}\n`);
+		this.emitStderr(`${message}\n`);
 		this.send(frameId === void 0 ? {
 			kind: "error",
 			message
@@ -824,12 +846,12 @@ process.on("disconnect", () => {
 	process.exit(0);
 });
 process.on("uncaughtException", (err) => {
-	process.stderr.write(`decode-worker-child: uncaught exception — ${errMessage(err)}\n`);
+	worker.emitStderr(`decode-worker-child: uncaught exception — ${errMessage(err)}\n`);
 	worker.teardown();
 	process.exit(1);
 });
 process.on("unhandledRejection", (reason) => {
-	process.stderr.write(`decode-worker-child: unhandled rejection — ${errMessage(reason)}\n`);
+	worker.emitStderr(`decode-worker-child: unhandled rejection — ${errMessage(reason)}\n`);
 });
 //#endregion
 exports.DecodeWorkerChild = DecodeWorkerChild;

package/dist/session-decode/decode-worker-child.mjs

@@ -317,6 +317,16 @@ var DecodeWorkerChild = class {
 	abortController = null;
 	started = false;
 	stopped = false;
+	/**
+	* The numeric device id this worker decodes for — learned from the `start`
+	* message's {@link VideoFrameSource}. The child's stderr is INHERITED by the
+	* pipeline-runner (silent:false fork), so these lines land in the runner's
+	* raw stderr WITHOUT passing through a scoped logger; prefixing every line
+	* with `[dev:<id>]` (see {@link emitStderr}) is what lets the per-device log
+	* UI attribute the forked worker's output to its camera. `null` only for the
+	* brief pre-`start` window (e.g. a malformed first message).
+	*/
+	deviceId = null;
 	sessionFormat = "rgb";
 	minIntervalMs = 0;
 	/**
@@ -389,16 +399,17 @@ var DecodeWorkerChild = class {
 		const deliveredDelta = this.framesDelivered - this.lastDeliveredSnapshot;
 		const deliveredFps = Math.round(deliveredDelta / windowMs * 1e3 * 10) / 10;
 		const skipped = this.framesSkipped + this.frames.droppedCount;
-		process.stderr.write(`session-decode metrics {framesDecoded:${this.framesDecoded}, framesSkipped:${skipped}, deliveredFps:${deliveredFps}}${final ? " (final)" : ""}\n`);
+		this.emitStderr(`session-decode metrics {framesDecoded:${this.framesDecoded}, framesSkipped:${skipped}, deliveredFps:${deliveredFps}}${final ? " (final)" : ""}\n`);
 		this.lastMetricsAt = now;
 		this.lastDeliveredSnapshot = this.framesDelivered;
 	}
 	handleStart(source, opts) {
 		if (this.started) {
-			process.stderr.write("decode-worker-child: duplicate start ignored\n");
+			this.emitStderr("decode-worker-child: duplicate start ignored\n");
 			return;
 		}
 		this.started = true;
+		this.deviceId = source.deviceId;
 		this.sessionFormat = opts.format ?? "rgb";
 		this.minIntervalMs = opts.fps && opts.fps > 0 ? 1e3 / opts.fps : 0;
 		this.lastMetricsAt = Date.now();
@@ -455,7 +466,7 @@ var DecodeWorkerChild = class {
 				await this.dialAndDecode(nav, C, url);
 			} catch (err) {
 				if (this.stopped) break;
-				process.stderr.write(`decode-worker-child: dial ended — re-dial scheduled: ${errMessage(err)}\n`);
+				this.emitStderr(`decode-worker-child: dial ended — re-dial scheduled: ${errMessage(err)}\n`);
 			} finally {
 				this.closeInput();
 			}
@@ -548,7 +559,7 @@ var DecodeWorkerChild = class {
 				return;
 			}
 			this.hwFilterDecision = "hardware";
-			process.stderr.write(`decode-worker-child: GPU crop+scale path active (${this.gpuScaleFilter})\n`);
+			this.emitStderr(`decode-worker-child: GPU crop+scale path active (${this.gpuScaleFilter})\n`);
 		}
 		this.publishFrame(frame);
 	}
@@ -586,7 +597,7 @@ var DecodeWorkerChild = class {
 			for (const out of outputs) out.free();
 			return ok;
 		} catch (err) {
-			process.stderr.write(`decode-worker-child: GPU filter probe failed — using software decode: ${errMessage(err)}\n`);
+			this.emitStderr(`decode-worker-child: GPU filter probe failed — using software decode: ${errMessage(err)}\n`);
 			return false;
 		} finally {
 			filter?.close();
@@ -763,7 +774,7 @@ var DecodeWorkerChild = class {
 			if (deviceType === null) continue;
 			const hw = nav.HardwareContext.create(deviceType);
 			if (!hw) {
-				process.stderr.write(`decode-worker-child: hwaccel candidate '${backend}' failed — trying next\n`);
+				this.emitStderr(`decode-worker-child: hwaccel candidate '${backend}' failed — trying next\n`);
 				continue;
 			}
 			this.hwContext = hw;
@@ -771,7 +782,7 @@ var DecodeWorkerChild = class {
 			this.hwFilterDecision = this.gpuScaleFilter !== null ? "undecided" : "software";
 			return;
 		}
-		process.stderr.write("decode-worker-child: no hwaccel backend available — using software decode\n");
+		this.emitStderr("decode-worker-child: no hwaccel backend available — using software decode\n");
 	}
 	/** Interruptible re-dial backoff — `teardown` clears the pending timer. */
 	sleep(ms) {
@@ -802,8 +813,19 @@ var DecodeWorkerChild = class {
 	send(reply) {
 		process.send?.(reply);
 	}
+	/**
+	* Write one diagnostic line to the (inherited) stderr, prefixed with the
+	* device tag so the per-device log UI can attribute the forked worker's
+	* output. Public so the module-level process handlers — which only hold the
+	* `worker` instance — emit device-tagged lines too. Callers pass the line
+	* INCLUDING its trailing newline (unchanged from the prior direct writes).
+	*/
+	emitStderr(line) {
+		const tag = this.deviceId === null ? "[dev:?]" : `[dev:${this.deviceId}]`;
+		process.stderr.write(`${tag} ${line}`);
+	}
 	sendError(message, frameId) {
-		process.stderr.write(`${message}\n`);
+		this.emitStderr(`${message}\n`);
 		this.send(frameId === void 0 ? {
 			kind: "error",
 			message
@@ -823,12 +845,12 @@ process.on("disconnect", () => {
 	process.exit(0);
 });
 process.on("uncaughtException", (err) => {
-	process.stderr.write(`decode-worker-child: uncaught exception — ${errMessage(err)}\n`);
+	worker.emitStderr(`decode-worker-child: uncaught exception — ${errMessage(err)}\n`);
 	worker.teardown();
 	process.exit(1);
 });
 process.on("unhandledRejection", (reason) => {
-	process.stderr.write(`decode-worker-child: unhandled rejection — ${errMessage(reason)}\n`);
+	worker.emitStderr(`decode-worker-child: unhandled rejection — ${errMessage(reason)}\n`);
 });
 //#endregion
 export { DecodeWorkerChild };

package/dist/stream-broker/index.js

@@ -11875,10 +11875,13 @@ var TranscodePipelineManager = class {
 		const sourceRes = sourceStream.resolution;
 		const resMatchesTarget = input.targetResolution === void 0 || sourceRes !== void 0 && sourceRes.width === input.targetResolution.width && sourceRes.height === input.targetResolution.height;
 		if (input.video === "copy" || sourceCodec !== null && videoTargetToCodec(input.video) === sourceCodec && wantedAudio === "copy" && outputArgs.length === 0 && resMatchesTarget) {
-			if (sourceCodec === null) this.logger.warn("copy-passthrough requested but source codec is unknown — reporting H264", { meta: {
-				deviceId: input.deviceId,
-				camStreamId: sourceStream.camStreamId
-			} });
+			if (sourceCodec === null) this.logger.warn("copy-passthrough requested but source codec is unknown — reporting H264", {
+				tags: { deviceId: input.deviceId },
+				meta: {
+					deviceId: input.deviceId,
+					camStreamId: sourceStream.camStreamId
+				}
+			});
 			const passVideoCodec = sourceCodec ?? "H264";
 			const url = this.resolveSourceUrl(input.deviceId, sourceStream.camStreamId);
 			const key = pipelineKeyFor(input.deviceId, sourceStream.camStreamId, "copy", wantedAudio, outResolution, outputArgs, false);
@@ -11967,13 +11970,16 @@ var TranscodePipelineManager = class {
 			releaseTimer: null
 		};
 		this.entries.set(opts.key, entry);
-		this.logger.info("Transcode pipeline started", { meta: {
-			key: opts.key,
-			encoder,
-			decodeHwAccel,
-			sourceUrl,
-			url
-		} });
+		this.logger.info("Transcode pipeline started", {
+			tags: { deviceId: opts.deviceId },
+			meta: {
+				key: opts.key,
+				encoder,
+				decodeHwAccel,
+				sourceUrl,
+				url
+			}
+		});
 		return source;
 	}
 	firstPublished(deviceId) {
@@ -14506,10 +14512,13 @@ var StreamBrokerManager = class {
 			const key = `${cam.deviceId}:${cam.camStreamId}`;
 			if (!this.sourceParserFellBackWarned.has(key)) {
 				this.sourceParserFellBackWarned.add(key);
-				this.logger.warn("source parser native-udp requested but not yet implemented — falling back to native-tcp", { meta: {
-					deviceId: cam.deviceId,
-					camStreamId: cam.camStreamId
-				} });
+				this.logger.warn("source parser native-udp requested but not yet implemented — falling back to native-tcp", {
+					tags: { deviceId: cam.deviceId },
+					meta: {
+						deviceId: cam.deviceId,
+						camStreamId: cam.camStreamId
+					}
+				});
 			}
 		}
 		if (resolved.engine !== "ffmpeg") return {};
@@ -14725,7 +14734,7 @@ var StreamBrokerManager = class {
 		if (!broker) return;
 		if (this.derivedFeeders.has(brokerId)) return;
 		const controller = new DerivedFeederController({
-			logger: this.logger.child(`derived-feeder:${camStreamId}`),
+			logger: this.logger.child(`derived-feeder:${camStreamId}`).withTags({ deviceId }),
 			spawn: (onTeardown) => this.spawnDerivedFeeder(deviceId, camStreamId, source, encodeProfile, broker, onTeardown)
 		});
 		const unsubscribe = broker.onDemandChange((active) => controller.onDemand(active));
@@ -14776,21 +14785,27 @@ var StreamBrokerManager = class {
 		const feeder = new DerivedStreamFeeder({
 			ffmpegPath: this.ffmpegConfig.binaryPath,
 			args,
-			logger: this.logger.child(`derived-ffmpeg:${camStreamId}`)
+			logger: this.logger.child(`derived-ffmpeg:${camStreamId}`).withTags({ deviceId })
 		}, {
 			onEncodedPacket: (packet) => broker.pushEncodedPacket(packet),
 			onAudioInfo: (info) => broker.pushAudioInfo(info),
 			onPlaying: () => {
-				this.logger.info("derived feeder streaming", { meta: {
-					camStreamId,
-					loopbackUrl
-				} });
+				this.logger.info("derived feeder streaming", {
+					tags: { deviceId },
+					meta: {
+						camStreamId,
+						loopbackUrl
+					}
+				});
 			},
 			onError: (error) => {
-				this.logger.warn("derived feeder error", { meta: {
-					camStreamId,
-					error: error.message
-				} });
+				this.logger.warn("derived feeder error", {
+					tags: { deviceId },
+					meta: {
+						camStreamId,
+						error: error.message
+					}
+				});
 			},
 			onTeardown
 		});
@@ -16937,10 +16952,13 @@ var BrokerWebrtcServer = class {
 		const entry = this.sessions.get(sessionId);
 		if (!entry) return;
 		await entry.session.addIceCandidate(candidate).catch((err) => {
-			this.logger.warn("addIceCandidate threw", { meta: {
-				sessionId,
-				error: require_dist.errMsg(err)
-			} });
+			this.logger.warn("addIceCandidate threw", {
+				tags: { deviceId: deviceIdFromBrokerId(entry.brokerId) },
+				meta: {
+					sessionId,
+					error: require_dist.errMsg(err)
+				}
+			});
 		});
 	}
 	/** Trickle ICE — the server's gathered candidates for a session (poll). */
@@ -16957,10 +16975,13 @@ var BrokerWebrtcServer = class {
 		if (!entry) return;
 		this.cleanupSession(sessionId);
 		await entry.session.close().catch(() => {});
-		this.logger.info("WebRTC session closed", { meta: {
-			sessionId,
-			deviceId: deviceIdFromBrokerId(entry.brokerId)
-		} });
+		this.logger.info("WebRTC session closed", {
+			tags: { deviceId: deviceIdFromBrokerId(entry.brokerId) },
+			meta: {
+				sessionId,
+				deviceId: deviceIdFromBrokerId(entry.brokerId)
+			}
+		});
 	}
 	async stop() {
 		if (this.stopped) return;
@@ -17061,13 +17082,16 @@ var BrokerWebrtcServer = class {
 			target: { kind: "adaptive" },
 			epoch
 		};
-		this.logger.info("adaptive: scheduling renegotiation", { meta: {
-			sessionId,
-			deviceId,
-			tier,
-			forceTranscodeDown,
-			epoch
-		} });
+		this.logger.info("adaptive: scheduling renegotiation", {
+			tags: { deviceId },
+			meta: {
+				sessionId,
+				deviceId,
+				tier,
+				forceTranscodeDown,
+				epoch
+			}
+		});
 	}
 	cleanupSession(sessionId) {
 		const entry = this.sessions.get(sessionId);
@@ -17301,10 +17325,13 @@ var CameraStreamsProvider = class {
 	async pickStream(input) {
 		const streams = await this.manager.getCameraStreamsForDevice(input.deviceId);
 		if (streams.length === 0) {
-			this.manager.getLogger?.()?.info("camera-streams: pickStream — no streams for device", { meta: {
-				deviceId: input.deviceId,
-				requirements: input.requirements
-			} });
+			this.manager.getLogger?.()?.info("camera-streams: pickStream — no streams for device", {
+				tags: { deviceId: input.deviceId },
+				meta: {
+					deviceId: input.deviceId,
+					requirements: input.requirements
+				}
+			});
 			return null;
 		}
 		const requirements = input.requirements;
@@ -17321,15 +17348,18 @@ var CameraStreamsProvider = class {
 			return true;
 		});
 		if (candidates.length === 0) {
-			this.manager.getLogger?.()?.info("camera-streams: pickStream — no matching candidates", { meta: {
-				deviceId: input.deviceId,
-				requirements: input.requirements,
-				streams: streams.map((s) => ({
-					camStreamId: s.camStreamId,
-					codec: s.codec,
-					resolution: s.resolution
-				}))
-			} });
+			this.manager.getLogger?.()?.info("camera-streams: pickStream — no matching candidates", {
+				tags: { deviceId: input.deviceId },
+				meta: {
+					deviceId: input.deviceId,
+					requirements: input.requirements,
+					streams: streams.map((s) => ({
+						camStreamId: s.camStreamId,
+						codec: s.codec,
+						resolution: s.resolution
+					}))
+				}
+			});
 			return null;
 		}
 		const requireSibling = requirements.requireSiblingCodec ?? [];
@@ -17338,14 +17368,17 @@ var CameraStreamsProvider = class {
 				if (s.camStreamId.startsWith("derived:")) return false;
 				return codecMatches(s.codec, requireSibling);
 			})) {
-				this.manager.getLogger?.()?.info("camera-streams: pickStream — no sibling codec, skipping bypass", { meta: {
-					deviceId: input.deviceId,
-					requireSibling,
-					streams: streams.map((s) => ({
-						camStreamId: s.camStreamId,
-						codec: s.codec
-					}))
-				} });
+				this.manager.getLogger?.()?.info("camera-streams: pickStream — no sibling codec, skipping bypass", {
+					tags: { deviceId: input.deviceId },
+					meta: {
+						deviceId: input.deviceId,
+						requireSibling,
+						streams: streams.map((s) => ({
+							camStreamId: s.camStreamId,
+							codec: s.codec
+						}))
+					}
+				});
 				return null;
 			}
 		}

package/dist/stream-broker/index.mjs

@@ -11871,10 +11871,13 @@ var TranscodePipelineManager = class {
 		const sourceRes = sourceStream.resolution;
 		const resMatchesTarget = input.targetResolution === void 0 || sourceRes !== void 0 && sourceRes.width === input.targetResolution.width && sourceRes.height === input.targetResolution.height;
 		if (input.video === "copy" || sourceCodec !== null && videoTargetToCodec(input.video) === sourceCodec && wantedAudio === "copy" && outputArgs.length === 0 && resMatchesTarget) {
-			if (sourceCodec === null) this.logger.warn("copy-passthrough requested but source codec is unknown — reporting H264", { meta: {
-				deviceId: input.deviceId,
-				camStreamId: sourceStream.camStreamId
-			} });
+			if (sourceCodec === null) this.logger.warn("copy-passthrough requested but source codec is unknown — reporting H264", {
+				tags: { deviceId: input.deviceId },
+				meta: {
+					deviceId: input.deviceId,
+					camStreamId: sourceStream.camStreamId
+				}
+			});
 			const passVideoCodec = sourceCodec ?? "H264";
 			const url = this.resolveSourceUrl(input.deviceId, sourceStream.camStreamId);
 			const key = pipelineKeyFor(input.deviceId, sourceStream.camStreamId, "copy", wantedAudio, outResolution, outputArgs, false);
@@ -11963,13 +11966,16 @@ var TranscodePipelineManager = class {
 			releaseTimer: null
 		};
 		this.entries.set(opts.key, entry);
-		this.logger.info("Transcode pipeline started", { meta: {
-			key: opts.key,
-			encoder,
-			decodeHwAccel,
-			sourceUrl,
-			url
-		} });
+		this.logger.info("Transcode pipeline started", {
+			tags: { deviceId: opts.deviceId },
+			meta: {
+				key: opts.key,
+				encoder,
+				decodeHwAccel,
+				sourceUrl,
+				url
+			}
+		});
 		return source;
 	}
 	firstPublished(deviceId) {
@@ -14502,10 +14508,13 @@ var StreamBrokerManager = class {
 			const key = `${cam.deviceId}:${cam.camStreamId}`;
 			if (!this.sourceParserFellBackWarned.has(key)) {
 				this.sourceParserFellBackWarned.add(key);
-				this.logger.warn("source parser native-udp requested but not yet implemented — falling back to native-tcp", { meta: {
-					deviceId: cam.deviceId,
-					camStreamId: cam.camStreamId
-				} });
+				this.logger.warn("source parser native-udp requested but not yet implemented — falling back to native-tcp", {
+					tags: { deviceId: cam.deviceId },
+					meta: {
+						deviceId: cam.deviceId,
+						camStreamId: cam.camStreamId
+					}
+				});
 			}
 		}
 		if (resolved.engine !== "ffmpeg") return {};
@@ -14721,7 +14730,7 @@ var StreamBrokerManager = class {
 		if (!broker) return;
 		if (this.derivedFeeders.has(brokerId)) return;
 		const controller = new DerivedFeederController({
-			logger: this.logger.child(`derived-feeder:${camStreamId}`),
+			logger: this.logger.child(`derived-feeder:${camStreamId}`).withTags({ deviceId }),
 			spawn: (onTeardown) => this.spawnDerivedFeeder(deviceId, camStreamId, source, encodeProfile, broker, onTeardown)
 		});
 		const unsubscribe = broker.onDemandChange((active) => controller.onDemand(active));
@@ -14772,21 +14781,27 @@ var StreamBrokerManager = class {
 		const feeder = new DerivedStreamFeeder({
 			ffmpegPath: this.ffmpegConfig.binaryPath,
 			args,
-			logger: this.logger.child(`derived-ffmpeg:${camStreamId}`)
+			logger: this.logger.child(`derived-ffmpeg:${camStreamId}`).withTags({ deviceId })
 		}, {
 			onEncodedPacket: (packet) => broker.pushEncodedPacket(packet),
 			onAudioInfo: (info) => broker.pushAudioInfo(info),
 			onPlaying: () => {
-				this.logger.info("derived feeder streaming", { meta: {
-					camStreamId,
-					loopbackUrl
-				} });
+				this.logger.info("derived feeder streaming", {
+					tags: { deviceId },
+					meta: {
+						camStreamId,
+						loopbackUrl
+					}
+				});
 			},
 			onError: (error) => {
-				this.logger.warn("derived feeder error", { meta: {
-					camStreamId,
-					error: error.message
-				} });
+				this.logger.warn("derived feeder error", {
+					tags: { deviceId },
+					meta: {
+						camStreamId,
+						error: error.message
+					}
+				});
 			},
 			onTeardown
 		});
@@ -16933,10 +16948,13 @@ var BrokerWebrtcServer = class {
 		const entry = this.sessions.get(sessionId);
 		if (!entry) return;
 		await entry.session.addIceCandidate(candidate).catch((err) => {
-			this.logger.warn("addIceCandidate threw", { meta: {
-				sessionId,
-				error: errMsg(err)
-			} });
+			this.logger.warn("addIceCandidate threw", {
+				tags: { deviceId: deviceIdFromBrokerId(entry.brokerId) },
+				meta: {
+					sessionId,
+					error: errMsg(err)
+				}
+			});
 		});
 	}
 	/** Trickle ICE — the server's gathered candidates for a session (poll). */
@@ -16953,10 +16971,13 @@ var BrokerWebrtcServer = class {
 		if (!entry) return;
 		this.cleanupSession(sessionId);
 		await entry.session.close().catch(() => {});
-		this.logger.info("WebRTC session closed", { meta: {
-			sessionId,
-			deviceId: deviceIdFromBrokerId(entry.brokerId)
-		} });
+		this.logger.info("WebRTC session closed", {
+			tags: { deviceId: deviceIdFromBrokerId(entry.brokerId) },
+			meta: {
+				sessionId,
+				deviceId: deviceIdFromBrokerId(entry.brokerId)
+			}
+		});
 	}
 	async stop() {
 		if (this.stopped) return;
@@ -17057,13 +17078,16 @@ var BrokerWebrtcServer = class {
 			target: { kind: "adaptive" },
 			epoch
 		};
-		this.logger.info("adaptive: scheduling renegotiation", { meta: {
-			sessionId,
-			deviceId,
-			tier,
-			forceTranscodeDown,
-			epoch
-		} });
+		this.logger.info("adaptive: scheduling renegotiation", {
+			tags: { deviceId },
+			meta: {
+				sessionId,
+				deviceId,
+				tier,
+				forceTranscodeDown,
+				epoch
+			}
+		});
 	}
 	cleanupSession(sessionId) {
 		const entry = this.sessions.get(sessionId);
@@ -17297,10 +17321,13 @@ var CameraStreamsProvider = class {
 	async pickStream(input) {
 		const streams = await this.manager.getCameraStreamsForDevice(input.deviceId);
 		if (streams.length === 0) {
-			this.manager.getLogger?.()?.info("camera-streams: pickStream — no streams for device", { meta: {
-				deviceId: input.deviceId,
-				requirements: input.requirements
-			} });
+			this.manager.getLogger?.()?.info("camera-streams: pickStream — no streams for device", {
+				tags: { deviceId: input.deviceId },
+				meta: {
+					deviceId: input.deviceId,
+					requirements: input.requirements
+				}
+			});
 			return null;
 		}
 		const requirements = input.requirements;
@@ -17317,15 +17344,18 @@ var CameraStreamsProvider = class {
 			return true;
 		});
 		if (candidates.length === 0) {
-			this.manager.getLogger?.()?.info("camera-streams: pickStream — no matching candidates", { meta: {
-				deviceId: input.deviceId,
-				requirements: input.requirements,
-				streams: streams.map((s) => ({
-					camStreamId: s.camStreamId,
-					codec: s.codec,
-					resolution: s.resolution
-				}))
-			} });
+			this.manager.getLogger?.()?.info("camera-streams: pickStream — no matching candidates", {
+				tags: { deviceId: input.deviceId },
+				meta: {
+					deviceId: input.deviceId,
+					requirements: input.requirements,
+					streams: streams.map((s) => ({
+						camStreamId: s.camStreamId,
+						codec: s.codec,
+						resolution: s.resolution
+					}))
+				}
+			});
 			return null;
 		}
 		const requireSibling = requirements.requireSiblingCodec ?? [];
@@ -17334,14 +17364,17 @@ var CameraStreamsProvider = class {
 				if (s.camStreamId.startsWith("derived:")) return false;
 				return codecMatches(s.codec, requireSibling);
 			})) {
-				this.manager.getLogger?.()?.info("camera-streams: pickStream — no sibling codec, skipping bypass", { meta: {
-					deviceId: input.deviceId,
-					requireSibling,
-					streams: streams.map((s) => ({
-						camStreamId: s.camStreamId,
-						codec: s.codec
-					}))
-				} });
+				this.manager.getLogger?.()?.info("camera-streams: pickStream — no sibling codec, skipping bypass", {
+					tags: { deviceId: input.deviceId },
+					meta: {
+						deviceId: input.deviceId,
+						requireSibling,
+						streams: streams.map((s) => ({
+							camStreamId: s.camStreamId,
+							codec: s.codec
+						}))
+					}
+				});
 				return null;
 			}
 		}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-pipeline",
-  "version": "1.1.42",
+  "version": "1.1.43",
   "description": "CamStack Pipeline bundle — runner, detection, motion, audio + stream broker. Multi-entry npm package shipping pipeline addons under a single bundle.",
   "keywords": [
     "camstack",