@camstack/addon-pipeline 1.2.79 → 1.2.81

package/dist/{dist-BfTf6doa.mjs → dist-DGp0dRiq.mjs}

@@ -13704,6 +13704,18 @@ var LlmGenerateBaseInputSchema = object({
 * Resource ceiling = llama-server flags + idleStopMinutes ONLY (no RSS
 * watchdog — operator decision #3).
 */
+/**
+* A companion artifact that MUST land beside the main GGUF: the `mmproj`
+* projector of a vision model, or shards 2..N of a split GGUF. Carried on the
+* REF rather than looked up at install time, so what the operator approved in
+* the preview is exactly what the node downloads.
+*/
+var ManagedModelExtraFileSchema = object({
+	url: string(),
+	filename: string(),
+	sizeBytes: number(),
+	sha256: string().optional()
+});
 var ManagedModelRefSchema = discriminatedUnion("kind", [
 	object({
 		kind: literal("catalog"),
@@ -13712,7 +13724,11 @@ var ManagedModelRefSchema = discriminatedUnion("kind", [
 	object({
 		kind: literal("url"),
 		url: string(),
-		sha256: string().optional()
+		sha256: string().optional(),
+		/** Picker/status label; the file basename when absent. */
+		label: string().optional(),
+		sizeBytes: number().optional(),
+		extraFiles: array(ManagedModelExtraFileSchema).optional()
 	}),
 	object({
 		kind: literal("path"),
@@ -13773,11 +13789,39 @@ var ManagedRuntimeConfigSchema = object({
 		"q4_1",
 		"q4_0"
 	]).optional(),
+	/**
+	* Escape hatch for llama-server flags this schema does NOT model — `--jinja`
+	* (which most vision chat templates need and some language-only models
+	* dislike), `--cont-batching`, `--rope-scaling`, …
+	*
+	* It is NOT a second place to set the flags above. A token that collides
+	* with a typed field is REJECTED at start, naming the field that owns it
+	* (`assertNoOwnedFlags`), because two knobs writing the same argv is exactly
+	* the "two switches that disagree" failure this repo has already shipped
+	* twice (D62).
+	*/
+	extraArgs: array(string()).default([]),
 	/** Else lazy: first generate boots it. */
 	autoStart: boolean().default(false),
 	/** 0 = never; frees RAM after quiet periods. */
 	idleStopMinutes: number().int().default(30)
 });
+/**
+* Where a multi-GB install currently is. A single 0..1 fraction cannot answer
+* "is it stuck?" for an install that is three files (shards + mmproj) followed
+* by a sha256 pass over 22 GB — during which the fraction sat at 1.0 and the
+* node looked hung. Phase + file + bytes is the smallest shape that does.
+*/
+var LlmDownloadProgressSchema = object({
+	phase: _enum(["downloading", "verifying"]),
+	/** The artifact currently moving, e.g. `mmproj-F16.gguf`. */
+	file: string(),
+	fileIndex: number().int(),
+	fileCount: number().int(),
+	/** Across the WHOLE install, not the current file. */
+	downloadedBytes: number(),
+	totalBytes: number().optional()
+});
 var LlmRuntimeStatusSchema = object({
 	/** Status is ALWAYS node-qualified. */
 	nodeId: string(),
@@ -13794,6 +13838,8 @@ var LlmRuntimeStatusSchema = object({
 	modelPath: string().optional(),
 	modelId: string().optional(),
 	downloadProgress: number().min(0).max(1).optional(),
+	/** Detail behind `downloadProgress`; present for the same lifetime. */
+	download: LlmDownloadProgressSchema.optional(),
 	lastError: string().optional(),
 	crashesInWindow: number(),
 	/** Child RSS (sampled best-effort). */
@@ -13804,7 +13850,14 @@ var LlmNodeModelSchema = object({
 	file: string(),
 	sizeBytes: number(),
 	catalogId: string().optional(),
-	installedAt: number().optional()
+	installedAt: number().optional(),
+	/**
+	* Absolute path on the node. Present so a file that is on disk but matches
+	* no catalog entry — a custom Hugging Face install, or a GGUF the operator
+	* copied in by hand — is still SELECTABLE, as a `{kind:'path'}` ref. Without
+	* it the picker could list such a file and do nothing with it.
+	*/
+	path: string().optional()
 });
 var LlmRuntimeDiskUsageSchema = object({
 	nodeId: string(),
@@ -13950,6 +14003,36 @@ var ManagedModelCatalogEntrySchema = object({
 	/** Vision models: companion projector file. */
 	mmprojUrl: string().optional()
 });
+/**
+* The outcome of turning one operator-typed Hugging Face reference into a
+* download plan. A RESULT, never a throw: "this repo has 24 quantizations and
+* I will not pick for you" is a normal answer the UI has to render, not an
+* exception.
+*
+* `candidates` is the whole reason the refusal is usable — every string in it
+* is a tag that resolves when pasted back as `<org>/<repo>:<TAG>`.
+*/
+var HfModelResolutionSchema = discriminatedUnion("ok", [object({
+	ok: literal(true),
+	/** Ready to hand to `installModel` unchanged. */
+	model: ManagedModelRefSchema,
+	label: string(),
+	repo: string(),
+	quantization: string(),
+	purpose: _enum(["text", "vision"]),
+	totalBytes: number(),
+	/** mmproj + shards, for the preview: an operator approving 23 GB should
+	*  see that 0.9 GB of it is a projector they did not name. */
+	extraFilenames: array(string())
+}), object({
+	ok: literal(false),
+	code: string(),
+	message: string(),
+	candidates: array(string()).optional(),
+	/** Set when the refusal was only the ceiling: re-calling with
+	*  `maxBytes: requiredBytes` is the operator's explicit override. */
+	requiredBytes: number().optional()
+})]);
 var LlmRuntimeNodeSchema = object({
 	nodeId: string(),
 	reachable: boolean(),
@@ -13986,6 +14069,15 @@ method(LlmGenerateBaseInputSchema, LlmGenerateResultSchema, { kind: "mutation" }
 	consumer: string().optional(),
 	profileId: string().optional()
 }), array(LlmUsageRollupSchema)), method(object({}), array(ManagedModelCatalogEntrySchema)), method(object({}), array(LlmRuntimeNodeSchema)), method(object({ nodeId: string() }), array(LlmNodeModelSchema)), method(object({
+	/** `https://huggingface.co/<org>/<repo>/resolve/main/<f>.gguf`,
+	*  `<org>/<repo>/<f>.gguf`, `<org>/<repo>` or `<org>/<repo>:<QUANT>`. */
+	ref: string(),
+	/** Explicit ceiling override, in bytes. Absent = the built-in ceiling. */
+	maxBytes: number().positive().optional()
+}), HfModelResolutionSchema, {
+	kind: "mutation",
+	auth: "admin"
+}), method(object({
 	nodeId: string(),
 	model: ManagedModelRefSchema
 }), _void(), {
@@ -19613,6 +19705,17 @@ var maxSessionHoldMsField = {
 	default: 12e4,
 	step: 5e3
 };
+/**
+* Quiet period that closes an `audioMode: 'on-motion'` audio window. Floor of
+* 5s so a rearm can never degenerate into per-event stream churn; default 90s
+* comfortably outlives the gap between two PIR wakes on a battery camera.
+*/
+var audioMotionWindowMsField = {
+	min: 5e3,
+	max: 6e5,
+	default: 9e4,
+	step: 5e3
+};
 var motionFpsField = {
 	min: 1,
 	max: 30,
@@ -19789,6 +19892,27 @@ var RunnerCameraConfigSchema = object({
 	* resolved `CameraDetectionConfig`.
 	*/
 	maxSessionHoldMs: number().min(maxSessionHoldMsField.min).max(maxSessionHoldMsField.max).optional(),
+	/**
+	* Orchestrator-side quiet period (ms) that closes an `audioMode:
+	* 'on-motion'` audio window, measured from the LAST motion event.
+	*
+	* This exists because the falling edge cannot be relied on. Camera-native
+	* providers emit motion as a RISING EDGE ONLY (Reolink's Baichuan push and
+	* its email-push SMTP path both emit `detected: true` and never the
+	* counterpart); only the frame-diff analyzer emits falls. So on an
+	* onboard-only camera a window that closed only on `detected: false` never
+	* closed at all, and `on-motion` silently behaved as `always-on` — on a
+	* battery camera, the one failure mode the mode exists to prevent.
+	*
+	* Every motion event rearms this timer WITHOUT restarting the stream, so a
+	* burst of re-fires costs nothing. A falling edge, when one does arrive,
+	* still closes earlier via `motionCooldownMs` — whichever comes first wins.
+	*
+	* Not consumed by the runner: carried here so it shares the per-camera
+	* device-settings surface with `motionCooldownMs`, exactly like
+	* `maxSessionHoldMs`.
+	*/
+	audioMotionWindowMs: number().min(audioMotionWindowMsField.min).max(audioMotionWindowMsField.max).optional(),
 	motionFps: number().min(motionFpsField.min).max(motionFpsField.max).default(motionFpsField.default),
 	detectionFps: number().min(detectionFpsField.min).max(detectionFpsField.max).default(detectionFpsField.default),
 	motionStreamId: string(),
@@ -19884,7 +20008,7 @@ var RunnerCameraConfigSchema = object({
 	*/
 	inferenceDevices: array(RunnerInferenceDeviceSchema).readonly().optional()
 });
-motionFpsField.min, motionFpsField.max, motionFpsField.step, motionFpsField.default, detectionFpsField.min, detectionFpsField.max, detectionFpsField.step, detectionFpsField.default, motionCooldownMsField.min, motionCooldownMsField.max, motionCooldownMsField.step, motionCooldownMsField.default, maxSessionHoldMsField.min, maxSessionHoldMsField.max, maxSessionHoldMsField.step, maxSessionHoldMsField.default, occupancyRecheckSecField.min, occupancyRecheckSecField.max, occupancyRecheckSecField.step, occupancyRecheckSecField.default, occupancyRecheckFramesField.min, occupancyRecheckFramesField.max, occupancyRecheckFramesField.step, occupancyRecheckFramesField.default;
+motionFpsField.min, motionFpsField.max, motionFpsField.step, motionFpsField.default, detectionFpsField.min, detectionFpsField.max, detectionFpsField.step, detectionFpsField.default, motionCooldownMsField.min, motionCooldownMsField.max, motionCooldownMsField.step, motionCooldownMsField.default, maxSessionHoldMsField.min, maxSessionHoldMsField.max, maxSessionHoldMsField.step, maxSessionHoldMsField.default, audioMotionWindowMsField.min, audioMotionWindowMsField.max, audioMotionWindowMsField.step, audioMotionWindowMsField.default, occupancyRecheckSecField.min, occupancyRecheckSecField.max, occupancyRecheckSecField.step, occupancyRecheckSecField.default, occupancyRecheckFramesField.min, occupancyRecheckFramesField.max, occupancyRecheckFramesField.step, occupancyRecheckFramesField.default;
 /**
 * Runtime load summary returned by `getLocalLoad`. Used by the orchestrator's
 * load-balancing levels (L2 capacity-based, L3 hardware-aware) to decide
@@ -22659,6 +22783,25 @@ var BatteryStatusSchema = object({
 	/** Ms epoch of the last observation. Lets consumers reason about freshness. */
 	lastUpdated: number(),
 	/**
+	* Ms epoch of the last time the device PROVED it was reachable — a
+	* completed firmware round-trip, an observed wake, or an inbound push
+	* (firmware event, email). `0`/absent = never since this slice was born.
+	*
+	* This is the ONLY input that separates "asleep" from "gone", and it is
+	* fed exclusively by PASSIVE signals: nothing may write it by reaching
+	* for the radio, because a poll that confirms reachability is the same
+	* poll that drains the battery. See {@link deriveBatteryPresence} — the
+	* single derivation every consumer must use; no surface computes its own.
+	*
+	* It is deliberately NOT a clock in the
+	* `scripts/check-runtime-state-durability.ts` sense: it is the
+	* observation itself, and it is the only thing a 30-hour silence is
+	* visible in. Writers quantise it (see `CONTACT_WRITE_QUANTUM_MS` in the
+	* Reolink provider) so a value that means "recently" cannot cost a
+	* SQLite commit per round-trip.
+	*/
+	lastContactAt: number().optional(),
+	/**
 	* True when the source is a BINARY low-battery indicator (HA
 	* `binary_sensor` device_class=battery / `LOW_BAT`) that has no real
 	* charge level — `percentage` is then a coarse stand-in (100 = normal,
@@ -22667,17 +22810,84 @@ var BatteryStatusSchema = object({
 	*/
 	binary: boolean().optional()
 });
-DeviceType.Camera, DeviceType.Sensor, DeviceType.Button, DeviceType.Switch, method(object({
-	deviceId: number(),
-	/** Bound on the wait. Sensible range 3000–10000ms. */
-	timeoutMs: number().int().min(500).max(3e4).default(8e3)
-}), object({
-	awoke: boolean(),
-	durationMs: number()
-}), { kind: "mutation" }), object({
-	deviceId: number(),
-	status: BatteryStatusSchema
-});
+var batteryCapability = {
+	name: "battery",
+	scope: "device",
+	deviceNative: true,
+	mode: "singleton",
+	deviceTypes: [
+		DeviceType.Camera,
+		DeviceType.Sensor,
+		DeviceType.Button,
+		DeviceType.Switch
+	],
+	methods: { 
+	/**
+	* Explicitly wake the camera from low-power sleep ahead of a
+	* streaming session start. Consumers that initiate a stream
+	* against a sleeping battery cam (HomeKit Secure Video, Alexa
+	* RTCSession, snapshot wrappers) call this with a short timeout
+	* before establishing the media pipeline — the broker's own
+	* passive wake-on-dial works but adds 5–7 seconds to first-frame,
+	* during which the consumer renders a black screen. Pre-waking
+	* compresses that gap.
+	*
+	* Returns `awoke: true` when the firmware acknowledged the wake
+	* before `timeoutMs`. Returns `awoke: false` when it timed out OR
+	* the cap surface is unavailable (no Baichuan / firmware
+	* channel); the caller should still attempt the stream — the
+	* passive broker wake remains as fallback.
+	*/
+wakeForStream: method(object({
+		deviceId: number(),
+		/** Bound on the wait. Sensible range 3000–10000ms. */
+		timeoutMs: number().int().min(500).max(3e4).default(8e3)
+	}), object({
+		awoke: boolean(),
+		durationMs: number()
+	}), { kind: "mutation" }) },
+	events: { 
+	/**
+	* Emitted whenever the cached status changes (firmware push OR
+	* poll observes a delta). The DeviceEventPropagator mirrors this
+	* event on the parent chain — subscribing to a camera's source
+	* receives battery events from child accessories automatically.
+	*/
+onStatusChanged: { data: object({
+		deviceId: number(),
+		status: BatteryStatusSchema
+	}) } },
+	status: {
+		schema: BatteryStatusSchema,
+		kind: "push",
+		empty: {
+			percentage: 0,
+			charging: "none",
+			sleeping: false,
+			lastUpdated: 0
+		}
+	},
+	/**
+	* Runtime-state slice — every provider that registers this cap
+	* stores the same shape under `device.runtimeState[battery]`.
+	* Cross-provider uniformity: a Reolink Argus, a Frigate sensor
+	* proxy, an ONVIF battery cam all read/write the same keys.
+	* Consumers (BatteryBadge, snapshot wrapper sleep gate) read once
+	* via `device.runtimeState.getCapState('battery')` regardless of
+	* the underlying driver.
+	*/
+	runtimeState: BatteryStatusSchema,
+	/**
+	* Runtime-state durability: **restored** — a sleeping battery camera may not report for hours; the restored percentage is the only thing the UI and the sleep gate have. Zero churn once `lastUpdated` is excluded — 526 writes, 0 value changes, in 25 minutes.
+	*
+	* See `RuntimeStateDurability`. Enforced by
+	* `scripts/check-runtime-state-durability.ts`.
+	*/
+	durability: "restored",
+	/** Clock fields: written, but excluded from the compare that decides
+	*  whether persisting is worth a SQLite commit. */
+	volatileStateFields: ["lastUpdated"]
+};
 object({
 	on: boolean(),
 	/** Ms epoch of the last transition. 0 if never observed. */
@@ -27088,6 +27298,16 @@ var CamStreamDescriptorSchema = object({
 	/** Transport-specific opaque metadata (e.g. rfc4571 SDP). */
 	metadata: record(string(), unknown()).optional()
 });
+object({
+	/** The descriptors as last built from a real camera response. Never a guess:
+	*  a failed or refused build writes NOTHING, so a restored catalog is always
+	*  one the camera itself once produced. */
+	descriptors: array(CamStreamDescriptorSchema),
+	/** Ms epoch of the build that produced {@link descriptors}. Lets the wake
+	*  path decide whether the camera's own awake window is worth spending on a
+	*  re-read. */
+	lastFetchedAt: number()
+});
 DeviceType.Camera, method(object({ deviceId: number().int().nonnegative() }), array(CamStreamDescriptorSchema).readonly());
 /** One of the camera's stream profiles. */
 var StreamProfileSchema = _enum([
@@ -27972,6 +28192,24 @@ AccessoryKind.Siren, AccessoryKind.Floodlight, AccessoryKind.Spotlight, Accessor
 DeviceType.Cover, DeviceType.Valve, DeviceType.Humidifier, DeviceType.WaterHeater, DeviceType.Camera, DeviceType.Hub, DeviceType.Switch, DeviceType.Siren, DeviceType.Light, DeviceType.Fan, DeviceType.Sensor, DeviceType.Thermostat, DeviceType.Climate, DeviceType.Button, DeviceType.EventEmitter, DeviceType.Update, DeviceType.Generic, DeviceType.Notifier, DeviceType.Script, DeviceType.Automation, DeviceType.Lock, DeviceType.MediaPlayer, DeviceType.AlarmPanel, DeviceType.Control, DeviceType.Presence, DeviceType.Weather, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.Container, DeviceType.Image, DeviceType.PetFeeder;
 new Set(Object.values(DeviceType));
 DeviceFeature.BatteryOperated;
+/**
+* THE derivation. One crop rectangle, one presence verdict — see D52 for why
+* this repo insists a derived value has exactly one implementation.
+*
+* `undefined` status ⇒ `sleeping`. A device with no slice has made no claim,
+* and the caller decides separately whether it is even battery-operated
+* (`DeviceFeature.BatteryOperated`); this function never answers that
+* question, only what a battery device is doing.
+*/
+function deriveBatteryPresence(input) {
+	const status = input.status;
+	if (!status) return "sleeping";
+	if (status.sleeping !== true) return "awake";
+	const lastContactAt = status.lastContactAt;
+	if (typeof lastContactAt !== "number" || lastContactAt <= 0) return "sleeping";
+	const budget = input.unreachableAfterMs ?? 216e5;
+	return input.nowMs - lastContactAt > budget ? "unreachable" : "sleeping";
+}
 Object.freeze({
 	"accessories.setChildHidden": {
 		capName: "accessories",
@@ -30121,6 +30359,12 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"llm.resolveModelRef": {
+		capName: "llm",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"llm.setDefault": {
 		capName: "llm",
 		capScope: "system",
@@ -36277,4 +36521,4 @@ function enumerateInferenceDevices(hw) {
 	return out;
 }
 //#endregion
-export { supportedRuntimes as $, defaultDeviceFor as A, string as At, mapAudioLabelToMacro as B, YAMNET_TO_MACRO as C, boolean as Ct, cameraStreamsCapability as D, number as Dt, audioAnalyzerCapability as E, literal as Et, egressTranscodeSharingKey as F, pipelineExecutorCapability as G, motionDetectionCapability as H, egressTransportFromRequest as I, recordingExportCapability as J, pipelineRunnerCapability as K, enumerateInferenceDevices as L, deriveDetailCropRect as M, EventCategory as Mt, deriveRecordingMode as N, createHwAccelCache as O, object as Ot, detectionPipelineCapability as P, streamBrokerCapability as Q, evaluateZoneRules as R, RingBuffer as S, array as St, audioAnalysisCapability as T, lazy as Tt, pickDetailCropConvention as U, maskUrlCredentials as V, pickNativeLeaseOverride as W, runtimeDevices as X, resolveEgressDecodeHwAccel as Y, storageEvictableCapability as Z, OpsLogEntrySchema as _, parseJsonUnknown as _t, COCO_TO_MACRO as a, invocationFromEncodeProfile as at, RECORDING_EXPORT_MAX_READ_BYTES as b, sleep as bt, DEFAULT_EVENTS_BAND_BUFFER_SEC as c, CAM_PROFILE_ORDER as ct, EVENT_PAD_MS as d, createEvent as dt, webrtcSessionCapability as et, EncodeProfileSchema as f, hydrateSchema as ft, NativeLeaseSettingsSchema as g, nodePin as gt, NativeLeaseAdmissionSchema as h, makeSourceBrokerId as ht, COCO_80_LABELS as i, buildFfmpegArgs as it, defineCustomActions as j, union as jt, customAction as k, record as kt, DEFAULT_NATIVE_LEASE_SETTINGS as l, DeviceFeature as lt, HF_BASE_URL as m, makeProfileBrokerId as mt, AUDIO_BACKEND_CHOICES as n, AUDIO_PRESETS as nt, DEFAULT_AUDIO_ANALYZER_CONFIG as o, isSoftwareDecode as ot, ExportRecordSchema as p, isEvent as pt, recordingCapability as q, AUDIO_MACRO_LABELS as r, Fmp4BoxSplitter as rt, DEFAULT_DETAIL_CROP_CONVENTION as s, BaseAddon as st, APPLE_SA_TO_MACRO as t, errMsg as tt, DEVICE_BACKEND_TO_FORMAT as u, DeviceType as ut, RATE_CONTROL_RELAXED as v, parseProfileBrokerId as vt, addonWidgetsSourceCapability as w, discriminatedUnion as wt, RecordingConfigSchema as x, _enum as xt, RATE_CONTROL_TIGHT as y, selectAssignedProfileSlots as yt, hfModelUrl as z };
+export { runtimeDevices as $, createHwAccelCache as A, number as At, enumerateInferenceDevices as B, RingBuffer as C, sleep as Ct, audioAnalyzerCapability as D, discriminatedUnion as Dt, audioAnalysisCapability as E, boolean as Et, deriveDetailCropRect as F, EventCategory as Ft, motionDetectionCapability as G, hfModelUrl as H, deriveRecordingMode as I, pipelineExecutorCapability as J, pickDetailCropConvention as K, detectionPipelineCapability as L, defaultDeviceFor as M, record as Mt, defineCustomActions as N, string as Nt, batteryCapability as O, lazy as Ot, deriveBatteryPresence as P, union as Pt, resolveEgressDecodeHwAccel as Q, egressTranscodeSharingKey as R, RecordingConfigSchema as S, selectAssignedProfileSlots as St, addonWidgetsSourceCapability as T, array as Tt, mapAudioLabelToMacro as U, evaluateZoneRules as V, maskUrlCredentials as W, recordingCapability as X, pipelineRunnerCapability as Y, recordingExportCapability as Z, NativeLeaseSettingsSchema as _, makeProfileBrokerId as _t, COCO_80_LABELS as a, AUDIO_PRESETS as at, RATE_CONTROL_TIGHT as b, parseJsonUnknown as bt, DEFAULT_DETAIL_CROP_CONVENTION as c, invocationFromEncodeProfile as ct, DEVICE_BACKEND_TO_FORMAT as d, CAM_PROFILE_ORDER as dt, storageEvictableCapability as et, EVENT_PAD_MS as f, DeviceFeature as ft, NativeLeaseAdmissionSchema as g, isEvent as gt, HF_BASE_URL as h, hydrateSchema as ht, BatteryStatusSchema as i, errMsg as it, customAction as j, object as jt, cameraStreamsCapability as k, literal as kt, DEFAULT_EVENTS_BAND_BUFFER_SEC as l, isSoftwareDecode as lt, ExportRecordSchema as m, createEvent as mt, AUDIO_BACKEND_CHOICES as n, supportedRuntimes as nt, COCO_TO_MACRO as o, Fmp4BoxSplitter as ot, EncodeProfileSchema as p, DeviceType as pt, pickNativeLeaseOverride as q, AUDIO_MACRO_LABELS as r, webrtcSessionCapability as rt, DEFAULT_AUDIO_ANALYZER_CONFIG as s, buildFfmpegArgs as st, APPLE_SA_TO_MACRO as t, streamBrokerCapability as tt, DEFAULT_NATIVE_LEASE_SETTINGS as u, BaseAddon as ut, OpsLogEntrySchema as v, makeSourceBrokerId as vt, YAMNET_TO_MACRO as w, _enum as wt, RECORDING_EXPORT_MAX_READ_BYTES as x, parseProfileBrokerId as xt, RATE_CONTROL_RELAXED as y, nodePin as yt, egressTransportFromRequest as z };

package/dist/{event-loop-stall-monitor-CmrHj0i9.mjs → event-loop-stall-monitor-8vYH44kg.mjs}

@@ -1,4 +1,4 @@
-import { a as COCO_TO_MACRO, i as COCO_80_LABELS, r as AUDIO_MACRO_LABELS, z as hfModelUrl } from "./dist-BfTf6doa.mjs";
+import { H as hfModelUrl, a as COCO_80_LABELS, o as COCO_TO_MACRO, r as AUDIO_MACRO_LABELS } from "./dist-DGp0dRiq.mjs";
 import { PerformanceObserver } from "node:perf_hooks";
 //#region src/detection-pipeline/registry/model-catalogs.ts
 var HF_REPO = "camstack/camstack-models";

package/dist/{event-loop-stall-monitor-CGLQP0by.js → event-loop-stall-monitor-DPA6Pu_h.js}

@@ -1,4 +1,4 @@
-const require_dist = require("./dist-BUIpqu3E.js");
+const require_dist = require("./dist-B57MztMq.js");
 let node_perf_hooks = require("node:perf_hooks");
 //#region src/detection-pipeline/registry/model-catalogs.ts
 var HF_REPO = "camstack/camstack-models";

package/dist/{lazy-sharp-BZVhL9Lw.js → lazy-sharp-BMgRSV9x.js}

@@ -1,4 +1,4 @@
-const require_dist = require("./dist-BUIpqu3E.js");
+const require_dist = require("./dist-B57MztMq.js");
 let node_url = require("node:url");
 let node_module = require("node:module");
 let node_path = require("node:path");

package/dist/motion-wasm/index.js

@@ -2,8 +2,8 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_dist = require("../dist-BUIpqu3E.js");
-const require_lazy_sharp = require("../lazy-sharp-BZVhL9Lw.js");
+const require_dist = require("../dist-B57MztMq.js");
+const require_lazy_sharp = require("../lazy-sharp-BMgRSV9x.js");
 let node_path = require("node:path");
 let node_fs = require("node:fs");
 //#region src/motion-wasm/wasm-motion-detector.ts

package/dist/motion-wasm/index.mjs

@@ -1,4 +1,4 @@
-import { H as motionDetectionCapability, R as evaluateZoneRules, ft as hydrateSchema, st as BaseAddon, ut as DeviceType } from "../dist-BfTf6doa.mjs";
+import { G as motionDetectionCapability, V as evaluateZoneRules, ht as hydrateSchema, pt as DeviceType, ut as BaseAddon } from "../dist-DGp0dRiq.mjs";
 import { t as getSharp } from "../lazy-sharp-6oymT_yf.mjs";
 import { join } from "node:path";
 import { readFileSync } from "node:fs";

package/dist/pipeline-runner/index.js

@@ -2,11 +2,11 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_dist = require("../dist-BUIpqu3E.js");
-const require_event_loop_stall_monitor = require("../event-loop-stall-monitor-CGLQP0by.js");
-const require_worker_protocol = require("../worker-protocol-BaLcYcOo.js");
+const require_dist = require("../dist-B57MztMq.js");
+const require_event_loop_stall_monitor = require("../event-loop-stall-monitor-DPA6Pu_h.js");
+const require_worker_protocol = require("../worker-protocol-4L4SbSAo.js");
 const require_hub_hostname = require("../hub-hostname-DAJXlOgV.js");
-const require_lazy_sharp = require("../lazy-sharp-BZVhL9Lw.js");
+const require_lazy_sharp = require("../lazy-sharp-BMgRSV9x.js");
 const require_remote_restream = require("../remote-restream-BYbAsgUf.js");
 let sharp = require("sharp");
 sharp = require_dist.__toESM(sharp);
@@ -4350,6 +4350,12 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends require_dist.BaseAdd
 	nodeId = "unknown";
 	metricsSnapshotTimer = null;
 	unsubMotionEvents = null;
+	/** Devices we have positively observed reporting `battery.sleeping: true`.
+	*  Absent = unknown or awake; both mean "do not gate" (D49). Fed only by
+	*  `BatteryOnStatusChanged`, so consulting it costs nothing and can never
+	*  wake the camera it protects. See `enqueueOccupancyBurst`. */
+	sleepingBatteryDevices = /* @__PURE__ */ new Set();
+	unsubBatteryEvents = null;
 	/** Last analyzer-detected state per device — gates the
 	*  `MotionOnMotionChanged` emit in `runMotionAnalysis` to transitions
 	*  only (otherwise we'd emit on every analyzer frame). */
@@ -4557,6 +4563,13 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends require_dist.BaseAdd
 			if (!attachment.config.motionSources.includes(source)) return;
 			this.runner?.reportMotion(deviceId, data.detected, source, data.regions ? [...data.regions] : void 0);
 		});
+		if (this.ctx.eventBus) this.unsubBatteryEvents = this.ctx.eventBus.subscribe({ category: require_dist.EventCategory.BatteryOnStatusChanged }, (event) => {
+			const data = event.data;
+			const deviceId = data.deviceId;
+			if (typeof deviceId !== "number") return;
+			if (data.status?.sleeping === true) this.sleepingBatteryDevices.add(deviceId);
+			else this.sleepingBatteryDevices.delete(deviceId);
+		});
 		this.metricsSnapshotTimer = setInterval(() => this.emitMetricsSnapshot(), METRICS_SNAPSHOT_INTERVAL_MS);
 		return {
 			providers: [{
@@ -4590,6 +4603,11 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends require_dist.BaseAdd
 			this.unsubMotionEvents();
 			this.unsubMotionEvents = null;
 		}
+		if (this.unsubBatteryEvents) {
+			this.unsubBatteryEvents();
+			this.unsubBatteryEvents = null;
+		}
+		this.sleepingBatteryDevices.clear();
 		this.lastAnalyzerDetected.clear();
 		this.packageGovernor.reset();
 		this.packageGateSkips.clear();
@@ -6660,6 +6678,10 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends require_dist.BaseAdd
 	* parallel decoder dials.
 	*/
 	enqueueOccupancyBurst(deviceId, frames) {
+		if (this.sleepingBatteryDevices.has(deviceId)) {
+			this.ctx.logger.debug("occupancy recheck skipped — battery camera is sleeping", { tags: { deviceId } });
+			return;
+		}
 		this.occupancyFrames.set(deviceId, frames);
 		if (this.occupancyBurstInFlight.has(deviceId) || this.occupancyQueued.has(deviceId)) return;
 		this.occupancyQueued.add(deviceId);

package/dist/pipeline-runner/index.mjs

@@ -1,6 +1,6 @@
-import { At as string, Ct as boolean, Dt as number, Et as literal, K as pipelineRunnerCapability, M as deriveDetailCropRect, Mt as EventCategory, Ot as object, St as array, Tt as lazy, U as pickDetailCropConvention, W as pickNativeLeaseOverride, dt as createEvent, gt as nodePin, j as defineCustomActions, k as customAction, s as DEFAULT_DETAIL_CROP_CONVENTION, st as BaseAddon, tt as errMsg, u as DEVICE_BACKEND_TO_FORMAT, xt as _enum } from "../dist-BfTf6doa.mjs";
-import { c as getStepDefinition, t as attributeStall } from "../event-loop-stall-monitor-CmrHj0i9.mjs";
-import { a as nativeLeaseSettingEnv, t as isWorkerReply } from "../worker-protocol-BdOv9Ujl.mjs";
+import { At as number, Et as boolean, F as deriveDetailCropRect, Ft as EventCategory, K as pickDetailCropConvention, N as defineCustomActions, Nt as string, Ot as lazy, Tt as array, Y as pipelineRunnerCapability, c as DEFAULT_DETAIL_CROP_CONVENTION, d as DEVICE_BACKEND_TO_FORMAT, it as errMsg, j as customAction, jt as object, kt as literal, mt as createEvent, q as pickNativeLeaseOverride, ut as BaseAddon, wt as _enum, yt as nodePin } from "../dist-DGp0dRiq.mjs";
+import { c as getStepDefinition, t as attributeStall } from "../event-loop-stall-monitor-8vYH44kg.mjs";
+import { a as nativeLeaseSettingEnv, t as isWorkerReply } from "../worker-protocol-_e84lGuR.mjs";
 import { t as resolveHubHostname } from "../hub-hostname-cCknRYKj.mjs";
 import { t as getSharp } from "../lazy-sharp-6oymT_yf.mjs";
 import { i as withDetectionIntent, n as profileForStreamId, t as isRemoteRestream } from "../remote-restream-Ci7RXNGb.mjs";
@@ -4343,6 +4343,12 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends BaseAddon {
 	nodeId = "unknown";
 	metricsSnapshotTimer = null;
 	unsubMotionEvents = null;
+	/** Devices we have positively observed reporting `battery.sleeping: true`.
+	*  Absent = unknown or awake; both mean "do not gate" (D49). Fed only by
+	*  `BatteryOnStatusChanged`, so consulting it costs nothing and can never
+	*  wake the camera it protects. See `enqueueOccupancyBurst`. */
+	sleepingBatteryDevices = /* @__PURE__ */ new Set();
+	unsubBatteryEvents = null;
 	/** Last analyzer-detected state per device — gates the
 	*  `MotionOnMotionChanged` emit in `runMotionAnalysis` to transitions
 	*  only (otherwise we'd emit on every analyzer frame). */
@@ -4550,6 +4556,13 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends BaseAddon {
 			if (!attachment.config.motionSources.includes(source)) return;
 			this.runner?.reportMotion(deviceId, data.detected, source, data.regions ? [...data.regions] : void 0);
 		});
+		if (this.ctx.eventBus) this.unsubBatteryEvents = this.ctx.eventBus.subscribe({ category: EventCategory.BatteryOnStatusChanged }, (event) => {
+			const data = event.data;
+			const deviceId = data.deviceId;
+			if (typeof deviceId !== "number") return;
+			if (data.status?.sleeping === true) this.sleepingBatteryDevices.add(deviceId);
+			else this.sleepingBatteryDevices.delete(deviceId);
+		});
 		this.metricsSnapshotTimer = setInterval(() => this.emitMetricsSnapshot(), METRICS_SNAPSHOT_INTERVAL_MS);
 		return {
 			providers: [{
@@ -4583,6 +4596,11 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends BaseAddon {
 			this.unsubMotionEvents();
 			this.unsubMotionEvents = null;
 		}
+		if (this.unsubBatteryEvents) {
+			this.unsubBatteryEvents();
+			this.unsubBatteryEvents = null;
+		}
+		this.sleepingBatteryDevices.clear();
 		this.lastAnalyzerDetected.clear();
 		this.packageGovernor.reset();
 		this.packageGateSkips.clear();
@@ -6653,6 +6671,10 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends BaseAddon {
 	* parallel decoder dials.
 	*/
 	enqueueOccupancyBurst(deviceId, frames) {
+		if (this.sleepingBatteryDevices.has(deviceId)) {
+			this.ctx.logger.debug("occupancy recheck skipped — battery camera is sleeping", { tags: { deviceId } });
+			return;
+		}
 		this.occupancyFrames.set(deviceId, frames);
 		if (this.occupancyBurstInFlight.has(deviceId) || this.occupancyQueued.has(deviceId)) return;
 		this.occupancyQueued.add(deviceId);

package/dist/recorder/index.js

@@ -1,6 +1,6 @@
-const require_dist = require("../dist-BUIpqu3E.js");
+const require_dist = require("../dist-B57MztMq.js");
 const require_hub_hostname = require("../hub-hostname-DAJXlOgV.js");
-const require_addon_utils = require("../addon-utils-BZQxAJ1G.js");
+const require_addon_utils = require("../addon-utils-CQFlZXSn.js");
 let node_crypto = require("node:crypto");
 let node_child_process = require("node:child_process");
 let node_path = require("node:path");
@@ -3764,6 +3764,7 @@ async function buildPlaybackManifest(deps, codecCache, deviceId, fromMs, toMs) {
 	if (base === null) return noPlayback(deviceId);
 	const readPrefix = deps.readFilePrefix ?? readPrefixFromDisk;
 	const playbackDir = playbackDirFor(deps.dataDir, deviceId);
+	if (deps.index.hydrationOf(deviceId, fromMs, toMs) !== "hydrated") await deps.hydrateWindow?.(deviceId, fromMs, toMs);
 	const profiles = [...new Set(deps.index.segments(deviceId).map((s) => s.profile))];
 	const variants = [];
 	for (const profile of profiles) {
@@ -5016,6 +5017,61 @@ async function hydrateDeviceFromStorage(_api, index, deviceId, locations, logger
 }
 /** Entries classified between yields in {@link hydrateDeviceFromStorage}. */
 var HYDRATE_CHUNK = 2e4;
+/**
+* Device walks in flight at once in {@link hydrateDevicesFromStorage}.
+*
+* The walk is `readdir` latency on a network/FUSE share, not CPU: measured on
+* the live hub, 24 cold hour directories cost 31 s one at a time and 16.7 s
+* eight at a time. Four is the conservative point on that curve — enough to
+* hide most of the latency, few enough that the boot walk never becomes the
+* reason a live SegmentWriter waits. libuv's default threadpool is 4, so a
+* higher number here mostly queues.
+*/
+var HYDRATE_DEVICE_CONCURRENCY = 4;
+/**
+* Walk the archive for a whole fleet: bounded-parallel, and each camera becomes
+* authoritative the moment ITS OWN walk lands (D167).
+*
+* Two things this fixes, both measured on the live hub on 2026-08-15:
+*
+* - The caller was `for (const id of ids) await hydrateDeviceFromStorage(...)`,
+*   so seven cameras' 357 s of `readdir` WAS the 362 s wall clock. Nothing in
+*   the walk contends for CPU — it is share latency — so overlapping is free.
+* - `markHydratedAll` ran in a SECOND loop after every device. A camera whose
+*   walk finished at minute 1 still reported `hydrationOf → 'unknown'` until
+*   minute 6, and every read of it in that window paid for an on-demand walk
+*   over rows already in the index, competing with the walk still running for
+*   the others.
+*
+* A device whose walk throws is NOT marked: `unknown` is the honest answer, and
+* it is what keeps the read path walking that window on demand.
+*/
+async function hydrateDevicesFromStorage(api, index, deviceIds, locations, logger, options = {}) {
+	const concurrency = Math.max(1, options.concurrency ?? HYDRATE_DEVICE_CONCURRENCY);
+	const queue = [...deviceIds];
+	const walkOptions = {
+		...options.yieldBetween ? { yieldBetween: options.yieldBetween } : {},
+		...options.chunkSize !== void 0 ? { chunkSize: options.chunkSize } : {}
+	};
+	const lane = async () => {
+		for (;;) {
+			const deviceId = queue.shift();
+			if (deviceId === void 0) return;
+			try {
+				options.onDeviceStarted?.(deviceId);
+				await hydrateDeviceFromStorage(api, index, deviceId, locations, logger, walkOptions);
+				index.markHydratedAll(deviceId);
+				options.onDeviceHydrated?.(deviceId);
+			} catch (err) {
+				logger.warn("recorder: device hydrate failed — window stays unknown, reads will walk it", {
+					tags: { deviceId },
+					meta: { error: require_dist.errMsg(err) }
+				});
+			}
+		}
+	};
+	await Promise.all(Array.from({ length: Math.min(concurrency, queue.length) }, lane));
+}
 var macrotask$1 = () => new Promise((resolve) => {
 	setImmediate(resolve);
 });
@@ -8108,11 +8164,12 @@ var RecorderV2Addon = class extends require_dist.BaseAddon {
 			return;
 		}
 		this.warmToday([...configs.keys()]);
-		for (const deviceId of configs.keys()) await hydrateDeviceFromStorage(this.ctx.api, this.index, deviceId, this.resolvedLocations, this.ctx.logger);
-		for (const deviceId of configs.keys()) this.index.markHydratedAll(deviceId);
+		const hydrateStartedMs = Date.now();
+		await hydrateDevicesFromStorage(this.ctx.api, this.index, [...configs.keys()], this.resolvedLocations, this.ctx.logger);
 		this.ctx.logger.info("recorder: hydrated index from storage", { meta: {
 			deviceCount: configs.size,
-			locationCount: this.resolvedLocations.length
+			locationCount: this.resolvedLocations.length,
+			ms: Date.now() - hydrateStartedMs
 		} });
 		const loggedDomains = /* @__PURE__ */ new Set();
 		for (const loc of this.resolvedLocations) {