camstack 1.2.26 → 1.2.28

package/dist/{chunk-LGVHKS3K.js → chunk-2THGXGK3.js}

@@ -14522,7 +14522,7 @@ function date4(params) {
 // ../../node_modules/zod/v4/classic/external.js
 config(en_default());
 
-// ../types/dist/sleep-DlC2kJYf.mjs
+// ../types/dist/sleep-BxO5xNe6.mjs
 var WELL_KNOWN_TABS = [
   {
     id: "overview",
@@ -27729,6 +27729,39 @@ var snapshotCapability = {
       etag: external_exports.string().nullable()
     }))),
     /**
+    * The full decision chain for ONE device, for the viewer's debug readout —
+    * the answer to "why does this tile show what it shows" in a single poll:
+    * the battery slice the state was derived from, the resolved state + its
+    * reason, the cached frame's identity/age, whether a wake window is open,
+    * and whether a fresh capture is in flight. Cache-only and capture-free:
+    * a debug read must never wake a battery camera.
+    */
+    getDebugState: systemMethod(external_exports.object({ deviceId: external_exports.number() }), external_exports.object({
+      /** The battery slice as read, or null when the device has none. */
+      battery: external_exports.object({
+        sleeping: external_exports.boolean(),
+        lastUpdated: external_exports.number(),
+        lastContactAt: external_exports.number().optional()
+      }).nullable(),
+      /** The resolved snapshot state (what the overlay decision used). */
+      state: external_exports.object({
+        isBattery: external_exports.boolean(),
+        reason: external_exports.enum([
+          "disabled",
+          "sleeping",
+          "unreachable",
+          "waking"
+        ]).nullable()
+      }),
+      /** The cached frame behind the next paint. */
+      frame: external_exports.object({
+        capturedAt: external_exports.number().nullable(),
+        ageMs: external_exports.number().nullable()
+      }),
+      /** A wake window is currently open (the Waking overlay's source). */
+      waking: external_exports.boolean()
+    })),
+    /**
     * Signed, expiring links to a CLIENT-SIZED frame — and the demand signal
     * that makes those frames current.
     *
@@ -27811,7 +27844,14 @@ var snapshotCapability = {
         "sleeping",
         "unreachable",
         "waking"
-      ]).nullable()
+      ]).nullable(),
+      /** A battery camera (whatever its current state). An AWAKE battery
+      *  camera is deliberately NOT recaptured on the poll cadence — every
+      *  capture is a camera hit that would keep it out of sleep — so its
+      *  cached frame legitimately ages past the currency ceiling while
+      *  nothing is streaming. A surface must keep painting it (a fresh
+      *  frame is captured at each wake), not blank to "unavailable". */
+      battery: external_exports.boolean()
     })))
   },
   status: {
@@ -40814,6 +40854,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
     addonId: null,
     access: "view"
   },
+  "snapshot.getDebugState": {
+    capName: "snapshot",
+    capScope: "device",
+    addonId: null,
+    access: "view"
+  },
   "snapshot.getSnapshot": {
     capName: "snapshot",
     capScope: "device",
@@ -43411,6 +43457,11 @@ var METHOD_DEVICE_SELECTORS = Object.freeze({
     form: "single",
     optional: false
   }],
+  "snapshot.getDebugState": [{
+    name: "deviceId",
+    form: "single",
+    optional: false
+  }],
   "snapshot.getSnapshot": [{
     name: "deviceId",
     form: "single",

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   runDiscover
-} from "./chunk-LGVHKS3K.js";
+} from "./chunk-2THGXGK3.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-UHXHTYD4.js");
+  await import("./launcher-XHGXNFNV.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-UHXHTYD4.js");
+  await import("./launcher-XHGXNFNV.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-OGDGUAC5.js");
+  const { discoverNodes, resolveHubFromDiscovered, filterHubNodes, DEFAULT_HUB_HTTPS_PORT } = await import("./discover-5Y5DI4XF.js");
   if (presetNamespace) {
     const spinner4 = clack.spinner();
     spinner4.start(`Discovering hub on LAN (namespace "${presetNamespace}")`);

package/dist/{discover-OGDGUAC5.js → discover-5Y5DI4XF.js}

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

package/dist/{launcher-UHXHTYD4.js → launcher-XHGXNFNV.js}

@@ -23631,9 +23631,9 @@ var require_zod = __commonJS({
   }
 });
 
