@camstack/system 1.2.98 → 1.2.100

package/dist/builtins/addon-pages-aggregator/addon-pages-aggregator.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-uhKRdmyc.js");
+const require_dist = require("../../dist-tMrPAfpF.js");
 const require_settle_sources = require("../../settle-sources-Bhsy57y-.js");
 let node_crypto = require("node:crypto");
 let node_path = require("node:path");

package/dist/builtins/addon-pages-aggregator/addon-pages-aggregator.addon.mjs

@@ -1,4 +1,4 @@
-import { Gt as EventCategory, v as addonPagesCapability, vt as errMsg, yt as BaseAddon } from "../../dist-6JUfbDpM.mjs";
+import { Gt as EventCategory, v as addonPagesCapability, vt as errMsg, yt as BaseAddon } from "../../dist-RbFV8cX7.mjs";
 import { t as settleSourcesWithTimeout } from "../../settle-sources-CDtNC8ub.mjs";
 import { createHash, randomUUID } from "node:crypto";
 import * as path$1 from "node:path";

package/dist/builtins/addon-widgets-aggregator/addon-widgets-aggregator.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-uhKRdmyc.js");
+const require_dist = require("../../dist-tMrPAfpF.js");
 const require_settle_sources = require("../../settle-sources-Bhsy57y-.js");
 let node_crypto = require("node:crypto");
 let node_path = require("node:path");

package/dist/builtins/addon-widgets-aggregator/addon-widgets-aggregator.addon.mjs

@@ -1,4 +1,4 @@
-import { Gt as EventCategory, b as addonWidgetsCapability, vt as errMsg, yt as BaseAddon } from "../../dist-6JUfbDpM.mjs";
+import { Gt as EventCategory, b as addonWidgetsCapability, vt as errMsg, yt as BaseAddon } from "../../dist-RbFV8cX7.mjs";
 import { t as settleSourcesWithTimeout } from "../../settle-sources-CDtNC8ub.mjs";
 import { createHash, randomUUID } from "node:crypto";
 import * as path$1 from "node:path";

