@camstack/system 1.2.8 → 1.2.10

package/dist/addon-runner.js

@@ -1,7 +1,7 @@
 const require_chunk = require("./chunk-Cek0wNdY.js");
-const require_dist = require("./dist-CdgScQ3H.js");
-const require_manifest_python_deps = require("./manifest-python-deps-CUHn5wqq.js");
-const require_custom_action_registry = require("./custom-action-registry-vLYEFTtv.js");
+const require_dist = require("./dist-BQOCTD5b.js");
+const require_manifest_python_deps = require("./manifest-python-deps-1I7WdPDD.js");
+const require_custom_action_registry = require("./custom-action-registry-jY0NOZK8.js");
 let node_fs = require("node:fs");
 node_fs = require_chunk.__toESM(node_fs);
 let node_path = require("node:path");
@@ -274,7 +274,7 @@ function createChildAddonCallDispatch(deps) {
 				if (typeof action !== "string" || action.length === 0) throw new Error(`child-addon-call: addon "${addonId}" custom call missing action name`);
 				const entry = deps.customActions.resolve(addonId, action);
 				if (entry === null) throw new Error(`child-addon-call: addon "${addonId}" has no custom action "${action}"`);
-				return entry.handler(call.args);
+				return entry.handler(call.args, call.caller);
 			}
 			case "settings": {
 				const method = call.method;
@@ -608,10 +608,10 @@ async function main() {
 		}
 		if (initResult?.customActions && initResult.actionHandlers) {
 			const handlers = initResult.actionHandlers;
-			customActionRegistry.registerAddon(spec.addonId, initResult.customActions, (action, input) => {
+			customActionRegistry.registerAddon(spec.addonId, initResult.customActions, (action, input, caller) => {
 				const fn = handlers[action];
 				if (!fn) throw new Error(`addon '${spec.addonId}' has no handler for custom action '${action}'`);
-				return fn(input);
+				return fn(input, caller);
 			});
 		}
 		require_manifest_python_deps.validateProviderRegistrations(spec.addonId, declaration, registeredProviders, context.logger);

package/dist/addon-runner.mjs

@@ -1,6 +1,6 @@
-import { M as isCollectionArrayMethod, t as ALL_CAPABILITY_DEFINITIONS } from "./dist-CxM20CkF.mjs";
-import { Ct as resolveAddonClass, I as createUdsLoggerWithControl, L as LocalChildClient, at as setWorkerNativeCapsChangeListener, bt as installManifestNativeDeps, i as createUdsAddonContext, nt as getWorkerNativeCapProvider, rt as getWorkerNativeCapSnapshot, st as validateProviderRegistrations, t as installManifestPythonDeps } from "./manifest-python-deps-CcW0WpfS.mjs";
-import { t as CustomActionRegistry } from "./custom-action-registry-BEXwC-oo.mjs";
+import { N as isCollectionArrayMethod, t as ALL_CAPABILITY_DEFINITIONS } from "./dist-DpKeSZel.mjs";
+import { Ct as resolveAddonClass, I as createUdsLoggerWithControl, L as LocalChildClient, at as setWorkerNativeCapsChangeListener, bt as installManifestNativeDeps, i as createUdsAddonContext, nt as getWorkerNativeCapProvider, rt as getWorkerNativeCapSnapshot, st as validateProviderRegistrations, t as installManifestPythonDeps } from "./manifest-python-deps-I2MGvDvo.mjs";
+import { t as CustomActionRegistry } from "./custom-action-registry-F__gp_VX.mjs";
 import { register } from "node:module";
 import * as fs from "node:fs";
 import * as path$1 from "node:path";
@@ -270,7 +270,7 @@ function createChildAddonCallDispatch(deps) {
 				if (typeof action !== "string" || action.length === 0) throw new Error(`child-addon-call: addon "${addonId}" custom call missing action name`);
 				const entry = deps.customActions.resolve(addonId, action);
 				if (entry === null) throw new Error(`child-addon-call: addon "${addonId}" has no custom action "${action}"`);
-				return entry.handler(call.args);
+				return entry.handler(call.args, call.caller);
 			}
 			case "settings": {
 				const method = call.method;
@@ -604,10 +604,10 @@ async function main() {
 		}
 		if (initResult?.customActions && initResult.actionHandlers) {
 			const handlers = initResult.actionHandlers;
-			customActionRegistry.registerAddon(spec.addonId, initResult.customActions, (action, input) => {
+			customActionRegistry.registerAddon(spec.addonId, initResult.customActions, (action, input, caller) => {
 				const fn = handlers[action];
 				if (!fn) throw new Error(`addon '${spec.addonId}' has no handler for custom action '${action}'`);
-				return fn(input);
+				return fn(input, caller);
 			});
 		}
 		validateProviderRegistrations(spec.addonId, declaration, registeredProviders, context.logger);

package/dist/addon-utils.js

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("./chunk-Cek0wNdY.js");
 const require_model_download_service = require("./model-download-service-hf0ookyy.js");
-const require_custom_action_registry = require("./custom-action-registry-vLYEFTtv.js");
+const require_custom_action_registry = require("./custom-action-registry-jY0NOZK8.js");
 exports.CustomActionRegistry = require_custom_action_registry.CustomActionRegistry;
 exports.ModelDownloadService = require_model_download_service.ModelDownloadService;
 exports.collectModelFiles = require_model_download_service.collectModelFiles;

package/dist/addon-utils.mjs

@@ -1,3 +1,3 @@
 import { c as getModelFilePath, d as contentTypeFor, i as downloadFile, l as isModelDownloaded, n as collectModelFiles, o as ensureModel, p as parseRangeHeader, r as deleteModelFromDisk, t as ModelDownloadService, u as createFileDataPlaneHandler } from "./model-download-service-Cp9f4dk6.mjs";
-import { t as CustomActionRegistry } from "./custom-action-registry-BEXwC-oo.mjs";
+import { t as CustomActionRegistry } from "./custom-action-registry-F__gp_VX.mjs";
 export { CustomActionRegistry, ModelDownloadService, collectModelFiles, contentTypeFor, createFileDataPlaneHandler, deleteModelFromDisk, downloadFile, ensureModel, getModelFilePath, isModelDownloaded, parseRangeHeader };

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-CdgScQ3H.js");
+const require_dist = require("../../dist-BQOCTD5b.js");
 const require_settle_sources = require("../../settle-sources-Bhsy57y-.js");
 let node_fs = require("node:fs");
 node_fs = require_chunk.__toESM(node_fs);

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

@@ -1,4 +1,4 @@
-import { At as EventCategory, at as BaseAddon, f as addonPagesCapability, it as errMsg } from "../../dist-CxM20CkF.mjs";
+import { at as errMsg, jt as EventCategory, ot as BaseAddon, p as addonPagesCapability } from "../../dist-DpKeSZel.mjs";
 import { t as settleSourcesWithTimeout } from "../../settle-sources-CDtNC8ub.mjs";
 import * as fs from "node:fs";
 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-CdgScQ3H.js");
+const require_dist = require("../../dist-BQOCTD5b.js");
 const require_settle_sources = require("../../settle-sources-Bhsy57y-.js");
 let node_fs = require("node:fs");
 node_fs = require_chunk.__toESM(node_fs);

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

@@ -1,4 +1,4 @@
-import { At as EventCategory, at as BaseAddon, it as errMsg, m as addonWidgetsCapability } from "../../dist-CxM20CkF.mjs";
+import { at as errMsg, h as addonWidgetsCapability, jt as EventCategory, ot as BaseAddon } from "../../dist-DpKeSZel.mjs";
 import { t as settleSourcesWithTimeout } from "../../settle-sources-CDtNC8ub.mjs";
 import * as fs from "node:fs";
 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-CdgScQ3H.js");
+const require_dist = require("../../dist-BQOCTD5b.js");
 //#region src/builtins/alerts/alerts.addon.ts
 var CATEGORY_MAPPINGS = {
 	"addon.crashed": {

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

@@ -1,4 +1,4 @@
-import { At as EventCategory, at as BaseAddon, h as alertsCapability, it as errMsg, n as AlertSchema, vt as createEvent } from "../../dist-CxM20CkF.mjs";
+import { at as errMsg, g as alertsCapability, jt as EventCategory, n as AlertSchema, ot as BaseAddon, yt as createEvent } from "../../dist-DpKeSZel.mjs";
 //#region src/builtins/alerts/alerts.addon.ts
 var CATEGORY_MAPPINGS = {
 	"addon.crashed": {

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-CdgScQ3H.js");
+const require_dist = require("../../dist-BQOCTD5b.js");
 let node_fs = require("node:fs");
 let node_fs$1 = require_chunk.__toESM(node_fs, 1);
 node_fs = require_chunk.__toESM(node_fs);

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

@@ -1,4 +1,4 @@
-import { At as EventCategory, at as BaseAddon, v as backupCapability } from "../../dist-CxM20CkF.mjs";
+import { jt as EventCategory, ot as BaseAddon, y as backupCapability } from "../../dist-DpKeSZel.mjs";
 import * as fs from "node:fs";
 import Kt from "node:fs";
 import * as path$1 from "node:path";

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-CdgScQ3H.js");
+const require_dist = require("../../dist-BQOCTD5b.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 { R as logDestinationCapability, at as BaseAddon } from "../../dist-CxM20CkF.mjs";
+import { ot as BaseAddon, z as logDestinationCapability } from "../../dist-DpKeSZel.mjs";
 import { t as formatLogLine } from "../../formatter-B7qW8bPJ.mjs";
 //#region src/builtins/console-logging/console-destination.ts
 var LEVEL_RANK = {

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-CdgScQ3H.js");
+const require_dist = require("../../dist-BQOCTD5b.js");
 let _camstack_types_node = require("@camstack/types/node");
 let zod = require("zod");
 let node_crypto = require("node:crypto");

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

@@ -1,4 +1,4 @@
-import { A as getByPath, At as EventCategory, Ct as isDeviceConfigCap, D as evaluateLinkExpression, E as enumerateSchemaFields, H as normalizeUnit, S as deviceStatusCapability, T as enumerateItemArrayFields, W as parseStreamParamsFormPatch, Y as setByPath, a as DeviceStatusSchema, at as BaseAddon, b as deviceManagerCapability, c as STREAM_PROFILE_META, dt as DeviceType, g as applyTransform, i as CAP_NAMES_WITH_STATUS, it as errMsg, kt as sleep, lt as DeviceFeature, mt as WELL_KNOWN_TAB_MAP, rt as validateExpressionSource, t as ALL_CAPABILITY_DEFINITIONS, tt as toExpressionValue, ut as DeviceRole, x as deviceStateCapability, y as buildStreamParamsConfigSchema } from "../../dist-CxM20CkF.mjs";
+import { At as sleep, C as deviceStatusCapability, D as enumerateSchemaFields, E as enumerateItemArrayFields, G as parseStreamParamsFormPatch, O as evaluateLinkExpression, S as deviceStateCapability, U as normalizeUnit, X as setByPath, _ as applyTransform, a as CAP_NAMES_WITH_STATUS, at as errMsg, b as buildStreamParamsConfigSchema, dt as DeviceRole, ft as DeviceType, ht as WELL_KNOWN_TAB_MAP, it as validateExpressionSource, j as getByPath, jt as EventCategory, l as STREAM_PROFILE_META, nt as toExpressionValue, o as DeviceStatusSchema, ot as BaseAddon, t as ALL_CAPABILITY_DEFINITIONS, ut as DeviceFeature, wt as isDeviceConfigCap, x as deviceManagerCapability } from "../../dist-DpKeSZel.mjs";
 import { canonicalDeviceFingerprint } from "@camstack/types/node";
 import { z } from "zod";
 import { randomUUID } from "node:crypto";

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-CdgScQ3H.js");
+const require_dist = require("../../dist-BQOCTD5b.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 { At as EventCategory, C as doorbellCapability, at as BaseAddon, dt as DeviceType, it as errMsg, vt as createEvent } from "../../dist-CxM20CkF.mjs";
+import { at as errMsg, ft as DeviceType, jt as EventCategory, ot as BaseAddon, w as doorbellCapability, yt as createEvent } from "../../dist-DpKeSZel.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-CdgScQ3H.js");
+const require_dist = require("../../dist-BQOCTD5b.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 { R as logDestinationCapability, at as BaseAddon } from "../../dist-CxM20CkF.mjs";
+import { ot as BaseAddon, z as logDestinationCapability } from "../../dist-DpKeSZel.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/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-CdgScQ3H.js");
+const require_dist = require("../../dist-BQOCTD5b.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,4 +1,4 @@
-import { _ as authProviderCapability, at as BaseAddon, d as UserRecordSchema, l as ScopedTokenSchema, nt as userManagementCapability, r as ApiKeyRecordSchema } from "../../dist-CxM20CkF.mjs";
+import { f as UserRecordSchema, ot as BaseAddon, r as ApiKeyRecordSchema, rt as userManagementCapability, u as ScopedTokenSchema, v as authProviderCapability } from "../../dist-DpKeSZel.mjs";
 import { createRequire } from "node:module";
 import * as crypto$1 from "node:crypto";
 import { randomUUID } from "node: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-CdgScQ3H.js");
+const require_dist = require("../../dist-BQOCTD5b.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 { At as EventCategory, L as localNetworkCapability, at as BaseAddon } from "../../dist-CxM20CkF.mjs";
+import { R as localNetworkCapability, jt as EventCategory, ot as BaseAddon } from "../../dist-DpKeSZel.mjs";
 import * as os from "node:os";
 //#region src/builtins/local-network/local-network.addon.ts
 /**

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-CdgScQ3H.js");
+const require_dist = require("../../dist-BQOCTD5b.js");
 let node_fs = require("node:fs");
 node_fs = require_chunk.__toESM(node_fs);
 let node_child_process = require("node:child_process");

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

@@ -1,4 +1,4 @@
-import { At as EventCategory, B as metricsProviderCapability, at as BaseAddon, vt as createEvent } from "../../dist-CxM20CkF.mjs";
+import { V as metricsProviderCapability, jt as EventCategory, ot as BaseAddon, yt as createEvent } from "../../dist-DpKeSZel.mjs";
 import * as fs from "node:fs";
 import { execFile, execFileSync } from "node:child_process";
 import { promisify } from "node:util";

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-CdgScQ3H.js");
+const require_dist = require("../../dist-BQOCTD5b.js");
 let node_fs = require("node:fs");
 node_fs = require_chunk.__toESM(node_fs);
 let node_child_process = require("node:child_process");

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

@@ -1,4 +1,4 @@
-import { At as EventCategory, G as platformProbeCapability, J as scoreRuntimes, at as BaseAddon, bt as emitReadiness, it as errMsg, w as enumerateInferenceDevices } from "../../dist-CxM20CkF.mjs";
+import { K as platformProbeCapability, T as enumerateInferenceDevices, Y as scoreRuntimes, at as errMsg, jt as EventCategory, ot as BaseAddon, xt as emitReadiness } from "../../dist-DpKeSZel.mjs";
 import * as fs from "node:fs";
 import { execFile } from "node:child_process";
 import { promisify } from "node:util";

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-CdgScQ3H.js");
+const require_dist = require("../../dist-BQOCTD5b.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 { At as EventCategory, at as BaseAddon } from "../../dist-CxM20CkF.mjs";
+import { jt as EventCategory, ot as BaseAddon } from "../../dist-DpKeSZel.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" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-CdgScQ3H.js");
+const require_dist = require("../../dist-BQOCTD5b.js");
 let node_child_process = require("node:child_process");
 //#region src/builtins/snapshot/snapshot-coalescing.ts
 /**
@@ -485,6 +485,16 @@ var SnapshotAddon = class SnapshotAddon extends require_dist.BaseAddon {
 			});
 			return hit ? hit.data : null;
 		}
+		if (!force && isBatteryDevice && await this.isDeviceSleeping(deviceId)) {
+			log.debug("snapshot: sleeping battery cam and no force — serving cache, not capturing", {
+				tags: { deviceId },
+				meta: {
+					hasCache: hit !== void 0,
+					ageMs: hit ? now - hit.ts : null
+				}
+			});
+			return hit ? hit.data : null;
+		}
 		const flightKey = `${deviceId}:${effectiveStreamId ?? "auto"}`;
 		const flight = this.captureFlight.run(flightKey, () => this.captureFresh({
 			deviceId,
@@ -755,7 +765,25 @@ var SnapshotAddon = class SnapshotAddon extends require_dist.BaseAddon {
 	* missing, RPC timeout) is swallowed and treated as "awake" — we'd
 	* rather pay a wake-up than strand the caller on a cache that's
 	* semantically stale. Debug-logged for observability.
+	*
+	* Cheap: a battery provider serves this from its runtime-state slice,
+	* so the probe costs one RPC and zero camera traffic. Only consulted
+	* on the path that would otherwise CAPTURE — a fresh cache hit
+	* returns before we get here.
 	*/
+	async isDeviceSleeping(deviceId) {
+		try {
+			const raw = await this.ctx.api.battery.getStatus.query({ deviceId });
+			const parsed = require_dist.BatteryStatusSchema.safeParse(raw);
+			return parsed.success && parsed.data.sleeping;
+		} catch (err) {
+			this.ctx.logger.debug("snapshot: battery sleep probe failed — assuming awake", {
+				tags: { deviceId },
+				meta: { error: require_dist.errMsg(err) }
+			});
+			return false;
+		}
+	}
 	/**
 	* True when at least one of the device's brokers is actively
 	* streaming (status === 'streaming'). Used by the battery-cam guard

package/dist/builtins/snapshot/index.mjs

@@ -1,4 +1,4 @@
-import { V as nodePin, Z as snapshotCapability, at as BaseAddon, dt as DeviceType, et as streamQualityLabel, it as errMsg, lt as DeviceFeature } from "../../dist-CxM20CkF.mjs";
+import { H as nodePin, Q as snapshotCapability, at as errMsg, ft as DeviceType, i as BatteryStatusSchema, ot as BaseAddon, tt as streamQualityLabel, ut as DeviceFeature } from "../../dist-DpKeSZel.mjs";
 import { execFile } from "node:child_process";
 //#region src/builtins/snapshot/snapshot-coalescing.ts
 /**
@@ -480,6 +480,16 @@ var SnapshotAddon = class SnapshotAddon extends BaseAddon {
 			});
 			return hit ? hit.data : null;
 		}
+		if (!force && isBatteryDevice && await this.isDeviceSleeping(deviceId)) {
+			log.debug("snapshot: sleeping battery cam and no force — serving cache, not capturing", {
+				tags: { deviceId },
+				meta: {
+					hasCache: hit !== void 0,
+					ageMs: hit ? now - hit.ts : null
+				}
+			});
+			return hit ? hit.data : null;
+		}
 		const flightKey = `${deviceId}:${effectiveStreamId ?? "auto"}`;
 		const flight = this.captureFlight.run(flightKey, () => this.captureFresh({
 			deviceId,
@@ -750,7 +760,25 @@ var SnapshotAddon = class SnapshotAddon extends BaseAddon {
 	* missing, RPC timeout) is swallowed and treated as "awake" — we'd
 	* rather pay a wake-up than strand the caller on a cache that's
 	* semantically stale. Debug-logged for observability.
+	*
+	* Cheap: a battery provider serves this from its runtime-state slice,
+	* so the probe costs one RPC and zero camera traffic. Only consulted
+	* on the path that would otherwise CAPTURE — a fresh cache hit
+	* returns before we get here.
 	*/
+	async isDeviceSleeping(deviceId) {
+		try {
+			const raw = await this.ctx.api.battery.getStatus.query({ deviceId });
+			const parsed = BatteryStatusSchema.safeParse(raw);
+			return parsed.success && parsed.data.sleeping;
+		} catch (err) {
+			this.ctx.logger.debug("snapshot: battery sleep probe failed — assuming awake", {
+				tags: { deviceId },
+				meta: { error: errMsg(err) }
+			});
+			return false;
+		}
+	}
 	/**
 	* True when at least one of the device's brokers is actively
 	* streaming (status === 'streaming'). Used by the battery-cam guard

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

@@ -176,7 +176,13 @@ export declare class SnapshotAddon extends BaseAddon<SnapshotAddonConfig> {
      * missing, RPC timeout) is swallowed and treated as "awake" — we'd
      * rather pay a wake-up than strand the caller on a cache that's
      * semantically stale. Debug-logged for observability.
+     *
+     * Cheap: a battery provider serves this from its runtime-state slice,
+     * so the probe costs one RPC and zero camera traffic. Only consulted
+     * on the path that would otherwise CAPTURE — a fresh cache hit
+     * returns before we get here.
      */
+    private isDeviceSleeping;
     /**
      * True when at least one of the device's brokers is actively
      * streaming (status === 'streaming'). Used by the battery-cam guard

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-CdgScQ3H.js");
+const require_dist = require("../../dist-BQOCTD5b.js");
 let node_fs = require("node:fs");
 node_fs = require_chunk.__toESM(node_fs);
 let node_path = require("node:path");

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

@@ -1,4 +1,4 @@
-import { $ as storageProviderCapability, at as BaseAddon, k as filesystemBrowseCapability } from "../../dist-CxM20CkF.mjs";
+import { A as filesystemBrowseCapability, et as storageProviderCapability, ot as BaseAddon } from "../../dist-DpKeSZel.mjs";
 import * as fs from "node:fs";
 import * as path$1 from "node:path";
 import { basename, dirname, join, resolve, sep } 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-CdgScQ3H.js");
+const require_dist = require("../../dist-BQOCTD5b.js");
 let node_crypto = require("node:crypto");
 let better_sqlite3 = require("better-sqlite3");
 better_sqlite3 = require_chunk.__toESM(better_sqlite3);

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

@@ -1,4 +1,4 @@
-import { Tt as parseJsonUnknown, X as settingsStoreCapability, at as BaseAddon, ht as asJsonObject, it as errMsg, s as RUNTIME_DEFAULTS } from "../../dist-CxM20CkF.mjs";
+import { Et as parseJsonUnknown, Z as settingsStoreCapability, at as errMsg, c as RUNTIME_DEFAULTS, gt as asJsonObject, ot as BaseAddon } from "../../dist-DpKeSZel.mjs";
 import { randomUUID } from "node:crypto";
 import Database from "better-sqlite3";
 //#region src/builtins/sqlite-storage/sqlite-settings-backend.ts

package/dist/builtins/storage-orchestrator/storage-orchestrator.addon.d.ts

@@ -65,6 +65,18 @@ export declare class StorageOrchestratorAddon extends BaseAddon<StorageOrchestra
      */
     private resolveLocationThresholds;
     private locationBasePath;
+    /**
+     * A stable key for the PHYSICAL storage device behind a location — the
+     * `realpath` of its `basePath`, so symlinked / bind-mounted aliases and
+     * same-root managed locations (`recordings:default` + `recordingsLow:default`,
+     * both at `/recordings`) collapse to one key. Feeds the pressure manager's
+     * in-sweep dedup so a shared disk is relieved at most once per tick (closing
+     * the bounded over-eviction window; see `getLocationDeviceKey`). Falls back to
+     * the lexically-resolved path when realpath throws (root missing at boot),
+     * `null` when the location has no basePath — either way dedup degrades to
+     * per-location, never merging two distinct disks.
+     */
+    private locationDeviceKey;
     /** Free capacity (%) on a location's volume via `statfs`; 100 (guard inert) when unstattable. */
     private locationFreePercent;
     /** Total bytes on a location's volume via `statfs`; 0 when unstattable. */

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-CdgScQ3H.js");
+const require_dist = require("../../dist-BQOCTD5b.js");
 let node_path = require("node:path");
 node_path = require_chunk.__toESM(node_path);
 let node_fs_promises = require("node:fs/promises");
@@ -614,10 +614,19 @@ var StoragePressureManager = class {
 	/** Relieve every managed location currently under its threshold. */
 	async sweep() {
 		const thresholds = await this.deps.getLocationThresholds();
+		const relievedDevices = /* @__PURE__ */ new Set();
 		for (const [locationId, threshold] of thresholds) {
 			if (threshold <= 0) continue;
+			const deviceKey = await this.deps.getLocationDeviceKey?.(locationId) ?? null;
+			if (deviceKey !== null && relievedDevices.has(deviceKey)) {
+				this.deps.logger.debug("storage pressure: skipping location — physical device already relieved this sweep", { meta: {
+					locationId,
+					deviceKey
+				} });
+				continue;
+			}
 			try {
-				await this.relieveLocation(locationId, threshold);
+				if (await this.relieveLocation(locationId, threshold) && deviceKey !== null) relievedDevices.add(deviceKey);
 			} catch (err) {
 				this.deps.logger.warn("storage pressure: relief failed for location", { meta: {
 					locationId,
@@ -626,16 +635,25 @@ var StoragePressureManager = class {
 			}
 		}
 	}
+	/**
+	* Relieve one location until it recovers, nothing is evictable, or a round
+	* makes no progress. Returns `true` when at least one relief round actually
+	* reclaimed bytes (so the caller marks the location's physical device relieved
+	* for this sweep — the trigger for the over-eviction dedup: freed bytes mean a
+	* sibling alias may re-read a not-yet-settled `statfs`), `false` when nothing
+	* was freed (never breached, or breached with no evictable data).
+	*/
 	async relieveLocation(locationId, threshold) {
 		const maxRounds = this.deps.maxRounds ?? DEFAULT_MAX_ROUNDS;
 		const hysteresis = this.deps.hysteresisPercent ?? DEFAULT_HYSTERESIS_PERCENT;
+		let reclaimedAny = false;
 		for (let round = 0; round < maxRounds; round++) {
 			const free = await this.deps.getFreePercent(locationId);
-			if (free >= threshold) return;
+			if (free >= threshold) return reclaimedAny;
 			const total = await this.deps.getVolumeTotalBytes(locationId);
 			const deficitPercent = threshold - free + hysteresis;
 			const targetBytes = Math.ceil(total * deficitPercent / 100);
-			if (targetBytes <= 0) return;
+			if (targetBytes <= 0) return reclaimedAny;
 			const providers = this.deps.getEvictableProviders();
 			const usages = await Promise.all(providers.map(async (p) => ({
 				p,
@@ -648,7 +666,7 @@ var StoragePressureManager = class {
 					freePercent: free,
 					threshold
 				} });
-				return;
+				return reclaimedAny;
 			}
 			let reclaimed = 0;
 			for (const u of usages) {
@@ -660,6 +678,7 @@ var StoragePressureManager = class {
 				});
 				reclaimed += res.reclaimedBytes;
 			}
+			if (reclaimed > 0) reclaimedAny = true;
 			this.deps.logger.info("storage pressure: relief round", { meta: {
 				locationId,
 				round,
@@ -668,8 +687,9 @@ var StoragePressureManager = class {
 				targetBytes,
 				reclaimedBytes: reclaimed
 			} });
-			if (reclaimed <= 0) return;
+			if (reclaimed <= 0) return reclaimedAny;
 		}
+		return reclaimedAny;
 	}
 };
 //#endregion
@@ -923,7 +943,8 @@ var StorageOrchestratorAddon = class extends require_dist.BaseAddon {
 			getFreePercent: (id) => this.locationFreePercent(id),
 			getVolumeTotalBytes: (id) => this.locationVolumeTotalBytes(id),
 			getEvictableProviders: () => this.ctx.kernel.capabilityRegistry?.getCollection(STORAGE_EVICTABLE_CAP_NAME) ?? [],
-			getLocationThresholds: () => this.resolveLocationThresholds()
+			getLocationThresholds: () => this.resolveLocationThresholds(),
+			getLocationDeviceKey: (id) => this.locationDeviceKey(id)
 		});
 		this.pressureTimer = setInterval(() => {
 			this.runPressureSweep();
@@ -1036,6 +1057,26 @@ var StorageOrchestratorAddon = class extends require_dist.BaseAddon {
 		const bp = (this.service?.listLocations().find((l) => l.id === locationId))?.config["basePath"];
 		return typeof bp === "string" && bp.length > 0 ? bp : null;
 	}
+	/**
+	* A stable key for the PHYSICAL storage device behind a location — the
+	* `realpath` of its `basePath`, so symlinked / bind-mounted aliases and
+	* same-root managed locations (`recordings:default` + `recordingsLow:default`,
+	* both at `/recordings`) collapse to one key. Feeds the pressure manager's
+	* in-sweep dedup so a shared disk is relieved at most once per tick (closing
+	* the bounded over-eviction window; see `getLocationDeviceKey`). Falls back to
+	* the lexically-resolved path when realpath throws (root missing at boot),
+	* `null` when the location has no basePath — either way dedup degrades to
+	* per-location, never merging two distinct disks.
+	*/
+	async locationDeviceKey(locationId) {
+		const bp = this.locationBasePath(locationId);
+		if (!bp) return null;
+		try {
+			return await node_fs_promises.realpath(bp);
+		} catch {
+			return node_path.resolve(bp);
+		}
+	}
 	/** Free capacity (%) on a location's volume via `statfs`; 100 (guard inert) when unstattable. */
 	async locationFreePercent(locationId) {
 		const bp = this.locationBasePath(locationId);