@camstack/addon-pipeline 1.1.42 → 1.1.44

package/dist/recorder/index.js

@@ -1,10 +1,11 @@
-const require_model_download_service_C_IHWnXx = require("../model-download-service-C-IHWnXx-DxM2DSns.js");
-const require_dist = require("../dist-NvwN60Fq.js");
+const require_chunk = require("../chunk-D6vf50IK.js");
+const require_dist = require("../dist-CySHUkXY.js");
 const require_hub_hostname = require("../hub-hostname-DAJXlOgV.js");
+const require_model_download_service_C_IHWnXx = require("../model-download-service-C-IHWnXx-BLXzxpRB.js");
 let node_child_process = require("node:child_process");
 let node_fs = require("node:fs");
 let node_path = require("node:path");
-node_path = require_model_download_service_C_IHWnXx.__toESM(node_path);
+node_path = require_chunk.__toESM(node_path);
 //#region src/recorder/segment-path.ts
 function segmentRelPath(deviceId, profile, startMs, durMs, bytes) {
 	if (profile.includes("/")) throw new Error(`segmentRelPath: profile must not contain '/': ${profile}`);
@@ -224,7 +225,10 @@ var SegmentStore = class SegmentStore {
 		try {
 			bytes = await this.deps.statBytes(input.flatAbsPath);
 		} catch (err) {
-			this.deps.logger.warn("segment stat failed", err);
+			this.deps.logger.warn("segment stat failed", {
+				tags: { deviceId: input.deviceId },
+				error: err
+			});
 			return null;
 		}
 		if (bytes <= 0) return null;
@@ -233,7 +237,10 @@ var SegmentStore = class SegmentStore {
 		try {
 			await this.deps.moveFile(input.flatAbsPath, toAbs);
 		} catch (err) {
-			this.deps.logger.warn("segment relocate failed", err);
+			this.deps.logger.warn("segment relocate failed", {
+				tags: { deviceId: input.deviceId },
+				error: err
+			});
 			return null;
 		}
 		const row = {
@@ -283,7 +290,10 @@ var SegmentStore = class SegmentStore {
 				}
 				continue;
 			} catch (err) {
-				this.deps.logger.warn("bucket removeDir failed — falling back to per-file deletes", err);
+				this.deps.logger.warn("bucket removeDir failed — falling back to per-file deletes", {
+					tags: { deviceId: bucketRows[0]?.deviceId },
+					error: err
+				});
 			}
 			for (const r of bucketRows) try {
 				await this.deps.deletePath({
@@ -293,7 +303,10 @@ var SegmentStore = class SegmentStore {
 				removed.push(r.path);
 				reclaimed += r.bytes;
 			} catch (err) {
-				this.deps.logger.warn("segment delete failed", err);
+				this.deps.logger.warn("segment delete failed", {
+					tags: { deviceId: r.deviceId },
+					error: err
+				});
 			}
 		}
 		if (removed.length > 0) this.deps.index.removeSegments(removed);
@@ -448,13 +461,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 +1107,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 };
 		}
 	};
@@ -1857,7 +1876,7 @@ var RecordingController = class {
 	* assigned sources is ignored (record every assigned source — minimum of 1).
 	*/
 	async resolveProfiles(deviceId, override) {
-		const assigned = require_dist.selectAssignedProfileSlots(await this.deps.brokerCall(() => this.deps.api.streamBroker.listAllProfileSlots.query()), deviceId).map((slot) => slot.profile);
+		const assigned = require_dist.selectAssignedProfileSlots(await this.deps.brokerCall(() => this.deps.api.streamBroker.listAllProfileSlots.query(void 0, require_dist.nodePin(this.deps.ownerNodeId))), deviceId).map((slot) => slot.profile);
 		if (!override || override.length === 0) return assigned;
 		const selected = assigned.filter((p) => override.includes(p));
 		return selected.length > 0 ? selected : assigned;
@@ -1877,16 +1896,17 @@ var RecordingController = class {
 			profile,
 			...this.deps.consumerHostname !== void 0 ? { hostname: this.deps.consumerHostname } : {},
 			tag: `recorder:${deviceId}/${profile}`
-		}));
+		}, require_dist.nodePin(this.deps.ownerNodeId)));
 		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 +1921,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