package/dist/builtins/alerts/alerts.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-uhKRdmyc.js");
+const require_dist = require("../../dist-tMrPAfpF.js");
 //#region src/builtins/alerts/prune-policy.ts
 /**
 * Ids older than `cutoffMs`, oldest first.

package/dist/builtins/alerts/alerts.addon.mjs

@@ -1,4 +1,4 @@
-import { Gt as EventCategory, Mt as createEvent, n as AlertSchema, vt as errMsg, x as alertsCapability, yt as BaseAddon } from "../../dist-6JUfbDpM.mjs";
+import { Gt as EventCategory, Mt as createEvent, n as AlertSchema, vt as errMsg, x as alertsCapability, yt as BaseAddon } from "../../dist-RbFV8cX7.mjs";
 //#region src/builtins/alerts/prune-policy.ts
 /**
 * Ids older than `cutoffMs`, oldest first.

package/dist/builtins/backup-orchestrator/backup-orchestrator.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-uhKRdmyc.js");
+const require_dist = require("../../dist-tMrPAfpF.js");
 let node_crypto = require("node:crypto");
 let buffer = require("buffer");
 let node_fs_promises = require("node:fs/promises");

package/dist/builtins/backup-orchestrator/backup-orchestrator.addon.mjs

@@ -1,4 +1,4 @@
-import { C as backupCapability, Gt as EventCategory, yt as BaseAddon } from "../../dist-6JUfbDpM.mjs";
+import { C as backupCapability, Gt as EventCategory, yt as BaseAddon } from "../../dist-RbFV8cX7.mjs";
 import { randomBytes, randomUUID } from "node:crypto";
 import { Buffer as Buffer$1 } from "buffer";
 import * as fsp from "node:fs/promises";

package/dist/builtins/console-logging/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-uhKRdmyc.js");
+const require_dist = require("../../dist-tMrPAfpF.js");
 const require_formatter = require("../../formatter-DqAKDlvN.js");
 //#region src/builtins/console-logging/console-destination.ts
 var LEVEL_RANK = {

package/dist/builtins/console-logging/index.mjs

@@ -1,4 +1,4 @@
-import { X as logDestinationCapability, yt as BaseAddon } from "../../dist-6JUfbDpM.mjs";
+import { X as logDestinationCapability, yt as BaseAddon } from "../../dist-RbFV8cX7.mjs";
 import { t as formatLogLine } from "../../formatter-B7qW8bPJ.mjs";
 //#region src/builtins/console-logging/console-destination.ts
 var LEVEL_RANK = {

package/dist/builtins/core-blocks/core-blocks.addon.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-uhKRdmyc.js");
+const require_dist = require("../../dist-tMrPAfpF.js");
 let node_crypto = require("node:crypto");
 let node_fs_promises = require("node:fs/promises");
 node_fs_promises = require_chunk.__toESM(node_fs_promises);

package/dist/builtins/core-blocks/core-blocks.addon.mjs

@@ -1,4 +1,4 @@
-import { D as coreBlockAddonId, O as coreBlockIdFromAddonId, c as CoreBlockSchema, k as coreBlocksCapability, l as DeclaredDevices, o as CORE_BLOCKS_ADDON_ID, s as CORE_BLOCK_ADDON_PREFIX, vt as errMsg, yt as BaseAddon } from "../../dist-6JUfbDpM.mjs";
+import { D as coreBlockAddonId, O as coreBlockIdFromAddonId, c as CoreBlockSchema, k as coreBlocksCapability, l as DeclaredDevices, o as CORE_BLOCKS_ADDON_ID, s as CORE_BLOCK_ADDON_PREFIX, vt as errMsg, yt as BaseAddon } from "../../dist-RbFV8cX7.mjs";
 import { randomUUID } from "node:crypto";
 import * as fs from "node:fs/promises";
 import * as path$1 from "node:path";

package/dist/builtins/device-manager/device-manager.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-uhKRdmyc.js");
+const require_dist = require("../../dist-tMrPAfpF.js");
 let node_crypto = require("node:crypto");
 let _camstack_types_node = require("@camstack/types/node");
 //#region src/builtins/device-manager/adoption-job-engine.ts

package/dist/builtins/device-manager/device-manager.addon.mjs

@@ -1,4 +1,4 @@
-import { Ct as DeviceFeature, E as buildStreamParamsConfigSchema, F as deviceStatusCapability, Gt as EventCategory, Lt as isDeviceConfigCap, N as deviceManagerCapability, Ot as WELL_KNOWN_TAB_MAP, P as deviceStateCapability, R as enumerateItemArrayFields, Tt as DeviceType, Wt as sleep, a as CAP_NAMES_WITH_STATUS, at as runtimeStatePolicyFor, et as normalizeUnit, nt as parseStreamParamsFormPatch, p as STREAM_PROFILE_META, t as ALL_CAPABILITY_DEFINITIONS, u as DeviceStatusSchema, vt as errMsg, wt as DeviceRole, yt as BaseAddon, z as enumerateSchemaFields } from "../../dist-6JUfbDpM.mjs";
+import { Ct as DeviceFeature, E as buildStreamParamsConfigSchema, F as deviceStatusCapability, Gt as EventCategory, Lt as isDeviceConfigCap, N as deviceManagerCapability, Ot as WELL_KNOWN_TAB_MAP, P as deviceStateCapability, R as enumerateItemArrayFields, Tt as DeviceType, Wt as sleep, a as CAP_NAMES_WITH_STATUS, at as runtimeStatePolicyFor, et as normalizeUnit, nt as parseStreamParamsFormPatch, p as STREAM_PROFILE_META, t as ALL_CAPABILITY_DEFINITIONS, u as DeviceStatusSchema, vt as errMsg, wt as DeviceRole, yt as BaseAddon, z as enumerateSchemaFields } from "../../dist-RbFV8cX7.mjs";
 import { randomUUID } from "node:crypto";
 import { canonicalDeviceFingerprint } from "@camstack/types/node";
 //#region src/builtins/device-manager/adoption-job-engine.ts

package/dist/builtins/doorbell/virtual-doorbell.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-uhKRdmyc.js");
+const require_dist = require("../../dist-tMrPAfpF.js");
 //#region src/builtins/doorbell/trigger-engine.ts
 /**
 * Pure trigger logic for the virtual-doorbell builtin — edge detection over

package/dist/builtins/doorbell/virtual-doorbell.addon.mjs

@@ -1,4 +1,4 @@
-import { G as isSameAddonId, Gt as EventCategory, I as doorbellCapability, Mt as createEvent, Tt as DeviceType, vt as errMsg, w as bareAddonId, yt as BaseAddon } from "../../dist-6JUfbDpM.mjs";
+import { G as isSameAddonId, Gt as EventCategory, I as doorbellCapability, Mt as createEvent, Tt as DeviceType, vt as errMsg, w as bareAddonId, yt as BaseAddon } from "../../dist-RbFV8cX7.mjs";
 //#region src/builtins/doorbell/trigger-engine.ts
 /**
 * Pure trigger logic for the virtual-doorbell builtin — edge detection over

package/dist/builtins/hub-forwarder/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-uhKRdmyc.js");
+const require_dist = require("../../dist-tMrPAfpF.js");
 const require_formatter = require("../../formatter-DqAKDlvN.js");
 //#region src/builtins/hub-forwarder/hub-forwarder-destination.ts
 var DEFAULT_OUTBOUND_BUFFER_SIZE = 500;

package/dist/builtins/hub-forwarder/index.mjs

@@ -1,4 +1,4 @@
-import { X as logDestinationCapability, yt as BaseAddon } from "../../dist-6JUfbDpM.mjs";
+import { X as logDestinationCapability, yt as BaseAddon } from "../../dist-RbFV8cX7.mjs";
 import { t as formatLogLine } from "../../formatter-B7qW8bPJ.mjs";
 //#region src/builtins/hub-forwarder/hub-forwarder-destination.ts
 var DEFAULT_OUTBOUND_BUFFER_SIZE = 500;

package/dist/builtins/liveness-monitor/liveness-monitor.addon.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-uhKRdmyc.js");
+const require_dist = require("../../dist-tMrPAfpF.js");
 //#region src/builtins/liveness-monitor/liveness-checks.ts
 var NO_DEVICES = "liveness:no-devices";
 var ALL_OFFLINE = "liveness:all-devices-offline";

package/dist/builtins/liveness-monitor/liveness-monitor.addon.mjs

@@ -1,4 +1,4 @@
-import { Gt as EventCategory, Mt as createEvent, vt as errMsg, yt as BaseAddon } from "../../dist-6JUfbDpM.mjs";
+import { Gt as EventCategory, Mt as createEvent, vt as errMsg, yt as BaseAddon } from "../../dist-RbFV8cX7.mjs";
 //#region src/builtins/liveness-monitor/liveness-checks.ts
 var NO_DEVICES = "liveness:no-devices";
 var ALL_OFFLINE = "liveness:all-devices-offline";

package/dist/builtins/local-auth/local-auth.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-uhKRdmyc.js");
+const require_dist = require("../../dist-tMrPAfpF.js");
 let node_crypto = require("node:crypto");
 node_crypto = require_chunk.__toESM(node_crypto);
 let crypto$1 = require("crypto");

package/dist/builtins/local-auth/local-auth.addon.mjs

@@ -1,5 +1,5 @@
 import { i as __require, o as __toESM, t as __commonJSMin } from "../../chunk-CNf5ZN-e.mjs";
-import { S as authProviderCapability, _ as UserRecordSchema, ht as userManagementCapability, m as ScopedTokenSchema, r as ApiKeyRecordSchema, yt as BaseAddon } from "../../dist-6JUfbDpM.mjs";
+import { S as authProviderCapability, _ as UserRecordSchema, ht as userManagementCapability, m as ScopedTokenSchema, r as ApiKeyRecordSchema, yt as BaseAddon } from "../../dist-RbFV8cX7.mjs";
 import * as crypto$2 from "node:crypto";
 import { createHash, randomUUID, timingSafeEqual } from "node:crypto";
 import nodeCrypto from "crypto";

package/dist/builtins/local-network/local-network.addon.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-uhKRdmyc.js");
+const require_dist = require("../../dist-tMrPAfpF.js");
 let node_os = require("node:os");
 node_os = require_chunk.__toESM(node_os);
 //#region src/builtins/local-network/local-network.addon.ts

package/dist/builtins/local-network/local-network.addon.mjs

@@ -1,4 +1,4 @@
-import { Gt as EventCategory, Y as localNetworkCapability, yt as BaseAddon } from "../../dist-6JUfbDpM.mjs";
+import { Gt as EventCategory, Y as localNetworkCapability, yt as BaseAddon } from "../../dist-RbFV8cX7.mjs";
 import * as os from "node:os";
 //#region src/builtins/local-network/local-network.addon.ts
 /**

package/dist/builtins/loki-logging/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-uhKRdmyc.js");
+const require_dist = require("../../dist-tMrPAfpF.js");
 //#region src/builtins/loki-logging/loki-payload.ts
 /**
 * Loki rejects a label name that is not a valid Prometheus label

package/dist/builtins/loki-logging/index.mjs

@@ -1,4 +1,4 @@
-import { X as logDestinationCapability, yt as BaseAddon } from "../../dist-6JUfbDpM.mjs";
+import { X as logDestinationCapability, yt as BaseAddon } from "../../dist-RbFV8cX7.mjs";
 //#region src/builtins/loki-logging/loki-payload.ts
 /**
 * Loki rejects a label name that is not a valid Prometheus label

package/dist/builtins/native-metrics/native-metrics.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-uhKRdmyc.js");
+const require_dist = require("../../dist-tMrPAfpF.js");
 let node_child_process = require("node:child_process");
 let node_util = require("node:util");
 let node_os = require("node:os");

package/dist/builtins/native-metrics/native-metrics.addon.mjs

@@ -1,4 +1,4 @@
-import { $ as metricsProviderCapability, Gt as EventCategory, Mt as createEvent, yt as BaseAddon } from "../../dist-6JUfbDpM.mjs";
+import { $ as metricsProviderCapability, Gt as EventCategory, Mt as createEvent, yt as BaseAddon } from "../../dist-RbFV8cX7.mjs";
 import { execFile, execFileSync } from "node:child_process";
 import { promisify } from "node:util";
 import * as os from "node:os";

package/dist/builtins/platform-probe/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-uhKRdmyc.js");
+const require_dist = require("../../dist-tMrPAfpF.js");
 let node_child_process = require("node:child_process");
 let node_util = require("node:util");
 let node_os = require("node:os");

package/dist/builtins/platform-probe/index.mjs

@@ -1,5 +1,5 @@
 import { o as __toESM } from "../../chunk-CNf5ZN-e.mjs";
-import { Gt as EventCategory, L as enumerateInferenceDevices, Pt as emitReadiness, ct as scoreRuntimes, rt as platformProbeCapability, vt as errMsg, yt as BaseAddon } from "../../dist-6JUfbDpM.mjs";
+import { Gt as EventCategory, L as enumerateInferenceDevices, Pt as emitReadiness, ct as scoreRuntimes, rt as platformProbeCapability, vt as errMsg, yt as BaseAddon } from "../../dist-RbFV8cX7.mjs";
 import { execFile } from "node:child_process";
 import { promisify } from "node:util";
 import * as os from "node:os";

package/dist/builtins/remote-access-orchestrator/remote-access-orchestrator.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-uhKRdmyc.js");
+const require_dist = require("../../dist-tMrPAfpF.js");
 //#region src/builtins/remote-access-orchestrator/enabled-providers-reconcile.ts
 /**
 * Reconcile the durable `enabledProviders` set against authoritative

package/dist/builtins/remote-access-orchestrator/remote-access-orchestrator.addon.mjs

@@ -1,4 +1,4 @@
-import { Gt as EventCategory, yt as BaseAddon } from "../../dist-6JUfbDpM.mjs";
+import { Gt as EventCategory, yt as BaseAddon } from "../../dist-RbFV8cX7.mjs";
 //#region src/builtins/remote-access-orchestrator/enabled-providers-reconcile.ts
 /**
 * Reconcile the durable `enabledProviders` set against authoritative

package/dist/builtins/snapshot/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-uhKRdmyc.js");
+const require_dist = require("../../dist-tMrPAfpF.js");
 let zod = require("zod");
 let node_crypto = require("node:crypto");
 let _camstack_types_node = require("@camstack/types/node");
@@ -845,6 +845,9 @@ var DEVICE_META_MEMO_MS = 1e4;
 /** Wake-on-play's 8 s firmware wait + 20 s broker settle, with scheduling
 *  slack. A lost completion event must not leave a camera "Waking" forever. */
 var SNAPSHOT_WAKING_TTL_MS = 35e3;
