@camstack/system 1.2.485 → 1.2.486

package/dist/{agent-https-_EXvi6F8.mjs → agent-https-C4PLR74Z.mjs}

@@ -1,4 +1,4 @@
-import { Ji as defineRecordKinds } from "./dist-Df6c0RX_.mjs";
+import { Ji as defineRecordKinds } from "./dist-HBue971z.mjs";
 import { C as backdatedNotBefore, S as withUtcTimeEncoding, _ as NameConstraints, a as KeyUsageFlags, c as Pkcs10CertificateRequest, d as SubjectKeyIdentifierExtension, f as X509Certificate$1, g as GeneralSubtrees, h as GeneralSubtree, i as Extension, l as Pkcs10CertificateRequestGenerator, m as cryptoProvider, n as BasicConstraintsExtension, o as KeyUsagesExtension, p as X509CertificateGenerator, r as ExtendedKeyUsageExtension, s as PemConverter, t as AuthorityKeyIdentifierExtension, u as SubjectAlternativeNameExtension, v as GeneralName, x as AsnConvert } from "./x509.es-BRiJgOvu.mjs";
 import { z } from "zod";
 import { X509Certificate, createHash, createPrivateKey, randomBytes, webcrypto } from "node:crypto";

package/dist/{agent-https-DBP7P-ee.js → agent-https-DP-Ds2hU.js}

@@ -1,5 +1,5 @@
 const require_chunk = require("./chunk-Cek0wNdY.js");
