@camstack/system 1.2.316 → 1.2.318

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

@@ -1,4 +1,4 @@
-import { Gn as BaseAddon, It as localNetworkCapability, hr as EventCategory } from "../../dist-BPvku43i.mjs";
+import { Gn as BaseAddon, It as localNetworkCapability, hr as EventCategory } from "../../dist-CQ9vXSUh.mjs";
 import { S as readLanHttpState, _ as DEFAULT_LAN_HTTP_PORT, a as writeTlsMode, i as writeExtraSans, l as reissueTlsLeaf, n as readTlsAccessStatus, o as validateUploadedTls, r as readTlsMode, s as ensureTlsCert, t as readExtraSans, y as applyLanHttp } from "../../tls-IM-v7JV4.mjs";
 import { mkdir, writeFile } from "node:fs/promises";
 import { join } from "node:path";

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-RAl10EfG.js");
+const require_dist = require("../../dist-Dcy0gVHu.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 { Gn as BaseAddon, Rt as logDestinationCapability } from "../../dist-BPvku43i.mjs";
+import { Gn as BaseAddon, Rt as logDestinationCapability } from "../../dist-CQ9vXSUh.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-RAl10EfG.js");
+const require_dist = require("../../dist-Dcy0gVHu.js");
 const require_proc_stat = require("../../proc-stat-DL-WUOhl.js");
 let node_fs_promises = require("node:fs/promises");
 let node_fs = require("node:fs");

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