+/** Delay before the single wake-capture retry — covers a camera whose status
+*  flips awake a beat before its snapshot endpoint actually answers. */
+var WAKE_CAPTURE_RETRY_MS = 5e3;
 /** Default cache window for non-battery cams (seconds). Matches the Viewer's
 *  15 s currency contract (`LINK_CURRENT_MAX_AGE_MS`): a frame younger than
 *  that is presented as current, so re-capturing INSIDE the window bought
@@ -901,6 +904,9 @@ var SnapshotAddon = class SnapshotAddon extends require_dist.BaseAddon {
 	stateFrames = /* @__PURE__ */ new Map();
 	/** Devices inside the explicit battery wake-in-progress window. */
 	wakingDevices = /* @__PURE__ */ new Map();
+	/** Last sleeping flag per battery device, for wake-EDGE detection (the map
+	*  starts empty; only an observed true→false transition is a wake). */
+	lastKnownSleeping = /* @__PURE__ */ new Map();
 	/**
 	* Short-TTL memo for `lookupDeviceMeta` (see {@link DEVICE_META_MEMO_MS}).
 	* The PROMISE is stored (not the resolved value), so a burst of concurrent
@@ -975,7 +981,8 @@ var SnapshotAddon = class SnapshotAddon extends require_dist.BaseAddon {
 			applyDeviceSettingsPatch: (input) => this.saveDeviceSettingsPatch(input.deviceId, input.patch),
 			getStatus: async (input) => this.getStatus(input.deviceId),
 			getSnapshotOverview: (input) => this.getSnapshotOverview(input),
-			getSnapshotLinks: (input) => this.getSnapshotLinks(input)
+			getSnapshotLinks: (input) => this.getSnapshotLinks(input),
+			getDebugState: (input) => this.getSnapshotDebugState(input.deviceId)
 		};
 		this.subscribe({ category: require_dist.EventCategory.DeviceUnregistered }, (event) => {
 			const deviceId = event.data.deviceId;
@@ -997,6 +1004,9 @@ var SnapshotAddon = class SnapshotAddon extends require_dist.BaseAddon {
 		});
 		this.subscribe({ category: require_dist.EventCategory.BatteryOnStatusChanged }, (event) => {
 			this.wakingDevices.delete(event.data.deviceId);
+			const prevSleeping = this.lastKnownSleeping.get(event.data.deviceId);
+			this.lastKnownSleeping.set(event.data.deviceId, event.data.status.sleeping);
+			if (prevSleeping === true && !event.data.status.sleeping) this.captureOnWake(event.data.deviceId);
 		});
 		await this.serveMediaDataPlane();
 		await this.ensureLinkDataPlane();
@@ -1202,7 +1212,9 @@ var SnapshotAddon = class SnapshotAddon extends require_dist.BaseAddon {
 		const refreshes = input.targets.map(async (target) => {
 			const state = await this.snapshotStateForLink(target.deviceId);
 			stateByDevice.set(target.deviceId, state);
-			if (state.reason === void 0) await this.awaitFreshEnough(target.deviceId);
+			if (state.reason !== void 0) return;
+			if (state.isBattery && !await this.hasStreamingBrokerForDevice(target.deviceId)) return;
+			await this.awaitFreshEnough(target.deviceId);
 		});
 		await raceForResult(Promise.allSettled(refreshes), LINK_BATCH_WAIT_MS);
 		const rows = input.targets.map((target) => {
@@ -1226,7 +1238,8 @@ var SnapshotAddon = class SnapshotAddon extends require_dist.BaseAddon {
 				width: width ?? null,
 				neverCaptured: capturedAt === null,
 				sleeping: stateByDevice.get(deviceId)?.reason === "sleeping",
-				stateReason: stateByDevice.get(deviceId)?.reason ?? null
+				stateReason: stateByDevice.get(deviceId)?.reason ?? null,
+				battery: stateByDevice.get(deviceId)?.isBattery ?? false
 			};
 		});
 		this.ctx.logger.debug("snapshot: minted links", { meta: {
@@ -1237,6 +1250,36 @@ var SnapshotAddon = class SnapshotAddon extends require_dist.BaseAddon {
 		return rows;
 	}
 	/**
+	* The debug readout's data — the decision chain for one device, cache-only
+	* and capture-free (a debug poll must never wake a battery camera).
+	*/
+	async getSnapshotDebugState(deviceId) {
+		const meta = await this.lookupDeviceMeta(deviceId);
+		const state = await this.resolveSnapshotState(deviceId, meta);
+		const hit = this.cache.latest(deviceId);
+		const batterySlice = await this.ctx.api.deviceState.getCapSlice.query({
+			deviceId,
+			capName: require_dist.batteryCapability.name
+		}).catch(() => null);
+		const parsed = require_dist.BatteryStatusSchema.safeParse(batterySlice);
+		return {
+			battery: parsed.success ? {
+				sleeping: parsed.data.sleeping,
+				lastUpdated: parsed.data.lastUpdated,
+				...parsed.data.lastContactAt !== void 0 ? { lastContactAt: parsed.data.lastContactAt } : {}
+			} : null,
+			state: {
+				isBattery: state.isBattery,
+				reason: state.reason ?? null
+			},
+			frame: {
+				capturedAt: hit?.ts ?? null,
+				ageMs: hit ? Date.now() - hit.ts : null
+			},
+			waking: this.isDeviceWaking(deviceId)
+		};
+	}
+	/**
 	* Join the ordinary capture path for one device and wait, bounded, for it.
 	*
 	* Deliberately `getSnapshot` with `force: false`: the single flight, grab
@@ -1260,6 +1303,42 @@ var SnapshotAddon = class SnapshotAddon extends require_dist.BaseAddon {
 			}
 		});
 	}
+	/**
+	* The one fresh frame an awake battery camera gets outside an active stream:
+	* captured at the WAKE edge, because the link poll deliberately never
+	* recaptures an idle-awake battery camera (every capture is a camera hit
+	* that would keep it out of sleep — the link-mint gate documents the
+	* incident).
+	*
+	* `force: true` is correct here — not a violation of "never wake for a
+	* snapshot": the camera is ALREADY awake (the status edge is what fired),
+	* and the battery 1 h cache default would otherwise answer the wake with
+	* the pre-sleep frame. The single flight coalesces a burst of edges; one
+	* delayed retry covers a camera whose status flipped a beat before its
+	* snapshot endpoint is actually answering (firmware boot lag).
+	*/
+	async captureOnWake(deviceId) {
+		for (let attempt = 0; attempt < 2; attempt += 1) {
+			if (attempt > 0) await new Promise((r) => setTimeout(r, WAKE_CAPTURE_RETRY_MS));
+			try {
+				if (await this.getSnapshot({
+					deviceId,
+					force: true
+				}) !== null) {
+					this.ctx.logger.debug("snapshot: wake capture landed", { tags: { deviceId } });
+					return;
+				}
+			} catch (err) {
+				this.ctx.logger.debug("snapshot: wake capture failed", {
+					tags: { deviceId },
+					meta: {
+						error: require_dist.errMsg(err),
+						attempt
+					}
+				});
+			}
+		}
+	}
 	/** Resolve the state advertised by a minted link before deciding whether a
 	*  background capture is allowed. */
 	async snapshotStateForLink(deviceId) {
@@ -1393,6 +1472,7 @@ var SnapshotAddon = class SnapshotAddon extends require_dist.BaseAddon {
 		this.variants.clear();
 		this.stateFrames.clear();
 		this.wakingDevices.clear();
+		this.lastKnownSleeping.clear();
 		this.deviceMetaMemo.clear();
 		this.captureFlight.clear();
 		this.ownerCache = null;

package/dist/builtins/snapshot/index.mjs

@@ -1,4 +1,4 @@
-import { Ct as DeviceFeature, Gt as EventCategory, M as deriveBatteryPresence, Rt as nodePin, T as batteryCapability, Tt as DeviceType, i as BatteryStatusSchema, mt as streamQualityLabel, ut as snapshotCapability, vt as errMsg, w as bareAddonId, yt as BaseAddon } from "../../dist-6JUfbDpM.mjs";
+import { Ct as DeviceFeature, Gt as EventCategory, M as deriveBatteryPresence, Rt as nodePin, T as batteryCapability, Tt as DeviceType, i as BatteryStatusSchema, mt as streamQualityLabel, ut as snapshotCapability, vt as errMsg, w as bareAddonId, yt as BaseAddon } from "../../dist-RbFV8cX7.mjs";
 import { z } from "zod";
 import { randomUUID } from "node:crypto";
 import { signExpiringUrl, verifyExpiringUrl } from "@camstack/types/node";
@@ -839,6 +839,9 @@ var DEVICE_META_MEMO_MS = 1e4;
 /** Wake-on-play's 8 s firmware wait + 20 s broker settle, with scheduling
 *  slack. A lost completion event must not leave a camera "Waking" forever. */
 var SNAPSHOT_WAKING_TTL_MS = 35e3;
+/** Delay before the single wake-capture retry — covers a camera whose status
+*  flips awake a beat before its snapshot endpoint actually answers. */
+var WAKE_CAPTURE_RETRY_MS = 5e3;
 /** Default cache window for non-battery cams (seconds). Matches the Viewer's
 *  15 s currency contract (`LINK_CURRENT_MAX_AGE_MS`): a frame younger than
 *  that is presented as current, so re-capturing INSIDE the window bought
@@ -895,6 +898,9 @@ var SnapshotAddon = class SnapshotAddon extends BaseAddon {
 	stateFrames = /* @__PURE__ */ new Map();
 	/** Devices inside the explicit battery wake-in-progress window. */
 	wakingDevices = /* @__PURE__ */ new Map();
+	/** Last sleeping flag per battery device, for wake-EDGE detection (the map
+	*  starts empty; only an observed true→false transition is a wake). */
+	lastKnownSleeping = /* @__PURE__ */ new Map();
 	/**
 	* Short-TTL memo for `lookupDeviceMeta` (see {@link DEVICE_META_MEMO_MS}).
 	* The PROMISE is stored (not the resolved value), so a burst of concurrent
@@ -969,7 +975,8 @@ var SnapshotAddon = class SnapshotAddon extends BaseAddon {
 			applyDeviceSettingsPatch: (input) => this.saveDeviceSettingsPatch(input.deviceId, input.patch),
 			getStatus: async (input) => this.getStatus(input.deviceId),
 			getSnapshotOverview: (input) => this.getSnapshotOverview(input),
-			getSnapshotLinks: (input) => this.getSnapshotLinks(input)
+			getSnapshotLinks: (input) => this.getSnapshotLinks(input),
+			getDebugState: (input) => this.getSnapshotDebugState(input.deviceId)
 		};
 		this.subscribe({ category: EventCategory.DeviceUnregistered }, (event) => {
 			const deviceId = event.data.deviceId;
@@ -991,6 +998,9 @@ var SnapshotAddon = class SnapshotAddon extends BaseAddon {
 		});
 		this.subscribe({ category: EventCategory.BatteryOnStatusChanged }, (event) => {
 			this.wakingDevices.delete(event.data.deviceId);
+			const prevSleeping = this.lastKnownSleeping.get(event.data.deviceId);
+			this.lastKnownSleeping.set(event.data.deviceId, event.data.status.sleeping);
+			if (prevSleeping === true && !event.data.status.sleeping) this.captureOnWake(event.data.deviceId);
 		});
 		await this.serveMediaDataPlane();
 		await this.ensureLinkDataPlane();
@@ -1196,7 +1206,9 @@ var SnapshotAddon = class SnapshotAddon extends BaseAddon {
 		const refreshes = input.targets.map(async (target) => {
 			const state = await this.snapshotStateForLink(target.deviceId);
 			stateByDevice.set(target.deviceId, state);
-			if (state.reason === void 0) await this.awaitFreshEnough(target.deviceId);
+			if (state.reason !== void 0) return;
+			if (state.isBattery && !await this.hasStreamingBrokerForDevice(target.deviceId)) return;
+			await this.awaitFreshEnough(target.deviceId);
 		});
 		await raceForResult(Promise.allSettled(refreshes), LINK_BATCH_WAIT_MS);
 		const rows = input.targets.map((target) => {
@@ -1220,7 +1232,8 @@ var SnapshotAddon = class SnapshotAddon extends BaseAddon {
 				width: width ?? null,
 				neverCaptured: capturedAt === null,
 				sleeping: stateByDevice.get(deviceId)?.reason === "sleeping",
-				stateReason: stateByDevice.get(deviceId)?.reason ?? null
+				stateReason: stateByDevice.get(deviceId)?.reason ?? null,
+				battery: stateByDevice.get(deviceId)?.isBattery ?? false
 			};
 		});
 		this.ctx.logger.debug("snapshot: minted links", { meta: {
@@ -1231,6 +1244,36 @@ var SnapshotAddon = class SnapshotAddon extends BaseAddon {
 		return rows;
 	}
 	/**
+	* The debug readout's data — the decision chain for one device, cache-only
+	* and capture-free (a debug poll must never wake a battery camera).
+	*/
+	async getSnapshotDebugState(deviceId) {
+		const meta = await this.lookupDeviceMeta(deviceId);
+		const state = await this.resolveSnapshotState(deviceId, meta);
+		const hit = this.cache.latest(deviceId);
+		const batterySlice = await this.ctx.api.deviceState.getCapSlice.query({
+			deviceId,
+			capName: batteryCapability.name
+		}).catch(() => null);
+		const parsed = BatteryStatusSchema.safeParse(batterySlice);
+		return {
+			battery: parsed.success ? {
+				sleeping: parsed.data.sleeping,
+				lastUpdated: parsed.data.lastUpdated,
+				...parsed.data.lastContactAt !== void 0 ? { lastContactAt: parsed.data.lastContactAt } : {}
+			} : null,
+			state: {
+				isBattery: state.isBattery,
+				reason: state.reason ?? null
+			},
+			frame: {
+				capturedAt: hit?.ts ?? null,
+				ageMs: hit ? Date.now() - hit.ts : null
+			},
+			waking: this.isDeviceWaking(deviceId)
+		};
+	}
+	/**
 	* Join the ordinary capture path for one device and wait, bounded, for it.
 	*
 	* Deliberately `getSnapshot` with `force: false`: the single flight, grab
@@ -1254,6 +1297,42 @@ var SnapshotAddon = class SnapshotAddon extends BaseAddon {
 			}
 		});
 	}
+	/**
+	* The one fresh frame an awake battery camera gets outside an active stream:
+	* captured at the WAKE edge, because the link poll deliberately never
+	* recaptures an idle-awake battery camera (every capture is a camera hit
+	* that would keep it out of sleep — the link-mint gate documents the
+	* incident).
+	*
+	* `force: true` is correct here — not a violation of "never wake for a
+	* snapshot": the camera is ALREADY awake (the status edge is what fired),
+	* and the battery 1 h cache default would otherwise answer the wake with
+	* the pre-sleep frame. The single flight coalesces a burst of edges; one
+	* delayed retry covers a camera whose status flipped a beat before its
+	* snapshot endpoint is actually answering (firmware boot lag).
+	*/
+	async captureOnWake(deviceId) {
+		for (let attempt = 0; attempt < 2; attempt += 1) {
+			if (attempt > 0) await new Promise((r) => setTimeout(r, WAKE_CAPTURE_RETRY_MS));
+			try {
+				if (await this.getSnapshot({
+					deviceId,
+					force: true
+				}) !== null) {
+					this.ctx.logger.debug("snapshot: wake capture landed", { tags: { deviceId } });
+					return;
+				}
+			} catch (err) {
+				this.ctx.logger.debug("snapshot: wake capture failed", {
+					tags: { deviceId },
+					meta: {
+						error: errMsg(err),
+						attempt
+					}
+				});
+			}
+		}
+	}
 	/** Resolve the state advertised by a minted link before deciding whether a
 	*  background capture is allowed. */
 	async snapshotStateForLink(deviceId) {
@@ -1387,6 +1466,7 @@ var SnapshotAddon = class SnapshotAddon extends BaseAddon {
 		this.variants.clear();
 		this.stateFrames.clear();
 		this.wakingDevices.clear();
+		this.lastKnownSleeping.clear();
 		this.deviceMetaMemo.clear();
 		this.captureFlight.clear();
 		this.ownerCache = null;

package/dist/builtins/snapshot/snapshot.addon.d.ts

@@ -48,6 +48,9 @@ export declare class SnapshotAddon extends BaseAddon<SnapshotAddonConfig> {
     private readonly stateFrames;
     /** Devices inside the explicit battery wake-in-progress window. */
     private readonly wakingDevices;
+    /** Last sleeping flag per battery device, for wake-EDGE detection (the map
+     *  starts empty; only an observed true→false transition is a wake). */
+    private readonly lastKnownSleeping;
     /**
      * Short-TTL memo for `lookupDeviceMeta` (see {@link DEVICE_META_MEMO_MS}).
      * The PROMISE is stored (not the resolved value), so a burst of concurrent
@@ -207,6 +210,11 @@ export declare class SnapshotAddon extends BaseAddon<SnapshotAddonConfig> {
      * forward.
      */
     private getSnapshotLinks;
+    /**
+     * The debug readout's data — the decision chain for one device, cache-only
+     * and capture-free (a debug poll must never wake a battery camera).
+     */
+    private getSnapshotDebugState;
     /**
      * Join the ordinary capture path for one device and wait, bounded, for it.
      *
@@ -215,6 +223,21 @@ export declare class SnapshotAddon extends BaseAddon<SnapshotAddonConfig> {
      * the Viewer's 15-second currency contract and the link-mint wait bound.
      */
     private awaitFreshEnough;
+    /**
+     * The one fresh frame an awake battery camera gets outside an active stream:
+     * captured at the WAKE edge, because the link poll deliberately never
+     * recaptures an idle-awake battery camera (every capture is a camera hit
+     * that would keep it out of sleep — the link-mint gate documents the
+     * incident).
+     *
+     * `force: true` is correct here — not a violation of "never wake for a
+     * snapshot": the camera is ALREADY awake (the status edge is what fired),
+     * and the battery 1 h cache default would otherwise answer the wake with
+     * the pre-sleep frame. The single flight coalesces a burst of edges; one
+     * delayed retry covers a camera whose status flipped a beat before its
+     * snapshot endpoint is actually answering (firmware boot lag).
+     */
+    private captureOnWake;
     /** Resolve the state advertised by a minted link before deciding whether a
      *  background capture is allowed. */
     private snapshotStateForLink;

package/dist/builtins/sqlite-storage/filesystem-storage.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-uhKRdmyc.js");
+const require_dist = require("../../dist-tMrPAfpF.js");
 let node_crypto = require("node:crypto");
 let node_fs_promises = require("node:fs/promises");
 let node_path = require("node:path");

package/dist/builtins/sqlite-storage/filesystem-storage.addon.mjs

@@ -1,4 +1,4 @@
-import { V as filesystemBrowseCapability, pt as storageProviderCapability, yt as BaseAddon } from "../../dist-6JUfbDpM.mjs";
+import { V as filesystemBrowseCapability, pt as storageProviderCapability, yt as BaseAddon } from "../../dist-RbFV8cX7.mjs";
 import { randomUUID } from "node:crypto";
 import { mkdir, readdir, realpath, statfs } from "node:fs/promises";
 import * as path$1 from "node:path";

package/dist/builtins/sqlite-storage/sqlite-settings.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-uhKRdmyc.js");
+const require_dist = require("../../dist-tMrPAfpF.js");
 let node_crypto = require("node:crypto");
 let node_fs = require("node:fs");
 let node_module = require("node:module");

package/dist/builtins/sqlite-storage/sqlite-settings.addon.mjs

@@ -1,4 +1,4 @@
-import { A as dataStoreProviderCapability, Bt as parseJsonUnknown, _t as vectorStoreCapability, f as RUNTIME_DEFAULTS, gt as vectorDimFromBase64, j as decodeVectorBase64, kt as asJsonObject, vt as errMsg, w as bareAddonId, yt as BaseAddon } from "../../dist-6JUfbDpM.mjs";
+import { A as dataStoreProviderCapability, Bt as parseJsonUnknown, _t as vectorStoreCapability, f as RUNTIME_DEFAULTS, gt as vectorDimFromBase64, j as decodeVectorBase64, kt as asJsonObject, vt as errMsg, w as bareAddonId, yt as BaseAddon } from "../../dist-RbFV8cX7.mjs";
 import { createRequire } from "node:module";
 import { randomUUID } from "node:crypto";
 import { statSync } from "node:fs";

package/dist/builtins/storage-orchestrator/storage-orchestrator.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-uhKRdmyc.js");
+const require_dist = require("../../dist-tMrPAfpF.js");
 let node_crypto = require("node:crypto");
 let node_fs_promises = require("node:fs/promises");
 node_fs_promises = require_chunk.__toESM(node_fs_promises);

package/dist/builtins/storage-orchestrator/storage-orchestrator.addon.mjs

@@ -1,4 +1,4 @@
-import { dt as storageCapability, ft as storageMigrationCapability, g as StorageMigrationJobSchema, h as StorageLocationTypeSchema, lt as settingsStoreCapability, yt as BaseAddon, zt as parseJsonObject } from "../../dist-6JUfbDpM.mjs";
+import { dt as storageCapability, ft as storageMigrationCapability, g as StorageMigrationJobSchema, h as StorageLocationTypeSchema, lt as settingsStoreCapability, yt as BaseAddon, zt as parseJsonObject } from "../../dist-RbFV8cX7.mjs";
 import { randomUUID } from "node:crypto";
 import * as fs from "node:fs/promises";
 import * as path$1 from "node:path";

package/dist/builtins/system-config/system-config.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-uhKRdmyc.js");
+const require_dist = require("../../dist-tMrPAfpF.js");
 //#region src/builtins/system-config/system-config.addon.ts
 /**
 * Built-in `system-config` addon — Phase 4 of the settings redesign.

package/dist/builtins/system-config/system-config.addon.mjs

@@ -1,4 +1,4 @@
-import { It as hydrateSchema, vt as errMsg, yt as BaseAddon } from "../../dist-6JUfbDpM.mjs";
+import { It as hydrateSchema, vt as errMsg, yt as BaseAddon } from "../../dist-RbFV8cX7.mjs";
 //#region src/builtins/system-config/system-config.addon.ts
 /**
 * Built-in `system-config` addon — Phase 4 of the settings redesign.

package/dist/builtins/winston-logging/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-uhKRdmyc.js");
+const require_dist = require("../../dist-tMrPAfpF.js");
 const require_formatter = require("../../formatter-DqAKDlvN.js");
 let node_path = require("node:path");
 node_path = require_chunk.__toESM(node_path);

package/dist/builtins/winston-logging/index.mjs

@@ -1,4 +1,4 @@
-import { X as logDestinationCapability, yt as BaseAddon } from "../../dist-6JUfbDpM.mjs";
+import { X as logDestinationCapability, yt as BaseAddon } from "../../dist-RbFV8cX7.mjs";
 import { t as formatLogLine } from "../../formatter-B7qW8bPJ.mjs";
 import * as path$1 from "node:path";
 import path from "node:path";

package/dist/{dist-6JUfbDpM.mjs → dist-RbFV8cX7.mjs}

@@ -18540,6 +18540,39 @@ var snapshotCapability = {
 			etag: 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(z.object({ deviceId: z.number() }), z.object({
+			/** The battery slice as read, or null when the device has none. */
+			battery: z.object({
+				sleeping: z.boolean(),
+				lastUpdated: z.number(),
+				lastContactAt: z.number().optional()
+			}).nullable(),
+			/** The resolved snapshot state (what the overlay decision used). */
+			state: z.object({
+				isBattery: z.boolean(),
+				reason: z.enum([
+					"disabled",
+					"sleeping",
+					"unreachable",
+					"waking"
+				]).nullable()
+			}),
+			/** The cached frame behind the next paint. */
+			frame: z.object({
+				capturedAt: z.number().nullable(),
+				ageMs: z.number().nullable()
+			}),
+			/** A wake window is currently open (the Waking overlay's source). */
+			waking: z.boolean()
+		})),
+		/**
 		* Signed, expiring links to a CLIENT-SIZED frame — and the demand signal
 		* that makes those frames current.
 		*
@@ -18621,7 +18654,14 @@ targets: z.array(z.object({
 				"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: z.boolean()
 		})))
 	},
 	status: {
@@ -34375,6 +34415,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",
@@ -36972,6 +37018,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"snapshot.getDebugState": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"snapshot.getSnapshot": [{
 		name: "deviceId",
 		form: "single",

package/dist/{dist-uhKRdmyc.js → dist-tMrPAfpF.js}

@@ -18540,6 +18540,39 @@ var snapshotCapability = {
 			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.
 		*
@@ -18621,7 +18654,14 @@ targets: zod.z.array(zod.z.object({
 				"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: {
@@ -34375,6 +34415,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",
@@ -36972,6 +37018,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"snapshot.getDebugState": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"snapshot.getSnapshot": [{
 		name: "deviceId",
 		form: "single",

package/dist/index.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_chunk = require("./chunk-Cek0wNdY.js");
-const require_dist = require("./dist-uhKRdmyc.js");
+const require_dist = require("./dist-tMrPAfpF.js");
 const require_builtins_alerts_alerts_addon = require("./builtins/alerts/alerts.addon.js");
 require("./builtins/alerts/index.js");
 const require_formatter = require("./formatter-DqAKDlvN.js");

package/dist/index.mjs

@@ -1,5 +1,5 @@
 import { a as __toCommonJS, i as __require, n as __esmMin, o as __toESM$1, r as __exportAll, t as __commonJSMin$1 } from "./chunk-CNf5ZN-e.mjs";
-import { At as asNumber, B as extractNestedAddonId, Bt as parseJsonUnknown$1, Dt as ReadinessTimeoutError, Et as ReadinessRegistry, Ft as expandCapMethods, Gt as EventCategory$1, H as isArrayOutputSchema, Ht as resolveCapMount, J as lifecycleJobSchema, K as isVoidInput, Mt as createEvent, Nt as emitDownForOwnedCaps, Q as looseSchema, St as DEVICE_STATUS_METHOD, U as isCollectionArrayMethod, Ut as scopeKey, Vt as readinessKey, W as isObjectInput, Z as logLevelAtMost, bt as DATAPLANE_SECRET_HEADER$1, d as METHOD_ACCESS_MAP, f as RUNTIME_DEFAULTS, it as procedureAuthKey, jt as asString$1, kt as asJsonObject$1, ot as scopesAllowAddon, q as kebabToCamel, st as scopesAllowDeviceCap, t as ALL_CAPABILITY_DEFINITIONS, tt as objectInputDeclaresAddonId, vt as errMsg$1, xt as DEVICE_SETTINGS_CONTRIBUTION_METHODS, y as addonSettingsCapability, zt as parseJsonObject } from "./dist-6JUfbDpM.mjs";
+import { At as asNumber, B as extractNestedAddonId, Bt as parseJsonUnknown$1, Dt as ReadinessTimeoutError, Et as ReadinessRegistry, Ft as expandCapMethods, Gt as EventCategory$1, H as isArrayOutputSchema, Ht as resolveCapMount, J as lifecycleJobSchema, K as isVoidInput, Mt as createEvent, Nt as emitDownForOwnedCaps, Q as looseSchema, St as DEVICE_STATUS_METHOD, U as isCollectionArrayMethod, Ut as scopeKey, Vt as readinessKey, W as isObjectInput, Z as logLevelAtMost, bt as DATAPLANE_SECRET_HEADER$1, d as METHOD_ACCESS_MAP, f as RUNTIME_DEFAULTS, it as procedureAuthKey, jt as asString$1, kt as asJsonObject$1, ot as scopesAllowAddon, q as kebabToCamel, st as scopesAllowDeviceCap, t as ALL_CAPABILITY_DEFINITIONS, tt as objectInputDeclaresAddonId, vt as errMsg$1, xt as DEVICE_SETTINGS_CONTRIBUTION_METHODS, y as addonSettingsCapability, zt as parseJsonObject } from "./dist-RbFV8cX7.mjs";
 import { AlertCenterAddon } from "./builtins/alerts/alerts.addon.mjs";
 import "./builtins/alerts/index.mjs";
 import { t as formatLogLine } from "./formatter-B7qW8bPJ.mjs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/system",
-  "version": "1.2.98",
+  "version": "1.2.100",
   "description": "Core addon for CamStack — builtins, pipeline, process management, auth, logging, events",
   "keywords": [
     "camstack",