-const require_dist = require("./dist-xCNJAQMh.js");
+const require_dist = require("./dist-D-d_UWL4.js");
 const require_x509_es = require("./x509.es-WtnRNyYS.js");
 let zod = require("zod");
 let node_crypto = require("node:crypto");

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-xCNJAQMh.js");
+const require_dist = require("../../dist-D-d_UWL4.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 { _t as addonPagesCapability, ja as EventCategory, ni as BaseAddon, ti as errMsg } from "../../dist-Df6c0RX_.mjs";
+import { _t as addonPagesCapability, ja as EventCategory, ni as BaseAddon, ti as errMsg } from "../../dist-HBue971z.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-xCNJAQMh.js");
+const require_dist = require("../../dist-D-d_UWL4.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 { ja as EventCategory, ni as BaseAddon, ti as errMsg, yt as addonWidgetsCapability } from "../../dist-Df6c0RX_.mjs";
+import { ja as EventCategory, ni as BaseAddon, ti as errMsg, yt as addonWidgetsCapability } from "../../dist-HBue971z.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-xCNJAQMh.js");
+const require_dist = require("../../dist-D-d_UWL4.js");
 const require_read_all_rows$1 = require("../../read-all-rows-CVoO1ONM.js");
 //#region src/builtins/alerts/alert-episode-policy.ts
 /**

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

@@ -1,4 +1,4 @@
-import { Gi as createEvent, Ji as defineRecordKinds, St as alertsCapability, bn as isAlertEpisodeSeverity, bt as alertEpisodeId, i as AlertSchema, ja as EventCategory, ni as BaseAddon, ti as errMsg, xt as alertEpisodePayload, yn as isAlertEpisodeOpen } from "../../dist-Df6c0RX_.mjs";
+import { Gi as createEvent, Ji as defineRecordKinds, St as alertsCapability, bn as isAlertEpisodeSeverity, bt as alertEpisodeId, i as AlertSchema, ja as EventCategory, ni as BaseAddon, ti as errMsg, xt as alertEpisodePayload, yn as isAlertEpisodeOpen } from "../../dist-HBue971z.mjs";
 import { t as require_read_all_rows } from "../../read-all-rows-TaPqdWNF.mjs";
 //#region src/builtins/alerts/alert-episode-policy.ts
 /**

package/dist/builtins/autotrack/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-xCNJAQMh.js");
+const require_dist = require("../../dist-D-d_UWL4.js");
 //#region src/builtins/autotrack/autotrack-config.ts
 var DEFAULT_AUTOTRACK_LOOP_CONFIG = {
 	deadZoneFraction: .5,

package/dist/builtins/autotrack/index.mjs

@@ -1,4 +1,4 @@
-import { Et as bareAddonId, I as FIRST_LEVEL_MACRO_CLASSES, ja as EventCategory, ni as BaseAddon, ra as isEvent, rr as ptzAutotrackCapability, ti as errMsg } from "../../dist-Df6c0RX_.mjs";
+import { Et as bareAddonId, I as FIRST_LEVEL_MACRO_CLASSES, ja as EventCategory, ni as BaseAddon, ra as isEvent, rr as ptzAutotrackCapability, ti as errMsg } from "../../dist-HBue971z.mjs";
 //#region src/builtins/autotrack/autotrack-config.ts
 var DEFAULT_AUTOTRACK_LOOP_CONFIG = {
 	deadZoneFraction: .5,

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

@@ -3,9 +3,9 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-xCNJAQMh.js");
+const require_dist = require("../../dist-D-d_UWL4.js");
 const require_read_all_rows$1 = require("../../read-all-rows-CVoO1ONM.js");
-const require_restore_archive = require("../../restore-archive-DA7N6ZZA.js");
+const require_restore_archive = require("../../restore-archive-DHdXrKwG.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/backup-orchestrator/backup-orchestrator.addon.mjs

@@ -1,6 +1,6 @@
-import { Ea as toNodeId, Or as storageOccupancyCapability, Tt as backupCapability, Vn as mayWriteToLocation, fa as nodePin, ja as EventCategory, ni as BaseAddon } from "../../dist-Df6c0RX_.mjs";
+import { Ea as toNodeId, Or as storageOccupancyCapability, Tt as backupCapability, Vn as mayWriteToLocation, fa as nodePin, ja as EventCategory, ni as BaseAddon } from "../../dist-HBue971z.mjs";
 import { t as require_read_all_rows } from "../../read-all-rows-TaPqdWNF.mjs";
-import { _ as backupRecordStoresOf, a as BackupSnapshotRefusedError, d as ENCRYPTED_BACKUP_SUFFIX, f as generateBackupKeyPair, g as backupOrchestratorRecordKinds, i as BackupCancelledError, l as BackupKeyFormatError, m as parseBackupSecretKey, n as precheckRestoreKey, o as DEFAULT_BACKUP_DATABASES, p as parseBackupPublicKey, r as prepareRestoreArchive, s as SystemBackupService } from "../../restore-archive-Co70oRya.mjs";
+import { _ as backupRecordStoresOf, a as BackupSnapshotRefusedError, d as ENCRYPTED_BACKUP_SUFFIX, f as generateBackupKeyPair, g as backupOrchestratorRecordKinds, i as BackupCancelledError, l as BackupKeyFormatError, m as parseBackupSecretKey, n as precheckRestoreKey, o as DEFAULT_BACKUP_DATABASES, p as parseBackupPublicKey, r as prepareRestoreArchive, s as SystemBackupService } from "../../restore-archive-BGBRadFJ.mjs";
 import { randomUUID } from "node:crypto";
 import * as fsp from "node:fs/promises";
 import * as path$1 from "node:path";

package/dist/builtins/calendars/calendars.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-xCNJAQMh.js");
+const require_dist = require("../../dist-D-d_UWL4.js");
 const require_settle_sources = require("../../settle-sources-Bhsy57y-.js");
 let zod = require("zod");
 //#region src/builtins/calendars/calendar-color.ts

package/dist/builtins/calendars/calendars.addon.mjs

@@ -1,4 +1,4 @@
-import { Ji as defineRecordKinds, Mt as calendarsCapability, g as CalendarPreferencesSchema, ni as BaseAddon } from "../../dist-Df6c0RX_.mjs";
+import { Ji as defineRecordKinds, Mt as calendarsCapability, g as CalendarPreferencesSchema, ni as BaseAddon } from "../../dist-HBue971z.mjs";
 import { t as settleSourcesWithTimeout } from "../../settle-sources-CDtNC8ub.mjs";
 import { z } from "zod";
 //#region src/builtins/calendars/calendar-color.ts

package/dist/builtins/camera-grid/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-xCNJAQMh.js");
+const require_dist = require("../../dist-D-d_UWL4.js");
 let zod = require("zod");
 let _camstack_types_node = require("@camstack/types/node");
 let node_path = require("node:path");

package/dist/builtins/camera-grid/index.mjs

@@ -1,4 +1,4 @@
-import { Ar as streamCatalogCapability, Cr as snapshotCapability, Gi as createEvent, Gn as motionCapability, Hn as memoizePinnedFfmpeg, N as DeclaredDevices, Nt as cameraGridLayoutCapability, Qr as DeviceFeature, T as DERIVED_CAMERA_SILENCED_CAP_NAMES, Vr as buildFfmpegArgs, X as MOTION_CLOSE_AFTER_MS, a as BaseDevice, ei as DeviceType, ja as EventCategory, ni as BaseAddon, qt as declarationOwnerNodeId, ta as hydrateSchema, ti as errMsg } from "../../dist-Df6c0RX_.mjs";
+import { Ar as streamCatalogCapability, Cr as snapshotCapability, Gi as createEvent, Gn as motionCapability, Hn as memoizePinnedFfmpeg, N as DeclaredDevices, Nt as cameraGridLayoutCapability, Qr as DeviceFeature, T as DERIVED_CAMERA_SILENCED_CAP_NAMES, Vr as buildFfmpegArgs, X as MOTION_CLOSE_AFTER_MS, a as BaseDevice, ei as DeviceType, ja as EventCategory, ni as BaseAddon, qt as declarationOwnerNodeId, ta as hydrateSchema, ti as errMsg } from "../../dist-HBue971z.mjs";
 import { z } from "zod";
 import { FfmpegProcess } from "@camstack/types/node";
 import { join } from "node:path";

package/dist/builtins/composer/composer.addon.js

@@ -3,22 +3,22 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-xCNJAQMh.js");
-const require_composition_sources = require("../../composition-sources-BSQneZV9.js");
-const require_retention = require("../../retention-DNDOPW7Z.js");
+const require_dist = require("../../dist-D-d_UWL4.js");
+const require_composition_sources = require("../../composition-sources-CN8K2Q91.js");
+const require_retention = require("../../retention-ChgrkTfz.js");
 let zod = require("zod");
 //#region src/builtins/shared/device-state-changed.ts
 /** Structural narrowing helper for untrusted bus payloads. */
