@camstack/addon-pipeline 1.1.23 → 1.1.25

package/dist/audio-analyzer/index.js

@@ -2,8 +2,8 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_model_download_service_C_IHWnXx = require("../model-download-service-C-IHWnXx-BnQ_awK4.js");
-const require_dist = require("../dist-CE3a05qT.js");
+const require_model_download_service_C_IHWnXx = require("../model-download-service-C-IHWnXx-DxM2DSns.js");
+const require_dist = require("../dist-wzWBZ26C.js");
 let node_fs = require("node:fs");
 node_fs = require_model_download_service_C_IHWnXx.__toESM(node_fs);
 let node_path = require("node:path");

package/dist/audio-analyzer/index.mjs

@@ -1,6 +1,6 @@
 import { t as __require } from "../chunk-BdkLduGY.mjs";
-import { B as BaseAddon, E as mapAudioLabelToMacro, J as hydrateSchema, g as audioAnalyzerCapability, h as audioAnalysisCapability, l as HF_BASE_URL, n as AUDIO_BACKEND_CHOICES, o as DEFAULT_AUDIO_ANALYZER_CONFIG, z as errMsg } from "../dist-pd_-3C0T.mjs";
-import { r as downloadFile } from "../model-download-service-C-IHWnXx-3Mmeob3l.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-BecXbIzJ.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";
 //#region src/audio-analyzer/audio-pipeline.ts

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-CE3a05qT.js");
+const require_dist = require("../dist-wzWBZ26C.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 BaseAddon, _ as audioCodecCapability, z as errMsg } from "../dist-pd_-3C0T.mjs";
+import { B as errMsg, V as BaseAddon, v as audioCodecCapability } from "../dist-BecXbIzJ.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,7 +2,7 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_dist = require("../dist-CE3a05qT.js");
+const require_dist = require("../dist-wzWBZ26C.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");
@@ -145,8 +145,10 @@ function buildVideoFilter(hwaccel, pixel, outWidth, outHeight, maxW, gpuScaleFil
 *   stream line from stderr to learn the exact output W×H (the broker does not
 *   pass source geometry for the shm path). `-nostats` suppresses the periodic
 *   `frame= …` counter while keeping the one-shot Output block.
-* - The input is `pipe:0` (Annex-B packets written to stdin); the output is raw
-*   video on `pipe:1`.
+* - The input is `pipe:0` (Annex-B packets written to stdin) in push mode, or
+*   `options.inputUrl` (the owner's restream, dialed by ffmpeg itself —
+*   `-rtsp_transport tcp` for rtsp URLs) in pull mode; the output is raw video
+*   on `pipe:1` either way.
 */
 function buildFfmpegDecodeArgs(config, options) {
 	const inputFormat = codecToInputFormat(config.codec);
@@ -162,6 +164,16 @@ function buildFfmpegDecodeArgs(config, options) {
 		if (needsHwDownload(hwaccel)) hwaccelArgs.push("-hwaccel_device", options.renderDevice ?? "/dev/dri/renderD128");
 		if (keepFramesOnGpu(hwaccel, gpuScaleFilter)) hwaccelArgs.push("-hwaccel_output_format", hwaccel);
 	}
+	const inputArgs = options.inputUrl !== void 0 ? [
+		...options.inputUrl.startsWith("rtsp") ? ["-rtsp_transport", "tcp"] : [],
+		"-i",
+		options.inputUrl
+	] : [
+		"-f",
+		inputFormat,
+		"-i",
+		"pipe:0"
+	];
 	return [
 		...require_frame_dropper.logBannerArgs("info"),
 		"-nostats",
@@ -174,10 +186,7 @@ function buildFfmpegDecodeArgs(config, options) {
 		"-analyzeduration",
 		"0",
 		...hwaccelArgs,
-		"-f",
-		inputFormat,
-		"-i",
-		"pipe:0",
+		...inputArgs,
 		"-vf",
 		vf,
 		"-f",
@@ -650,6 +659,16 @@ var noopLogger = {
 *  hwaccel init failure (missing render node, unsupported codec on GPU, the
 *  Intel `qsv` `code=171`) surfaces this early. */
 var HWACCEL_FALLBACK_WINDOW_MS = 4e3;
+/**
+* Delay before a PULL-MODE session re-dials its input URL after the child
+* exits (RTSP EOF, restream teardown, network blip). Push mode never
+* self-respawns on a plain exit — the broker's packet feed drives recovery —
+* but a pull-mode child owns its own input, so the session must re-dial or a
+* single EOF would silence it forever. The delay turns a hard-down source
+* into a slow probe instead of a spawn storm; the consumer tearing the
+* session down (`destroy`) cancels the pending re-dial.
+*/
+var PULL_REDIAL_DELAY_MS = 3e3;
 var FfmpegDecoderSession = class {
 	config;
 	logger;
@@ -680,6 +699,15 @@ var FfmpegDecoderSession = class {
 	process = null;
 	spawnedAtMs = 0;
 	/**
+	* PULL-MODE input URL (P2b). `null` = push mode (packets via stdin — the
+	* default). Set by {@link openStream}; every (re)spawn since reads this URL
+	* directly instead of `pipe:0`. A session is push-mode or pull-mode for its
+	* whole life — `openStream` on a packet-fed session throws.
+	*/
+	pullUrl = null;
+	/** Pending pull-mode re-dial timer (armed on a pull child exit). */
+	pullRedialTimer = null;
+	/**
 	* Splits ffmpeg's raw stdout byte stream into frames, filling each DIRECTLY
 	* into its shm slot (zero-copy) — created once the output geometry is known.
 	*/
@@ -733,7 +761,25 @@ var FfmpegDecoderSession = class {
 		return this.frameRingSink;
 	}
 	get isPullMode() {
-		return false;
+		return this.pullUrl !== null;
+	}
+	/**
+	* Switch the session to PULL MODE: (re)spawn ffmpeg reading `url` directly
+	* (`-rtsp_transport tcp -i <url>` for rtsp) instead of stdin. The whole
+	* output path (filtergraph, rawvideo pipe, shm ring sink) is unchanged.
+	*
+	* - Calling it again re-dials with the FRESH url (a hub restream bounce
+	*   mints a new token URL — never cache the old one).
+	* - Calling it on a session already fed via `pushPacket` throws: a session
+	*   is push-mode or pull-mode, never both (mixing inputs would corrupt the
+	*   decode).
+	*/
+	async openStream(url) {
+		if (this.destroyed) return;
+		if (this.pullUrl === null && this.inputPackets > 0) throw new Error("ffmpeg decoder: openStream on a push-fed session — a session is push-mode or pull-mode, never both");
+		this.pullUrl = url;
+		this.logger.info("ffmpeg decoder: pull-mode openStream — dialing input URL", { meta: { url } });
+		this.spawnFfmpeg();
 	}
 	ensureFrameRingSink() {
 		if (this.frameRingSink === null) {
@@ -751,6 +797,7 @@ var FfmpegDecoderSession = class {
 	}
 	spawnFfmpeg() {
 		if (this.destroyed) return;
+		this.clearPullRedial();
 		this.killFfmpeg();
 		this.abortOpenSlot();
 		this.splitter = null;
@@ -767,7 +814,8 @@ var FfmpegDecoderSession = class {
 		}, {
 			hwaccel: this.hwaccel,
 			renderDevice: this.renderDevice,
-			gpuScaleFilter: this.activeGpuScaleFilter
+			gpuScaleFilter: this.activeGpuScaleFilter,
+			...this.pullUrl !== null ? { inputUrl: this.pullUrl } : {}
 		});
 		let child;
 		try {
@@ -854,6 +902,27 @@ var FfmpegDecoderSession = class {
 			signal,
 			outputFrames: this.outputFrames
 		} });
+		if (this.pullUrl !== null) {
+			this.clearPullRedial();
+			const timer = setTimeout(() => {
+				this.pullRedialTimer = null;
+				this.spawnFfmpeg();
+			}, PULL_REDIAL_DELAY_MS);
+			timer.unref?.();
+			this.pullRedialTimer = timer;
+			this.logger.info("ffmpeg decoder: pull-mode child exited — re-dial scheduled", { meta: {
+				code,
+				signal,
+				redialInMs: PULL_REDIAL_DELAY_MS
+			} });
+		}
+	}
+	/** Cancel a pending pull-mode re-dial, if armed. */
+	clearPullRedial() {
+		if (this.pullRedialTimer !== null) {
+			clearTimeout(this.pullRedialTimer);
+			this.pullRedialTimer = null;
+		}
 	}
 	handleStderr(data) {
 		const text = data.toString();
@@ -958,6 +1027,7 @@ var FfmpegDecoderSession = class {
 	}
 	pushPacket(packet) {
 		if (this.destroyed) return;
+		if (this.pullUrl !== null) return;
 		const stdin = this.process?.stdin;
 		if (!stdin) return;
 		this.inputPackets++;
@@ -990,6 +1060,7 @@ var FfmpegDecoderSession = class {
 	async destroy() {
 		if (this.destroyed) return;
 		this.destroyed = true;
+		this.clearPullRedial();
 		this.killFfmpeg();
 		this.abortOpenSlot();
 		this.splitter = null;
@@ -1235,7 +1306,7 @@ var DecoderFfmpegAddon = class extends require_dist.BaseAddon {
 		return {
 			id: "decoder-ffmpeg",
 			name: "Decoder (ffmpeg)",
-			isPullMode: false,
+			isPullMode: true,
 			priority: 20
 		};
 	}
@@ -1346,8 +1417,9 @@ var DecoderFfmpegAddon = class extends require_dist.BaseAddon {
 		});
 	}
 	async openStream(input) {
-		if (!this.sessions.get(input.sessionId)) throw new Error(`decoder-ffmpeg: unknown sessionId ${input.sessionId}`);
-		input.url;
+		const session = this.sessions.get(input.sessionId);
+		if (!session) throw new Error(`decoder-ffmpeg: unknown sessionId ${input.sessionId}`);
+		await session.openStream(input.url);
 	}
 	async pullFrames(input) {
 		if (!this.sessions.has(input.sessionId)) throw new Error(`decoder-ffmpeg: unknown sessionId ${input.sessionId}`);

package/dist/decoder-ffmpeg/index.mjs

@@ -1,4 +1,4 @@
-import { B as BaseAddon, b as decoderCapability, f as RingBuffer, s as DEFAULT_DECODER_HWACCEL_CONFIG, u as HWACCEL_OPTIONS, z as errMsg } from "../dist-pd_-3C0T.mjs";
+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-BecXbIzJ.mjs";
 import { r as logBannerArgs, t as FrameDropper } from "../frame-dropper-CwkBTPGV.mjs";
 import { FrameRingReaderCache, FrameRingWriter, MIN_RING_SLOTS, computeSegmentSize, computeSlotByteLength, createSegment, deriveSlotCount } from "@camstack/shm-ring";
 import { randomUUID } from "node:crypto";
@@ -141,8 +141,10 @@ function buildVideoFilter(hwaccel, pixel, outWidth, outHeight, maxW, gpuScaleFil
 *   stream line from stderr to learn the exact output W×H (the broker does not
 *   pass source geometry for the shm path). `-nostats` suppresses the periodic
 *   `frame= …` counter while keeping the one-shot Output block.
-* - The input is `pipe:0` (Annex-B packets written to stdin); the output is raw
-*   video on `pipe:1`.
+* - The input is `pipe:0` (Annex-B packets written to stdin) in push mode, or
+*   `options.inputUrl` (the owner's restream, dialed by ffmpeg itself —
+*   `-rtsp_transport tcp` for rtsp URLs) in pull mode; the output is raw video
+*   on `pipe:1` either way.
 */
 function buildFfmpegDecodeArgs(config, options) {
 	const inputFormat = codecToInputFormat(config.codec);
@@ -158,6 +160,16 @@ function buildFfmpegDecodeArgs(config, options) {
 		if (needsHwDownload(hwaccel)) hwaccelArgs.push("-hwaccel_device", options.renderDevice ?? "/dev/dri/renderD128");
 		if (keepFramesOnGpu(hwaccel, gpuScaleFilter)) hwaccelArgs.push("-hwaccel_output_format", hwaccel);
 	}
+	const inputArgs = options.inputUrl !== void 0 ? [
+		...options.inputUrl.startsWith("rtsp") ? ["-rtsp_transport", "tcp"] : [],
+		"-i",
+		options.inputUrl
+	] : [
+		"-f",
+		inputFormat,
+		"-i",
+		"pipe:0"
+	];
 	return [
 		...logBannerArgs("info"),
 		"-nostats",
@@ -170,10 +182,7 @@ function buildFfmpegDecodeArgs(config, options) {
 		"-analyzeduration",
 		"0",
 		...hwaccelArgs,
-		"-f",
-		inputFormat,
-		"-i",
-		"pipe:0",
+		...inputArgs,
 		"-vf",
 		vf,
 		"-f",
@@ -646,6 +655,16 @@ var noopLogger = {
 *  hwaccel init failure (missing render node, unsupported codec on GPU, the
 *  Intel `qsv` `code=171`) surfaces this early. */
 var HWACCEL_FALLBACK_WINDOW_MS = 4e3;
+/**
+* Delay before a PULL-MODE session re-dials its input URL after the child
+* exits (RTSP EOF, restream teardown, network blip). Push mode never
+* self-respawns on a plain exit — the broker's packet feed drives recovery —
+* but a pull-mode child owns its own input, so the session must re-dial or a
+* single EOF would silence it forever. The delay turns a hard-down source
+* into a slow probe instead of a spawn storm; the consumer tearing the
+* session down (`destroy`) cancels the pending re-dial.
+*/
+var PULL_REDIAL_DELAY_MS = 3e3;
 var FfmpegDecoderSession = class {
 	config;
 	logger;
@@ -676,6 +695,15 @@ var FfmpegDecoderSession = class {
 	process = null;
 	spawnedAtMs = 0;
 	/**
+	* PULL-MODE input URL (P2b). `null` = push mode (packets via stdin — the
+	* default). Set by {@link openStream}; every (re)spawn since reads this URL
+	* directly instead of `pipe:0`. A session is push-mode or pull-mode for its
+	* whole life — `openStream` on a packet-fed session throws.
+	*/
+	pullUrl = null;
+	/** Pending pull-mode re-dial timer (armed on a pull child exit). */
+	pullRedialTimer = null;
+	/**
 	* Splits ffmpeg's raw stdout byte stream into frames, filling each DIRECTLY
 	* into its shm slot (zero-copy) — created once the output geometry is known.
 	*/
@@ -729,7 +757,25 @@ var FfmpegDecoderSession = class {
 		return this.frameRingSink;
 	}
 	get isPullMode() {
-		return false;
+		return this.pullUrl !== null;
+	}
+	/**
+	* Switch the session to PULL MODE: (re)spawn ffmpeg reading `url` directly
+	* (`-rtsp_transport tcp -i <url>` for rtsp) instead of stdin. The whole
+	* output path (filtergraph, rawvideo pipe, shm ring sink) is unchanged.
+	*
+	* - Calling it again re-dials with the FRESH url (a hub restream bounce
+	*   mints a new token URL — never cache the old one).
+	* - Calling it on a session already fed via `pushPacket` throws: a session
+	*   is push-mode or pull-mode, never both (mixing inputs would corrupt the
+	*   decode).
+	*/
+	async openStream(url) {
+		if (this.destroyed) return;
+		if (this.pullUrl === null && this.inputPackets > 0) throw new Error("ffmpeg decoder: openStream on a push-fed session — a session is push-mode or pull-mode, never both");
+		this.pullUrl = url;
+		this.logger.info("ffmpeg decoder: pull-mode openStream — dialing input URL", { meta: { url } });
+		this.spawnFfmpeg();
 	}
 	ensureFrameRingSink() {
 		if (this.frameRingSink === null) {
@@ -747,6 +793,7 @@ var FfmpegDecoderSession = class {
 	}
 	spawnFfmpeg() {
 		if (this.destroyed) return;
+		this.clearPullRedial();
 		this.killFfmpeg();
 		this.abortOpenSlot();
 		this.splitter = null;
@@ -763,7 +810,8 @@ var FfmpegDecoderSession = class {
 		}, {
 			hwaccel: this.hwaccel,
 			renderDevice: this.renderDevice,
-			gpuScaleFilter: this.activeGpuScaleFilter
+			gpuScaleFilter: this.activeGpuScaleFilter,
+			...this.pullUrl !== null ? { inputUrl: this.pullUrl } : {}
 		});
 		let child;
 		try {
@@ -850,6 +898,27 @@ var FfmpegDecoderSession = class {
 			signal,
 			outputFrames: this.outputFrames
 		} });
+		if (this.pullUrl !== null) {
+			this.clearPullRedial();
+			const timer = setTimeout(() => {
+				this.pullRedialTimer = null;
+				this.spawnFfmpeg();
+			}, PULL_REDIAL_DELAY_MS);
+			timer.unref?.();
+			this.pullRedialTimer = timer;
+			this.logger.info("ffmpeg decoder: pull-mode child exited — re-dial scheduled", { meta: {
+				code,
+				signal,
+				redialInMs: PULL_REDIAL_DELAY_MS
+			} });
+		}
+	}
+	/** Cancel a pending pull-mode re-dial, if armed. */
+	clearPullRedial() {
+		if (this.pullRedialTimer !== null) {
+			clearTimeout(this.pullRedialTimer);
+			this.pullRedialTimer = null;
+		}
 	}
 	handleStderr(data) {
 		const text = data.toString();
@@ -954,6 +1023,7 @@ var FfmpegDecoderSession = class {
 	}
 	pushPacket(packet) {
 		if (this.destroyed) return;
+		if (this.pullUrl !== null) return;
 		const stdin = this.process?.stdin;
 		if (!stdin) return;
 		this.inputPackets++;
@@ -986,6 +1056,7 @@ var FfmpegDecoderSession = class {
 	async destroy() {
 		if (this.destroyed) return;
 		this.destroyed = true;
+		this.clearPullRedial();
 		this.killFfmpeg();
 		this.abortOpenSlot();
 		this.splitter = null;
@@ -1231,7 +1302,7 @@ var DecoderFfmpegAddon = class extends BaseAddon {
 		return {
 			id: "decoder-ffmpeg",
 			name: "Decoder (ffmpeg)",
-			isPullMode: false,
+			isPullMode: true,
 			priority: 20
 		};
 	}
@@ -1342,8 +1413,9 @@ var DecoderFfmpegAddon = class extends BaseAddon {
 		});
 	}
 	async openStream(input) {
-		if (!this.sessions.get(input.sessionId)) throw new Error(`decoder-ffmpeg: unknown sessionId ${input.sessionId}`);
-		input.url;
+		const session = this.sessions.get(input.sessionId);
+		if (!session) throw new Error(`decoder-ffmpeg: unknown sessionId ${input.sessionId}`);
+		await session.openStream(input.url);
 	}
 	async pullFrames(input) {
 		if (!this.sessions.has(input.sessionId)) throw new Error(`decoder-ffmpeg: unknown sessionId ${input.sessionId}`);

package/dist/detection-pipeline/index.js

@@ -2,8 +2,8 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_model_download_service_C_IHWnXx = require("../model-download-service-C-IHWnXx-BnQ_awK4.js");
-const require_dist = require("../dist-CE3a05qT.js");
+const require_model_download_service_C_IHWnXx = require("../model-download-service-C-IHWnXx-DxM2DSns.js");
+const require_dist = require("../dist-wzWBZ26C.js");
 let node_fs = require("node:fs");
 node_fs = require_model_download_service_C_IHWnXx.__toESM(node_fs);
 let node_path = require("node:path");

package/dist/detection-pipeline/index.mjs

@@ -1,6 +1,6 @@
 import { t as __require } from "../chunk-BdkLduGY.mjs";
-import { A as nodePin, B as BaseAddon, C as detectionPipelineCapability, J as hydrateSchema, L as supportedRuntimes$1, P as runtimeDevices$1, T as hfModelUrl, W as EventCategory, Z as parseJsonUnknown, a as COCO_TO_MACRO, et as sleep, i as COCO_80_LABELS, j as pipelineExecutorCapability, p as YAMNET_TO_MACRO, q as createEvent, r as AUDIO_MACRO_LABELS, t as APPLE_SA_TO_MACRO, w as evaluateZoneRules, x as defaultDeviceFor$1, z as errMsg } from "../dist-pd_-3C0T.mjs";
-import { a as isModelDownloaded, i as ensureModel, n as deleteModelFromDisk } from "../model-download-service-C-IHWnXx-3Mmeob3l.mjs";
+import { B as errMsg, E as hfModelUrl, F as runtimeDevices$1, G as EventCategory, J as createEvent, M as pipelineExecutorCapability, Q as parseJsonUnknown, R as supportedRuntimes$1, S as defaultDeviceFor$1, T as evaluateZoneRules, V as BaseAddon, Y as hydrateSchema, a as COCO_TO_MACRO, i as COCO_80_LABELS, j as nodePin, m as YAMNET_TO_MACRO, r as AUDIO_MACRO_LABELS, t as APPLE_SA_TO_MACRO, tt as sleep, w as detectionPipelineCapability } from "../dist-BecXbIzJ.mjs";
+import { a as isModelDownloaded, i as ensureModel, n as deleteModelFromDisk } from "../model-download-service-C-IHWnXx-BPy6aoAx.mjs";
 import * as fs from "node:fs";
 import * as path$1 from "node:path";
 import * as os from "node:os";

package/dist/{dist-pd_-3C0T.mjs → dist-BecXbIzJ.mjs}

@@ -6923,6 +6923,25 @@ var ConvertResultSchema = object({
 	})).readonly()
 });
 /**
+* THE canonical event-clip pad: the time window a single-timestamp analytics
+* event expands to when joined with footage (clip window = `[timestamp - preMs,
+* timestamp + postMs]`). Matches the admin-ui clip window (−5s/+10s).
+*
+* Every consumer derives from this ONE constant so event↔footage boundaries
+* agree everywhere (C1):
+*   - the `videoclips` default provider (addon-post-analysis) pads its clip
+*     windows with it;
+*   - the recorder's ephemeral in-RAM `EventMap` markers (addon-pipeline) pad
+*     their `startMs/endMs` with it.
+*
+* NOTE: this is a UI/JOIN convention, NOT the `events`-band keep/discard gate —
+* that uses the per-device `preBufferSec`/`postBufferSec` config.
+*/
+var EVENT_PAD_MS = {
+	preMs: 5e3,
+	postMs: 1e4
+};
+/**
 * Numeric day-of-week: 0 = Sunday … 6 = Saturday (matches `Date.getDay`).
 * Named `RecordingWeekday` to avoid collision with the string-union
 * `Weekday` exported from `interfaces/timezones.ts`.
@@ -10813,6 +10832,31 @@ var ReportMotionInputSchema = object({
 	regions: array(MotionRegionSchema).readonly().optional()
 });
 /**
+* Where a runner gets a camera's decoded frames (cross-node Phase 2,
+* restream-owner model — P2c).
+*
+* - `local-broker` (DEFAULT): today's path — subscribe to the co-located
+*   stream-broker's shm frame plane. Every pre-P2c attach payload (no
+*   `frameSource` key) parses to this, so the field is additive with zero
+*   behavior change.
+* - `remote-restream`: the detect node is NOT the camera's source-owner.
+*   The runner acquires the owner's COMPRESSED passthrough restream
+*   (`streamBroker.getStreamWithCodec({video:'copy'})` — refcounted, the
+*   double-pull guard) and decodes LOCALLY via a satellite frame plane +
+*   pull-mode decoder session pinned to its own node. The shm ring stays
+*   node-local; only H.264/H.265 packets cross the wire.
+*   `hubHostnameOverride` mirrors the recorder's `recordingHubHostname`:
+*   when set it overrides the `CAMSTACK_HUB_URL`-derived host the runner
+*   dials for the owner's restream.
+*/
+var RunnerFrameSourceSchema = discriminatedUnion("kind", [object({ kind: literal("local-broker") }), object({
+	kind: literal("remote-restream"),
+	/** The camera's source-owner node (slice 1: always the hub). */
+	ownerNodeId: string(),
+	/** Operator override for the owner host the runner dials. */
+	hubHostnameOverride: string().optional()
+})]).describe("Per-camera frame-source mode for the runner (P2c)");
+/**
 * Camera assignment payload sent by `addon-pipeline-orchestrator` to a
 * specific runner instance via `attachCamera`. Carries everything the
 * runner needs to subscribe to the local broker and execute inference.
@@ -10910,7 +10954,15 @@ var RunnerCameraConfigSchema = object({
 	*/
 	onboardMotionDrivesAnalyzer: boolean().default(true),
 	occupancyRecheckSec: number().min(occupancyRecheckSecField.min).max(occupancyRecheckSecField.max).default(occupancyRecheckSecField.default),
-	occupancyRecheckFrames: number().min(occupancyRecheckFramesField.min).max(occupancyRecheckFramesField.max).default(occupancyRecheckFramesField.default)
+	occupancyRecheckFrames: number().min(occupancyRecheckFramesField.min).max(occupancyRecheckFramesField.max).default(occupancyRecheckFramesField.default),
+	/**
+	* Where this runner gets the camera's decoded frames (P2c). Defaulted so
+	* every existing payload behaves as `local-broker` — the pre-Phase-2 path.
+	* Populated with `remote-restream` by the orchestrator ONLY when the
+	* camera's detect node differs from its source-owner (P2d, gated by the
+	* `remoteSourcingNodes` rollout setting).
+	*/
+	frameSource: RunnerFrameSourceSchema.default({ kind: "local-broker" })
 });
 motionFpsField.min, motionFpsField.max, motionFpsField.step, motionFpsField.default, detectionFpsField.min, detectionFpsField.max, detectionFpsField.step, detectionFpsField.default, motionCooldownMsField.min, motionCooldownMsField.max, motionCooldownMsField.step, motionCooldownMsField.default, occupancyRecheckSecField.min, occupancyRecheckSecField.max, occupancyRecheckSecField.step, occupancyRecheckSecField.default, occupancyRecheckFramesField.min, occupancyRecheckFramesField.max, occupancyRecheckFramesField.step, occupancyRecheckFramesField.default;
 /**
@@ -18144,6 +18196,16 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
 	kind: "mutation",
 	auth: "admin"
 });
+/**
+* `recording` cap — footage availability + HLS playback manifests + per-device
+* recording config. NOTE on events (source of truth, R5/C3): this cap carries
+* NO event surface — `getPlaybackManifest` returns playlist URLs only. Timeline
+* events (motion/object/audio) come from `pipelineAnalytics` (durable SQLite
+* rows); the recorder's internal EventMap markers are ephemeral in-RAM
+* annotations that are not exposed here and must not be treated as an event
+* feed. Event<->footage joins are by time, padded with the shared `EVENT_PAD_MS`
+* (`interfaces/recording-config.ts`).
+*/
 var RecordingStatusSchema = object({
 	deviceId: number(),
 	enabled: boolean(),
@@ -23203,4 +23265,4 @@ function defaultDeviceFor(id) {
 	return def(id).defaultDevice;
 }
 //#endregion
-export { selectAssignedProfileSlots as $, nodePin as A, BaseAddon as B, detectionPipelineCapability as C, maskUrlCredentials as D, mapAudioLabelToMacro as E, storageEvictableCapability as F, asJsonObject as G, DeviceFeature as H, streamBrokerCapability as I, hydrateSchema as J, createDurableState as K, supportedRuntimes as L, pipelineRunnerCapability as M, recordingCapability as N, migrateConfigToBands as O, runtimeDevices as P, parseProfileBrokerId as Q, webrtcSessionCapability as R, defineCustomActions as S, hfModelUrl as T, DeviceType as U, CAM_PROFILE_ORDER as V, EventCategory as W, makeSourceBrokerId as X, makeProfileBrokerId as Y, parseJsonUnknown as Z, audioCodecCapability as _, COCO_TO_MACRO as a, lazy as at, decoderCapability as b, EncodeProfileSchema as c, object as ct, RecordingConfigSchema as d, union as dt, sleep as et, RingBuffer as f, audioAnalyzerCapability as g, audioAnalysisCapability as h, COCO_80_LABELS as i, discriminatedUnion as it, pipelineExecutorCapability as j, motionDetectionCapability as k, HF_BASE_URL as l, record as lt, addonWidgetsSourceCapability as m, AUDIO_BACKEND_CHOICES as n, array as nt, DEFAULT_AUDIO_ANALYZER_CONFIG as o, literal as ot, YAMNET_TO_MACRO as p, createEvent as q, AUDIO_MACRO_LABELS as r, boolean as rt, DEFAULT_DECODER_HWACCEL_CONFIG as s, number as st, APPLE_SA_TO_MACRO as t, _enum as tt, HWACCEL_OPTIONS as u, string as ut, cameraStreamsCapability as v, evaluateZoneRules as w, defaultDeviceFor as x, customAction as y, errMsg as z };
+export { parseProfileBrokerId as $, motionDetectionCapability as A, errMsg as B, defineCustomActions as C, mapAudioLabelToMacro as D, hfModelUrl as E, runtimeDevices as F, EventCategory as G, CAM_PROFILE_ORDER as H, storageEvictableCapability as I, createEvent as J, asJsonObject as K, streamBrokerCapability as L, pipelineExecutorCapability as M, pipelineRunnerCapability as N, maskUrlCredentials as O, recordingCapability as P, parseJsonUnknown as Q, supportedRuntimes as R, defaultDeviceFor as S, evaluateZoneRules as T, DeviceFeature as U, BaseAddon as V, DeviceType as W, makeProfileBrokerId as X, hydrateSchema as Y, makeSourceBrokerId as Z, audioAnalyzerCapability as _, COCO_TO_MACRO as a, discriminatedUnion as at, customAction as b, EVENT_PAD_MS as c, number as ct, HWACCEL_OPTIONS as d, string as dt, selectAssignedProfileSlots as et, RecordingConfigSchema as f, union as ft, audioAnalysisCapability as g, addonWidgetsSourceCapability as h, COCO_80_LABELS as i, boolean as it, nodePin as j, migrateConfigToBands as k, EncodeProfileSchema as l, object as lt, YAMNET_TO_MACRO as m, AUDIO_BACKEND_CHOICES as n, _enum as nt, DEFAULT_AUDIO_ANALYZER_CONFIG as o, lazy as ot, RingBuffer as p, createDurableState as q, AUDIO_MACRO_LABELS as r, array as rt, DEFAULT_DECODER_HWACCEL_CONFIG as s, literal as st, APPLE_SA_TO_MACRO as t, sleep as tt, HF_BASE_URL as u, record as ut, audioCodecCapability as v, detectionPipelineCapability as w, decoderCapability as x, cameraStreamsCapability as y, webrtcSessionCapability as z };

package/dist/{dist-CE3a05qT.js → dist-wzWBZ26C.js}

@@ -6923,6 +6923,25 @@ var ConvertResultSchema = object({
 	})).readonly()
 });
 /**
+* THE canonical event-clip pad: the time window a single-timestamp analytics
+* event expands to when joined with footage (clip window = `[timestamp - preMs,
+* timestamp + postMs]`). Matches the admin-ui clip window (−5s/+10s).
+*
+* Every consumer derives from this ONE constant so event↔footage boundaries
+* agree everywhere (C1):
+*   - the `videoclips` default provider (addon-post-analysis) pads its clip
+*     windows with it;
+*   - the recorder's ephemeral in-RAM `EventMap` markers (addon-pipeline) pad
+*     their `startMs/endMs` with it.
+*
+* NOTE: this is a UI/JOIN convention, NOT the `events`-band keep/discard gate —
+* that uses the per-device `preBufferSec`/`postBufferSec` config.
+*/
+var EVENT_PAD_MS = {
+	preMs: 5e3,
+	postMs: 1e4
+};
+/**
 * Numeric day-of-week: 0 = Sunday … 6 = Saturday (matches `Date.getDay`).
 * Named `RecordingWeekday` to avoid collision with the string-union
 * `Weekday` exported from `interfaces/timezones.ts`.
@@ -10813,6 +10832,31 @@ var ReportMotionInputSchema = object({
 	regions: array(MotionRegionSchema).readonly().optional()
 });
 /**
+* Where a runner gets a camera's decoded frames (cross-node Phase 2,
+* restream-owner model — P2c).
+*
+* - `local-broker` (DEFAULT): today's path — subscribe to the co-located
+*   stream-broker's shm frame plane. Every pre-P2c attach payload (no
+*   `frameSource` key) parses to this, so the field is additive with zero
+*   behavior change.
+* - `remote-restream`: the detect node is NOT the camera's source-owner.
+*   The runner acquires the owner's COMPRESSED passthrough restream
+*   (`streamBroker.getStreamWithCodec({video:'copy'})` — refcounted, the
+*   double-pull guard) and decodes LOCALLY via a satellite frame plane +
+*   pull-mode decoder session pinned to its own node. The shm ring stays
+*   node-local; only H.264/H.265 packets cross the wire.
+*   `hubHostnameOverride` mirrors the recorder's `recordingHubHostname`:
+*   when set it overrides the `CAMSTACK_HUB_URL`-derived host the runner
+*   dials for the owner's restream.
+*/
+var RunnerFrameSourceSchema = discriminatedUnion("kind", [object({ kind: literal("local-broker") }), object({
+	kind: literal("remote-restream"),
+	/** The camera's source-owner node (slice 1: always the hub). */
+	ownerNodeId: string(),
+	/** Operator override for the owner host the runner dials. */
+	hubHostnameOverride: string().optional()
+})]).describe("Per-camera frame-source mode for the runner (P2c)");
+/**
 * Camera assignment payload sent by `addon-pipeline-orchestrator` to a
 * specific runner instance via `attachCamera`. Carries everything the
 * runner needs to subscribe to the local broker and execute inference.
@@ -10910,7 +10954,15 @@ var RunnerCameraConfigSchema = object({
 	*/
 	onboardMotionDrivesAnalyzer: boolean().default(true),
 	occupancyRecheckSec: number().min(occupancyRecheckSecField.min).max(occupancyRecheckSecField.max).default(occupancyRecheckSecField.default),
-	occupancyRecheckFrames: number().min(occupancyRecheckFramesField.min).max(occupancyRecheckFramesField.max).default(occupancyRecheckFramesField.default)
+	occupancyRecheckFrames: number().min(occupancyRecheckFramesField.min).max(occupancyRecheckFramesField.max).default(occupancyRecheckFramesField.default),
+	/**
+	* Where this runner gets the camera's decoded frames (P2c). Defaulted so
+	* every existing payload behaves as `local-broker` — the pre-Phase-2 path.
+	* Populated with `remote-restream` by the orchestrator ONLY when the
+	* camera's detect node differs from its source-owner (P2d, gated by the
+	* `remoteSourcingNodes` rollout setting).
+	*/
+	frameSource: RunnerFrameSourceSchema.default({ kind: "local-broker" })
 });
 motionFpsField.min, motionFpsField.max, motionFpsField.step, motionFpsField.default, detectionFpsField.min, detectionFpsField.max, detectionFpsField.step, detectionFpsField.default, motionCooldownMsField.min, motionCooldownMsField.max, motionCooldownMsField.step, motionCooldownMsField.default, occupancyRecheckSecField.min, occupancyRecheckSecField.max, occupancyRecheckSecField.step, occupancyRecheckSecField.default, occupancyRecheckFramesField.min, occupancyRecheckFramesField.max, occupancyRecheckFramesField.step, occupancyRecheckFramesField.default;
 /**
@@ -18144,6 +18196,16 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
 	kind: "mutation",
 	auth: "admin"
 });
+/**
+* `recording` cap — footage availability + HLS playback manifests + per-device
+* recording config. NOTE on events (source of truth, R5/C3): this cap carries
+* NO event surface — `getPlaybackManifest` returns playlist URLs only. Timeline
+* events (motion/object/audio) come from `pipelineAnalytics` (durable SQLite
+* rows); the recorder's internal EventMap markers are ephemeral in-RAM
+* annotations that are not exposed here and must not be treated as an event
+* feed. Event<->footage joins are by time, padded with the shared `EVENT_PAD_MS`
+* (`interfaces/recording-config.ts`).
+*/
 var RecordingStatusSchema = object({
 	deviceId: number(),
 	enabled: boolean(),
@@ -23269,6 +23331,12 @@ Object.defineProperty(exports, "DeviceType", {
 		return DeviceType;
 	}
 });
+Object.defineProperty(exports, "EVENT_PAD_MS", {
+	enumerable: true,
+	get: function() {
+		return EVENT_PAD_MS;
+	}
+});
 Object.defineProperty(exports, "EncodeProfileSchema", {
 	enumerable: true,
 	get: function() {