@camstack/addon-pipeline 1.1.38 → 1.1.40

package/dist/{dist-DdZEBePv.mjs → dist-v6cKLmU3.mjs}

@@ -4627,7 +4627,7 @@ function _instanceof(cls, params = {}) {
 	return inst;
 }
 //#endregion
-//#region ../types/dist/sleep-BiDFW0E7.mjs
+//#region ../types/dist/sleep-CZDdRBua.mjs
 var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["SystemBoot"] = "system.boot";
 	EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -7418,7 +7418,16 @@ var DecoderStatsSchema = object({
 	inputFps: number(),
 	outputFps: number(),
 	avgDecodeTimeMs: number(),
-	droppedFrames: number()
+	droppedFrames: number(),
+	/**
+	* Pull-mode adaptive-fps telemetry (optional — only pull sessions run the
+	* lag-driven controller; push sessions omit these). `lagMs` is the EWMA of
+	* the decoder's real-time drift (rising = falling behind live); `adaptiveFps`
+	* is the current lag-throttled emit rate (≤ `effectiveFps` ceiling).
+	*/
+	lagMs: number().optional(),
+	effectiveFps: number().optional(),
+	adaptiveFps: number().optional()
 });
 var DecoderSessionConfigSchema = object({
 	codec: string(),
@@ -7459,7 +7468,15 @@ var DecoderSessionConfigSchema = object({
 	*   other — `pullFrames` returns nothing for an `'shm'` session and
 	*   `pullHandles` returns nothing for a `'callback'` session.
 	*/
-	frameSink: _enum(["callback", "shm"]).default("callback")
+	frameSink: _enum(["callback", "shm"]).default("callback"),
+	/**
+	* Per-camera decoder DEBUG facility. When `true`, a pull-mode session emits
+	* a throttled (~1Hz) structured `decoder debug` line (effective/adaptive fps,
+	* real-time lag, dropped-frame delta, avg decode time, hwaccel). Mirrors the
+	* stream-broker's `streamingDebug` gate — off by default so production logs
+	* stay quiet and the emit path pays zero per-frame cost when disabled.
+	*/
+	debug: boolean().optional()
 });
 var EncodeProfileSchema = object({
 	video: object({
@@ -10331,6 +10348,75 @@ DeviceType.Cover, method(object({ deviceId: number().int().nonnegative() }), _vo
 	auth: "admin"
 });
 /**
+* Vendor-neutral day/night (IR-cut) control — the per-camera config cap
+* shared by reolink / hikvision / amcrest. Models the common firmware
+* surface: the IR-cut switching MODE plus the two knobs that gate it
+* (photocell `sensitivity` + `switchDelaySec`). Each vendor maps these
+* onto its own ISAPI / Baichuan / Dahua-CGI fields; the cap standardises
+* the shape so ONE derived-form renders every camera.
+*
+* Follows the D14 `deviceConfig` archetype (see `stream-params.cap.ts`):
+* `getOptions` advertises per-camera availability, `getStatus` (auto-
+* injected from `status`) reports the live values, and a single
+* `setSettings` mutation applies a partial change. No hand-written
+* settings-contribution methods — the framework derives the UI + save
+* routing from this surface.
+*/
+/** IR-cut switching mode. `schedule` = time-of-day table configured on the camera. */
+var DayNightModeSchema = _enum([
+	"auto",
+	"day",
+	"night",
+	"schedule"
+]);
+/** Normalized numeric range descriptor — `{ min, max, step }` per the
+*  getOptions availability convention. Normalized values are 0–100. */
+var NormalizedRangeSchema$1 = object({
+	min: number(),
+	max: number(),
+	step: number()
+});
+object({
+	mode: DayNightModeSchema,
+	/** IR-cut trigger sensitivity, NORMALIZED 0–100 (higher = switches to night sooner). */
+	sensitivity: number().optional(),
+	/** Delay before the IR-cut filter flips, in seconds. */
+	switchDelaySec: number().optional(),
+	lastFetchedAt: number()
+});
+/**
+* Per-camera availability descriptor — drives which controls the admin UI
+* renders. Booleans as `supportsX`; numeric ranges as `{ min, max, step }`
+* (normalized 0–100); the mode choice-set as an array. A provider returns
+* honest, camera-probed values — never hardcoded.
+*/
+var DayNightOptionsSchema = object({
+	/** Modes this camera accepts. Empty → the camera has no configurable day/night mode. */
+	modes: array(DayNightModeSchema),
+	supportsSensitivity: boolean(),
+	/** Present when `supportsSensitivity` — the normalized 0–100 range. */
+	sensitivity: NormalizedRangeSchema$1.optional(),
+	supportsSwitchDelay: boolean(),
+	/** Present when `supportsSwitchDelay` — the allowed delay range in seconds. */
+	switchDelaySec: NormalizedRangeSchema$1.optional()
+});
+/**
+* Partial change to the day/night config — every field optional. A
+* provider ignores fields it does not support.
+*/
+var DayNightSettingsPatchSchema = object({
+	mode: DayNightModeSchema.optional(),
+	sensitivity: number().optional(),
+	switchDelaySec: number().optional()
+});
+DeviceType.Camera, method(object({ deviceId: number() }), DayNightOptionsSchema), method(object({
+	deviceId: number(),
+	settings: DayNightSettingsPatchSchema
+}), _void(), {
+	kind: "mutation",
+	auth: "admin"
+});
+/**
 * Identity envelope for a device's upstream-system metadata.
 *
 * Two jobs:
@@ -10686,6 +10772,130 @@ object({
 });
 DeviceType.Image;
 /**
+* Vendor-neutral image / picture-adjustment cap — the per-camera config
+* cap shared by reolink / hikvision / amcrest. Models the common ISP
+* surface: the four picture sliders (brightness / contrast / saturation /
+* sharpness), orientation (mirror / flip / rotate), white-balance,
+* exposure and backlight-compensation modes.
+*
+* NORMALIZATION: every slider is a normalized int 0–100. Vendors expose
+* these natively as 0–100 or 0–255 (or other ranges); each provider maps
+* its native range to/from this normalized 0–100 space so the cap surface
+* (and the derived form) is identical across cameras. `warmth` (manual
+* white-balance) is likewise normalized 0–100.
+*
+* Follows the D14 `deviceConfig` archetype (see `stream-params.cap.ts`):
+* `getOptions` advertises per-camera availability, `getStatus` (auto-
+* injected from `status`) reports the live values, and a single
+* `setSettings` mutation applies a partial change. No hand-written
+* settings-contribution methods — the framework derives the UI + save
+* routing from this surface.
+*/
+/** Sensor/image rotation, degrees clockwise. */
+var ImageRotateSchema = _enum([
+	"0",
+	"90",
+	"180",
+	"270"
+]);
+/** White-balance mode. `manual` unlocks the normalized `warmth` knob. */
+var WhiteBalanceModeSchema = _enum(["auto", "manual"]);
+/** Exposure mode. */
+var ExposureModeSchema = _enum(["auto", "manual"]);
+/**
+* Backlight-compensation mode:
+*   - `off` — disabled
+*   - `blc` — backlight compensation
+*   - `wdr` — wide dynamic range
+*   - `hlc` — highlight compensation
+*/
+var BacklightModeSchema = _enum([
+	"off",
+	"blc",
+	"wdr",
+	"hlc"
+]);
+/** Normalized numeric range descriptor — `{ min, max, step }` per the
+*  getOptions availability convention. Slider values are normalized 0–100. */
+var NormalizedRangeSchema = object({
+	min: number(),
+	max: number(),
+	step: number()
+});
+object({
+	/** Normalized 0–100. */
+	brightness: number().optional(),
+	/** Normalized 0–100. */
+	contrast: number().optional(),
+	/** Normalized 0–100. */
+	saturation: number().optional(),
+	/** Normalized 0–100. */
+	sharpness: number().optional(),
+	mirror: boolean().optional(),
+	flip: boolean().optional(),
+	rotate: ImageRotateSchema.optional(),
+	whiteBalance: WhiteBalanceModeSchema.optional(),
+	/** Manual white-balance warmth, NORMALIZED 0–100. Meaningful only when `whiteBalance === 'manual'`. */
+	warmth: number().optional(),
+	exposureMode: ExposureModeSchema.optional(),
+	backlightMode: BacklightModeSchema.optional(),
+	lastFetchedAt: number()
+});
+/**
+* Per-camera availability descriptor — drives which controls the admin UI
+* renders. Booleans as `supportsX`; numeric ranges as `{ min, max, step }`
+* (the normalized 0–100 range); enums as arrays of supported values (empty
+* array → control hidden). A provider returns honest, camera-probed values
+* — never hardcoded.
+*/
+var ImageSettingsOptionsSchema = object({
+	supportsBrightness: boolean(),
+	brightness: NormalizedRangeSchema.optional(),
+	supportsContrast: boolean(),
+	contrast: NormalizedRangeSchema.optional(),
+	supportsSaturation: boolean(),
+	saturation: NormalizedRangeSchema.optional(),
+	supportsSharpness: boolean(),
+	sharpness: NormalizedRangeSchema.optional(),
+	supportsMirror: boolean(),
+	supportsFlip: boolean(),
+	/** Supported rotation values. Empty → rotation not configurable. */
+	rotateOptions: array(ImageRotateSchema),
+	/** Supported white-balance modes. Empty → white-balance not configurable. */
+	whiteBalanceModes: array(WhiteBalanceModeSchema),
+	supportsWarmth: boolean(),
+	/** Present when `supportsWarmth` — the normalized 0–100 range. */
+	warmth: NormalizedRangeSchema.optional(),
+	/** Supported exposure modes. Empty → exposure not configurable. */
+	exposureModes: array(ExposureModeSchema),
+	/** Supported backlight modes. Empty → backlight-compensation not configurable. */
+	backlightModes: array(BacklightModeSchema)
+});
+/**
+* Partial change to the image config — every field optional. Slider values
+* are normalized 0–100. A provider ignores fields it does not support.
+*/
+var ImageSettingsPatchSchema = object({
+	brightness: number().optional(),
+	contrast: number().optional(),
+	saturation: number().optional(),
+	sharpness: number().optional(),
+	mirror: boolean().optional(),
+	flip: boolean().optional(),
+	rotate: ImageRotateSchema.optional(),
+	whiteBalance: WhiteBalanceModeSchema.optional(),
+	warmth: number().optional(),
+	exposureMode: ExposureModeSchema.optional(),
+	backlightMode: BacklightModeSchema.optional()
+});
+DeviceType.Camera, method(object({ deviceId: number() }), ImageSettingsOptionsSchema), method(object({
+	deviceId: number(),
+	settings: ImageSettingsPatchSchema
+}), _void(), {
+	kind: "mutation",
+	auth: "admin"
+});
+/**
 * Robotic lawn-mower cap. Models HA `lawn_mower.*` entities — anything
 * with a mowing lifecycle plus a dock action.
 *
@@ -11728,6 +11938,16 @@ var RunnerCameraConfigSchema = object({
 	* this gate is bypassed.
 	*/
 	onboardMotionDrivesAnalyzer: boolean().default(true),
+	/**
+	* Master toggle for the occupancy re-check. When `false` (DEFAULT) the runner
+	* never arms the periodic recheck timer, regardless of `occupancyRecheckSec` —
+	* this is off by default because the recheck re-subscribes a detection session
+	* every N seconds while `watching`, a major source of pull-decoder re-dial
+	* churn (each cycle creates+tears a session → RTSP re-dial → latency). The
+	* `occupancyRecheckSec` / `occupancyRecheckFrames` sliders only take effect
+	* (and only render) when this is enabled.
+	*/
+	occupancyRecheckEnabled: boolean().default(false),
 	occupancyRecheckSec: number().min(occupancyRecheckSecField.min).max(occupancyRecheckSecField.max).default(occupancyRecheckSecField.default),
 	occupancyRecheckFrames: number().min(occupancyRecheckFramesField.min).max(occupancyRecheckFramesField.max).default(occupancyRecheckFramesField.default),
 	/**
@@ -13781,79 +14001,42 @@ var SessionInventoryEntrySchema = object({
 	framesIn: number(),
 	framesOut: number()
 });
-/**
-* audio-codec — bidirectional PCM ↔ encoded audio I/O box.
-*
-* Independent per-consumer sessions. The provider runs decode + resample
-* (or resample + encode) inside the session so a 16kHz mono ASA
-* subscriber and a 48kHz stereo WebRTC subscriber on the same source
-* stream don't share resamplers.
-*
-* Singleton on each node. Decoder and encoder live in the same provider
-* because they share the underlying libav contexts (node-av today,
-* pluggable later) — operators always install one or the other together.
-*/
-var audioCodecCapability = {
-	name: "audio-codec",
-	scope: "system",
-	mode: "singleton",
-	preferredProvider: "audio-codec-ffmpeg",
-	methods: {
-		/** Probe the local runtime and return the supported codec matrix. */
-		listSupportedCodecs: method(_void(), array(AudioCodecInfoSchema).readonly()),
-		/** Cheap predicate — does the runtime support `(codec, kind)`? */
-		canHandle: method(object({
-			codec: string(),
-			kind: _enum(["decode", "encode"])
-		}), boolean()),
-		createDecodeSession: method(AudioDecodeSessionConfigSchema, object({
-			sessionId: string(),
-			nodeId: string()
-		}), { kind: "mutation" }),
-		createEncodeSession: method(AudioEncodeSessionConfigSchema, object({
-			sessionId: string(),
-			nodeId: string()
-		}), { kind: "mutation" }),
-		closeSession: method(object({
-			sessionId: string(),
-			nodeId: string().optional()
-		}), _void(), { kind: "mutation" }),
-		/** Push one encoded audio frame into a decode session. */
-		pushEncodedFrame: method(object({
-			sessionId: string(),
-			nodeId: string().optional(),
-			data: _instanceof(Uint8Array),
-			/** Source PTS in milliseconds. Synthesised when omitted. */
-			pts: number().optional()
-		}), _void(), { kind: "mutation" }),
-		/** Pull up to `maxCount` PCM chunks from a decode session. */
-		pullPcm: method(object({
-			sessionId: string(),
-			nodeId: string().optional(),
-			maxCount: number().int().positive().default(8)
-		}), array(AudioPcmChunkSchema)),
-		/** Push one PCM chunk into an encode session. */
-		pushPcm: method(object({
-			sessionId: string(),
-			nodeId: string().optional(),
-			data: _instanceof(Uint8Array),
-			/** Source PTS in milliseconds. */
-			pts: number().optional()
-		}), _void(), { kind: "mutation" }),
-		/** Pull up to `maxCount` encoded chunks from an encode session. */
-		pullEncoded: method(object({
-			sessionId: string(),
-			nodeId: string().optional(),
-			maxCount: number().int().positive().default(8)
-		}), array(AudioEncodedChunkSchema)),
-		/** Flush any pending encoded output (call before close on graceful tear). */
-		flushEncode: method(object({
-			sessionId: string(),
-			nodeId: string().optional()
-		}), array(AudioEncodedChunkSchema), { kind: "mutation" }),
-		listActiveSessions: method(_void(), array(SessionInventoryEntrySchema).readonly())
-	}
-};
+method(_void(), array(AudioCodecInfoSchema).readonly()), method(object({
+	codec: string(),
+	kind: _enum(["decode", "encode"])
+}), boolean()), method(AudioDecodeSessionConfigSchema, object({
+	sessionId: string(),
+	nodeId: string()
+}), { kind: "mutation" }), method(AudioEncodeSessionConfigSchema, object({
+	sessionId: string(),
+	nodeId: string()
+}), { kind: "mutation" }), method(object({
+	sessionId: string(),
+	nodeId: string().optional()
+}), _void(), { kind: "mutation" }), method(object({
+	sessionId: string(),
+	nodeId: string().optional(),
+	data: _instanceof(Uint8Array),
+	/** Source PTS in milliseconds. Synthesised when omitted. */
+	pts: number().optional()
+}), _void(), { kind: "mutation" }), method(object({
+	sessionId: string(),
+	nodeId: string().optional(),
+	maxCount: number().int().positive().default(8)
+}), array(AudioPcmChunkSchema)), method(object({
+	sessionId: string(),
+	nodeId: string().optional(),
+	data: _instanceof(Uint8Array),
+	/** Source PTS in milliseconds. */
+	pts: number().optional()
+}), _void(), { kind: "mutation" }), method(object({
+	sessionId: string(),
+	nodeId: string().optional(),
+	maxCount: number().int().positive().default(8)
+}), array(AudioEncodedChunkSchema)), method(object({
+	sessionId: string(),
+	nodeId: string().optional()
+}), array(AudioEncodedChunkSchema), { kind: "mutation" }), method(_void(), array(SessionInventoryEntrySchema).readonly());
 var AuthResultSchema = object({
 	userId: string(),
 	username: string(),
@@ -20443,6 +20626,18 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"dayNight.getOptions": {
+		capName: "day-night",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
+	"dayNight.setSettings": {
+		capName: "day-night",
+		capScope: "device",
+		addonId: null,
+		access: "create"
+	},
 	"decoder.createSession": {
 		capName: "decoder",
 		capScope: "system",
@@ -21373,6 +21568,18 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"imageSettings.getOptions": {
+		capName: "image-settings",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
+	"imageSettings.setSettings": {
+		capName: "image-settings",
+		capScope: "device",
+		addonId: null,
+		access: "create"
+	},
 	"integrations.create": {
 		capName: "integrations",
 		capScope: "system",
@@ -24241,4 +24448,4 @@ function defaultDeviceFor(id) {
 	return def(id).defaultDevice;
 }
 //#endregion
-export { boolean as $, pipelineRunnerCapability as A, DeviceFeature as B, hfModelUrl as C, motionDetectionCapability as D, migrateConfigToBands as E, supportedRuntimes as F, makeProfileBrokerId as G, EventCategory as H, webrtcSessionCapability as I, parseProfileBrokerId as J, makeSourceBrokerId as K, errMsg as L, runtimeDevices as M, storageEvictableCapability as N, nodePin as O, streamBrokerCapability as P, array as Q, BaseAddon as R, evaluateZoneRules as S, maskUrlCredentials as T, createEvent as U, DeviceType as V, hydrateSchema as W, sleep as X, selectAssignedProfileSlots as Y, _enum as Z, cameraStreamsCapability as _, COCO_TO_MACRO as a, record as at, defineCustomActions as b, EncodeProfileSchema as c, RingBuffer as d, discriminatedUnion as et, YAMNET_TO_MACRO as f, audioCodecCapability as g, audioAnalyzerCapability as h, COCO_80_LABELS as i, object as it, recordingCapability as j, pipelineExecutorCapability as k, HF_BASE_URL as l, audioAnalysisCapability as m, AUDIO_BACKEND_CHOICES as n, literal as nt, DEFAULT_AUDIO_ANALYZER_CONFIG as o, string as ot, addonWidgetsSourceCapability as p, parseJsonUnknown as q, AUDIO_MACRO_LABELS as r, number as rt, EVENT_PAD_MS as s, union as st, APPLE_SA_TO_MACRO as t, lazy as tt, RecordingConfigSchema as u, customAction as v, mapAudioLabelToMacro as w, detectionPipelineCapability as x, defaultDeviceFor as y, CAM_PROFILE_ORDER as z };
+export { discriminatedUnion as $, recordingCapability as A, DeviceType as B, mapAudioLabelToMacro as C, nodePin as D, motionDetectionCapability as E, webrtcSessionCapability as F, makeSourceBrokerId as G, createEvent as H, errMsg as I, selectAssignedProfileSlots as J, parseJsonUnknown as K, BaseAddon as L, storageEvictableCapability as M, streamBrokerCapability as N, pipelineExecutorCapability as O, supportedRuntimes as P, boolean as Q, CAM_PROFILE_ORDER as R, hfModelUrl as S, migrateConfigToBands as T, hydrateSchema as U, EventCategory as V, makeProfileBrokerId as W, _enum as X, sleep as Y, array as Z, customAction as _, COCO_TO_MACRO as a, string as at, detectionPipelineCapability as b, EncodeProfileSchema as c, RingBuffer as d, lazy as et, YAMNET_TO_MACRO as f, cameraStreamsCapability as g, audioAnalyzerCapability as h, COCO_80_LABELS as i, record as it, runtimeDevices as j, pipelineRunnerCapability as k, HF_BASE_URL as l, audioAnalysisCapability as m, AUDIO_BACKEND_CHOICES as n, number as nt, DEFAULT_AUDIO_ANALYZER_CONFIG as o, union as ot, addonWidgetsSourceCapability as p, parseProfileBrokerId as q, AUDIO_MACRO_LABELS as r, object as rt, EVENT_PAD_MS as s, APPLE_SA_TO_MACRO as t, literal as tt, RecordingConfigSchema as u, defaultDeviceFor as v, maskUrlCredentials as w, evaluateZoneRules as x, defineCustomActions as y, DeviceFeature as z };

package/dist/{frame-handle-plane-zfv8z5a5.js → frame-handle-plane-BP8YV4sF.js}

@@ -1,4 +1,4 @@
-const require_dist = require("./dist-CdltGhTt.js");
+const require_dist = require("./dist-BJTPkJFw.js");
 let node_crypto = require("node:crypto");
 //#region src/stream-broker/stream-broker/decoder-session-proxy.ts
 /**
@@ -173,6 +173,27 @@ var DECODE_FPS_WINDOW_MS = 2e3;
 */
 var SESSION_LINGER_MS = 45e3;
 /**
+* Short keep-warm grace for a PURE-OCCUPANCY session (every remaining
+* subscriber is a periodic on-motion occupancy recheck, tag `'occupancy'`).
+*
+* Occupancy rechecks subscribe to decoded frames for ~1s every ~30s. The
+* normal `SESSION_LINGER_MS` (45s) EXCEEDS that ~30s interval, so the linger
+* timer is perpetually cancelled by the next recheck before it can fire — the
+* decoder never tears down and decodes continuously at source-rate to serve a
+* 1s/30s consumer (~30x wasted decode; multiplied across cameras this is the
+* iGPU baseline that saturated the decoder). A pure-occupancy session instead
+* tears down between polls: short enough to fire well before the next ~30s
+* recheck, long enough to absorb the ~1s poll plus minor jitter. Re-dial is
+* cheap on GPU-scale decode and the restream burst re-primes the live edge
+* fast, so on-demand re-arm on the next recheck is fine.
+*/
+var OCCUPANCY_LINGER_MS = 5e3;
+/** Subscription tag emitted by the periodic on-motion occupancy recheck. A
+*  session whose subscribers have only ever carried this tag gets the short
+*  `OCCUPANCY_LINGER_MS` teardown; any other subscriber biases to the long
+*  `SESSION_LINGER_MS` warm linger (interactive viewers, detection, motion). */
+var OCCUPANCY_TAG = "occupancy";
+/**
 * Default retry cooldown after a decoder session lands on a NON-LOCAL node
 * (see `FrameHandlePlaneOptions.sessionRetryCooldownMs`). Long enough to
 * turn a per-packet storm into a slow probe; short enough that the plane
@@ -190,6 +211,7 @@ var FrameHandlePlane = class {
 	localNodeId;
 	sessionRetryCooldownMs;
 	getSeedPackets;
+	isDebugEnabled;
 	subscriptions = /* @__PURE__ */ new Map();
 	sessions = /* @__PURE__ */ new Map();
 	/** Per-format retry gate set when a session lands on a non-local node:
@@ -219,6 +241,7 @@ var FrameHandlePlane = class {
 		this.localNodeId = options.localNodeId;
 		this.sessionRetryCooldownMs = options.sessionRetryCooldownMs ?? SESSION_RETRY_COOLDOWN_MS;
 		this.getSeedPackets = options.getSeedPackets;
+		this.isDebugEnabled = options.isDebugEnabled;
 	}
 	/** Number of active handle subscriptions — surfaced for diagnostics. */
 	get subscriberCount() {
@@ -375,15 +398,33 @@ var FrameHandlePlane = class {
 	*/
 	scheduleLinger(session) {
 		this.clearLinger(session);
+		const occupancyOnly = !session.hasNonOccupancySubscriberEver;
+		const lingerMs = occupancyOnly ? OCCUPANCY_LINGER_MS : SESSION_LINGER_MS;
+		this.logger?.debug(occupancyOnly ? "frame-handle plane: short occupancy linger scheduled" : "frame-handle plane: keep-warm linger scheduled", { meta: {
+			format: session.format,
+			lingerMs,
+			occupancyOnly
+		} });
 		const timer = setTimeout(() => {
 			session.lingerTimer = null;
 			if (session.subscriberIds.size > 0) return;
 			this.sessions.delete(session.format);
 			this.destroySession(session).catch(() => {});
-		}, SESSION_LINGER_MS);
+		}, lingerMs);
 		timer.unref?.();
 		session.lingerTimer = timer;
 	}
+	/**
+	* Latch `session.hasNonOccupancySubscriberEver` when the subscription
+	* `subscriptionId` carries any tag other than `OCCUPANCY_TAG`. Called at
+	* every point a subscription is attached to a session so the keep-warm
+	* decision only fast-tears-down sessions that have been PURELY on-demand
+	* occupancy rechecks. Unknown ids (mid-teardown) are ignored.
+	*/
+	noteSessionSubscriberTag(session, subscriptionId) {
+		const subscription = this.subscriptions.get(subscriptionId);
+		if (subscription && subscription.tag !== OCCUPANCY_TAG) session.hasNonOccupancySubscriberEver = true;
+	}
 	/** Cancel a session's pending keep-warm teardown timer, if any. */
 	clearLinger(session) {
 		if (session.lingerTimer) {
@@ -563,12 +604,17 @@ var FrameHandlePlane = class {
 		if (existing) {
 			this.clearLinger(existing);
 			existing.subscriberIds.add(subscriptionId);
+			this.noteSessionSubscriberTag(existing, subscriptionId);
 			return;
 		}
 		const inflight = this.sessionCreating.get(format);
 		if (inflight) {
 			await inflight;
-			this.sessions.get(format)?.subscriberIds.add(subscriptionId);
+			const session = this.sessions.get(format);
+			if (session) {
+				session.subscriberIds.add(subscriptionId);
+				this.noteSessionSubscriberTag(session, subscriptionId);
+			}
 			return;
 		}
 		if (Date.now() < (this.sessionRetryCooldownUntil.get(format) ?? 0)) return;
@@ -583,8 +629,10 @@ var FrameHandlePlane = class {
 				bootstrapped: false,
 				pullMode: false,
 				targetFps: this.computeFormatFps(format),
-				lingerTimer: null
+				lingerTimer: null,
+				hasNonOccupancySubscriberEver: false
 			};
+			for (const id of subscriberIds) this.noteSessionSubscriberTag(session, id);
 			let started = false;
 			try {
 				started = await this.startSessionDecoder(session);
@@ -631,7 +679,8 @@ var FrameHandlePlane = class {
 			scale: 1,
 			frameSink: "shm",
 			...info.numericDeviceId !== void 0 ? { deviceId: info.numericDeviceId } : {},
-			tag: `${info.tag}:shm:${format}`
+			tag: `${info.tag}:shm:${format}`,
+			...this.isDebugEnabled?.() ? { debug: true } : {}
 		});
 		if (!isDecoderNodeColocated(this.localNodeId, nodeId)) {
 			this.sessionRetryCooldownUntil.set(format, Date.now() + this.sessionRetryCooldownMs);

package/dist/{frame-handle-plane-C0Rzay-b.mjs → frame-handle-plane-DKAXTtfn.mjs}

@@ -1,4 +1,4 @@
-import { L as errMsg, d as RingBuffer } from "./dist-DdZEBePv.mjs";
+import { I as errMsg, d as RingBuffer } from "./dist-v6cKLmU3.mjs";
 import { randomUUID } from "node:crypto";
 //#region src/stream-broker/stream-broker/decoder-session-proxy.ts
 /**
@@ -173,6 +173,27 @@ var DECODE_FPS_WINDOW_MS = 2e3;
 */
 var SESSION_LINGER_MS = 45e3;
 /**
+* Short keep-warm grace for a PURE-OCCUPANCY session (every remaining
+* subscriber is a periodic on-motion occupancy recheck, tag `'occupancy'`).
+*
+* Occupancy rechecks subscribe to decoded frames for ~1s every ~30s. The
+* normal `SESSION_LINGER_MS` (45s) EXCEEDS that ~30s interval, so the linger
+* timer is perpetually cancelled by the next recheck before it can fire — the
+* decoder never tears down and decodes continuously at source-rate to serve a
+* 1s/30s consumer (~30x wasted decode; multiplied across cameras this is the
+* iGPU baseline that saturated the decoder). A pure-occupancy session instead
+* tears down between polls: short enough to fire well before the next ~30s
+* recheck, long enough to absorb the ~1s poll plus minor jitter. Re-dial is
+* cheap on GPU-scale decode and the restream burst re-primes the live edge
+* fast, so on-demand re-arm on the next recheck is fine.
+*/
+var OCCUPANCY_LINGER_MS = 5e3;
+/** Subscription tag emitted by the periodic on-motion occupancy recheck. A
+*  session whose subscribers have only ever carried this tag gets the short
+*  `OCCUPANCY_LINGER_MS` teardown; any other subscriber biases to the long
+*  `SESSION_LINGER_MS` warm linger (interactive viewers, detection, motion). */
+var OCCUPANCY_TAG = "occupancy";
+/**
 * Default retry cooldown after a decoder session lands on a NON-LOCAL node
 * (see `FrameHandlePlaneOptions.sessionRetryCooldownMs`). Long enough to
 * turn a per-packet storm into a slow probe; short enough that the plane
@@ -190,6 +211,7 @@ var FrameHandlePlane = class {
 	localNodeId;
 	sessionRetryCooldownMs;
 	getSeedPackets;
+	isDebugEnabled;
 	subscriptions = /* @__PURE__ */ new Map();
 	sessions = /* @__PURE__ */ new Map();
 	/** Per-format retry gate set when a session lands on a non-local node:
@@ -219,6 +241,7 @@ var FrameHandlePlane = class {
 		this.localNodeId = options.localNodeId;
 		this.sessionRetryCooldownMs = options.sessionRetryCooldownMs ?? SESSION_RETRY_COOLDOWN_MS;
 		this.getSeedPackets = options.getSeedPackets;
+		this.isDebugEnabled = options.isDebugEnabled;
 	}
 	/** Number of active handle subscriptions — surfaced for diagnostics. */
 	get subscriberCount() {
@@ -375,15 +398,33 @@ var FrameHandlePlane = class {
 	*/
 	scheduleLinger(session) {
 		this.clearLinger(session);
+		const occupancyOnly = !session.hasNonOccupancySubscriberEver;
+		const lingerMs = occupancyOnly ? OCCUPANCY_LINGER_MS : SESSION_LINGER_MS;
+		this.logger?.debug(occupancyOnly ? "frame-handle plane: short occupancy linger scheduled" : "frame-handle plane: keep-warm linger scheduled", { meta: {
+			format: session.format,
+			lingerMs,
+			occupancyOnly
+		} });
 		const timer = setTimeout(() => {
 			session.lingerTimer = null;
 			if (session.subscriberIds.size > 0) return;
 			this.sessions.delete(session.format);
 			this.destroySession(session).catch(() => {});
-		}, SESSION_LINGER_MS);
+		}, lingerMs);
 		timer.unref?.();
 		session.lingerTimer = timer;
 	}
+	/**
+	* Latch `session.hasNonOccupancySubscriberEver` when the subscription
+	* `subscriptionId` carries any tag other than `OCCUPANCY_TAG`. Called at
+	* every point a subscription is attached to a session so the keep-warm
+	* decision only fast-tears-down sessions that have been PURELY on-demand
+	* occupancy rechecks. Unknown ids (mid-teardown) are ignored.
+	*/
+	noteSessionSubscriberTag(session, subscriptionId) {
+		const subscription = this.subscriptions.get(subscriptionId);
+		if (subscription && subscription.tag !== OCCUPANCY_TAG) session.hasNonOccupancySubscriberEver = true;
+	}
 	/** Cancel a session's pending keep-warm teardown timer, if any. */
 	clearLinger(session) {
 		if (session.lingerTimer) {
@@ -563,12 +604,17 @@ var FrameHandlePlane = class {
 		if (existing) {
 			this.clearLinger(existing);
 			existing.subscriberIds.add(subscriptionId);
+			this.noteSessionSubscriberTag(existing, subscriptionId);
 			return;
 		}
 		const inflight = this.sessionCreating.get(format);
 		if (inflight) {
 			await inflight;
-			this.sessions.get(format)?.subscriberIds.add(subscriptionId);
+			const session = this.sessions.get(format);
+			if (session) {
+				session.subscriberIds.add(subscriptionId);
+				this.noteSessionSubscriberTag(session, subscriptionId);
+			}
 			return;
 		}
 		if (Date.now() < (this.sessionRetryCooldownUntil.get(format) ?? 0)) return;
@@ -583,8 +629,10 @@ var FrameHandlePlane = class {
 				bootstrapped: false,
 				pullMode: false,
 				targetFps: this.computeFormatFps(format),
-				lingerTimer: null
+				lingerTimer: null,
+				hasNonOccupancySubscriberEver: false
 			};
+			for (const id of subscriberIds) this.noteSessionSubscriberTag(session, id);
 			let started = false;
 			try {
 				started = await this.startSessionDecoder(session);
@@ -631,7 +679,8 @@ var FrameHandlePlane = class {
 			scale: 1,
 			frameSink: "shm",
 			...info.numericDeviceId !== void 0 ? { deviceId: info.numericDeviceId } : {},
-			tag: `${info.tag}:shm:${format}`
+			tag: `${info.tag}:shm:${format}`,
+			...this.isDebugEnabled?.() ? { debug: true } : {}
 		});
 		if (!isDecoderNodeColocated(this.localNodeId, nodeId)) {
 			this.sessionRetryCooldownUntil.set(format, Date.now() + this.sessionRetryCooldownMs);