-function isRecord$2(value) {
+function isRecord$3(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function parseDeviceStateChanged(data) {
-	if (!isRecord$2(data)) return null;
+	if (!isRecord$3(data)) return null;
 	const deviceId = data["deviceId"];
 	const capName = data["capName"];
 	const slice = data["slice"];
 	if (typeof deviceId !== "number" || typeof capName !== "string") return null;
-	if (!isRecord$2(slice)) return null;
+	if (!isRecord$3(slice)) return null;
 	return {
 		deviceId,
 		capName,
@@ -50,11 +50,29 @@ function parseDeviceStateChanged(data) {
 * declaration is the authority for what this device is.
 */
 var COMPOSED_DEVICE_CONFIG_SCHEMA = zod.z.object({});
+function isRecord$2(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/** Unknown is a throw, never `false` (D393). */
+function sliceBoolean(slice, field) {
+	if (isRecord$2(slice)) {
+		const value = slice[field];
+		if (typeof value === "boolean") return value;
+	}
+	throw new Error(`composed ${field} is unknown — not a stand-in value`);
+}
 var ComposedDevice = class extends require_dist.BaseDevice {
 	features = [];
 	constructor(ctx, type, caps) {
 		super(ctx, COMPOSED_DEVICE_CONFIG_SCHEMA, { type });
-		for (const cap of caps) ctx.registerNativeCap(cap, {});
+		for (const cap of caps) {
+			if (cap.name === require_dist.motionCapability.name) {
+				const read = () => this.runtimeState.getCapState(require_dist.motionCapability.name);
+				ctx.registerNativeCap(require_dist.motionCapability, { isDetected: async () => sliceBoolean(read(), "detected") });
+				continue;
+			}
+			ctx.registerNativeCap(cap, {});
+		}
 		this.markOnline(false);
 	}
 	seed(capName, slice) {
@@ -1295,7 +1313,9 @@ function writable(record) {
 	switch (record.plan.unavailable) {
 		case "null": return null;
 		case "unknown": return "unknown";
-		default: return;
+		case "omit":
+		case "offline":
+		case "release": return;
 	}
 }
 function errorText(error) {
@@ -2018,7 +2038,16 @@ var CompositionRuntime = class {
 		this.seeded = new Set([...this.seeded, cap]);
 		this.markWritten(cap, entries);
 	}
+	/** An omitted optional reading must leave the slice, not keep the previous number (D944). */
+	clearsOmitted(cap) {
+		return this.recordsOf(cap).some((record) => record.plan.unavailable === "omit" && record.outcome?.state === "unavailable");
+	}
 	patchCap(cap, touched) {
+		if (this.clearsOmitted(cap)) {
+			const entries = this.entriesFor(cap, this.recordsOf(cap));
+			if (this.write(cap, "seed", entries)) this.markWritten(cap, entries);
+			return;
+		}
 		const entries = this.entriesFor(cap, this.recordsOf(cap).filter((r) => touched.has(fieldKey(r.plan)) && (!r.hasWritten || writable(r) !== r.written)));
 		if (entries.length === 0) return;
 		if (this.write(cap, "patch", entries)) this.markWritten(cap, entries);
@@ -3746,8 +3775,21 @@ var NodeDeadlineTimer = class {
 function unanswered(def) {
 	return Object.entries(def.methods).filter(([name, m]) => m.systemOnly !== true && def.composedMethods?.[name] === void 0).map(([name]) => name);
 }
-function composedMethod(answer) {
+function isSliceRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/** A slice field that is present. Unknown throws — it is not false or 0 (D393). */
+function sliceField(slice, field) {
+	const value = slice?.[field];
+	if (typeof value === "boolean" || typeof value === "number" || typeof value === "string") return value;
+	throw new Error(`composed ${field} is unknown — not a stand-in value`);
+}
+function composedMethod(answer, readSlice) {
 	if (answer.kind === "answer") return async () => answer.value;
+	if (answer.kind === "slice") {
+		const field = answer.field;
+		return async () => sliceField(await readSlice(), field);
+	}
 	return async () => {
 		throw new Error(answer.reason);
 	};
@@ -3865,7 +3907,11 @@ var GraftHost = class {
 		return ctx;
 	}
 	providerFor(deviceId, def) {
-		const answers = Object.entries(def.composedMethods ?? {}).map(([name, answer]) => [name, composedMethod(answer)]);
+		const readSlice = async () => {
+			const slice = await this.readMerged(deviceId, def.name);
+			return isSliceRecord(slice) ? slice : null;
+		};
+		const answers = Object.entries(def.composedMethods ?? {}).map(([name, answer]) => [name, composedMethod(answer, readSlice)]);
 		const withStatus = def.status === void 0 && def.runtimeState === void 0 ? [] : [["getStatus", async () => this.readMerged(deviceId, def.name)]];
 		return Object.fromEntries([...answers, ...withStatus]);
 	}
@@ -3942,7 +3988,7 @@ function entriesOf(request) {
 	}))];
 }
 function valueAtPath(slice, path) {
-	return path.split(".").reduce((node, segment) => isRecord$2(node) ? node[segment] : void 0, slice);
+	return path.split(".").reduce((node, segment) => isRecord$3(node) ? node[segment] : void 0, slice);
 }
 function onlineOf(slice) {
 	const online = slice["online"];
@@ -4609,12 +4655,12 @@ var DECLARED_INTEGRATION_NAME_UNUSED = "Blocks";
 var PULSE_HISTORY_MAX_POINTS = 5e3;
 /** The owner-only shadow payload is not in the typed catalog: narrowed at the boundary, like `device.state-changed`. */
 function parseNativeShadowChanged(data) {
-	if (!isRecord$2(data)) return null;
+	if (!isRecord$3(data)) return null;
 	const deviceId = data["deviceId"];
 	const capName = data["capName"];
 	const native = data["native"];
 	if (typeof deviceId !== "number" || typeof capName !== "string") return null;
-	if (!isRecord$2(native)) return null;
+	if (!isRecord$3(native)) return null;
 	return {
 		deviceId,
 		capName,

package/dist/builtins/composer/composer.addon.mjs

@@ -1,19 +1,19 @@
-import { $n as planComposition, Br as COMPOSER_ADDON_ID, Gi as createEvent, Gr as compositionFeatureEnabled, Hr as cloneStatefulExpressionMemory, It as composerCapability, Jr as compositionSourceKey, Kr as compositionItemFieldPath, Lt as compositionFieldKey, N as DeclaredDevices, Ot as buildCapabilityLookup, Ur as composedDeviceRef, Wr as composedDeviceStableId, Xr as disarmRoseMemory, Yr as createStatefulExpressionMemory, Zr as toExpressionValue, a as BaseDevice, cn as evaluateCompositionField, d as COMPOSED_ITEM_FIXED_FIELDS, dn as expressionContainsBuiltinCall, ei as DeviceType, ja as EventCategory, ni as BaseAddon, qr as compositionSliceKey, r as ALL_CAPABILITY_DEFINITIONS, ti as errMsg } from "../../dist-Df6c0RX_.mjs";
-import { n as normalizedNativeOwner } from "../../composition-sources-BnZpIA8u.mjs";
-import { i as DAY_MS, m as capSeriesKey, t as DEFAULT_RETENTION } from "../../retention-DfCW-dZS.mjs";
+import { $n as planComposition, Br as COMPOSER_ADDON_ID, Gi as createEvent, Gn as motionCapability, Gr as compositionFeatureEnabled, Hr as cloneStatefulExpressionMemory, It as composerCapability, Jr as compositionSourceKey, Kr as compositionItemFieldPath, Lt as compositionFieldKey, N as DeclaredDevices, Ot as buildCapabilityLookup, Ur as composedDeviceRef, Wr as composedDeviceStableId, Xr as disarmRoseMemory, Yr as createStatefulExpressionMemory, Zr as toExpressionValue, a as BaseDevice, cn as evaluateCompositionField, d as COMPOSED_ITEM_FIXED_FIELDS, dn as expressionContainsBuiltinCall, ei as DeviceType, ja as EventCategory, ni as BaseAddon, qr as compositionSliceKey, r as ALL_CAPABILITY_DEFINITIONS, ti as errMsg } from "../../dist-HBue971z.mjs";
+import { n as normalizedNativeOwner } from "../../composition-sources-IxiUkrz1.mjs";
+import { i as DAY_MS, m as capSeriesKey, t as DEFAULT_RETENTION } from "../../retention-8uqDWll8.mjs";
 import { z } from "zod";
 //#region src/builtins/shared/device-state-changed.ts
 /** Structural narrowing helper for untrusted bus payloads. */
-function isRecord$2(value) {
+function isRecord$3(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function parseDeviceStateChanged(data) {
-	if (!isRecord$2(data)) return null;
+	if (!isRecord$3(data)) return null;
 	const deviceId = data["deviceId"];
 	const capName = data["capName"];
 	const slice = data["slice"];
 	if (typeof deviceId !== "number" || typeof capName !== "string") return null;
-	if (!isRecord$2(slice)) return null;
+	if (!isRecord$3(slice)) return null;
 	return {
 		deviceId,
 		capName,
@@ -45,11 +45,29 @@ function parseDeviceStateChanged(data) {
 * declaration is the authority for what this device is.
 */
 var COMPOSED_DEVICE_CONFIG_SCHEMA = z.object({});
+function isRecord$2(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/** Unknown is a throw, never `false` (D393). */
+function sliceBoolean(slice, field) {
+	if (isRecord$2(slice)) {
+		const value = slice[field];
+		if (typeof value === "boolean") return value;
+	}
+	throw new Error(`composed ${field} is unknown — not a stand-in value`);
+}
 var ComposedDevice = class extends BaseDevice {
 	features = [];
 	constructor(ctx, type, caps) {
 		super(ctx, COMPOSED_DEVICE_CONFIG_SCHEMA, { type });
-		for (const cap of caps) ctx.registerNativeCap(cap, {});
+		for (const cap of caps) {
+			if (cap.name === motionCapability.name) {
+				const read = () => this.runtimeState.getCapState(motionCapability.name);
+				ctx.registerNativeCap(motionCapability, { isDetected: async () => sliceBoolean(read(), "detected") });
+				continue;
+			}
+			ctx.registerNativeCap(cap, {});
+		}
 		this.markOnline(false);
 	}
 	seed(capName, slice) {
@@ -1290,7 +1308,9 @@ function writable(record) {
 	switch (record.plan.unavailable) {
 		case "null": return null;
 		case "unknown": return "unknown";
-		default: return;
+		case "omit":
+		case "offline":
+		case "release": return;
 	}
 }
 function errorText(error) {
@@ -2013,7 +2033,16 @@ var CompositionRuntime = class {
 		this.seeded = new Set([...this.seeded, cap]);
 		this.markWritten(cap, entries);
 	}
+	/** An omitted optional reading must leave the slice, not keep the previous number (D944). */
+	clearsOmitted(cap) {
+		return this.recordsOf(cap).some((record) => record.plan.unavailable === "omit" && record.outcome?.state === "unavailable");
+	}
 	patchCap(cap, touched) {
+		if (this.clearsOmitted(cap)) {
+			const entries = this.entriesFor(cap, this.recordsOf(cap));
+			if (this.write(cap, "seed", entries)) this.markWritten(cap, entries);
+			return;
+		}
 		const entries = this.entriesFor(cap, this.recordsOf(cap).filter((r) => touched.has(fieldKey(r.plan)) && (!r.hasWritten || writable(r) !== r.written)));
 		if (entries.length === 0) return;
 		if (this.write(cap, "patch", entries)) this.markWritten(cap, entries);
@@ -3741,8 +3770,21 @@ var NodeDeadlineTimer = class {
 function unanswered(def) {
 	return Object.entries(def.methods).filter(([name, m]) => m.systemOnly !== true && def.composedMethods?.[name] === void 0).map(([name]) => name);
 }
-function composedMethod(answer) {
+function isSliceRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/** A slice field that is present. Unknown throws — it is not false or 0 (D393). */
+function sliceField(slice, field) {
+	const value = slice?.[field];
+	if (typeof value === "boolean" || typeof value === "number" || typeof value === "string") return value;
+	throw new Error(`composed ${field} is unknown — not a stand-in value`);
+}
+function composedMethod(answer, readSlice) {
 	if (answer.kind === "answer") return async () => answer.value;
+	if (answer.kind === "slice") {
+		const field = answer.field;
+		return async () => sliceField(await readSlice(), field);
+	}
 	return async () => {
 		throw new Error(answer.reason);
 	};
@@ -3860,7 +3902,11 @@ var GraftHost = class {
 		return ctx;
 	}
 	providerFor(deviceId, def) {
-		const answers = Object.entries(def.composedMethods ?? {}).map(([name, answer]) => [name, composedMethod(answer)]);
+		const readSlice = async () => {
+			const slice = await this.readMerged(deviceId, def.name);
+			return isSliceRecord(slice) ? slice : null;
+		};
+		const answers = Object.entries(def.composedMethods ?? {}).map(([name, answer]) => [name, composedMethod(answer, readSlice)]);
 		const withStatus = def.status === void 0 && def.runtimeState === void 0 ? [] : [["getStatus", async () => this.readMerged(deviceId, def.name)]];
 		return Object.fromEntries([...answers, ...withStatus]);
 	}
@@ -3937,7 +3983,7 @@ function entriesOf(request) {
 	}))];
 }
 function valueAtPath(slice, path) {
-	return path.split(".").reduce((node, segment) => isRecord$2(node) ? node[segment] : void 0, slice);
+	return path.split(".").reduce((node, segment) => isRecord$3(node) ? node[segment] : void 0, slice);
 }
 function onlineOf(slice) {
 	const online = slice["online"];
@@ -4604,12 +4650,12 @@ var DECLARED_INTEGRATION_NAME_UNUSED = "Blocks";
 var PULSE_HISTORY_MAX_POINTS = 5e3;
 /** The owner-only shadow payload is not in the typed catalog: narrowed at the boundary, like `device.state-changed`. */
 function parseNativeShadowChanged(data) {
-	if (!isRecord$2(data)) return null;
+	if (!isRecord$3(data)) return null;
 	const deviceId = data["deviceId"];
 	const capName = data["capName"];
 	const native = data["native"];
 	if (typeof deviceId !== "number" || typeof capName !== "string") return null;
-	if (!isRecord$2(native)) return null;
+	if (!isRecord$3(native)) return null;
 	return {
 		deviceId,
 		capName,

package/dist/builtins/composer/composition-runtime.d.ts

@@ -156,6 +156,8 @@ export declare class CompositionRuntime {
 	/** One info line per field per direction, never one per pass. */
 	private logReleaseTransitions;
 	private seedCap;
+	/** An omitted optional reading must leave the slice, not keep the previous number (D944). */
+	private clearsOmitted;
 	private patchCap;
 	/**
 	* After a failed write nothing is known about what landed, and after a

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-xCNJAQMh.js");
+const require_dist = require("../../dist-D-d_UWL4.js");
 const require_formatter = require("../../formatter-xbxeV4GD.js");
 //#region src/builtins/console-logging/console-destination.ts
 var LEVEL_RANK = {

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

@@ -1,4 +1,4 @@
-import { Ln as logDestinationCapability, ni as BaseAddon } from "../../dist-Df6c0RX_.mjs";
+import { Ln as logDestinationCapability, ni as BaseAddon } from "../../dist-HBue971z.mjs";
 import { t as formatLogLine } from "../../formatter-DkYZ4LXp.mjs";
 //#region src/builtins/console-logging/console-destination.ts
 var LEVEL_RANK = {

package/dist/builtins/core-blocks/composition-sources.d.ts

@@ -13,11 +13,13 @@
 * Devices are keyed by `{addonId, stableId}` — never a numeric device id,
 * which is this node's allocation and not the composition's identity.
 */
-import { type CompositionSourceDescription, type CompositionSourceRef, type CompositionTargetDescription, type DeviceType } from "@camstack/types";
+import { type CompositionSourceDescription, type CompositionSourceRef, type CompositionTargetDescription, type DeviceType, type ReadingQuantity } from "@camstack/types";
 export interface SourceRowView {
 	readonly id: number;
 	readonly stableId: string;
 	readonly type: DeviceType;
+	/** The device's stored quantity, when it declares one (D944 §4). */
+	readonly quantity?: ReadingQuantity;
 }
 /** One `getBindings` entry: the cap, and the addon serving it natively. */
 export interface BoundCapView {

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

@@ -1,8 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-xCNJAQMh.js");
+const require_dist = require("../../dist-D-d_UWL4.js");
 const require_read_all_rows$1 = require("../../read-all-rows-CVoO1ONM.js");
-const require_composition_sources = require("../../composition-sources-BSQneZV9.js");
+const require_composition_sources = require("../../composition-sources-CN8K2Q91.js");
 const require_prefix_range = require("../../prefix-range-D_KueXbQ.js");
 const require_prefix_walk = require("../../prefix-walk-Dv6MLZlM.js");
 let zod = require("zod");
@@ -1933,6 +1933,16 @@ function refuseIfChanged(deps, blockId, expectedUpdatedAt) {
 function existingTarget(composition) {
 	return composition.target.kind === "existing" ? composition.target.device : null;
 }
+function helperMemberDeviceIds(composition, sources) {
+	const helper = composition.helper;
+	if (helper === void 0) return [];
+	const ids = [];
+	for (const member of helper.members) {
+		const found = sources.get(require_dist.compositionSourceKey(member.source));
+		if (found?.kind === "found") ids.push(found.deviceId);
+	}
+	return ids;
+}
 async function validateAgainstStore(deps, composition, blockId) {
 	if (!deps.store.isLoaded()) throw new Error(`${NOT_LOADED_REASON} — a composition cannot be judged against the stored ones until it has; retry shortly`);
 	const self = blockId === null ? null : require_dist.composedDeviceRef(blockId);
@@ -1942,29 +1952,37 @@ async function validateAgainstStore(deps, composition, blockId) {
 	const blocks = deps.store.list();
 	const read = await deps.describe(refs, [...target === null ? [] : [target], ...storedCustomizationTargets(blocks)]);
 	const stored = storedPeers(blocks, read.targets, deps.lookupCap, blockId);
-	return require_dist.validateComposition(composition, {
-		lookupCap: deps.lookupCap,
-		sources: read.sources,
-		self,
-		blockId,
-		target: target === null ? null : read.targets.get(require_dist.compositionSourceKey(target)) ?? {
-			kind: "unreadable",
-			error: "it was not read"
-		},
-		peers: stored.peers,
-		unreadTargets: stored.unread
-	});
+	return {
+		validation: require_dist.validateComposition(composition, {
+			lookupCap: deps.lookupCap,
+			sources: read.sources,
+			self,
+			blockId,
+			target: target === null ? null : read.targets.get(require_dist.compositionSourceKey(target)) ?? {
+				kind: "unreadable",
+				error: "it was not read"
+			},
+			peers: stored.peers,
+			unreadTargets: stored.unread
+		}),
+		memberDeviceIds: helperMemberDeviceIds(composition, read.sources)
+	};
 }
 function describeProblems(validation) {
 	return validation.problems.map((p) => `${p.path} [${p.code}]: ${p.message}`);
 }
-function refuse(deps, subject, validation) {
+function refuse(deps, subject, validation, memberDeviceIds) {
 	const problems = describeProblems(validation);
-	deps.logger.warn("composition save refused", { meta: {
+	const meta = {
 		name: subject.name,
 		blockId: subject.blockId,
 		problems
-	} });
+	};
+	if (memberDeviceIds.length === 0) deps.logger.warn("composition save refused", { meta });
+	else for (const deviceId of memberDeviceIds) deps.logger.warn("composition save refused", {
+		tags: { deviceId },
+		meta
+	});
 	throw new Error(`core-blocks: the composition "${subject.name}" was refused — ${problems.join("; ")}`);
 }
 async function readStates(deps, blockIds) {
@@ -2109,11 +2127,11 @@ function buildCompositionApi(deps) {
 	return {
 		createComposition: ({ block, caller }) => serialized(async () => {
 			const name = await nameOnCreate(deps, block);
-			const validation = await validateAgainstStore(deps, block.composition, null);
-			if (!validation.ok && require_dist.problemsBlockSave(validation.problems)) refuse(deps, {
+			const judged = await validateAgainstStore(deps, block.composition, null);
+			if (!judged.validation.ok && require_dist.problemsBlockSave(judged.validation.problems)) refuse(deps, {
 				name,
 				blockId: null
-			}, validation);
+			}, judged.validation, judged.memberDeviceIds);
 			const created = await deps.store.createComposition({
 				...block,
 				name
@@ -2130,11 +2148,11 @@ function buildCompositionApi(deps) {
 			refuseIfChanged(deps, blockId, expectedUpdatedAt);
 			await refuseRetarget(deps, blockId, block);
 			if (block.composition !== void 0) {
-				const validation = await validateAgainstStore(deps, block.composition, blockId);
-				if (!validation.ok && require_dist.problemsBlockSave(validation.problems)) refuse(deps, {
+				const judged = await validateAgainstStore(deps, block.composition, blockId);
+				if (!judged.validation.ok && require_dist.problemsBlockSave(judged.validation.problems)) refuse(deps, {
 					name: block.name ?? blockId,
 					blockId
-				}, validation);
+				}, judged.validation, judged.memberDeviceIds);
 			}
 			const updated = await deps.store.updateComposition(blockId, block);
 			deps.logger.info("composition updated", { meta: {
@@ -2212,7 +2230,7 @@ function buildCompositionApi(deps) {
 				}
 			};
 		},
-		validateComposition: async ({ composition, blockId }) => validateAgainstStore(deps, composition, blockId ?? null),
+		validateComposition: async ({ composition, blockId }) => (await validateAgainstStore(deps, composition, blockId ?? null)).validation,
 		listComposableCaps: async ({ deviceType }) => ({ caps: [...require_dist.describeComposableCaps(deps.capabilityDefinitions, deviceType)] })
 	};
 }
@@ -2637,10 +2655,17 @@ var CoreBlocksAddon = class extends require_dist.BaseAddon {
 		return buildCompositionApi({
 			store: this.requireStore(),
 			describe: (sources, targets) => require_composition_sources.describeCompositionSources({
-				listByAddon: async (addonId) => requireApi().deviceManager.listAll.query({
-					addonId,
-					projection: "slim"
-				}),
+				listByAddon: async (addonId) => {
+					return (await requireApi().deviceManager.listAll.query({
+						addonId,
+						projection: "slim"
+					})).map((row) => ({
+						id: row.id,
+						stableId: row.stableId,
+						type: row.type,
+						...row.sourceInfo?.quantity === void 0 ? {} : { quantity: row.sourceInfo.quantity }
+					}));
+				},
 				bindings: async (deviceId) => (await requireApi().deviceManager.getBindings.query({ deviceId })).entries
 			}, sources, targets),
 			lookupCap: require_dist.buildCapabilityLookup(require_dist.ALL_CAPABILITY_DEFINITIONS),