camstack 1.2.81 → 1.2.83

package/dist/{chunk-QSGSW74H.js → chunk-U3YITXU5.js}

@@ -26454,7 +26454,20 @@ var RecentTracksQueryInput = external_exports.object({
   projection: TrackProjectionSchema.optional(),
   /** Include stationary-promoted rows (parked objects). Default false: the
   *  feed lists passages; parking records live on the stationary registry. */
-  includeStationary: external_exports.boolean().optional()
+  includeStationary: external_exports.boolean().optional(),
+  /**
+  * Restrict to these track classes. ABSENT or EMPTY means no filter.
+  *
+  * The same filter `listTracks` takes, because the timeline's class chips must
+  * mean the same thing whether the scope is one camera or twelve. Until this
+  * existed the scoped feed downloaded a page and narrowed it on the phone
+  * while the single-camera path narrowed the read — one filter, two costs.
+  *
+  * A SUPERSET prefilter on `classes[]`, like its single-camera twin: rows
+  * whose class list is unreadable are kept, and the client's rule stays the
+  * exact one.
+  */
+  classes: external_exports.array(external_exports.string()).optional()
 });
 var RecentTracksPageSchema = external_exports.object({
   /** Merged page, ordered by (`lastSeen` DESC, `trackId` DESC). */
@@ -26765,7 +26778,21 @@ var pipelineAnalyticsCapability = {
       /** Include stationary-promoted rows (parked objects handed to the
       *  stationary registry). Default false: the timeline lists passages,
       *  not parking records (operator decision, 2026-08-15). */
-      includeStationary: external_exports.boolean().optional()
+      includeStationary: external_exports.boolean().optional(),
+      /**
+      * Restrict to these track classes. ABSENT or EMPTY means no filter.
+      *
+      * Added 2026-09-03: the timeline's class chips filtered in the CLIENT,
+      * on a day of rows already downloaded. The zone filter had been moved
+      * here for exactly that reason — and it is also what lets the rows come
+      * back `slim` — but the class filter was left behind, so a narrow
+      * selection was still a wide read followed by a wide discard.
+      *
+      * Empty is "show all", not "nothing matches": a chip row with nothing
+      * selected is an operator who has not narrowed anything, and an empty
+      * timeline would read as a camera that saw nothing.
+      */
+      classes: external_exports.array(external_exports.string()).optional()
     }), external_exports.array(TrackSchema).readonly()),
     /**
     * Batched cluster-wide track listing — ONE call for the events page /
@@ -31716,8 +31743,22 @@ var automationControlCapability = {
   durability: "session"
 };
 var BatteryStatusSchema = external_exports.object({
-  /** 0..100 inclusive. Firmware-reported. */
-  percentage: external_exports.number().min(0).max(100),
+  /**
+  * 0..100 inclusive, firmware-reported. **`null` means NOT YET KNOWN** — the
+  * provider has registered the capability but no reading has landed.
+  *
+  * It is nullable because it was not, and the only value a provider could
+  * seed with was `0`. A battery camera behind an NVR therefore announced
+  * itself at 0% on every start and corrected itself a moment later, which is
+  * indistinguishable from a real flat battery: it fires the low-battery alert
+  * every time the hub restarts. Unknown is not empty (D315), and on a battery
+  * reading the difference is an alarm.
+  *
+  * `vacuum-control` and `lawn-mower-control` already model it this way.
+  * Consumers must SKIP a null rather than coerce it — `battery-band` already
+  * declines to band a non-finite reading, which is the correct shape.
+  */
+  percentage: external_exports.number().min(0).max(100).nullable(),
   /**
   * Charging source. `'dc'` covers wall/USB adapters; `'solar'` is
   * Reolink-specific for the Solar Panel 2 accessory (will become

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   runDiscover
-} from "./chunk-QSGSW74H.js";
+} from "./chunk-U3YITXU5.js";
 import "./chunk-LMMQX4CK.js";
 
 // src/cli.ts
@@ -38,7 +38,7 @@ async function runServe(args) {
     ...typeof values.data === "string" ? { data: values.data } : {}
   };
   Object.assign(process.env, buildServeEnv(opts));
-  await import("./launcher-RKRQJIVN.js");
+  await import("./launcher-FITGLHP4.js");
 }
 
 // src/commands/agent.ts
@@ -83,7 +83,7 @@ async function runAgent(args) {
     ...typeof values.port === "string" ? { port: values.port } : {}
   };
   Object.assign(process.env, buildAgentEnv(opts));
-  await import("./launcher-RKRQJIVN.js");
+  await import("./launcher-FITGLHP4.js");
 }
 
 // src/commands/setup.ts
@@ -1130,7 +1130,7 @@ function isUnknown(_value) {
   return true;
 }
 async function resolveServerInteractive(presetNamespace) {
-  const { discoverNodes, resolveHubFromDiscovered, filterHubNodes, DEFAULT_HUB_HTTPS_PORT } = await import("./discover-JG76SRMM.js");
+  const { discoverNodes, resolveHubFromDiscovered, filterHubNodes, DEFAULT_HUB_HTTPS_PORT } = await import("./discover-F573GVRC.js");
   if (presetNamespace) {
     const spinner4 = clack.spinner();
     spinner4.start(`Discovering hub on LAN (namespace "${presetNamespace}")`);

package/dist/{discover-JG76SRMM.js → discover-F573GVRC.js}

@@ -5,7 +5,7 @@ import {
   filterHubNodes,
   resolveHubFromDiscovered,
   runDiscover
-} from "./chunk-QSGSW74H.js";
+} from "./chunk-U3YITXU5.js";
 import "./chunk-LMMQX4CK.js";
 export {
   DEFAULT_HUB_HTTPS_PORT,

package/dist/{launcher-RKRQJIVN.js → launcher-FITGLHP4.js}

@@ -23633,9 +23633,9 @@ var require_zod = __commonJS({
   }
 });
 
-// ../system/dist/dist-DkVaJ5vG.js
-var require_dist_DkVaJ5vG = __commonJS({
-  "../system/dist/dist-DkVaJ5vG.js"(exports) {
+// ../system/dist/dist-C7qWwrK1.js
+var require_dist_C7qWwrK1 = __commonJS({
+  "../system/dist/dist-C7qWwrK1.js"(exports) {
     "use strict";
     var zod = require_zod();
     var EventCategory = /* @__PURE__ */ (function(EventCategory2) {
@@ -37159,7 +37159,20 @@ var require_dist_DkVaJ5vG = __commonJS({
       projection: TrackProjectionSchema.optional(),
       /** Include stationary-promoted rows (parked objects). Default false: the
       *  feed lists passages; parking records live on the stationary registry. */
-      includeStationary: zod.z.boolean().optional()
+      includeStationary: zod.z.boolean().optional(),
+      /**
+      * Restrict to these track classes. ABSENT or EMPTY means no filter.
+      *
+      * The same filter `listTracks` takes, because the timeline's class chips must
+      * mean the same thing whether the scope is one camera or twelve. Until this
+      * existed the scoped feed downloaded a page and narrowed it on the phone
+      * while the single-camera path narrowed the read — one filter, two costs.
+      *
+      * A SUPERSET prefilter on `classes[]`, like its single-camera twin: rows
+      * whose class list is unreadable are kept, and the client's rule stays the
+      * exact one.
+      */
+      classes: zod.z.array(zod.z.string()).optional()
     });
     var RecentTracksPageSchema = zod.z.object({
       /** Merged page, ordered by (`lastSeen` DESC, `trackId` DESC). */
@@ -37470,7 +37483,21 @@ var require_dist_DkVaJ5vG = __commonJS({
           /** Include stationary-promoted rows (parked objects handed to the
           *  stationary registry). Default false: the timeline lists passages,
           *  not parking records (operator decision, 2026-08-15). */
-          includeStationary: zod.z.boolean().optional()
+          includeStationary: zod.z.boolean().optional(),
+          /**
+          * Restrict to these track classes. ABSENT or EMPTY means no filter.
+          *
+          * Added 2026-09-03: the timeline's class chips filtered in the CLIENT,
+          * on a day of rows already downloaded. The zone filter had been moved
+          * here for exactly that reason — and it is also what lets the rows come
+          * back `slim` — but the class filter was left behind, so a narrow
+          * selection was still a wide read followed by a wide discard.
+          *
+          * Empty is "show all", not "nothing matches": a chip row with nothing
+          * selected is an operator who has not narrowed anything, and an empty
+          * timeline would read as a camera that saw nothing.
+          */
+          classes: zod.z.array(zod.z.string()).optional()
         }), zod.z.array(TrackSchema).readonly()),
         /**
         * Batched cluster-wide track listing — ONE call for the events page /
@@ -42276,8 +42303,22 @@ var require_dist_DkVaJ5vG = __commonJS({
       durability: "session"
     };
     var BatteryStatusSchema = zod.z.object({
-      /** 0..100 inclusive. Firmware-reported. */
-      percentage: zod.z.number().min(0).max(100),
+      /**
+      * 0..100 inclusive, firmware-reported. **`null` means NOT YET KNOWN** — the
+      * provider has registered the capability but no reading has landed.
+      *
+      * It is nullable because it was not, and the only value a provider could
+      * seed with was `0`. A battery camera behind an NVR therefore announced
+      * itself at 0% on every start and corrected itself a moment later, which is
+      * indistinguishable from a real flat battery: it fires the low-battery alert
+      * every time the hub restarts. Unknown is not empty (D315), and on a battery
+      * reading the difference is an alarm.
+      *
+      * `vacuum-control` and `lawn-mower-control` already model it this way.
+      * Consumers must SKIP a null rather than coerce it — `battery-band` already
+      * declines to band a non-finite reading, which is the correct shape.
+      */
+      percentage: zod.z.number().min(0).max(100).nullable(),
       /**
       * Charging source. `'dc'` covers wall/USB adapters; `'solar'` is
       * Reolink-specific for the Solar Panel 2 accessory (will become
@@ -50040,6 +50081,44 @@ var require_dist_DkVaJ5vG = __commonJS({
       "ffmpeg.threadCount": 0,
       "auth.tokenExpiry": "30d"
     };
+    var CONTAINER_CHILD_PRIORITY = [
+      "media-player",
+      "alarm-panel",
+      "thermostat",
+      "climate",
+      "humidifier",
+      "water-heater",
+      "lock",
+      "cover",
+      "valve",
+      "fan",
+      "vacuum",
+      "lawn-mower",
+      "light",
+      "switch",
+      "siren",
+      "button",
+      "control",
+      "notifier",
+      "script",
+      "automation",
+      "update",
+      "presence",
+      "weather",
+      "image",
+      "sensor"
+    ];
+    function rank(type) {
+      const i = CONTAINER_CHILD_PRIORITY.indexOf(type);
+      return i === -1 ? CONTAINER_CHILD_PRIORITY.length : i;
+    }
+    function resolveContainerPrimaryChild(children, overrideEntityId) {
+      if (overrideEntityId !== void 0 && overrideEntityId !== null) {
+        const picked = children.find((c) => c.stableId === overrideEntityId) ?? children.find((c) => c.entityId !== void 0 && c.entityId === overrideEntityId);
+        if (picked !== void 0) return picked;
+      }
+      return [...children].toSorted((a, b) => rank(a.type) - rank(b.type))[0] ?? null;
+    }
     var AccessoryKind = {
       Siren: DeviceRole.Siren,
       Floodlight: DeviceRole.Floodlight,
@@ -59661,6 +59740,12 @@ var require_dist_DkVaJ5vG = __commonJS({
         return resolveCapMount;
       }
     });
+    Object.defineProperty(exports, "resolveContainerPrimaryChild", {
+      enumerable: true,
+      get: function() {
+        return resolveContainerPrimaryChild;
+      }
+    });
     Object.defineProperty(exports, "resolveMethodAuth", {
       enumerable: true,
       get: function() {
@@ -59769,7 +59854,7 @@ var require_alerts_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DkVaJ5vG();
+    var require_dist10 = require_dist_C7qWwrK1();
     function selectExpired(alerts, cutoffMs) {
       return alerts.filter((a) => a.createdAt < cutoffMs).sort((a, b) => a.createdAt - b.createdAt).map((a) => a.id);
     }
@@ -60588,7 +60673,7 @@ var require_console_logging = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DkVaJ5vG();
+    var require_dist10 = require_dist_C7qWwrK1();
     var require_formatter = require_formatter_DqAKDlvN();
     var LEVEL_RANK = {
       debug: 0,
@@ -60682,7 +60767,7 @@ var require_core_blocks_addon = __commonJS({
     "use strict";
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DkVaJ5vG();
+    var require_dist10 = require_dist_C7qWwrK1();
     var node_crypto = __require("crypto");
     var node_fs_promises = __require("fs/promises");
     node_fs_promises = require_chunk.__toESM(node_fs_promises);
@@ -61579,11 +61664,11 @@ var require_core_blocks = __commonJS({
   }
 });
 
-// ../system/dist/retired-settings-keys-B1ij-xtH.js
-var require_retired_settings_keys_B1ij_xtH = __commonJS({
-  "../system/dist/retired-settings-keys-B1ij-xtH.js"(exports) {
+// ../system/dist/retired-settings-keys-3soU9pfP.js
+var require_retired_settings_keys_3soU9pfP = __commonJS({
+  "../system/dist/retired-settings-keys-3soU9pfP.js"(exports) {
     "use strict";
-    var require_dist10 = require_dist_DkVaJ5vG();
+    var require_dist10 = require_dist_C7qWwrK1();
     function settingsStoreIsAuthoritativeHere(env) {
       const raw = (env["CAMSTACK_ROLE"] ?? "").trim().toLowerCase();
       return raw === "" || raw === "hub";
@@ -63797,8 +63882,8 @@ var require_device_manager_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DkVaJ5vG();
-    var require_retired_settings_keys = require_retired_settings_keys_B1ij_xtH();
+    var require_dist10 = require_dist_C7qWwrK1();
+    var require_retired_settings_keys = require_retired_settings_keys_3soU9pfP();
     var node_crypto = __require("crypto");
     var _camstack_types_node = require_node();
     var JOB_HISTORY = 20;
@@ -65438,8 +65523,12 @@ var require_device_manager_addon = __commonJS({
       }
       const nextVisited = new Set(visited);
       nextVisited.add(id);
-      const children = byParent.get(id) ?? [];
-      for (const child of children) expandContainer(child.id, byId, byParent, nextVisited, out);
+      const primary = require_dist10.resolveContainerPrimaryChild((byParent.get(id) ?? []).map((c) => ({
+        id: c.id,
+        stableId: c.stableId,
+        type: c.type
+      })), byId.get(id)?.primaryChildEntityId);
+      if (primary !== null) expandContainer(primary.id, byId, byParent, nextVisited, out);
     }
     function resolveLinkedDeviceIds(params) {
       const { selfId, selfLocation, config, candidates } = params;
@@ -68834,7 +68923,7 @@ var require_hub_forwarder = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DkVaJ5vG();
+    var require_dist10 = require_dist_C7qWwrK1();
     var require_formatter = require_formatter_DqAKDlvN();
     var DEFAULT_OUTBOUND_BUFFER_SIZE = 500;
     var HubForwarderDestination = class {
@@ -68971,7 +69060,7 @@ var require_liveness_monitor_addon = __commonJS({
     "use strict";
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DkVaJ5vG();
+    var require_dist10 = require_dist_C7qWwrK1();
     var NO_DEVICES = "liveness:no-devices";
     var ALL_OFFLINE = "liveness:all-devices-offline";
     var NO_FOOTAGE_PREFIX = "liveness:no-footage:";
@@ -69161,7 +69250,7 @@ var require_local_auth_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DkVaJ5vG();
+    var require_dist10 = require_dist_C7qWwrK1();
     var node_crypto = __require("crypto");
     node_crypto = require_chunk.__toESM(node_crypto);
     var crypto$1 = __require("crypto");
@@ -76974,7 +77063,7 @@ var require_loki_logging = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DkVaJ5vG();
+    var require_dist10 = require_dist_C7qWwrK1();
     function sanitizeLabelName(raw) {
       const replaced = raw.replaceAll(/[^a-zA-Z0-9_]/g, "_");
       return /^[a-zA-Z_]/.test(replaced) ? replaced : `_${replaced}`;
@@ -77539,7 +77628,7 @@ var require_native_metrics_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DkVaJ5vG();
+    var require_dist10 = require_dist_C7qWwrK1();
     var node_fs_promises = __require("fs/promises");
     var node_child_process = __require("child_process");
     var node_util = __require("util");
@@ -80123,7 +80212,7 @@ var require_filesystem_storage_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DkVaJ5vG();
+    var require_dist10 = require_dist_C7qWwrK1();
     var node_crypto = __require("crypto");
     var node_fs_promises = __require("fs/promises");
     var node_path = __require("path");
@@ -81239,8 +81328,8 @@ var require_sqlite_settings_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DkVaJ5vG();
-    var require_retired_settings_keys = require_retired_settings_keys_B1ij_xtH();
+    var require_dist10 = require_dist_C7qWwrK1();
+    var require_retired_settings_keys = require_retired_settings_keys_3soU9pfP();
     var node_crypto = __require("crypto");
     var node_fs = __require("fs");
     var node_module = __require("module");
@@ -81633,6 +81722,14 @@ var require_sqlite_settings_addon = __commonJS({
         clauses.push(`${expr} IN (${values.map(() => "?").join(", ")})`);
         for (const v of values) params.push(serialize2(v));
       }
+      for (const [field, values] of Object.entries(filter?.whereJsonArrayAny ?? {})) {
+        const expr = resolve(field);
+        if (expr === null) continue;
+        if (values.length === 0) continue;
+        const placeholders = values.map(() => "?").join(", ");
+        clauses.push(`(${expr} IS NULL OR NOT json_valid(${expr}) OR EXISTS (SELECT 1 FROM json_each(${expr}) WHERE value IN (${placeholders})))`);
+        for (const v of values) params.push(serialize2(v));
+      }
       for (const [field, [low, high]] of Object.entries(filter?.whereBetween ?? {})) {
         const expr = resolve(field);
         if (expr === null) continue;
@@ -83722,7 +83819,7 @@ var require_storage_orchestrator_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DkVaJ5vG();
+    var require_dist10 = require_dist_C7qWwrK1();
     var require_hub_cap_forward = require_hub_cap_forward_DmHNjbB0();
     var zod = require_zod();
     var node_crypto = __require("crypto");
@@ -86673,7 +86770,7 @@ var require_system_config_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DkVaJ5vG();
+    var require_dist10 = require_dist_C7qWwrK1();
     var SECTION_TITLES = {
       server: "Server",
       auth: "Authentication"
@@ -104734,7 +104831,7 @@ var require_winston_logging = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DkVaJ5vG();
+    var require_dist10 = require_dist_C7qWwrK1();
     var require_formatter = require_formatter_DqAKDlvN();
     var node_path = __require("path");
     node_path = require_chunk.__toESM(node_path);
@@ -117234,12 +117331,12 @@ var require_dist2 = __commonJS({
   }
 });
 
-// ../system/dist/manifest-system-deps-BbB94ozU.js
-var require_manifest_system_deps_BbB94ozU = __commonJS({
-  "../system/dist/manifest-system-deps-BbB94ozU.js"(exports) {
+// ../system/dist/manifest-system-deps-PAIfmNun.js
+var require_manifest_system_deps_PAIfmNun = __commonJS({
+  "../system/dist/manifest-system-deps-PAIfmNun.js"(exports) {
     "use strict";
     var require_chunk = require_chunk_Cek0wNdY();
-    require_dist_DkVaJ5vG();
+    require_dist_C7qWwrK1();
     require_hub_cap_forward_DmHNjbB0();
     var node_crypto = __require("crypto");
     node_crypto = require_chunk.__toESM(node_crypto);
@@ -129306,7 +129403,7 @@ var require_dist3 = __commonJS({
     "use strict";
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DkVaJ5vG();
+    var require_dist10 = require_dist_C7qWwrK1();
     var require_builtins_alerts_alerts_addon = require_alerts_addon();
     require_alerts();
     var require_formatter = require_formatter_DqAKDlvN();
@@ -129333,7 +129430,7 @@ var require_dist3 = __commonJS({
     var require_builtins_winston_logging_index = require_winston_logging();
     var require_file_data_plane = require_file_data_plane_DO8KbxCe();
     var require_tls$1 = require_tls_BxQlomxd();
-    var require_manifest_system_deps = require_manifest_system_deps_BbB94ozU();
+    var require_manifest_system_deps = require_manifest_system_deps_PAIfmNun();
     var require_resource_monitor = require_resource_monitor_CdnzxBLP();
     var require_custom_action_registry = require_custom_action_registry_jY0NOZK8();
     var zod = require_zod();
@@ -210762,11 +210859,11 @@ var require_dist4 = __commonJS({
         px: streamPixels(s.metadata ?? {})
       })).toSorted((a, b) => b.px - a.px);
       const result = Array.from({ length: streams.length });
-      for (let rank = 0; rank < sorted.length; rank++) {
-        const { s, i } = sorted[rank];
+      for (let rank2 = 0; rank2 < sorted.length; rank2++) {
+        const { s, i } = sorted[rank2];
         let quality;
-        if (rank === 0) quality = "high";
-        else if (rank === sorted.length - 1) quality = "low";
+        if (rank2 === 0) quality = "high";
+        else if (rank2 === sorted.length - 1) quality = "low";
         else quality = "mid";
         result[i] = {
           ...s,
@@ -224195,7 +224292,20 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
       projection: TrackProjectionSchema.optional(),
       /** Include stationary-promoted rows (parked objects). Default false: the
       *  feed lists passages; parking records live on the stationary registry. */
-      includeStationary: zod.z.boolean().optional()
+      includeStationary: zod.z.boolean().optional(),
+      /**
+      * Restrict to these track classes. ABSENT or EMPTY means no filter.
+      *
+      * The same filter `listTracks` takes, because the timeline's class chips must
+      * mean the same thing whether the scope is one camera or twelve. Until this
+      * existed the scoped feed downloaded a page and narrowed it on the phone
+      * while the single-camera path narrowed the read — one filter, two costs.
+      *
+      * A SUPERSET prefilter on `classes[]`, like its single-camera twin: rows
+      * whose class list is unreadable are kept, and the client's rule stays the
+      * exact one.
+      */
+      classes: zod.z.array(zod.z.string()).optional()
     });
     var RecentTracksPageSchema = zod.z.object({
       /** Merged page, ordered by (`lastSeen` DESC, `trackId` DESC). */
@@ -224507,7 +224617,21 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
           /** Include stationary-promoted rows (parked objects handed to the
           *  stationary registry). Default false: the timeline lists passages,
           *  not parking records (operator decision, 2026-08-15). */
-          includeStationary: zod.z.boolean().optional()
+          includeStationary: zod.z.boolean().optional(),
+          /**
+          * Restrict to these track classes. ABSENT or EMPTY means no filter.
+          *
+          * Added 2026-09-03: the timeline's class chips filtered in the CLIENT,
+          * on a day of rows already downloaded. The zone filter had been moved
+          * here for exactly that reason — and it is also what lets the rows come
+          * back `slim` — but the class filter was left behind, so a narrow
+          * selection was still a wide read followed by a wide discard.
+          *
+          * Empty is "show all", not "nothing matches": a chip row with nothing
+          * selected is an operator who has not narrowed anything, and an empty
+          * timeline would read as a camera that saw nothing.
+          */
+          classes: zod.z.array(zod.z.string()).optional()
         }), zod.z.array(TrackSchema).readonly()),
         /**
         * Batched cluster-wide track listing — ONE call for the events page /
@@ -229479,8 +229603,22 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
       durability: "session"
     };
     var BatteryStatusSchema = zod.z.object({
-      /** 0..100 inclusive. Firmware-reported. */
-      percentage: zod.z.number().min(0).max(100),
+      /**
+      * 0..100 inclusive, firmware-reported. **`null` means NOT YET KNOWN** — the
+      * provider has registered the capability but no reading has landed.
+      *
+      * It is nullable because it was not, and the only value a provider could
+      * seed with was `0`. A battery camera behind an NVR therefore announced
+      * itself at 0% on every start and corrected itself a moment later, which is
+      * indistinguishable from a real flat battery: it fires the low-battery alert
+      * every time the hub restarts. Unknown is not empty (D315), and on a battery
+      * reading the difference is an alarm.
+      *
+      * `vacuum-control` and `lawn-mower-control` already model it this way.
+      * Consumers must SKIP a null rather than coerce it — `battery-band` already
+      * declines to band a non-finite reading, which is the correct shape.
+      */
+      percentage: zod.z.number().min(0).max(100).nullable(),
       /**
       * Charging source. `'dc'` covers wall/USB adapters; `'solar'` is
       * Reolink-specific for the Solar Panel 2 accessory (will become
@@ -237339,6 +237477,44 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
       "ffmpeg.threadCount": 0,
       "auth.tokenExpiry": "30d"
     };
+    var CONTAINER_CHILD_PRIORITY = [
+      "media-player",
+      "alarm-panel",
+      "thermostat",
+      "climate",
+      "humidifier",
+      "water-heater",
+      "lock",
+      "cover",
+      "valve",
+      "fan",
+      "vacuum",
+      "lawn-mower",
+      "light",
+      "switch",
+      "siren",
+      "button",
+      "control",
+      "notifier",
+      "script",
+      "automation",
+      "update",
+      "presence",
+      "weather",
+      "image",
+      "sensor"
+    ];
+    function rank(type) {
+      const i = CONTAINER_CHILD_PRIORITY.indexOf(type);
+      return i === -1 ? CONTAINER_CHILD_PRIORITY.length : i;
+    }
+    function resolveContainerPrimaryChild(children, overrideEntityId) {
+      if (overrideEntityId !== void 0 && overrideEntityId !== null) {
+        const picked = children.find((c) => c.stableId === overrideEntityId) ?? children.find((c) => c.entityId !== void 0 && c.entityId === overrideEntityId);
+        if (picked !== void 0) return picked;
+      }
+      return [...children].toSorted((a, b) => rank(a.type) - rank(b.type))[0] ?? null;
+    }
     var AccessoryKind = {
       Siren: require_sleep.DeviceRole.Siren,
       Floodlight: require_sleep.DeviceRole.Floodlight,
@@ -252716,6 +252892,7 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
     exports.COCO_80_LABELS = COCO_80_LABELS;
     exports.COCO_TO_MACRO = COCO_TO_MACRO;
     exports.CONNECTION_TEST_TIMEOUT_MS = CONNECTION_TEST_TIMEOUT_MS;
+    exports.CONTAINER_CHILD_PRIORITY = CONTAINER_CHILD_PRIORITY;
     exports.CORE_BLOCKS_ADDON_ID = CORE_BLOCKS_ADDON_ID;
     exports.CORE_BLOCK_ADDON_PREFIX = CORE_BLOCK_ADDON_PREFIX;
     exports.CamProfileSchema = require_sleep.CamProfileSchema;
@@ -253954,6 +254131,7 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
     exports.resolveBucketMs = resolveBucketMs;
     exports.resolveCapMount = require_sleep.resolveCapMount;
     exports.resolveClusterStepModelId = resolveClusterStepModelId;
+    exports.resolveContainerPrimaryChild = resolveContainerPrimaryChild;
     exports.resolveDetectionRuntime = resolveDetectionRuntime;
     exports.resolveDeviceControlKind = resolveDeviceControlKind;
     exports.resolveDeviceProfile = resolveDeviceProfile;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "camstack",
-  "version": "1.2.81",
+  "version": "1.2.83",
   "description": "CLI tool for managing and running CamStack server",
   "keywords": [
     "camstack",