@@ -1962,7 +1982,7 @@ var RecordingController = class {
 			r.writer.stop();
 		} catch {}
 		try {
-			await this.deps.api.streamBroker.releaseStreamWithCodec.mutate({ pipelineKey: r.pipelineKey });
+			await this.deps.api.streamBroker.releaseStreamWithCodec.mutate({ pipelineKey: r.pipelineKey }, require_dist.nodePin(this.deps.ownerNodeId));
 		} catch (err) {
 			this.deps.logger.warn("recorder: releaseStreamWithCodec failed", {
 				tags: { deviceId },
@@ -2073,9 +2093,13 @@ var MARKER_PAD_POST_MS = require_dist.EVENT_PAD_MS.postMs;
 *  form the hub reverse-proxy client path `/addon/recorder/playback`. */
 var RECORDER_ADDON_ID = "recorder";
 var PLAYBACK_PREFIX = "playback";
-/** Node the hub-only `stream-broker` runs on. Every recorder — on the hub or on
-*  a designated agent — gates on, and pulls from, THIS node's broker. */
-var BROKER_HOST_NODE_ID = "hub";
+/** Narrows the `unknown` extras `SegmentStore`'s logger contract accepts down
+*  to the structured `{ tags, error }` shape the device-scoped call sites
+*  (stat/relocate failures) pass — as opposed to the raw caught error most
+*  other call sites still pass directly. */
+function isSegmentStoreLogExtras(extras) {
+	return typeof extras === "object" && extras !== null && ("tags" in extras || "error" in extras);
+}
 var RecorderV2Addon = class extends require_dist.BaseAddon {
 	nodeId = "hub";
 	/** True when THIS node is the designated recording node (`recordingNodeId`).
@@ -2110,14 +2134,15 @@ var RecorderV2Addon = class extends require_dist.BaseAddon {
 			} });
 			return { providers: [] };
 		}
-		const consumerHostname = this.nodeId === BROKER_HOST_NODE_ID ? void 0 : resolveRecordingHubHostname(this.config.recordingHubHostname, process.env["CAMSTACK_HUB_URL"]);
-		if (this.nodeId !== BROKER_HOST_NODE_ID) {
+		const ingestOwner = await this.resolveIngestOwner();
+		const consumerHostname = this.nodeId === ingestOwner.ownerNodeId ? void 0 : ingestOwner.reachableHost ?? resolveRecordingHubHostname(this.config.recordingHubHostname, process.env["CAMSTACK_HUB_URL"]);
+		if (this.nodeId !== ingestOwner.ownerNodeId) {
 			this.ctx.logger.info("recorder is a REMOTE recording node — pulling broker streams cross-node", { meta: {
 				ownNodeId: this.nodeId,
-				brokerHost: BROKER_HOST_NODE_ID,
+				brokerHost: ingestOwner.ownerNodeId,
 				consumerHostname: consumerHostname ?? "(unresolved)"
 			} });
-			if (consumerHostname === void 0) this.ctx.logger.warn("recorder: could not resolve the hub host for cross-node pull — set the `recordingHubHostname` global setting or CAMSTACK_HUB_URL; recording will not reach this node", { meta: { ownNodeId: this.nodeId } });
+			if (consumerHostname === void 0) this.ctx.logger.warn("recorder: could not resolve the ingest owner host for cross-node pull — set the `recordingHubHostname` global setting or CAMSTACK_HUB_URL; recording will not reach this node", { meta: { ownNodeId: this.nodeId } });
 		}
 		const segmentStoreDeps = {
 			index: this.index,
@@ -2142,14 +2167,21 @@ var RecorderV2Addon = class extends require_dist.BaseAddon {
 					force: true
 				});
 			},
-			logger: { warn: (message, extras) => this.ctx.logger.warn(message, { meta: { extras } }) }
+			logger: { warn: (message, extras) => {
+				if (isSegmentStoreLogExtras(extras)) this.ctx.logger.warn(message, {
+					tags: extras.tags,
+					meta: { error: extras.error }
+				});
+				else this.ctx.logger.warn(message, { meta: { extras } });
+			} }
 		};
 		this.segmentStore = new SegmentStore(segmentStoreDeps);
-		const brokerHandle = this.ctx.useCapability("stream-broker", brokerScope(BROKER_HOST_NODE_ID));
+		const brokerHandle = this.ctx.useCapability("stream-broker", brokerScope(ingestOwner.ownerNodeId));
 		this.controller = new RecordingController({
 			api: this.ctx.api,
 			logger: this.ctx.logger,
 			nodeId: this.nodeId,
+			ownerNodeId: ingestOwner.ownerNodeId,
 			segmentStore: this.segmentStore,
 			loadConfig: (deviceId) => loadDeviceConfig(this.configStore(), deviceId),
 			enabledDeviceIds: async () => [...(await readDeviceConfigs(this.configStore())).keys()],
@@ -2158,7 +2190,7 @@ var RecorderV2Addon = class extends require_dist.BaseAddon {
 			segmentSeconds: this.config.segmentSeconds,
 			watchIntervalMs: this.config.watchIntervalMs,
 			...consumerHostname !== void 0 ? { consumerHostname } : {},
-			onBrokerReady: (handler) => this.ctx.onCapabilityStateChange("stream-broker", brokerScope(BROKER_HOST_NODE_ID), (state) => {
+			onBrokerReady: (handler) => this.ctx.onCapabilityStateChange("stream-broker", brokerScope(ingestOwner.ownerNodeId), (state) => {
 				if (state === "ready") handler();
 			}),
 			brokerCall: makeBrokerCall(brokerHandle)
@@ -2284,6 +2316,21 @@ var RecorderV2Addon = class extends require_dist.BaseAddon {
 		return this.resolvedLocations;
 	}
 	/**
+	* Resolve the cluster's camera-source owner. Graceful degrade: the
+	* `pipeline-orchestrator` cap may not be mounted yet (pre-image-release),
+	* in which case we fall back to `{ ownerNodeId: 'hub' }` — the same default
+	* `getIngestOwner` itself returns absent an explicit `clusterRoles.ingestNode`,
+	* so an unresolved owner is byte-identical to today's hub-only behaviour.
+	*/
+	async resolveIngestOwner() {
+		try {
+			return await this.ctx.api.pipelineOrchestrator.getIngestOwner.query();
+		} catch (err) {
+			this.ctx.logger.warn("recorder: getIngestOwner unavailable — defaulting to hub (cap not mounted yet?)", { meta: { error: require_dist.errMsg(err) } });
+			return { ownerNodeId: "hub" };
+		}
+	}
+	/**
 	* Roots the playback data-plane handler searches, IN ORDER: `<dataDir>/playback`
 	* FIRST (the freshly-written master/variant `.m3u8` playlists), then every
 	* recordings location root (the segment `.m4s` files at

package/dist/recorder/index.mjs

@@ -1,4 +1,4 @@
-import { A as recordingCapability, B as DeviceType, I as errMsg, J as selectAssignedProfileSlots, L as BaseAddon, M as storageEvictableCapability, T as migrateConfigToBands, U as hydrateSchema, V as EventCategory, at as string, it as record, s as EVENT_PAD_MS, u as RecordingConfigSchema } from "../dist-GFd8M6KO.mjs";
+import { A as recordingCapability, B as DeviceType, D as nodePin, I as errMsg, L as BaseAddon, M as storageEvictableCapability, T as migrateConfigToBands, U as hydrateSchema, V as EventCategory, Y as selectAssignedProfileSlots, at as record, ot as string, s as EVENT_PAD_MS, u as RecordingConfigSchema } from "../dist-CgBGV988.mjs";
 import { t as resolveHubHostname } from "../hub-hostname-cCknRYKj.mjs";
 import { t as createFileDataPlaneHandler } from "../model-download-service-C-IHWnXx-BPy6aoAx.mjs";
 import { spawn } from "node:child_process";
@@ -223,7 +223,10 @@ var SegmentStore = class SegmentStore {
 		try {
 			bytes = await this.deps.statBytes(input.flatAbsPath);
 		} catch (err) {
-			this.deps.logger.warn("segment stat failed", err);
+			this.deps.logger.warn("segment stat failed", {
+				tags: { deviceId: input.deviceId },
+				error: err
+			});
 			return null;
 		}
 		if (bytes <= 0) return null;
@@ -232,7 +235,10 @@ var SegmentStore = class SegmentStore {
 		try {
 			await this.deps.moveFile(input.flatAbsPath, toAbs);
 		} catch (err) {
-			this.deps.logger.warn("segment relocate failed", err);
+			this.deps.logger.warn("segment relocate failed", {
+				tags: { deviceId: input.deviceId },
+				error: err
+			});
 			return null;
 		}
 		const row = {
@@ -282,7 +288,10 @@ var SegmentStore = class SegmentStore {
 				}
 				continue;
 			} catch (err) {
-				this.deps.logger.warn("bucket removeDir failed — falling back to per-file deletes", err);
+				this.deps.logger.warn("bucket removeDir failed — falling back to per-file deletes", {
+					tags: { deviceId: bucketRows[0]?.deviceId },
+					error: err
+				});
 			}
 			for (const r of bucketRows) try {
 				await this.deps.deletePath({
@@ -292,7 +301,10 @@ var SegmentStore = class SegmentStore {
 				removed.push(r.path);
 				reclaimed += r.bytes;
 			} catch (err) {
-				this.deps.logger.warn("segment delete failed", err);
+				this.deps.logger.warn("segment delete failed", {
+					tags: { deviceId: r.deviceId },
+					error: err
+				});
 			}
 		}
 		if (removed.length > 0) this.deps.index.removeSegments(removed);
@@ -447,13 +459,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 +1105,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 };
 		}
 	};
@@ -1856,7 +1874,7 @@ var RecordingController = class {
 	* assigned sources is ignored (record every assigned source — minimum of 1).
 	*/
 	async resolveProfiles(deviceId, override) {
-		const assigned = selectAssignedProfileSlots(await this.deps.brokerCall(() => this.deps.api.streamBroker.listAllProfileSlots.query()), deviceId).map((slot) => slot.profile);
+		const assigned = selectAssignedProfileSlots(await this.deps.brokerCall(() => this.deps.api.streamBroker.listAllProfileSlots.query(void 0, nodePin(this.deps.ownerNodeId))), deviceId).map((slot) => slot.profile);
 		if (!override || override.length === 0) return assigned;
 		const selected = assigned.filter((p) => override.includes(p));
 		return selected.length > 0 ? selected : assigned;
@@ -1876,16 +1894,17 @@ var RecordingController = class {
 			profile,
 			...this.deps.consumerHostname !== void 0 ? { hostname: this.deps.consumerHostname } : {},
 			tag: `recorder:${deviceId}/${profile}`
-		}));
+		}, nodePin(this.deps.ownerNodeId)));
 		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 +1919,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