-// ../system/dist/dist-uhKRdmyc.js
-var require_dist_uhKRdmyc = __commonJS({
-  "../system/dist/dist-uhKRdmyc.js"(exports) {
+// ../system/dist/dist-tMrPAfpF.js
+var require_dist_tMrPAfpF = __commonJS({
+  "../system/dist/dist-tMrPAfpF.js"(exports) {
     "use strict";
     var zod = require_zod();
     var EventCategory = /* @__PURE__ */ (function(EventCategory2) {
@@ -38011,6 +38011,39 @@ var require_dist_uhKRdmyc = __commonJS({
           etag: zod.z.string().nullable()
         }))),
         /**
+        * The full decision chain for ONE device, for the viewer's debug readout —
+        * the answer to "why does this tile show what it shows" in a single poll:
+        * the battery slice the state was derived from, the resolved state + its
+        * reason, the cached frame's identity/age, whether a wake window is open,
+        * and whether a fresh capture is in flight. Cache-only and capture-free:
+        * a debug read must never wake a battery camera.
+        */
+        getDebugState: systemMethod(zod.z.object({ deviceId: zod.z.number() }), zod.z.object({
+          /** The battery slice as read, or null when the device has none. */
+          battery: zod.z.object({
+            sleeping: zod.z.boolean(),
+            lastUpdated: zod.z.number(),
+            lastContactAt: zod.z.number().optional()
+          }).nullable(),
+          /** The resolved snapshot state (what the overlay decision used). */
+          state: zod.z.object({
+            isBattery: zod.z.boolean(),
+            reason: zod.z.enum([
+              "disabled",
+              "sleeping",
+              "unreachable",
+              "waking"
+            ]).nullable()
+          }),
+          /** The cached frame behind the next paint. */
+          frame: zod.z.object({
+            capturedAt: zod.z.number().nullable(),
+            ageMs: zod.z.number().nullable()
+          }),
+          /** A wake window is currently open (the Waking overlay's source). */
+          waking: zod.z.boolean()
+        })),
+        /**
         * Signed, expiring links to a CLIENT-SIZED frame — and the demand signal
         * that makes those frames current.
         *
@@ -38093,7 +38126,14 @@ var require_dist_uhKRdmyc = __commonJS({
             "sleeping",
             "unreachable",
             "waking"
-          ]).nullable()
+          ]).nullable(),
+          /** A battery camera (whatever its current state). An AWAKE battery
+          *  camera is deliberately NOT recaptured on the poll cadence — every
+          *  capture is a camera hit that would keep it out of sleep — so its
+          *  cached frame legitimately ages past the currency ceiling while
+          *  nothing is streaming. A surface must keep painting it (a fresh
+          *  frame is captured at each wake), not blank to "unavailable". */
+          battery: zod.z.boolean()
         })))
       },
       status: {
@@ -51787,6 +51827,12 @@ var require_dist_uhKRdmyc = __commonJS({
         addonId: null,
         access: "view"
       },
+      "snapshot.getDebugState": {
+        capName: "snapshot",
+        capScope: "device",
+        addonId: null,
+        access: "view"
+      },
       "snapshot.getSnapshot": {
         capName: "snapshot",
         capScope: "device",
@@ -54384,6 +54430,11 @@ var require_dist_uhKRdmyc = __commonJS({
         form: "single",
         optional: false
       }],
+      "snapshot.getDebugState": [{
+        name: "deviceId",
+        form: "single",
+        optional: false
+      }],
       "snapshot.getSnapshot": [{
         name: "deviceId",
         form: "single",
@@ -55862,7 +55913,7 @@ var require_alerts_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_uhKRdmyc();
+    var require_dist10 = require_dist_tMrPAfpF();
     function selectExpired(alerts, cutoffMs) {
       return alerts.filter((a) => a.createdAt < cutoffMs).sort((a, b) => a.createdAt - b.createdAt).map((a) => a.id);
     }
@@ -56675,7 +56726,7 @@ var require_console_logging = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_uhKRdmyc();
+    var require_dist10 = require_dist_tMrPAfpF();
     var require_formatter = require_formatter_DqAKDlvN();
     var LEVEL_RANK = {
       debug: 0,
@@ -56769,7 +56820,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_uhKRdmyc();
+    var require_dist10 = require_dist_tMrPAfpF();
     var node_crypto = __require("crypto");
     var node_fs_promises = __require("fs/promises");
     node_fs_promises = require_chunk.__toESM(node_fs_promises);
@@ -59489,7 +59540,7 @@ var require_device_manager_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_uhKRdmyc();
+    var require_dist10 = require_dist_tMrPAfpF();
     var node_crypto = __require("crypto");
     var _camstack_types_node = require_node();
     var JOB_HISTORY = 20;
@@ -63477,7 +63528,7 @@ var require_hub_forwarder = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_uhKRdmyc();
+    var require_dist10 = require_dist_tMrPAfpF();
     var require_formatter = require_formatter_DqAKDlvN();
     var DEFAULT_OUTBOUND_BUFFER_SIZE = 500;
     var HubForwarderDestination = class {
@@ -63614,7 +63665,7 @@ var require_liveness_monitor_addon = __commonJS({
     "use strict";
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_uhKRdmyc();
+    var require_dist10 = require_dist_tMrPAfpF();
     var NO_DEVICES = "liveness:no-devices";
     var ALL_OFFLINE = "liveness:all-devices-offline";
     var NO_FOOTAGE_PREFIX = "liveness:no-footage:";
@@ -63804,7 +63855,7 @@ var require_local_auth_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_uhKRdmyc();
+    var require_dist10 = require_dist_tMrPAfpF();
     var node_crypto = __require("crypto");
     node_crypto = require_chunk.__toESM(node_crypto);
     var crypto$1 = __require("crypto");
@@ -71488,7 +71539,7 @@ var require_loki_logging = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_uhKRdmyc();
+    var require_dist10 = require_dist_tMrPAfpF();
     function sanitizeLabelName(raw) {
       const replaced = raw.replaceAll(/[^a-zA-Z0-9_]/g, "_");
       return /^[a-zA-Z_]/.test(replaced) ? replaced : `_${replaced}`;
@@ -72053,7 +72104,7 @@ var require_native_metrics_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_uhKRdmyc();
+    var require_dist10 = require_dist_tMrPAfpF();
     var node_child_process = __require("child_process");
     var node_util = __require("util");
     var node_os = __require("os");
@@ -72995,7 +73046,7 @@ var require_filesystem_storage_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_uhKRdmyc();
+    var require_dist10 = require_dist_tMrPAfpF();
     var node_crypto = __require("crypto");
     var node_fs_promises = __require("fs/promises");
     var node_path = __require("path");
@@ -74111,7 +74162,7 @@ var require_sqlite_settings_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_uhKRdmyc();
+    var require_dist10 = require_dist_tMrPAfpF();
     var node_crypto = __require("crypto");
     var node_fs = __require("fs");
     var node_module = __require("module");
@@ -75679,7 +75730,7 @@ var require_storage_orchestrator_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_uhKRdmyc();
+    var require_dist10 = require_dist_tMrPAfpF();
     var node_crypto = __require("crypto");
     var node_fs_promises = __require("fs/promises");
     node_fs_promises = require_chunk.__toESM(node_fs_promises);
@@ -77558,7 +77609,7 @@ var require_system_config_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_uhKRdmyc();
+    var require_dist10 = require_dist_tMrPAfpF();
     var SECTION_TITLES = {
       server: "Server",
       auth: "Authentication"
@@ -95619,7 +95670,7 @@ var require_winston_logging = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_uhKRdmyc();
+    var require_dist10 = require_dist_tMrPAfpF();
     var require_formatter = require_formatter_DqAKDlvN();
     var node_path = __require("path");
     node_path = require_chunk.__toESM(node_path);
@@ -96772,9 +96823,9 @@ var require_event_category_D3gG7oil = __commonJS({
   }
 });
 
-// ../types/dist/sleep-CoL-9qhR.js
-var require_sleep_CoL_9qhR = __commonJS({
-  "../types/dist/sleep-CoL-9qhR.js"(exports) {
+// ../types/dist/sleep-EYtyUX0L.js
+var require_sleep_EYtyUX0L = __commonJS({
+  "../types/dist/sleep-EYtyUX0L.js"(exports) {
     "use strict";
     var require_event_category = require_event_category_D3gG7oil();
     var zod = require_zod();
@@ -99334,6 +99385,7 @@ var require_sleep_CoL_9qhR = __commonJS({
           getSnapshot: (input) => dispatch("snapshot", "snapshot", "getSnapshot", "query", input),
           invalidateCache: (input) => dispatch("snapshot", "snapshot", "invalidateCache", "mutation", input),
           getSnapshotOverview: (input) => dispatch("snapshot", "snapshot", "getSnapshotOverview", "query", input),
+          getDebugState: (input) => dispatch("snapshot", "snapshot", "getDebugState", "query", input),
           getSnapshotLinks: (input) => dispatch("snapshot", "snapshot", "getSnapshotLinks", "query", input),
           getStatus: (input) => dispatch("snapshot", "snapshot", "getStatus", "query", input),
           getDeviceSettingsContribution: (input) => dispatch("snapshot", "snapshot", "getDeviceSettingsContribution", "query", input),
@@ -100215,7 +100267,7 @@ var require_addon = __commonJS({
     "use strict";
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
     var require_event_category = require_event_category_D3gG7oil();
-    var require_sleep = require_sleep_CoL_9qhR();
+    var require_sleep = require_sleep_EYtyUX0L();
     var require_err_msg = require_err_msg_COpsHMw2();
     var CAP_INPUT_DEFAULTS = Object.freeze({
       "addons": { "getLogs": { "limit": 100 } },
@@ -107089,9 +107141,9 @@ var require_dist2 = __commonJS({
   }
 });
 
-// ../system/dist/manifest-python-deps-BZO_eMn-.js
-var require_manifest_python_deps_BZO_eMn = __commonJS({
-  "../system/dist/manifest-python-deps-BZO_eMn-.js"(exports) {
+// ../system/dist/manifest-python-deps-BtVjvfvj.js
+var require_manifest_python_deps_BtVjvfvj = __commonJS({
+  "../system/dist/manifest-python-deps-BtVjvfvj.js"(exports) {
     "use strict";
     var require_chunk = require_chunk_Cek0wNdY();
     var node_crypto = __require("crypto");
@@ -108223,7 +108275,7 @@ var require_manifest_python_deps_BZO_eMn = __commonJS({
             id,
             stableId,
             addonId,
-            type: _camstack_types_addon.DeviceType.Camera,
+            type: _camstack_types_addon.DeviceType.Generic,
             name: stableId,
             location: null,
             disabled: false,
@@ -117672,7 +117724,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_uhKRdmyc();
+    var require_dist10 = require_dist_tMrPAfpF();
     var require_builtins_alerts_alerts_addon = require_alerts_addon();
     require_alerts();
     var require_formatter = require_formatter_DqAKDlvN();
@@ -117697,7 +117749,7 @@ var require_dist3 = __commonJS({
     require_system_config();
     var require_builtins_winston_logging_index = require_winston_logging();
     var require_file_data_plane = require_file_data_plane_DUHPHa_Y();
-    var require_manifest_python_deps = require_manifest_python_deps_BZO_eMn();
+    var require_manifest_python_deps = require_manifest_python_deps_BtVjvfvj();
     var require_resource_monitor = require_resource_monitor_CdnzxBLP();
     var require_custom_action_registry = require_custom_action_registry_jY0NOZK8();
     var zod = require_zod();
@@ -237004,7 +237056,7 @@ var require_dist9 = __commonJS({
     "use strict";
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
     var require_event_category = require_event_category_D3gG7oil();
-    var require_sleep = require_sleep_CoL_9qhR();
+    var require_sleep = require_sleep_EYtyUX0L();
     var require_canonical_hash = require_canonical_hash_DNV8S5ET();
     var require_enums2 = require_enums();
     var require_err_msg = require_err_msg_COpsHMw2();
@@ -252079,6 +252131,39 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
           etag: zod.z.string().nullable()
         }))),
         /**
+        * The full decision chain for ONE device, for the viewer's debug readout —
+        * the answer to "why does this tile show what it shows" in a single poll:
+        * the battery slice the state was derived from, the resolved state + its
+        * reason, the cached frame's identity/age, whether a wake window is open,
+        * and whether a fresh capture is in flight. Cache-only and capture-free:
+        * a debug read must never wake a battery camera.
+        */
+        getDebugState: require_sleep.systemMethod(zod.z.object({ deviceId: zod.z.number() }), zod.z.object({
+          /** The battery slice as read, or null when the device has none. */
+          battery: zod.z.object({
+            sleeping: zod.z.boolean(),
+            lastUpdated: zod.z.number(),
+            lastContactAt: zod.z.number().optional()
+          }).nullable(),
+          /** The resolved snapshot state (what the overlay decision used). */
+          state: zod.z.object({
+            isBattery: zod.z.boolean(),
+            reason: zod.z.enum([
+              "disabled",
+              "sleeping",
+              "unreachable",
+              "waking"
+            ]).nullable()
+          }),
+          /** The cached frame behind the next paint. */
+          frame: zod.z.object({
+            capturedAt: zod.z.number().nullable(),
+            ageMs: zod.z.number().nullable()
+          }),
+          /** A wake window is currently open (the Waking overlay's source). */
+          waking: zod.z.boolean()
+        })),
+        /**
         * Signed, expiring links to a CLIENT-SIZED frame — and the demand signal
         * that makes those frames current.
         *
@@ -252161,7 +252246,14 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
             "sleeping",
             "unreachable",
             "waking"
-          ]).nullable()
+          ]).nullable(),
+          /** A battery camera (whatever its current state). An AWAKE battery
+          *  camera is deliberately NOT recaptured on the poll cadence — every
+          *  capture is a camera hit that would keep it out of sleep — so its
+          *  cached frame legitimately ages past the currency ceiling while
+          *  nothing is streaming. A surface must keep painting it (a fresh
+          *  frame is captured at each wake), not blank to "unavailable". */
+          battery: zod.z.boolean()
         })))
       },
       status: {
@@ -268771,6 +268863,12 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
         addonId: null,
         access: "view"
       },
+      "snapshot.getDebugState": {
+        capName: "snapshot",
+        capScope: "device",
+        addonId: null,
+        access: "view"
+      },
       "snapshot.getSnapshot": {
         capName: "snapshot",
         capScope: "device",
@@ -271620,6 +271718,11 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
         form: "single",
         optional: false
       }],
+      "snapshot.getDebugState": [{
+        name: "deviceId",
+        form: "single",
+        optional: false
+      }],
       "snapshot.getSnapshot": [{
         name: "deviceId",
         form: "single",

package/package.json

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