@@ -1,4 +1,4 @@
-import { Ct as foldSnapshotByFunction, Gn as BaseAddon, Ut as metricsProviderCapability, Wn as errMsg, en as reducePoints, hr as EventCategory, nn as resolveBucketMs, tr as createEvent } from "../../dist-BPvku43i.mjs";
+import { Ct as foldSnapshotByFunction, Gn as BaseAddon, Ut as metricsProviderCapability, Wn as errMsg, en as reducePoints, hr as EventCategory, nn as resolveBucketMs, tr as createEvent } from "../../dist-CQ9vXSUh.mjs";
 import { a as parseProcStat, i as nodeProcReader, n as elapsedSecSince, o as parseProcStatusRss, r as lifetimeCpuPercent, t as commandFromCmdline } from "../../proc-stat-CbC55Kqi.mjs";
 import { access, readFile, readdir } from "node:fs/promises";
 import * as fs from "node:fs";

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-RAl10EfG.js");
+const require_dist = require("../../dist-Dcy0gVHu.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,5 +1,5 @@
 import { o as __toESM } from "../../chunk-CNf5ZN-e.mjs";
-import { Gn as BaseAddon, Wn as errMsg, Zt as platformProbeCapability, cn as scoreRuntimes, hr as EventCategory, ht as enumerateInferenceDevices, rr as emitReadiness } from "../../dist-BPvku43i.mjs";
+import { Gn as BaseAddon, Wn as errMsg, Zt as platformProbeCapability, cn as scoreRuntimes, hr as EventCategory, ht as enumerateInferenceDevices, rr as emitReadiness } from "../../dist-CQ9vXSUh.mjs";
 import * as fs from "node:fs";
 import { execFile } from "node:child_process";
 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-RAl10EfG.js");
+const require_dist = require("../../dist-Dcy0gVHu.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 { Gn as BaseAddon, hr as EventCategory } from "../../dist-BPvku43i.mjs";
+import { Gn as BaseAddon, hr as EventCategory } from "../../dist-CQ9vXSUh.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-RAl10EfG.js");
+const require_dist = require("../../dist-Dcy0gVHu.js");
 const require_snapshot_courtesy = require("../../snapshot-courtesy-Cqs7GkOV.js");
 let zod = require("zod");
 let node_crypto = require("node:crypto");

package/dist/builtins/snapshot/index.mjs

@@ -1,4 +1,4 @@
-import { G as batteryCapability, Gn as BaseAddon, Un as DeviceType, Vn as DeviceFeature, W as bareAddonId, Wn as errMsg, _n as streamQualityLabel, a as BatteryStatusSchema, cr as nodePin, dn as snapshotCapability, hr as EventCategory, lt as deriveBatteryPresence } from "../../dist-BPvku43i.mjs";
+import { G as batteryCapability, Gn as BaseAddon, Un as DeviceType, Vn as DeviceFeature, W as bareAddonId, Wn as errMsg, _n as streamQualityLabel, a as BatteryStatusSchema, cr as nodePin, dn as snapshotCapability, hr as EventCategory, lt as deriveBatteryPresence } from "../../dist-CQ9vXSUh.mjs";
 import { i as renderCourtesyOverlayJpeg, n as courtesyCacheKey, r as renderCourtesyJpeg } from "../../snapshot-courtesy-CZPvteq2.mjs";
 import { z } from "zod";
 import { randomUUID } from "node:crypto";

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-RAl10EfG.js");
+const require_dist = require("../../dist-Dcy0gVHu.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 { Gn as BaseAddon, St as filesystemBrowseCapability, hn as storageProviderCapability } from "../../dist-BPvku43i.mjs";
+import { Gn as BaseAddon, St as filesystemBrowseCapability, hn as storageProviderCapability } from "../../dist-CQ9vXSUh.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/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-RAl10EfG.js");
+const require_dist = require("../../dist-Dcy0gVHu.js");
 const require_hub_cap_forward = require("../../hub-cap-forward-DmHNjbB0.js");
 let zod = require("zod");
 let node_crypto = require("node:crypto");

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

@@ -1,4 +1,4 @@
-import { Cn as withLocationMode, D as REDACTED_SECRET, F as StorageLocationTypeSchema, Gn as BaseAddon, Ht as mayWriteToLocation, I as StorageMigrationJobSchema, N as StorageCleanupJobSchema, Ot as isLocationEnabled, P as StorageLocationModeSchema, Pt as legacyModeOf, Tt as gbToBytes, Vt as mayReadLocation, Wt as modeMayWrite, Y as collectSecretConfigKeys, fn as storageCapability, hr as EventCategory, ln as settingsStoreCapability, lr as parseJsonObject, pn as storageMigrationCapability, rn as resolveLocationMode, x as LegacyStorageLocationDefaultSchema, yt as evictionPolicyOfLocation } from "../../dist-BPvku43i.mjs";
+import { Cn as withLocationMode, D as REDACTED_SECRET, F as StorageLocationTypeSchema, Gn as BaseAddon, Ht as mayWriteToLocation, I as StorageMigrationJobSchema, N as StorageCleanupJobSchema, Ot as isLocationEnabled, P as StorageLocationModeSchema, Pt as legacyModeOf, Tt as gbToBytes, Vt as mayReadLocation, Wt as modeMayWrite, Y as collectSecretConfigKeys, fn as storageCapability, hr as EventCategory, ln as settingsStoreCapability, lr as parseJsonObject, pn as storageMigrationCapability, rn as resolveLocationMode, x as LegacyStorageLocationDefaultSchema, yt as evictionPolicyOfLocation } from "../../dist-CQ9vXSUh.mjs";
 import { t as HUB_CAP_FWD_ACTION } from "../../hub-cap-forward-BdT320dq.mjs";
 import { z } from "zod";
 import { randomUUID } from "node:crypto";

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-RAl10EfG.js");
+const require_dist = require("../../dist-Dcy0gVHu.js");
 //#region src/builtins/system-config/system-config.addon.ts
 /**
 * Built-in `system-config` addon — Phase 4 of the settings redesign.
@@ -124,11 +124,11 @@ var SystemConfigAddon = class extends require_dist.BaseAddon {
 			const values = await this.ctx.settings.getSection(section);
 			Object.assign(merged, values);
 		} catch (err) {
-			const msg = require_dist.errMsg(err);
-			this.ctx.logger.debug("Failed to read section", { meta: {
+			this.ctx.logger.warn("system-config: a settings section could not be read", { meta: {
 				section,
-				error: msg
+				error: require_dist.errMsg(err)
 			} });
+			throw err;
 		}
 		return require_dist.hydrateSchema(schema, merged);
 	}

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

@@ -1,4 +1,4 @@
-import { Gn as BaseAddon, Wn as errMsg, ar as hydrateSchema } from "../../dist-BPvku43i.mjs";
+import { Gn as BaseAddon, Wn as errMsg, ar as hydrateSchema } from "../../dist-CQ9vXSUh.mjs";
 //#region src/builtins/system-config/system-config.addon.ts
 /**
 * Built-in `system-config` addon — Phase 4 of the settings redesign.
@@ -119,11 +119,11 @@ var SystemConfigAddon = class extends BaseAddon {
 			const values = await this.ctx.settings.getSection(section);
 			Object.assign(merged, values);
 		} catch (err) {
-			const msg = errMsg(err);
-			this.ctx.logger.debug("Failed to read section", { meta: {
+			this.ctx.logger.warn("system-config: a settings section could not be read", { meta: {
 				section,
-				error: msg
+				error: errMsg(err)
 			} });
+			throw err;
 		}
 		return hydrateSchema(schema, merged);
 	}

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-RAl10EfG.js");
+const require_dist = require("../../dist-Dcy0gVHu.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 { Gn as BaseAddon, Rt as logDestinationCapability } from "../../dist-BPvku43i.mjs";
+import { Gn as BaseAddon, Rt as logDestinationCapability } from "../../dist-CQ9vXSUh.mjs";
 import { t as formatLogLine } from "../../formatter-B7qW8bPJ.mjs";
 import * as path$1 from "node:path";
 import path from "node:path";

package/dist/{child-cap-dispatch-AAltfBUH.mjs → child-cap-dispatch-C2VINHu1.mjs}

@@ -719,23 +719,23 @@ function formatSocketPlane(window) {
 }
 //#endregion
 //#region src/kernel/moleculer/mesh-queue-report.ts
-function isRecord$1(value) {
+function isRecord$2(value) {
 	return typeof value === "object" && value !== null;
 }
 /** The shape `TcpWriter` keeps its sockets in. Anything else is not a mesh. */
 function writerSocketsOf(broker) {
-	if (!isRecord$1(broker)) return void 0;
+	if (!isRecord$2(broker)) return void 0;
 	const transit = broker["transit"];
-	if (!isRecord$1(transit)) return void 0;
+	if (!isRecord$2(transit)) return void 0;
 	const transporter = transit["tx"];
-	if (!isRecord$1(transporter)) return void 0;
+	if (!isRecord$2(transporter)) return void 0;
 	const writer = transporter["writer"];
-	if (!isRecord$1(writer)) return void 0;
+	if (!isRecord$2(writer)) return void 0;
 	const sockets = writer["sockets"];
 	return sockets instanceof Map ? sockets : void 0;
 }
 function readSocket(nodeId, socket) {
-	if (typeof nodeId !== "string" || !isRecord$1(socket)) return void 0;
+	if (typeof nodeId !== "string" || !isRecord$2(socket)) return void 0;
 	const queuedBytes = socket["writableLength"];
 	const bytesWritten = socket["bytesWritten"];
 	if (typeof queuedBytes !== "number" || typeof bytesWritten !== "number") return void 0;
@@ -3346,7 +3346,7 @@ async function resolveUncached(options) {
 }
 //#endregion
 //#region src/kernel/addon-class-resolver.ts
-function isRecord(value) {
+function isRecord$1(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 /**
@@ -3370,14 +3370,14 @@ function isRecord(value) {
 function isAddonConstructor(fn) {
 	if (typeof fn !== "function") return false;
 	const proto = fn.prototype;
-	if (!isRecord(proto)) return false;
+	if (!isRecord$1(proto)) return false;
 	return typeof proto["initialize"] === "function";
 }
 function resolveAddonClass(mod) {
 	let candidate = mod["default"];
-	if (isRecord(candidate) && "default" in candidate) candidate = candidate["default"];
+	if (isRecord$1(candidate) && "default" in candidate) candidate = candidate["default"];
 	if (isAddonConstructor(candidate)) return candidate;
-	if (isRecord(candidate)) {
+	if (isRecord$1(candidate)) {
 		const fn = Object.values(candidate).find(isAddonConstructor);
 		if (fn) return fn;
 	}
@@ -4418,6 +4418,51 @@ function createChildrenBatchLoader(opts) {
 	} };
 }
 //#endregion
+//#region src/kernel/moleculer/runtime-state-load.ts
+/** A device build refused because its runtime state could not be loaded. */
+var RuntimeStateLoadError = class extends Error {
+	deviceId;
+	constructor(deviceId, reason, options) {
+		super(`runtime state of device ${deviceId} could not be loaded (${reason}) — the device is not built from an empty state (D677)`, options);
+		this.deviceId = deviceId;
+		this.name = "RuntimeStateLoadError";
+	}
+};
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function errorMessage(err) {
+	return err instanceof Error ? err.message : String(err);
+}
+/**
+* Load the device's runtime state, or throw {@link RuntimeStateLoadError}
+* after one warn naming the device. An answer that is not an object is a
+* failed load too — it would hydrate as nothing.
+*/
+async function loadRuntimeStateOrRefuse(load, logger, target) {
+	const refuse = (reason, cause) => {
+		logger.warn("loadRuntimeState failed — device build refused, never hydrated from an empty state (D677)", {
+			tags: {
+				deviceId: target.deviceId,
+				stableId: target.stableId
+			},
+			meta: {
+				phase: target.phase,
+				error: reason
+			}
+		});
+		throw new RuntimeStateLoadError(target.deviceId, reason, cause === void 0 ? void 0 : { cause });
+	};
+	let answer;
+	try {
+		answer = await load();
+	} catch (err) {
+		return refuse(errorMessage(err), err);
+	}
+	if (!isRecord(answer)) return refuse(`answered ${answer === null ? "null" : typeof answer}`);
+	return answer;
+}
+//#endregion
 //#region src/kernel/moleculer/device-cap-proxy.ts
 /**
 * Max number of accessory children spawned concurrently during a single
@@ -4697,6 +4742,12 @@ function createBrokerDeviceManagerApi(opts) {
 		}
 	});
 	const deviceRebuildFactories = /* @__PURE__ */ new Map();
+	/** `loadRuntimeState` that refuses the build instead of answering `{}` (D677). */
+	const loadRuntimeStateFor = (deviceId, stableId, phase) => loadRuntimeStateOrRefuse(() => callDeviceManager(api, "loadRuntimeState", { deviceId }), opts.logger, {
+		deviceId,
+		stableId,
+		phase
+	});
 	const buildContext = (stableId, id, parentDeviceId = null, initialRuntimeState = {}, persistedConfig = {}, deviceMeta = null) => {
 		let runtimeStateRef = null;
 		return {
@@ -4913,7 +4964,7 @@ function createBrokerDeviceManagerApi(opts) {
 			data: spec.config
 		}).catch(() => {});
 		const [initialRuntimeState, loadedConfig, deviceMeta] = await Promise.all([
-			callDeviceManager(api, "loadRuntimeState", { deviceId: id }).catch(() => empty),
+			loadRuntimeStateFor(id, childStableId, "accessory-child"),
 			callDeviceManager(api, "loadConfig", { deviceId: id }).catch(() => empty),
 			callDeviceManager(api, "loadMeta", { deviceId: id }).catch(() => null)
 		]);
@@ -4929,8 +4980,8 @@ function createBrokerDeviceManagerApi(opts) {
 		const child = spec.factory(childCtx);
 		await deviceApi.register(child);
 		deviceRebuildFactories.set(id, async (mergedConfig) => {
-			const [rt, meta] = await Promise.all([callDeviceManager(api, "loadRuntimeState", { deviceId: id }).catch(() => ({})), callDeviceManager(api, "loadMeta", { deviceId: id }).catch(() => null)]);
-			return spec.factory(buildContext(childStableId, id, parent.id, rt, mergedConfig, meta));
+			const [rt, meta] = await Promise.all([loadRuntimeStateFor(id, childStableId, "rebuild"), callDeviceManager(api, "loadMeta", { deviceId: id }).catch(() => null)]);
+			return () => spec.factory(buildContext(childStableId, id, parent.id, rt, mergedConfig, meta));
 		});
 		return child;
 	};
@@ -5056,19 +5107,20 @@ function createBrokerDeviceManagerApi(opts) {
 			});
 			const empty = {};
 			const [initialRuntimeState, persistedConfig, deviceMeta] = await Promise.all([
-				callDeviceManager(api, "loadRuntimeState", { deviceId: id }).catch(() => empty),
+				loadRuntimeStateFor(id, stableId, "create"),
 				callDeviceManager(api, "loadConfig", { deviceId: id }).catch(() => empty),
 				callDeviceManager(api, "loadMeta", { deviceId: id }).catch(() => null)
 			]);
 			const device = new DeviceClass(buildContext(stableId, id, parentDeviceId, initialRuntimeState, persistedConfig, deviceMeta));
 			await deviceApi.register(device);
 			deviceRebuildFactories.set(id, async (mergedConfig) => {
-				const [rt, meta] = await Promise.all([callDeviceManager(api, "loadRuntimeState", { deviceId: id }).catch(() => ({})), callDeviceManager(api, "loadMeta", { deviceId: id }).catch(() => null)]);
-				return new DeviceClass(buildContext(stableId, id, parentDeviceId, rt, mergedConfig, meta));
+				const [rt, meta] = await Promise.all([loadRuntimeStateFor(id, stableId, "rebuild"), callDeviceManager(api, "loadMeta", { deviceId: id }).catch(() => null)]);
+				return () => new DeviceClass(buildContext(stableId, id, parentDeviceId, rt, mergedConfig, meta));
 			});
 			return device;
 		},
 		createContext: (stableId, id, parentDeviceId = null, persistedConfig = {}) => buildContext(stableId, id, parentDeviceId, {}, persistedConfig),
+		loadContext: async (stableId, id, parentDeviceId = null, persistedConfig = {}) => buildContext(stableId, id, parentDeviceId, await loadRuntimeStateFor(id, stableId, "context"), persistedConfig),
 		loadConfig: async (deviceId) => {
 			const empty = {};
 			return callDeviceManager(api, "loadConfig", { deviceId }).catch(() => empty);
@@ -5446,9 +5498,9 @@ function createBrokerDeviceManagerApi(opts) {
 			});
 			const rebuild = deviceRebuildFactories.get(deviceId);
 			if (!rebuild) return;
+			const construct = await rebuild(merged);
 			await deviceApi.decommission(deviceId);
-			const fresh = await rebuild(merged);
-			await deviceApi.register(fresh);
+			await deviceApi.register(construct());
 		},
 		remove: async (deviceId) => {
 			deviceRebuildFactories.delete(deviceId);

package/dist/{child-cap-dispatch-DzcUd_ct.js → child-cap-dispatch-C8uts1P4.js}

@@ -722,23 +722,23 @@ function formatSocketPlane(window) {
 }
 //#endregion
 //#region src/kernel/moleculer/mesh-queue-report.ts
-function isRecord$1(value) {
+function isRecord$2(value) {
 	return typeof value === "object" && value !== null;
 }
 /** The shape `TcpWriter` keeps its sockets in. Anything else is not a mesh. */
 function writerSocketsOf(broker) {
-	if (!isRecord$1(broker)) return void 0;
+	if (!isRecord$2(broker)) return void 0;
 	const transit = broker["transit"];
-	if (!isRecord$1(transit)) return void 0;
+	if (!isRecord$2(transit)) return void 0;
 	const transporter = transit["tx"];
-	if (!isRecord$1(transporter)) return void 0;
+	if (!isRecord$2(transporter)) return void 0;
 	const writer = transporter["writer"];
-	if (!isRecord$1(writer)) return void 0;
+	if (!isRecord$2(writer)) return void 0;
 	const sockets = writer["sockets"];
 	return sockets instanceof Map ? sockets : void 0;
 }
 function readSocket(nodeId, socket) {
-	if (typeof nodeId !== "string" || !isRecord$1(socket)) return void 0;
+	if (typeof nodeId !== "string" || !isRecord$2(socket)) return void 0;
 	const queuedBytes = socket["writableLength"];
 	const bytesWritten = socket["bytesWritten"];
 	if (typeof queuedBytes !== "number" || typeof bytesWritten !== "number") return void 0;
@@ -3349,7 +3349,7 @@ async function resolveUncached(options) {
 }
 //#endregion
 //#region src/kernel/addon-class-resolver.ts
-function isRecord(value) {
+function isRecord$1(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 /**
@@ -3373,14 +3373,14 @@ function isRecord(value) {
 function isAddonConstructor(fn) {
 	if (typeof fn !== "function") return false;
 	const proto = fn.prototype;
-	if (!isRecord(proto)) return false;
+	if (!isRecord$1(proto)) return false;
 	return typeof proto["initialize"] === "function";
 }
 function resolveAddonClass(mod) {
 	let candidate = mod["default"];
-	if (isRecord(candidate) && "default" in candidate) candidate = candidate["default"];
+	if (isRecord$1(candidate) && "default" in candidate) candidate = candidate["default"];
 	if (isAddonConstructor(candidate)) return candidate;
-	if (isRecord(candidate)) {
+	if (isRecord$1(candidate)) {
 		const fn = Object.values(candidate).find(isAddonConstructor);
 		if (fn) return fn;
 	}
@@ -4421,6 +4421,51 @@ function createChildrenBatchLoader(opts) {
 	} };
 }
 //#endregion
+//#region src/kernel/moleculer/runtime-state-load.ts
+/** A device build refused because its runtime state could not be loaded. */
+var RuntimeStateLoadError = class extends Error {
+	deviceId;
+	constructor(deviceId, reason, options) {
+		super(`runtime state of device ${deviceId} could not be loaded (${reason}) — the device is not built from an empty state (D677)`, options);
+		this.deviceId = deviceId;
+		this.name = "RuntimeStateLoadError";
+	}
+};
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function errorMessage(err) {
+	return err instanceof Error ? err.message : String(err);
+}
+/**
+* Load the device's runtime state, or throw {@link RuntimeStateLoadError}
+* after one warn naming the device. An answer that is not an object is a
+* failed load too — it would hydrate as nothing.
+*/
+async function loadRuntimeStateOrRefuse(load, logger, target) {
+	const refuse = (reason, cause) => {
+		logger.warn("loadRuntimeState failed — device build refused, never hydrated from an empty state (D677)", {
+			tags: {
+				deviceId: target.deviceId,
+				stableId: target.stableId
+			},
+			meta: {
+				phase: target.phase,
+				error: reason
+			}
+		});
+		throw new RuntimeStateLoadError(target.deviceId, reason, cause === void 0 ? void 0 : { cause });
+	};
+	let answer;
+	try {
+		answer = await load();
+	} catch (err) {
+		return refuse(errorMessage(err), err);
+	}
+	if (!isRecord(answer)) return refuse(`answered ${answer === null ? "null" : typeof answer}`);
+	return answer;
+}
+//#endregion
 //#region src/kernel/moleculer/device-cap-proxy.ts
 /**
 * Max number of accessory children spawned concurrently during a single
@@ -4700,6 +4745,12 @@ function createBrokerDeviceManagerApi(opts) {
 		}
 	});
 	const deviceRebuildFactories = /* @__PURE__ */ new Map();
+	/** `loadRuntimeState` that refuses the build instead of answering `{}` (D677). */
+	const loadRuntimeStateFor = (deviceId, stableId, phase) => loadRuntimeStateOrRefuse(() => callDeviceManager(api, "loadRuntimeState", { deviceId }), opts.logger, {
+		deviceId,
+		stableId,
+		phase
+	});
 	const buildContext = (stableId, id, parentDeviceId = null, initialRuntimeState = {}, persistedConfig = {}, deviceMeta = null) => {
 		let runtimeStateRef = null;
 		return {
@@ -4916,7 +4967,7 @@ function createBrokerDeviceManagerApi(opts) {
 			data: spec.config
 		}).catch(() => {});
 		const [initialRuntimeState, loadedConfig, deviceMeta] = await Promise.all([
-			callDeviceManager(api, "loadRuntimeState", { deviceId: id }).catch(() => empty),
+			loadRuntimeStateFor(id, childStableId, "accessory-child"),
 			callDeviceManager(api, "loadConfig", { deviceId: id }).catch(() => empty),
 			callDeviceManager(api, "loadMeta", { deviceId: id }).catch(() => null)
 		]);
@@ -4932,8 +4983,8 @@ function createBrokerDeviceManagerApi(opts) {
 		const child = spec.factory(childCtx);
 		await deviceApi.register(child);
 		deviceRebuildFactories.set(id, async (mergedConfig) => {
-			const [rt, meta] = await Promise.all([callDeviceManager(api, "loadRuntimeState", { deviceId: id }).catch(() => ({})), callDeviceManager(api, "loadMeta", { deviceId: id }).catch(() => null)]);
-			return spec.factory(buildContext(childStableId, id, parent.id, rt, mergedConfig, meta));
+			const [rt, meta] = await Promise.all([loadRuntimeStateFor(id, childStableId, "rebuild"), callDeviceManager(api, "loadMeta", { deviceId: id }).catch(() => null)]);
+			return () => spec.factory(buildContext(childStableId, id, parent.id, rt, mergedConfig, meta));
 		});
 		return child;
 	};
@@ -5059,19 +5110,20 @@ function createBrokerDeviceManagerApi(opts) {
 			});
 			const empty = {};
 			const [initialRuntimeState, persistedConfig, deviceMeta] = await Promise.all([
-				callDeviceManager(api, "loadRuntimeState", { deviceId: id }).catch(() => empty),
+				loadRuntimeStateFor(id, stableId, "create"),
 				callDeviceManager(api, "loadConfig", { deviceId: id }).catch(() => empty),
 				callDeviceManager(api, "loadMeta", { deviceId: id }).catch(() => null)
 			]);
 			const device = new DeviceClass(buildContext(stableId, id, parentDeviceId, initialRuntimeState, persistedConfig, deviceMeta));
 			await deviceApi.register(device);
 			deviceRebuildFactories.set(id, async (mergedConfig) => {
-				const [rt, meta] = await Promise.all([callDeviceManager(api, "loadRuntimeState", { deviceId: id }).catch(() => ({})), callDeviceManager(api, "loadMeta", { deviceId: id }).catch(() => null)]);
-				return new DeviceClass(buildContext(stableId, id, parentDeviceId, rt, mergedConfig, meta));
+				const [rt, meta] = await Promise.all([loadRuntimeStateFor(id, stableId, "rebuild"), callDeviceManager(api, "loadMeta", { deviceId: id }).catch(() => null)]);
+				return () => new DeviceClass(buildContext(stableId, id, parentDeviceId, rt, mergedConfig, meta));
 			});
 			return device;
 		},
 		createContext: (stableId, id, parentDeviceId = null, persistedConfig = {}) => buildContext(stableId, id, parentDeviceId, {}, persistedConfig),
+		loadContext: async (stableId, id, parentDeviceId = null, persistedConfig = {}) => buildContext(stableId, id, parentDeviceId, await loadRuntimeStateFor(id, stableId, "context"), persistedConfig),
 		loadConfig: async (deviceId) => {
 			const empty = {};
 			return callDeviceManager(api, "loadConfig", { deviceId }).catch(() => empty);
@@ -5449,9 +5501,9 @@ function createBrokerDeviceManagerApi(opts) {
 			});
 			const rebuild = deviceRebuildFactories.get(deviceId);
 			if (!rebuild) return;
+			const construct = await rebuild(merged);
 			await deviceApi.decommission(deviceId);
-			const fresh = await rebuild(merged);
-			await deviceApi.register(fresh);
+			await deviceApi.register(construct());
 		},
 		remove: async (deviceId) => {
 			deviceRebuildFactories.delete(deviceId);

package/dist/{composition-sources-BwE1POnF.js → composition-sources-BjRPhWtU.js}

@@ -1,4 +1,4 @@
-const require_dist = require("./dist-RAl10EfG.js");
+const require_dist = require("./dist-Dcy0gVHu.js");
 //#region src/builtins/core-blocks/composition-sources.ts
 /**
 * Describe what a composition reads and writes for SAVE-time validation

package/dist/{composition-sources-fUyF4z39.mjs → composition-sources-Cg2MP-qf.mjs}

@@ -1,4 +1,4 @@
-import { In as compositionSourceKey, Wn as errMsg } from "./dist-BPvku43i.mjs";
+import { In as compositionSourceKey, Wn as errMsg } from "./dist-CQ9vXSUh.mjs";
 //#region src/builtins/core-blocks/composition-sources.ts
 /**
 * Describe what a composition reads and writes for SAVE-time validation