@@ -1961,7 +1980,7 @@ var RecordingController = class {
 			r.writer.stop();
 		} catch {}
 		try {
-			await this.deps.api.streamBroker.releaseStreamWithCodec.mutate({ pipelineKey: r.pipelineKey });
+			await this.deps.api.streamBroker.releaseStreamWithCodec.mutate({ pipelineKey: r.pipelineKey }, nodePin(this.deps.ownerNodeId));
 		} catch (err) {
 			this.deps.logger.warn("recorder: releaseStreamWithCodec failed", {
 				tags: { deviceId },
@@ -2072,9 +2091,13 @@ var MARKER_PAD_POST_MS = EVENT_PAD_MS.postMs;
 *  form the hub reverse-proxy client path `/addon/recorder/playback`. */
 var RECORDER_ADDON_ID = "recorder";
 var PLAYBACK_PREFIX = "playback";
-/** Node the hub-only `stream-broker` runs on. Every recorder — on the hub or on
-*  a designated agent — gates on, and pulls from, THIS node's broker. */
-var BROKER_HOST_NODE_ID = "hub";
+/** Narrows the `unknown` extras `SegmentStore`'s logger contract accepts down
+*  to the structured `{ tags, error }` shape the device-scoped call sites
+*  (stat/relocate failures) pass — as opposed to the raw caught error most
+*  other call sites still pass directly. */
+function isSegmentStoreLogExtras(extras) {
+	return typeof extras === "object" && extras !== null && ("tags" in extras || "error" in extras);
+}
 var RecorderV2Addon = class extends BaseAddon {
 	nodeId = "hub";
 	/** True when THIS node is the designated recording node (`recordingNodeId`).
@@ -2109,14 +2132,15 @@ var RecorderV2Addon = class extends BaseAddon {
 			} });
 			return { providers: [] };
 		}
-		const consumerHostname = this.nodeId === BROKER_HOST_NODE_ID ? void 0 : resolveRecordingHubHostname(this.config.recordingHubHostname, process.env["CAMSTACK_HUB_URL"]);
-		if (this.nodeId !== BROKER_HOST_NODE_ID) {
+		const ingestOwner = await this.resolveIngestOwner();
+		const consumerHostname = this.nodeId === ingestOwner.ownerNodeId ? void 0 : ingestOwner.reachableHost ?? resolveRecordingHubHostname(this.config.recordingHubHostname, process.env["CAMSTACK_HUB_URL"]);
+		if (this.nodeId !== ingestOwner.ownerNodeId) {
 			this.ctx.logger.info("recorder is a REMOTE recording node — pulling broker streams cross-node", { meta: {
 				ownNodeId: this.nodeId,
-				brokerHost: BROKER_HOST_NODE_ID,
+				brokerHost: ingestOwner.ownerNodeId,
 				consumerHostname: consumerHostname ?? "(unresolved)"
 			} });
-			if (consumerHostname === void 0) this.ctx.logger.warn("recorder: could not resolve the hub host for cross-node pull — set the `recordingHubHostname` global setting or CAMSTACK_HUB_URL; recording will not reach this node", { meta: { ownNodeId: this.nodeId } });
+			if (consumerHostname === void 0) this.ctx.logger.warn("recorder: could not resolve the ingest owner host for cross-node pull — set the `recordingHubHostname` global setting or CAMSTACK_HUB_URL; recording will not reach this node", { meta: { ownNodeId: this.nodeId } });
 		}
 		const segmentStoreDeps = {
 			index: this.index,
@@ -2141,14 +2165,21 @@ var RecorderV2Addon = class extends BaseAddon {
 					force: true
 				});
 			},
-			logger: { warn: (message, extras) => this.ctx.logger.warn(message, { meta: { extras } }) }
+			logger: { warn: (message, extras) => {
+				if (isSegmentStoreLogExtras(extras)) this.ctx.logger.warn(message, {
+					tags: extras.tags,
+					meta: { error: extras.error }
+				});
+				else this.ctx.logger.warn(message, { meta: { extras } });
+			} }
 		};
 		this.segmentStore = new SegmentStore(segmentStoreDeps);
-		const brokerHandle = this.ctx.useCapability("stream-broker", brokerScope(BROKER_HOST_NODE_ID));
+		const brokerHandle = this.ctx.useCapability("stream-broker", brokerScope(ingestOwner.ownerNodeId));
 		this.controller = new RecordingController({
 			api: this.ctx.api,
 			logger: this.ctx.logger,
 			nodeId: this.nodeId,
+			ownerNodeId: ingestOwner.ownerNodeId,
 			segmentStore: this.segmentStore,
 			loadConfig: (deviceId) => loadDeviceConfig(this.configStore(), deviceId),
 			enabledDeviceIds: async () => [...(await readDeviceConfigs(this.configStore())).keys()],
@@ -2157,7 +2188,7 @@ var RecorderV2Addon = class extends BaseAddon {
 			segmentSeconds: this.config.segmentSeconds,
 			watchIntervalMs: this.config.watchIntervalMs,
 			...consumerHostname !== void 0 ? { consumerHostname } : {},
-			onBrokerReady: (handler) => this.ctx.onCapabilityStateChange("stream-broker", brokerScope(BROKER_HOST_NODE_ID), (state) => {
+			onBrokerReady: (handler) => this.ctx.onCapabilityStateChange("stream-broker", brokerScope(ingestOwner.ownerNodeId), (state) => {
 				if (state === "ready") handler();
 			}),
 			brokerCall: makeBrokerCall(brokerHandle)
@@ -2283,6 +2314,21 @@ var RecorderV2Addon = class extends BaseAddon {
 		return this.resolvedLocations;
 	}
 	/**
+	* Resolve the cluster's camera-source owner. Graceful degrade: the
+	* `pipeline-orchestrator` cap may not be mounted yet (pre-image-release),
+	* in which case we fall back to `{ ownerNodeId: 'hub' }` — the same default
+	* `getIngestOwner` itself returns absent an explicit `clusterRoles.ingestNode`,
+	* so an unresolved owner is byte-identical to today's hub-only behaviour.
+	*/
+	async resolveIngestOwner() {
+		try {
+			return await this.ctx.api.pipelineOrchestrator.getIngestOwner.query();
+		} catch (err) {
+			this.ctx.logger.warn("recorder: getIngestOwner unavailable — defaulting to hub (cap not mounted yet?)", { meta: { error: errMsg(err) } });
+			return { ownerNodeId: "hub" };
+		}
+	}
+	/**
 	* Roots the playback data-plane handler searches, IN ORDER: `<dataDir>/playback`
 	* FIRST (the freshly-written master/variant `.m3u8` playlists), then every
 	* recordings location root (the segment `.m4s` files at