@camstack/types 1.2.417 → 1.2.419

package/dist/index.js

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sleep = require("./sleep-gtskVoMw.js");
-const require_event_category = require("./event-category-DXZ3f9Q5.js");
-const require_composition = require("./composition-DsmkwP9-.js");
+const require_sleep = require("./sleep-YJ6FVsUu.js");
+const require_event_category = require("./event-category-Ave2VSxY.js");
+const require_composition = require("./composition-re1aezX9.js");
 const require_node_color = require("./node-color.js");
 const require_err_msg = require("./err-msg-BhVbr0NX.js");
 const require_enums = require("./enums.js");
@@ -12624,7 +12624,10 @@ var CompositionProblemCodeSchema = zod.z.enum([
 	"target-missing",
 	"target-unreadable",
 	"not-replaceable",
-	"native-capability-replace"
+	"native-capability-replace",
+	"mixed-quantity",
+	"helper-mismatch",
+	"member-constraint"
 ]);
 /** One refusal, named (D391). `path` points into the composition, e.g. `features[0].fields.celsius`. */
 var CompositionProblemSchema = zod.z.object({
@@ -12648,7 +12651,8 @@ var CompositionUnavailableModeSchema = zod.z.enum([
 	"null",
 	"offline",
 	"unknown",
-	"release"
+	"release",
+	"omit"
 ]);
 /**
 * `derived` reads a source · `clock` reads only `now`, recomputed when a sibling
@@ -13019,6 +13023,24 @@ function inferExpressionKinds(input) {
 * planner (`composition-items.ts`). Internal to the composition module — NOT
 * in the barrel: these are planner internals, not a published contract.
 */
+function aggregateKinds(source) {
+	if (source.publish !== "value") return {
+		ok: true,
+		kinds: new Set(["number"])
+	};
+	if (source.reducer === "any" || source.reducer === "all") return {
+		ok: true,
+		kinds: new Set(["boolean"])
+	};
+	if (source.empty === "null") return {
+		ok: true,
+		kinds: new Set(["number", "null"])
+	};
+	return {
+		ok: true,
+		kinds: new Set(["number"])
+	};
+}
 function readKinds(read, lookupCap) {
 	const def = lookupCap(read.cap);
 	const schema = def?.runtimeState ?? def?.status?.schema;
@@ -13046,6 +13068,7 @@ function sourceKinds(source, lookupCap) {
 		code: "reserved-variant",
 		message: "code fields arrive in slice 4"
 	};
+	if (source.kind === "aggregate") return aggregateKinds(source);
 	const bindingKinds = /* @__PURE__ */ new Map();
 	for (const [name, binding] of Object.entries(source.bindings)) {
 		if (binding.kind === "literal") {
@@ -13242,6 +13265,531 @@ function planItems(def, feature, featureIndex, lookupCap, mode = "new") {
 	};
 }
 //#endregion
+//#region src/composition/helpers/catalog.ts
+/**
+* One catalog row per base reading a group helper can build (D944 §3).
+* Data, not a form default written into the block.
+*/
+var NOW = {
+	fieldPath: "lastFetchedAt",
+	expr: "now"
+};
+var CHANGED = {
+	fieldPath: "lastChangedAt",
+	expr: "now"
+};
+function numeric(input) {
+	return {
+		...input,
+		family: "numeric",
+		deviceType: require_err_msg.DeviceType.Sensor,
+		memberDeviceType: require_err_msg.DeviceType.Sensor,
+		commandCaps: [],
+		baseUnit: require_sleep.baseUnitOf(input.quantity),
+		aggregates: require_composition.NUMERIC_AGGREGATES,
+		accept: [{
+			cap: input.outputCap,
+			fieldPath: input.outputField
+		}]
+	};
+}
+function binary(input) {
+	return {
+		...input,
+		family: "binary",
+		deviceType: require_err_msg.DeviceType.Sensor,
+		memberDeviceType: require_err_msg.DeviceType.Sensor,
+		commandCaps: [],
+		quantity: "none",
+		baseUnit: void 0,
+		aggregates: require_composition.BINARY_AGGREGATES,
+		empty: "offline"
+	};
+}
+var GROUP_TEMPLATES = [
+	numeric({
+		id: "temperature",
+		summary: "Mean, median, min, max or sum of temperatures. Offline and unknown members are left out, never read as 0 °C.",
+		role: require_err_msg.DeviceRole.TemperatureSensor,
+		outputCap: "temperature-sensor",
+		outputField: "celsius",
+		quantity: "temperature",
+		defaultAggregate: "mean",
+		empty: "null",
+		companions: [NOW]
+	}),
+	numeric({
+		id: "humidity",
+		summary: "Humidity in percent. Offline and unknown members are left out, never read as 0 %.",
+		role: require_err_msg.DeviceRole.HumiditySensor,
+		outputCap: "humidity-sensor",
+		outputField: "percent",
+		quantity: "humidity",
+		defaultAggregate: "mean",
+		empty: "null",
+		companions: [NOW]
+	}),
+	numeric({
+		id: "pressure",
+		summary: "Pressure in hectopascals. Offline and unknown members are left out, never read as 0 hPa.",
+		role: require_err_msg.DeviceRole.PressureSensor,
+		outputCap: "pressure-sensor",
+		outputField: "hpa",
+		quantity: "pressure",
+		defaultAggregate: "mean",
+		empty: "null",
+		companions: [NOW]
+	}),
+	numeric({
+		id: "illuminance",
+		summary: "Illuminance in lux. Offline and unknown members are left out, never read as 0 lx.",
+		role: require_err_msg.DeviceRole.AmbientLightSensor,
+		outputCap: "ambient-light-sensor",
+		outputField: "lux",
+		quantity: "illuminance",
+		defaultAggregate: "mean",
+		empty: "null",
+		companions: [NOW]
+	}),
+	numeric({
+		id: "power",
+		summary: "Power in watts, summed by default. Nobody reporting omits the key rather than writing 0 W.",
+		role: require_err_msg.DeviceRole.PowerSensor,
+		outputCap: "power-meter",
+		outputField: "watts",
+		quantity: "power",
+		defaultAggregate: "sum",
+		empty: "omit",
+		companions: [NOW]
+	}),
+	numeric({
+		id: "energy",
+		summary: "Energy in kilowatt-hours, summed by default. Nobody reporting omits the key rather than writing 0 kWh.",
+		role: require_err_msg.DeviceRole.EnergySensor,
+		outputCap: "power-meter",
+		outputField: "kwhTotal",
+		quantity: "energy",
+		defaultAggregate: "sum",
+		empty: "omit",
+		companions: [NOW]
+	}),
+	numeric({
+		id: "battery",
+		summary: "Battery charge in percent. Offline and unknown members are left out, never read as 0 %.",
+		role: require_err_msg.DeviceRole.BatterySensor,
+		outputCap: "battery",
+		outputField: "percentage",
+		quantity: "percentage",
+		defaultAggregate: "mean",
+		empty: "null",
+		companions: [
+			{
+				fieldPath: "charging",
+				expr: "\"unknown\""
+			},
+			{
+				fieldPath: "sleeping",
+				expr: "false"
+			},
+			{
+				fieldPath: "lastUpdated",
+				expr: "now"
+			}
+		]
+	}),
+	numeric({
+		id: "numeric",
+		summary: "A numeric reading in the members’ shared quantity. Mixed quantities are refused. Nobody reporting publishes null, not 0.",
+		role: require_err_msg.DeviceRole.NumericSensor,
+		outputCap: "numeric-sensor",
+		outputField: "value",
+		quantity: "device",
+		defaultAggregate: "mean",
+		empty: "null",
+		companions: [NOW]
+	}),
+	binary({
+		id: "motion",
+		summary: "Any or all motion. Offline and unknown members are left out, never read as off. Nobody reporting takes the device offline.",
+		role: require_err_msg.DeviceRole.MotionSensor,
+		outputCap: "motion",
+		outputField: "detected",
+		defaultAggregate: "any",
+		accept: [{
+			cap: "motion",
+			fieldPath: "detected"
+		}],
+		companions: [{
+			fieldPath: "lastDetectedAt",
+			expr: "null"
+		}, {
+			fieldPath: "autoClearAfterMs",
+			expr: "null"
+		}]
+	}),
+	binary({
+		id: "contact",
+		summary: "Any or all open contacts. Offline and unknown members are left out, never read as closed.",
+		role: require_err_msg.DeviceRole.ContactSensor,
+		outputCap: "contact",
+		outputField: "entryOpen",
+		defaultAggregate: "any",
+		accept: [{
+			cap: "contact",
+			fieldPath: "entryOpen"
+		}],
+		companions: [CHANGED]
+	}),
+	binary({
+		id: "leak",
+		summary: "Any or all leak detections. Offline and unknown members are left out, never read as dry.",
+		role: require_err_msg.DeviceRole.LeakSensor,
+		outputCap: "flood",
+		outputField: "flooded",
+		defaultAggregate: "any",
+		accept: [{
+			cap: "flood",
+			fieldPath: "flooded"
+		}],
+		companions: [CHANGED]
+	}),
+	binary({
+		id: "smoke",
+		summary: "Any or all smoke detections. Offline and unknown members are left out, never read as clear.",
+		role: require_err_msg.DeviceRole.SmokeSensor,
+		outputCap: "smoke",
+		outputField: "detected",
+		defaultAggregate: "any",
+		accept: [{
+			cap: "smoke",
+			fieldPath: "detected"
+		}],
+		companions: [CHANGED]
+	}),
+	binary({
+		id: "occupancy",
+		summary: "Any or all of motion or binary sensors, published as a binary. Presence zones are not aggregated. Nobody reporting is offline, not off.",
+		role: require_err_msg.DeviceRole.BinarySensor,
+		outputCap: "binary",
+		outputField: "on",
+		defaultAggregate: "any",
+		accept: [{
+			cap: "motion",
+			fieldPath: "detected"
+		}, {
+			cap: "binary",
+			fieldPath: "on"
+		}],
+		companions: [CHANGED]
+	}),
+	binary({
+		id: "binary",
+		summary: "Any or all generic binary sensors. Offline and unknown members are left out, never read as off.",
+		role: require_err_msg.DeviceRole.BinarySensor,
+		outputCap: "binary",
+		outputField: "on",
+		defaultAggregate: "any",
+		accept: [{
+			cap: "binary",
+			fieldPath: "on"
+		}],
+		companions: [CHANGED]
+	}),
+	actuator({
+		id: "switch",
+		summary: "On when at least one switch is on, or when all of them are. Offline and unknown members are left out of that decision, never read as off, and still receive the command.",
+		deviceType: require_err_msg.DeviceType.Switch,
+		outputCap: "switch",
+		commandCaps: ["switch"]
+	}),
+	actuator({
+		id: "light",
+		summary: "On when at least one light is on, or when all of them are. Brightness and colour are offered only when every member has them. A command is not sent to a member that lacks it.",
+		deviceType: require_err_msg.DeviceType.Light,
+		outputCap: "switch",
+		commandCaps: [
+			"switch",
+			"brightness",
+			"color"
+		]
+	})
+];
+function actuator(input) {
+	return {
+		...input,
+		family: "actuator",
+		role: void 0,
+		memberDeviceType: input.deviceType,
+		outputField: "on",
+		quantity: "none",
+		baseUnit: void 0,
+		aggregates: require_composition.BINARY_AGGREGATES,
+		defaultAggregate: "any",
+		empty: "offline",
+		accept: [{
+			cap: "switch",
+			fieldPath: "on"
+		}],
+		companions: [CHANGED]
+	};
+}
+var BY_ID = new Map(GROUP_TEMPLATES.map((template) => [template.id, template]));
+function groupTemplate(id) {
+	return BY_ID.get(id) ?? null;
+}
+//#endregion
+//#region src/composition/helpers/actuator.ts
+/**
+* Actuator groups (D944 phase 1b). The active boolean is the binary reducer
+* with unknown members left out. A command is one call per member that binds
+* the cap, including members that are offline. One failure does not cancel
+* the others.
+*/
+/** Caps a light group may expose, in display order. Switch is the active state. */
+var LIGHT_SHARED_CAPS = [
+	"switch",
+	"brightness",
+	"color"
+];
+var COLOR_MODE_FEATURES = [
+	require_err_msg.DeviceFeature.LightColorRgb,
+	require_err_msg.DeviceFeature.LightColorHsv,
+	require_err_msg.DeviceFeature.LightColorMired
+];
+/** How many member calls run at once. The rest wait; none are dropped. */
+var FAN_OUT_CONCURRENCY = 4;
+/** `at-least-one` is any included member on; `all` is every included member on. */
+function reducerForActive(active) {
+	return active === "all" ? "all" : "any";
+}
+function activeForReducer(reducer) {
+	return reducer === "all" ? "all" : "at-least-one";
+}
+/**
+* Caps every member binds, from {@link LIGHT_SHARED_CAPS}. An empty member
+* list shares nothing. A member that lacks colour drops colour from the group.
+*/
+function sharedLightCaps(memberCaps) {
+	if (memberCaps.length === 0) return [];
+	return LIGHT_SHARED_CAPS.filter((cap) => memberCaps.every((bound) => bound.includes(cap)));
+}
+/**
+* Colour modes every member advertises. Offline does not remove a mode:
+* the caller passes device features, not liveness. No members → no mode.
+*/
+function sharedColorModes(memberFeatures) {
+	if (memberFeatures.length === 0) return [];
+	return COLOR_MODE_FEATURES.filter((mode) => memberFeatures.every((features) => features.includes(mode)));
+}
+/**
+* One call per member that binds `cap`. Offline members stay in the list.
+* A member without the cap is not called — the command cannot reach it.
+*/
+function fanOutTargets(members, cap, method, args) {
+	return members.flatMap((member) => member.caps.includes(cap) ? [{
+		deviceId: member.deviceId,
+		cap,
+		method,
+		args: { ...args }
+	}] : []);
+}
+/**
+* Run every call. A throw is that member's result; the other calls still run.
+* At most {@link FAN_OUT_CONCURRENCY} are in flight.
+*/
+async function runFanOut(calls, invoke) {
+	const results = [];
+	let next = 0;
+	const worker = async () => {
+		for (;;) {
+			const index = next;
+			next += 1;
+			const call = calls[index];
+			if (call === void 0) return;
+			try {
+				await invoke(call);
+				results[index] = {
+					deviceId: call.deviceId,
+					ok: true
+				};
+			} catch (err) {
+				const error = err instanceof Error ? err.message : String(err);
+				results[index] = {
+					deviceId: call.deviceId,
+					ok: false,
+					error
+				};
+			}
+		}
+	};
+	const width = Math.min(4, calls.length);
+	await Promise.all(Array.from({ length: width }, () => worker()));
+	return results;
+}
+//#endregion
+//#region src/composition/helpers/compile.ts
+function sameSource(a, b) {
+	return a.addonId === b.addonId && a.stableId === b.stableId;
+}
+function sameMember(a, b) {
+	return sameSource(a.source, b.source) && a.cap === b.cap && a.fieldPath === b.fieldPath;
+}
+function accepted(template, member) {
+	return template.accept.some((field) => field.cap === member.cap && field.fieldPath === member.fieldPath);
+}
+function memberProblems(template, spec) {
+	return spec.members.flatMap((member, index) => {
+		const at = `helper.members[${index}]`;
+		const problems = [];
+		if (!accepted(template, member)) {
+			const allowed = template.accept.map((field) => `${field.cap}.${field.fieldPath}`).join(" or ");
+			problems.push(problem("member-constraint", at, `a ${template.id} group reads ${allowed}; this member is ${member.cap}.${member.fieldPath}`));
+		}
+		if (spec.members.slice(0, index).some((other) => sameMember(other, member))) problems.push(problem("member-constraint", at, "this member is already in the group"));
+		return problems;
+	});
+}
+function aggregateSource(template, spec, reads, publish) {
+	return {
+		kind: "aggregate",
+		reducer: spec.aggregate,
+		reads: [...reads],
+		publish,
+		empty: template.empty
+	};
+}
+function expressionSource(expr) {
+	return {
+		kind: "expression",
+		expr,
+		bindings: {}
+	};
+}
+function draftOf$1(template, spec) {
+	const reads = spec.members.map((member) => ({
+		source: member.source,
+		cap: member.cap,
+		fieldPath: member.fieldPath
+	}));
+	const companions = Object.fromEntries(template.companions.map((companion) => [companion.fieldPath, expressionSource(companion.expr)]));
+	return {
+		target: {
+			kind: "new",
+			type: template.deviceType,
+			...template.role === void 0 ? {} : { role: template.role }
+		},
+		helper: spec,
+		features: [{
+			kind: "fields",
+			cap: template.outputCap,
+			fields: {
+				[template.outputField]: aggregateSource(template, spec, reads, "value"),
+				...companions
+			}
+		}, {
+			kind: "fields",
+			cap: "group-status",
+			fields: {
+				included: aggregateSource(template, spec, reads, "included"),
+				excluded: aggregateSource(template, spec, reads, "excluded"),
+				total: aggregateSource(template, spec, reads, "total")
+			}
+		}]
+	};
+}
+function criterionProblems(template, spec) {
+	if (template.family === "actuator") {
+		if (spec.active === void 0) return [problem("kind-mismatch", "helper.active", `a ${template.id} group needs an active criterion (at-least-one or all)`)];
+		const reducer = reducerForActive(spec.active);
+		if (spec.aggregate !== reducer) return [problem("kind-mismatch", "helper.aggregate", `active \`${spec.active}\` aggregates by \`${reducer}\`, not \`${spec.aggregate}\``)];
+		return [];
+	}
+	if (spec.active !== void 0) return [problem("kind-mismatch", "helper.active", `a ${template.id} group has no active criterion — that belongs to an actuator group`)];
+	return [];
+}
+function parseDraft(draft) {
+	const parsed = require_composition.CompositionSchema.safeParse(draft);
+	if (parsed.success) return {
+		ok: true,
+		composition: parsed.data
+	};
+	return {
+		ok: false,
+		problems: [problem("helper-mismatch", "helper", `the template did not compile: ${parsed.error.issues.map((issue) => issue.message).join("; ")}`)]
+	};
+}
+/** Compile a group template to a new-device composition. Refusals are named. */
+function compileHelper(spec) {
+	const template = groupTemplate(spec.templateId);
+	if (template === null) return {
+		ok: false,
+		problems: [problem("member-constraint", "helper.templateId", `unknown template \`${spec.templateId}\``)]
+	};
+	const criterion = criterionProblems(template, spec);
+	if (criterion.length > 0) return {
+		ok: false,
+		problems: criterion
+	};
+	if (!template.aggregates.includes(spec.aggregate)) {
+		const allowed = template.aggregates.join(", ");
+		return {
+			ok: false,
+			problems: [problem("kind-mismatch", "helper.aggregate", `a ${template.id} group aggregates by ${allowed}, not \`${spec.aggregate}\``)]
+		};
+	}
+	const members = memberProblems(template, spec);
+	if (members.length > 0) return {
+		ok: false,
+		problems: members
+	};
+	return parseDraft(draftOf$1(template, spec));
+}
+/** The built body, ignoring `helper`, so a save can demand one writer. */
+function sameHelperBody(stored, compiled) {
+	return JSON.stringify(stored.target) === JSON.stringify(compiled.target) && JSON.stringify(stored.features) === JSON.stringify(compiled.features);
+}
+function templateDeviceType(spec) {
+	return groupTemplate(spec.templateId)?.memberDeviceType ?? null;
+}
+//#endregion
+//#region src/composition/helpers/save.ts
+function quantityProblems(spec, facts) {
+	const template = groupTemplate(spec.templateId);
+	if (template === null || template.family !== "numeric") return [];
+	const known = spec.members.flatMap((member, index) => {
+		const quantity = facts.get(require_composition.compositionSourceKey(member.source))?.quantity;
+		return quantity === void 0 ? [] : [{
+			index,
+			quantity
+		}];
+	});
+	if (template.quantity !== "device") return known.flatMap((member) => member.quantity === template.quantity ? [] : [problem("mixed-quantity", `helper.members[${member.index}]`, `a ${template.id} group is ${template.quantity}${template.baseUnit === void 0 ? "" : ` (${template.baseUnit})`}; this member is ${member.quantity}`)]);
+	const distinct = [...new Set(known.map((member) => member.quantity))];
+	if (distinct.length <= 1) return [];
+	return [problem("mixed-quantity", "helper.members", `a numeric group requires one quantity; members report ${distinct.join(" and ")}`)];
+}
+function deviceTypeProblems(spec, facts) {
+	const template = groupTemplate(spec.templateId);
+	if (template === null) return [];
+	return spec.members.flatMap((member, index) => {
+		const deviceType = facts.get(require_composition.compositionSourceKey(member.source))?.deviceType;
+		if (deviceType === void 0 || deviceType === template.memberDeviceType) return [];
+		return [problem("member-constraint", `helper.members[${index}]`, `a ${template.id} group takes ${template.memberDeviceType} devices; this member is a ${deviceType}`)];
+	});
+}
+/**
+* Problems that refuse a save. No `helper` key means a free composition: this
+* returns nothing, and expression semantics stay as they are.
+*/
+function helperSaveProblems(composition, facts) {
+	const spec = composition.helper;
+	if (spec === void 0) return [];
+	const compiled = compileHelper(spec);
+	if (!compiled.ok) return compiled.problems;
+	if (!sameHelperBody(composition, compiled.composition)) return [problem("helper-mismatch", "helper", "the stored features are not this template — the helper spec is the only writer")];
+	return [...quantityProblems(spec, facts), ...deviceTypeProblems(spec, facts)];
+}
+//#endregion
 //#region src/composition/composition-graph.ts
 /**
 * The field graph across every composition, and the cycles in it (D659).
@@ -13448,11 +13996,22 @@ function composableCap(feature, at, lookupCap) {
 * required field. A REPLACE needs none of it: the cap is bound (a fact), the
 * native keeps serving its methods, and only the named fields are owned (D663).
 */
-function builtCapProblems({ def, state, fields: targetFields }, feature, at, deviceType) {
+/**
+* Caps an actuator helper is allowed to serve. A free composition, and a
+* reading group, get an empty set — `has-commands` stays for them.
+*/
+function actuatorCommandCaps(composition) {
+	const spec = composition.helper;
+	if (spec === void 0) return /* @__PURE__ */ new Set();
+	const template = groupTemplate(spec.templateId);
+	if (template === null || template.family !== "actuator") return /* @__PURE__ */ new Set();
+	return new Set(template.commandCaps);
+}
+function builtCapProblems({ def, state, fields: targetFields }, feature, at, deviceType, servedCommands) {
 	const problems = [];
 	if (def.deviceTypes !== void 0 && !def.deviceTypes.includes(deviceType)) problems.push(problem("wrong-device-type", `${at}.cap`, `\`${def.name}\` is not offered on a \`${deviceType}\` device (it allows ${def.deviceTypes.join(", ")})`));
 	const served = Object.entries(def.methods).filter(([name, m]) => m.systemOnly !== true && def.composedMethods?.[name] === void 0).map(([name]) => `\`${name}\``);
-	if (served.length > 0) problems.push(problem("has-commands", `${at}.cap`, `\`${def.name}\` has ${served.join(", ")}, which a composed device cannot serve until commands arrive (slice 3)`));
+	if (served.length > 0 && !servedCommands.has(def.name)) problems.push(problem("has-commands", `${at}.cap`, `\`${def.name}\` has ${served.join(", ")}, which a composed device cannot serve until commands arrive (slice 3)`));
 	const itemArrayPath = feature.items === void 0 ? null : def.status?.itemArray?.path ?? null;
 	for (const key of requiredTopLevelKeys(state)) {
 		if (key === itemArrayPath) continue;
@@ -13472,6 +14031,7 @@ function planTopLevelField({ def, fields }, field, mode, lookupCap) {
 	const role = roleOf(source);
 	const unavailable = unavailableFor(tf, role, mode, def.name, fieldAt);
 	if (!unavailable.ok) return refused(unavailable.problem);
+	const omitEmpty = source.kind === "aggregate" && source.publish === "value" && source.empty === "omit";
 	const plan = {
 		cap: def.name,
 		path,
@@ -13479,7 +14039,7 @@ function planTopLevelField({ def, fields }, field, mode, lookupCap) {
 		kind: tf.kind,
 		nullable: tf.nullable,
 		required: tf.required,
-		unavailable: unavailable.unavailable,
+		unavailable: omitEmpty ? "omit" : unavailable.unavailable,
 		role,
 		source,
 		reads: [...require_composition.fieldReads(source)]
@@ -13492,11 +14052,11 @@ function planTopLevelField({ def, fields }, field, mode, lookupCap) {
 		events: []
 	};
 }
-function planFeature(feature, featureIndex, target, lookupCap) {
+function planFeature(feature, featureIndex, target, lookupCap, servedCommands) {
 	const at = `features[${featureIndex}]`;
 	const cap = composableCap(feature, at, lookupCap);
 	if ("code" in cap) return refused(cap);
-	const capProblems = target.mode === "replace" ? [] : [...builtCapProblems(cap, feature, at, target.deviceType)];
+	const capProblems = target.mode === "replace" ? [] : [...builtCapProblems(cap, feature, at, target.deviceType, servedCommands)];
 	if (feature.commands !== void 0 && Object.keys(feature.commands).length > 0) capProblems.push(problem("reserved-variant", `${at}.commands`, "commands (`forward`) arrive in slice 3"));
 	const perField = Object.entries(feature.fields).map(([path, source]) => planTopLevelField(cap, {
 		featureIndex,
@@ -13582,6 +14142,7 @@ function featureTargetOf(target, cap, at) {
 function planComposition(composition, lookupCap, target) {
 	const planTarget = planTargetOf(composition, target);
 	if ("code" in planTarget) return refused(planTarget);
+	const servedCommands = actuatorCommandCaps(composition);
 	const results = composition.features.map((feature, index) => {
 		const at = `features[${index}]`;
 		if (feature.kind === "passthrough") return refused(problem("reserved-variant", at, `whole-capability passthrough of \`${feature.cap}\` arrives in slice 3`));
@@ -13596,9 +14157,9 @@ function planComposition(composition, lookupCap, target) {
 			return nativeReplaceOrBlock(featureTarget, planFeature(feature, index, {
 				mode: "add",
 				deviceType: planTarget.found.type
-			}, lookupCap));
+			}, lookupCap, servedCommands));
 		}
-		const result = planFeature(feature, index, featureTarget, lookupCap);
+		const result = planFeature(feature, index, featureTarget, lookupCap, servedCommands);
 		return require_composition.compositionFeatureEnabled(feature) ? result : {
 			problems: result.problems,
 			fields: [],
@@ -13744,10 +14305,15 @@ function validateComposition(composition, ctx) {
 		if (refusedFeatures.some((at) => item.path === at || item.path.startsWith(`${at}.`))) return false;
 		return refusedFeatures.length === 0 || item.path !== "features";
 	});
+	const facts = new Map([...ctx.sources].flatMap(([key, source]) => source.kind === "found" ? [[key, {
+		deviceType: source.deviceType,
+		quantity: source.quantity
+	}]] : []));
 	const problems = [
 		...plan.problems,
 		...sourceProblems(plan.fields, ctx, self),
-		...cycles
+		...cycles,
+		...helperSaveProblems(composition, facts)
 	];
 	return {
 		ok: problems.length === 0,
@@ -44507,6 +45073,8 @@ var NcSystemEventKindSchema = zod.z.enum([
 	"detection-blind",
 	"motion-noisy",
 	"motion-calm",
+	"package-llm-silent",
+	"package-llm-answered",
 	"recording-stalled",
 	"recording-healthy",
 	"recording-degraded",
@@ -46151,6 +46719,14 @@ var NC_CONDITION_CATALOG = [
 				value: "motion-calm",
 				label: "Camera motion calm again"
 			},
+			{
+				value: "package-llm-silent",
+				label: "Package confirm not answering"
+			},
+			{
+				value: "package-llm-answered",
+				label: "Package confirm answering again"
+			},
 			{
 				value: "recording-stalled",
 				label: "Recording stalled"
@@ -60182,6 +60758,28 @@ var PackageVersionInfoSchema = zod.z.object({
 	deprecated: zod.z.string().optional(),
 	distTags: zod.z.array(zod.z.string()).readonly()
 });
+/**
+* One published document. `ok` is markdown from the registry. `missing` means
+* the registry answered and the file was not there. `error` is a registry or
+* tarball failure — never an empty string standing in for either.
+*/
+var PackageDocBodySchema = zod.z.discriminatedUnion("status", [
+	zod.z.object({
+		status: zod.z.literal("ok"),
+		markdown: zod.z.string()
+	}),
+	zod.z.object({ status: zod.z.literal("missing") }),
+	zod.z.object({
+		status: zod.z.literal("error"),
+		message: zod.z.string()
+	})
+]);
+var PackageDocsSchema = zod.z.object({
+	name: zod.z.string(),
+	version: zod.z.string(),
+	readme: PackageDocBodySchema,
+	changelog: PackageDocBodySchema
+});
 var SearchResultSchema = zod.z.object({
 	name: zod.z.string(),
 	version: zod.z.string(),
@@ -60548,6 +61146,15 @@ var addonsCapability = {
 			auth: "admin"
 		}),
 		getVersions: require_sleep.method(zod.z.object({ name: zod.z.string() }), zod.z.array(PackageVersionInfoSchema).readonly()),
+		/**
+		* README and CHANGELOG for one registry package, read on the hub and
+		* cached. `version` omitted resolves the `latest` dist-tag. The browser
+		* never talks to the registry.
+		*/
+		getPackageDocs: require_sleep.method(zod.z.object({
+			name: zod.z.string().min(1),
+			version: zod.z.string().min(1).optional()
+		}), PackageDocsSchema, { auth: "admin" }),
 		restartAddon: require_sleep.method(zod.z.object({ addonId: zod.z.string() }), RestartAddonResultSchema, {
 			kind: "mutation",
 			auth: "admin"
@@ -62109,6 +62716,10 @@ var ColorStatusSchema = zod.z.object({
 	/** Ms epoch of the last operator-driven change. */
 	lastChangedAt: zod.z.number()
 });
+function parseColorInput(value) {
+	const parsed = ColorInputSchema.safeParse(value);
+	return parsed.success ? parsed.data : null;
+}
 var colorCapability = {
 	name: "color",
 	scope: "device",
@@ -64307,6 +64918,99 @@ var gasCapability = {
 	volatileStateFields: ["lastChangedAt"]
 };
 //#endregion
+//#region src/capabilities/group-commands.cap.ts
+/**
+* The last command a helper actuator group sent to each member (D944).
+* The composer writes this slice; the aggregate pass does not, so a later
+* reading does not wipe it. History is none — the outcome is the latest
+* attempt, not a series.
+*/
+var GroupCommandResultSchema = zod.z.object({
+	deviceId: zod.z.number().int().nonnegative(),
+	cap: zod.z.string().min(1),
+	method: zod.z.string().min(1),
+	ok: zod.z.boolean(),
+	error: zod.z.string().optional(),
+	/** Ms epoch of the attempt. */
+	at: zod.z.number()
+});
+var GroupCommandsSchema = zod.z.object({ 
+/** One row per member that has been commanded. A later command replaces that member's row. */
+results: zod.z.array(GroupCommandResultSchema) });
+var groupCommandsCapability = {
+	name: "group-commands",
+	scope: "device",
+	deviceNative: true,
+	mode: "singleton",
+	deviceTypes: [require_err_msg.DeviceType.Switch, require_err_msg.DeviceType.Light],
+	methods: {},
+	status: {
+		schema: GroupCommandsSchema,
+		kind: "push"
+	},
+	runtimeState: GroupCommandsSchema,
+	/**
+	* Runtime-state durability: **session** — the last attempt. A restored
+	* failure would outlive the command that caused it.
+	*
+	* See `RuntimeStateDurability`. Enforced by
+	* `scripts/check-runtime-state-durability.ts`.
+	*/
+	durability: "session",
+	history: "none"
+};
+//#endregion
+//#region src/capabilities/group-status.cap.ts
+/**
+* How many members of a helper group answered (D944). Counts are integers,
+* not measurements: zero included is a real count, never a stand-in reading.
+* The reading itself stays on the output capability. History is none — the
+* series that later statistics read is the output cap's own history block.
+*/
+var GroupStatusSchema = zod.z.object({
+	/** Members whose current value entered the aggregate. */
+	included: zod.z.number().int().nonnegative().meta(require_sleep.readingMeta("count", {
+		precision: 0,
+		label: "Reporting"
+	})),
+	/** Members left out: offline, unknown, or not a finite reading (D393). */
+	excluded: zod.z.number().int().nonnegative().meta(require_sleep.readingMeta("count", {
+		precision: 0,
+		label: "Excluded"
+	})),
+	/** `included` + `excluded`. */
+	total: zod.z.number().int().nonnegative().meta(require_sleep.readingMeta("count", {
+		precision: 0,
+		label: "Members"
+	}))
+});
+var groupStatusCapability = {
+	name: "group-status",
+	scope: "device",
+	deviceNative: true,
+	mode: "singleton",
+	deviceTypes: [
+		require_err_msg.DeviceType.Sensor,
+		require_err_msg.DeviceType.Switch,
+		require_err_msg.DeviceType.Light
+	],
+	methods: {},
+	status: {
+		schema: GroupStatusSchema,
+		kind: "push"
+	},
+	runtimeState: GroupStatusSchema,
+	/**
+	* Runtime-state durability: **session** — recomputed from members on the
+	* next source event; a restored count would outlive the readings it named.
+	*
+	* See `RuntimeStateDurability`. Enforced by
+	* `scripts/check-runtime-state-durability.ts`.
+	*/
+	durability: "session",
+	history: "none"
+};
+//#endregion
 //#region src/capabilities/heating-valve.cap.ts
 var HeatingValveStatusSchema = zod.z.object({
 	/** Radiator valve opening 0 (closed) .. 100 (open). Null = not yet known. */
@@ -66402,12 +67106,18 @@ var motionCapability = {
 	methods: { 
 	/**
 	* Pull the current motion state synchronously. Convenience shortcut
-	* for consumers that don't need the full status object; equivalent
-	* to `getStatus()?.detected ?? false`. Will likely be folded into
-	* `getStatus` once the auto-injected status surface lands in every
-	* consumer.
+	* for consumers that don't need the full status object. A composed
+	* group answers from its slice (D944): unknown throws, it is not off.
 	*/
 isDetected: require_sleep.method(zod.z.object({ deviceId: zod.z.number() }), zod.z.boolean()) },
+	/**
+	* A composed motion group serves `isDetected` from `detected` (D944).
+	* Without this the cap stays uncomposable (`has-commands`).
+	*/
+	composedMethods: { isDetected: {
+		kind: "slice",
+		field: "detected"
+	} },
 	events: { 
 	/**
 	* Fires every time the runner transitions a camera between
@@ -77154,6 +77864,127 @@ function createDeviceExtensionProvider(options) {
 	};
 }
 //#endregion
+//#region src/composition/helpers/aggregate.ts
+function isBinaryReducer(reducer) {
+	return reducer === "any" || reducer === "all";
+}
+function includedValue(reducer, member) {
+	if (member.state !== "fresh") return null;
+	if (isBinaryReducer(reducer)) return typeof member.value === "boolean" ? member.value : null;
+	return typeof member.value === "number" && Number.isFinite(member.value) ? member.value : null;
+}
+function median$1(values) {
+	const sorted = [...values].toSorted((a, b) => a - b);
+	const mid = Math.floor(sorted.length / 2);
+	const right = sorted[mid];
+	const left = sorted[mid - 1];
+	if (right === void 0) throw new Error("median requires at least one finite number");
+	if (sorted.length % 2 === 1) return right;
+	if (left === void 0) throw new Error("median requires at least one finite number");
+	return (left + right) / 2;
+}
+function reduceNumbers(reducer, values) {
+	if (reducer === "min") return Math.min(...values);
+	if (reducer === "max") return Math.max(...values);
+	if (reducer === "sum") return values.reduce((sum, value) => sum + value, 0);
+	if (reducer === "median") return median$1(values);
+	return values.reduce((sum, value) => sum + value, 0) / values.length;
+}
+function reduceBooleans(reducer, values) {
+	return reducer === "all" ? values.every((value) => value) : values.some((value) => value);
+}
+function countsOf(included, total) {
+	return {
+		included,
+		excluded: total - included,
+		total
+	};
+}
+function fatalReason(members) {
+	const reasons = members.flatMap((member) => member.state === "unavailable" && member.fatal === true ? [member.reason ?? "source gone"] : []);
+	return reasons.length === 0 ? null : reasons.join("; ");
+}
+function emptyOutcome(empty, counts) {
+	if (empty === "null") return {
+		kind: "value",
+		value: null,
+		counts
+	};
+	return {
+		kind: "unavailable",
+		fatal: false,
+		reason: "no member included — unknown is not 0 or off",
+		counts
+	};
+}
+/** Pure. `members` is not mutated. An empty included set is null or unavailable, never 0 or false. */
+function evaluateAggregate(input) {
+	const included = input.members.flatMap((member) => {
+		const value = includedValue(input.reducer, member);
+		return value === null ? [] : [value];
+	});
+	const counts = countsOf(included.length, input.members.length);
+	const gone = fatalReason(input.members);
+	if (gone !== null) return {
+		kind: "unavailable",
+		fatal: true,
+		reason: gone,
+		counts
+	};
+	if (input.publish === "included") return {
+		kind: "value",
+		value: counts.included,
+		counts
+	};
+	if (input.publish === "excluded") return {
+		kind: "value",
+		value: counts.excluded,
+		counts
+	};
+	if (input.publish === "total") return {
+		kind: "value",
+		value: counts.total,
+		counts
+	};
+	if (included.length === 0) return emptyOutcome(input.empty, counts);
+	if (isBinaryReducer(input.reducer)) {
+		const flags = included.filter((value) => typeof value === "boolean");
+		return {
+			kind: "value",
+			value: reduceBooleans(input.reducer, flags),
+			counts
+		};
+	}
+	const numbers = included.filter((value) => typeof value === "number");
+	return {
+		kind: "value",
+		value: reduceNumbers(input.reducer, numbers),
+		counts
+	};
+}
+//#endregion
+//#region src/composition/helpers/source-pick.ts
+/** What the member step asks the selector for this template. */
+function sourcePickForTemplate(template) {
+	const valueKind = template.family === "numeric" ? "number" : "boolean";
+	return {
+		purpose: "member",
+		multiple: true,
+		max: 64,
+		deviceTypes: [template.memberDeviceType],
+		accept: template.accept.map((field) => ({
+			...field,
+			valueKind
+		})),
+		history: {
+			required: false,
+			minRetentionMs: null
+		},
+		mustBindCaps: template.family === "actuator" ? [template.outputCap] : [],
+		exclude: []
+	};
+}
+//#endregion
 //#region src/units/unit-table.ts
 /**
 * Frozen unit → spec table. `•` in the doc marks each dimension's canonical
@@ -77740,11 +78571,45 @@ function expressionOutcome(source, read, now, stateful) {
 		deadline: deadlines.length > 0 ? Math.min(...deadlines) : null
 	};
 }
+function aggregateRead(reading) {
+	if (reading.state === "unavailable") return {
+		state: "unavailable",
+		fatal: reading.fatal,
+		reason: reading.reason
+	};
+	return {
+		state: reading.state,
+		value: reading.value,
+		...reading.state === "stale" ? { reason: reading.reason } : {}
+	};
+}
+function aggregateField(source, read) {
+	const outcome = evaluateAggregate({
+		reducer: source.reducer,
+		members: source.reads.map((item) => aggregateRead(read(item))),
+		publish: source.publish,
+		empty: source.empty
+	});
+	if (outcome.kind === "value") return {
+		state: "fresh",
+		value: outcome.value,
+		reason: null,
+		deadline: null
+	};
+	return {
+		state: "unavailable",
+		value: null,
+		reason: outcome.reason,
+		fatal: outcome.fatal,
+		confirmed: true
+	};
+}
 function evaluateCompositionField(input) {
 	const { source } = input;
 	switch (source.kind) {
 		case "from": return fromReading(input.read(source), source);
 		case "expression": return expressionOutcome(source, input.read, input.now, input.stateful);
+		case "aggregate": return aggregateField(source, input.read);
 		case "code": return {
 			state: "unavailable",
 			value: null,
@@ -80600,6 +81465,8 @@ var DEVICE_LOCAL_STATE_CAPS = {
 	featureProbe: featureProbeCapability,
 	flood: floodCapability,
 	gas: gasCapability,
+	groupCommands: groupCommandsCapability,
+	groupStatus: groupStatusCapability,
 	heatingValve: heatingValveCapability,
 	humidifier: humidifierCapability,
 	humiditySensor: humiditySensorCapability,
@@ -82817,6 +83684,13 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		access: "view",
 		role: "admin"
 	},
+	"addons.getPackageDocs": {
+		capName: "addons",
+		capScope: "system",
+		addonId: null,
+		access: "view",
+		role: "admin"
+	},
 	"addons.getVersions": {
 		capName: "addons",
 		capScope: "system",
@@ -85925,6 +86799,20 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		access: "view",
 		role: "viewer"
 	},
+	"groupCommands.getStatus": {
+		capName: "group-commands",
+		capScope: "device",
+		addonId: null,
+		access: "view",
+		role: "viewer"
+	},
+	"groupStatus.getStatus": {
+		capName: "group-status",
+		capScope: "device",
+		addonId: null,
+		access: "view",
+		role: "viewer"
+	},
 	"heatingValve.getStatus": {
 		capName: "heating-valve",
 		capScope: "device",
@@ -92463,6 +93351,8 @@ var KNOWN_CAP_NAMES = [
 	"filesystem-browse",
 	"flood",
 	"gas",
+	"group-commands",
+	"group-status",
 	"heating-valve",
 	"humidifier",
 	"humidity-sensor",
@@ -92611,6 +93501,8 @@ var DEVICE_CAP_NAMES = [
 	"feature-probe",
 	"flood",
 	"gas",
+	"group-commands",
+	"group-status",
 	"heating-valve",
 	"humidifier",
 	"humidity-sensor",
@@ -96128,6 +97020,37 @@ var SENSOR_CAP_VOCABULARY = {
 			icon: "flame"
 		}]
 	},
+	"group-commands": {
+		scope: "device",
+		noun: t("Group command", "Comando di gruppo")
+	},
+	"group-status": {
+		scope: "device",
+		noun: t("Group", "Gruppo"),
+		state: [
+			{
+				kind: "numeric",
+				field: "included",
+				quantity: t("the members reporting", "i membri che rispondono"),
+				label: t("Reporting", "Rispondono"),
+				icon: "users"
+			},
+			{
+				kind: "numeric",
+				field: "excluded",
+				quantity: t("the members left out", "i membri esclusi"),
+				label: t("Excluded", "Esclusi"),
+				icon: "users"
+			},
+			{
+				kind: "numeric",
+				field: "total",
+				quantity: t("the member count", "il numero di membri"),
+				label: t("Members", "Membri"),
+				icon: "sigma"
+			}
+		]
+	},
 	"humidity-sensor": {
 		scope: "device",
 		noun: t("Humidity", "Umidità"),
@@ -98265,6 +99188,8 @@ var CAP_NAMES_WITH_STATUS = [
 	"feature-probe",
 	"flood",
 	"gas",
+	"group-commands",
+	"group-status",
 	"heating-valve",
 	"humidifier",
 	"humidity-sensor",
@@ -98387,6 +99312,8 @@ var CAPABILITY_NAMES = {
 	filesystemBrowse: "filesystem-browse",
 	flood: "flood",
 	gas: "gas",
+	groupCommands: "group-commands",
+	groupStatus: "group-status",
 	heatingValve: "heating-valve",
 	humidifier: "humidifier",
 	humiditySensor: "humidity-sensor",
@@ -98793,6 +99720,14 @@ var CAPABILITY_ROUTER_KEYS = [
 		key: "gas",
 		name: "gas"
 	},
+	{
+		key: "groupCommands",
+		name: "group-commands"
+	},
+	{
+		key: "groupStatus",
+		name: "group-status"
+	},
 	{
 		key: "heatingValve",
 		name: "heating-valve"
@@ -99306,6 +100241,8 @@ var ALL_CAPABILITY_DEFINITIONS = [
 	filesystemBrowseCapability,
 	floodCapability,
 	gasCapability,
+	groupCommandsCapability,
+	groupStatusCapability,
 	heatingValveCapability,
 	humidifierCapability,
 	humiditySensorCapability,
@@ -100382,6 +101319,16 @@ var METHOD_DEVICE_SELECTORS = Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"groupCommands.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"groupStatus.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"heatingValve.getStatus": [{
 		name: "deviceId",
 		form: "single",
@@ -102393,7 +103340,7 @@ function getCapsByProviderKind(kind) {
 //#region src/generated/runtime-state-durability.ts
 /**
 * Per-cap runtime-state policy, projected from every `*.cap.ts` that declares
-* `runtimeState`. 72 caps: 38 `restored`, 34 `session`.
+* `runtimeState`. 74 caps: 38 `restored`, 36 `session`.
 *
 * A cap absent from this map has no runtime-state slice at all. A cap PRESENT
 * with `durability: 'session'` has one and has decided not to keep it.
@@ -102511,6 +103458,14 @@ var RUNTIME_STATE_POLICY = {
 		durability: "restored",
 		volatileFields: ["lastChangedAt"]
 	},
+	"group-commands": {
+		durability: "session",
+		volatileFields: []
+	},
+	"group-status": {
+		durability: "session",
+		volatileFields: []
+	},
 	"heating-valve": {
 		durability: "session",
 		volatileFields: ["lastFetchedAt"]
@@ -102853,7 +103808,7 @@ var BucketAccumulator = class {
 //#region src/generated/history-catalog.ts
 /**
 * Cap history catalog, projected from every `*.cap.ts` `history` block.
-* 41 caps with series (75 series), 30 caps answered `'none'`.
+* 41 caps with series (75 series), 32 caps answered `'none'`.
 * Field keys are `runtimeState` paths (`a.b` into fixed objects only).
 */
 var HISTORY_CATALOG = {
@@ -103254,6 +104209,8 @@ var HISTORY_NONE_CAPS = [
 	"doorbell",
 	"event-emitter",
 	"feature-probe",
+	"group-commands",
+	"group-status",
 	"image",
 	"image-settings",
 	"intercom",
@@ -103832,6 +104789,7 @@ function createSystemProxy(api) {
 			listCapabilityProviders: (input) => dispatch("addons", "listCapabilityProviders", "query", input),
 			setCapabilityProviderEnabled: (input) => dispatch("addons", "setCapabilityProviderEnabled", "mutation", input),
 			getVersions: (input) => dispatch("addons", "getVersions", "query", input),
+			getPackageDocs: (input) => dispatch("addons", "getPackageDocs", "query", input),
 			restartAddon: (input) => dispatch("addons", "restartAddon", "mutation", input),
 			retryLoad: (input) => dispatch("addons", "retryLoad", "mutation", input),
 			getAutoUpdateSettings: (input) => dispatch("addons", "getAutoUpdateSettings", "query", input),
@@ -105414,8 +106372,8 @@ var NC_SYSTEM_EVENT_FILTER_KEYS = [
 function systemEventFilterApplies(kind, filter) {
 	if (LEGACY_KINDS_WITHOUT_FILTERS.has(kind)) return false;
 	switch (filter) {
-		case "deviceIds": return kind.startsWith("device-") || kind.startsWith("stream-") || kind === "detection-blind" || kind.startsWith("motion-") || kind.startsWith("recording-") || kind === "alarm-triggered";
-		case "deviceTypes": return kind.startsWith("device-") || kind === "detection-blind" || kind.startsWith("motion-");
+		case "deviceIds": return kind.startsWith("device-") || kind.startsWith("stream-") || kind === "detection-blind" || kind.startsWith("motion-") || kind.startsWith("package-llm-") || kind.startsWith("recording-") || kind === "alarm-triggered";
+		case "deviceTypes": return kind.startsWith("device-") || kind === "detection-blind" || kind.startsWith("motion-") || kind.startsWith("package-llm-");
 		case "nodeIds": return kind.startsWith("node-") || kind === "addon-crash-loop" || kind === "addon-update-available" || kind === "addon-updated" || kind === "server-update-available" || kind === "wrapper-update-available" || kind === "server-updated" || kind.startsWith("storage-location-") || kind.startsWith("alert-");
 		case "packageNames": return kind.endsWith("update-available") || kind === "addon-updated" || kind === "node-updating" || kind === "server-updated";
 		case "consumableLowPercent": return NC_CONSUMABLE_SYSTEM_EVENT_KINDS.includes(kind);
@@ -105472,6 +106430,8 @@ var NC_SYSTEM_EVENT_FAMILY = {
 	"detection-blind": "device-events",
 	"motion-noisy": "device-events",
 	"motion-calm": "device-events",
+	"package-llm-silent": "device-events",
+	"package-llm-answered": "device-events",
 	"recording-stalled": "device-events",
 	"recording-healthy": "device-events",
 	"recording-degraded": "device-events",
@@ -105573,6 +106533,12 @@ var NC_SYSTEM_EVENT_KIND_GROUP_SPECS = [
 		label: "Motion without a subject",
 		kinds: ["motion-noisy", "motion-calm"]
 	},
+	{
+		id: "package-llm",
+		family: "device-events",
+		label: "Package confirm",
+		kinds: ["package-llm-silent", "package-llm-answered"]
+	},
 	{
 		id: "recording",
 		family: "device-events",
@@ -107493,6 +108459,8 @@ var DEVICE_EVENTS = [
 	"detection-blind",
 	"motion-noisy",
 	"motion-calm",
+	"package-llm-silent",
+	"package-llm-answered",
 	"recording-stalled",
 	"recording-healthy",
 	"recording-degraded",
@@ -108096,7 +109064,8 @@ var NC_TEMPLATE_VARS = [
 		systemEventKinds: [
 			"recording-degraded",
 			...DEVICE_ATTENTION,
-			...ALERT_EPISODE
+			...ALERT_EPISODE,
+			"package-llm-silent"
 		]
 	},
 	{
@@ -108189,7 +109158,8 @@ var NC_TEMPLATE_VARS = [
 		systemEventKinds: [
 			"storage-location-low",
 			"storage-location-critical",
-			"storage-location-ok"
+			"storage-location-ok",
+			"package-llm-silent"
 		]
 	},
 	{
@@ -108600,7 +109570,9 @@ var NC_TEMPLATE_HELD_BACK_SYSTEM_EVENT_KINDS = [
 	"device-attention-required",
 	"device-attention-resolved",
 	"rule-broken",
-	"rule-repaired"
+	"rule-repaired",
+	"package-llm-silent",
+	"package-llm-answered"
 ];
 /**
 * The catalog as `getTemplateCatalog` SERVES it: every descriptor, with the
@@ -108762,6 +109734,15 @@ var NC_SYSTEM_EVENT_CLASS_SPECS = [
 		snapshotLabel: "Cameras with constant motion now",
 		snapshotSection: null
 	},
+	{
+		id: "package-llm-confirm",
+		family: "device-events",
+		label: "Package confirm (not answering / answering again)",
+		bad: ["package-llm-silent"],
+		recovery: ["package-llm-answered"],
+		snapshotLabel: "Cameras whose package confirm is not answering",
+		snapshotSection: null
+	},
 	{
 		id: "recording-health",
 		family: "device-events",
@@ -114505,10 +115486,12 @@ function armRemovalReconcile(opts) {
 //#endregion
 exports.ACCESSORY_LABEL = ACCESSORY_LABEL;
 exports.ACCESS_ROLES = ACCESS_ROLES;
+exports.ACTIVE_CRITERIA = require_composition.ACTIVE_CRITERIA;
 exports.ADMIN_SCOPE = ADMIN_SCOPE;
 exports.AGENT_MDNS_QUERY_NAME = AGENT_MDNS_QUERY_NAME;
 exports.AGENT_MDNS_SERVICE_TYPE = AGENT_MDNS_SERVICE_TYPE;
 exports.AGENT_MDNS_TXT_KEYS = AGENT_MDNS_TXT_KEYS;
+exports.AGGREGATE_REDUCERS = require_composition.AGGREGATE_REDUCERS;
 exports.AGGREGATE_THROUGHPUT_BY_KIND = AGGREGATE_THROUGHPUT_BY_KIND;
 exports.ALEXA_EGRESS_PROFILE = ALEXA_EGRESS_PROFILE;
 exports.ALL_CAPABILITY_DEFINITIONS = ALL_CAPABILITY_DEFINITIONS;
@@ -114542,6 +115525,7 @@ exports.AcceleratorComputeSchema = AcceleratorComputeSchema;
 exports.AcceleratorKindSchema = AcceleratorKindSchema;
 exports.AccessoriesStatusSchema = AccessoriesStatusSchema;
 exports.AccessoryKind = AccessoryKind;
+exports.ActiveCriterionSchema = require_composition.ActiveCriterionSchema;
 exports.AddBrokerInputSchema = AddBrokerInputSchema;
 exports.AddRetrainFrameFromRecordingResultSchema = AddRetrainFrameFromRecordingResultSchema;
 exports.AddonAutoUpdateSchema = AddonAutoUpdateSchema;
@@ -114563,6 +115547,7 @@ exports.AdoptionOutcomeSchema = AdoptionOutcomeSchema;
 exports.AdoptionReleaseInputSchema = ReleaseInputSchema;
 exports.AdoptionStatusSchema = AdoptionStatusSchema;
 exports.AgentLoadSummarySchema = AgentLoadSummarySchema;
+exports.AggregateReducerSchema = require_composition.AggregateReducerSchema;
 exports.AirQualitySensorStatusSchema = AirQualitySensorStatusSchema;
 exports.AlarmArmModeSchema = AlarmArmModeSchema;
 exports.AlarmPanelStatusSchema = AlarmPanelStatusSchema;
@@ -114629,6 +115614,7 @@ exports.BASE_LIVE_EGRESS_PROFILE = BASE_LIVE_EGRESS_PROFILE;
 exports.BATTERY_DEVICE_PROFILE = BATTERY_DEVICE_PROFILE;
 exports.BATTERY_UNREACHABLE_AFTER_MS = BATTERY_UNREACHABLE_AFTER_MS;
 exports.BENCH_ROOT_STEP_ID = BENCH_ROOT_STEP_ID;
+exports.BINARY_AGGREGATES = require_composition.BINARY_AGGREGATES;
 exports.BIRTH_DECISION_DEFAULT_LIMIT = BIRTH_DECISION_DEFAULT_LIMIT;
 exports.BOOT_RECOVERY_BACKOFF_MS = require_sleep.BOOT_RECOVERY_BACKOFF_MS;
 exports.BUILTIN_RESULT_KINDS = BUILTIN_RESULT_KINDS;
@@ -114839,6 +115825,7 @@ exports.ComposerApplyResultSchema = ComposerApplyResultSchema;
 exports.ComposerBlockSchema = ComposerBlockSchema;
 exports.ComposerBlockVerdictSchema = ComposerBlockVerdictSchema;
 exports.ComposerUnreadableBlockSchema = ComposerUnreadableBlockSchema;
+exports.CompositionAggregateSourceSchema = require_composition.CompositionAggregateSourceSchema;
 exports.CompositionBindingSchema = require_composition.CompositionBindingSchema;
 exports.CompositionBlockInputSchema = CompositionBlockInputSchema;
 exports.CompositionBlockStateSchema = CompositionBlockStateSchema;
@@ -115192,6 +116179,7 @@ exports.FACE_RESCORE_INTERVAL_FIELD = FACE_RESCORE_INTERVAL_FIELD;
 exports.FACE_RESCORE_INTERVAL_KEY = FACE_RESCORE_INTERVAL_KEY;
 exports.FACE_RESCORE_INTERVAL_MIN_RUNNING = FACE_RESCORE_INTERVAL_MIN_RUNNING;
 exports.FACE_RESCORE_SECTION_ID = FACE_RESCORE_SECTION_ID;
+exports.FAN_OUT_CONCURRENCY = FAN_OUT_CONCURRENCY;
 exports.FEEDER_EXAMPLE_ADDON_ID = FEEDER_EXAMPLE_ADDON_ID;
 exports.FEEDER_EXAMPLE_HA_DEVICE_ID = FEEDER_EXAMPLE_HA_DEVICE_ID;
 exports.FFMPEG_PATH_ENV = require_composition.FFMPEG_PATH_ENV;
@@ -115215,12 +116203,19 @@ exports.FrameInputSchema = FrameInputSchema;
 exports.FrameLazyCountersSchema = FrameLazyCountersSchema;
 exports.FrameLazyMetricsSchema = FrameLazyMetricsSchema;
 exports.G711_SCALE_CORRECTION_DB = G711_SCALE_CORRECTION_DB;
+exports.GROUP_TEMPLATES = GROUP_TEMPLATES;
+exports.GROUP_TEMPLATE_IDS = require_composition.GROUP_TEMPLATE_IDS;
 exports.GasStatusSchema = GasStatusSchema;
 exports.GetLoggingSettingsInputSchema = GetLoggingSettingsInputSchema;
 exports.GetStreamWithCodecInputSchema = GetStreamWithCodecInputSchema;
 exports.GlobalMetricsSchema = GlobalMetricsSchema;
 exports.GridLayoutPatchSchema = GridLayoutPatchSchema;
 exports.GridLayoutViewSchema = GridLayoutViewSchema;
+exports.GroupCommandResultSchema = GroupCommandResultSchema;
+exports.GroupCommandsSchema = GroupCommandsSchema;
+exports.GroupHelperSpecSchema = require_composition.GroupHelperSpecSchema;
+exports.GroupStatusSchema = GroupStatusSchema;
+exports.GroupTemplateIdSchema = require_composition.GroupTemplateIdSchema;
 exports.HAP_AUDIO_BASE = HAP_AUDIO_BASE;
 exports.HAP_AUDIO_BITRATE_KBPS = HAP_AUDIO_BITRATE_KBPS;
 exports.HAP_AUDIO_VBV_KBITS = HAP_AUDIO_VBV_KBITS;
@@ -115244,6 +116239,8 @@ exports.HWACCEL_OPTIONS = HWACCEL_OPTIONS;
 exports.HardwareClassIdSchema = HardwareClassIdSchema;
 exports.HealthStatusSchema = HealthStatusSchema;
 exports.HeatingValveStatusSchema = HeatingValveStatusSchema;
+exports.HelperMemberSchema = require_composition.HelperMemberSchema;
+exports.HelperSpecSchema = require_composition.HelperSpecSchema;
 exports.HfModelResolutionSchema = HfModelResolutionSchema;
 exports.HistoryPointSchema = HistoryPointSchema;
 exports.HistoryResolutionEnum = HistoryResolutionEnum;
@@ -115303,6 +116300,7 @@ exports.LABEL_SUPPLY_MACRO = LABEL_SUPPLY_MACRO;
 exports.LABEL_SUPPLY_STEP_IDS = LABEL_SUPPLY_STEP_IDS;
 exports.LABEL_SUPPLY_VOCABULARIES = LABEL_SUPPLY_VOCABULARIES;
 exports.LEGACY_READ_ONLY_CONFIG_KEY = LEGACY_READ_ONLY_CONFIG_KEY;
+exports.LIGHT_SHARED_CAPS = LIGHT_SHARED_CAPS;
 exports.LINKED_DEVICES_SLOT = LINKED_DEVICES_SLOT;
 exports.LINKED_LABEL_STEP_PREFIX = LINKED_LABEL_STEP_PREFIX;
 exports.LLM_PROFILE_KIND_PATTERN = LLM_PROFILE_KIND_PATTERN;
@@ -115418,6 +116416,7 @@ exports.MAX_EXPRESSION_BINDINGS = require_composition.MAX_EXPRESSION_BINDINGS;
 exports.MAX_EXPRESSION_CALL_ARGS = require_composition.MAX_EXPRESSION_CALL_ARGS;
 exports.MAX_EXPRESSION_EVAL_STEPS = require_composition.MAX_EXPRESSION_EVAL_STEPS;
 exports.MAX_EXPRESSION_SOURCE_LENGTH = require_composition.MAX_EXPRESSION_SOURCE_LENGTH;
+exports.MAX_HELPER_MEMBERS = require_composition.MAX_HELPER_MEMBERS;
 exports.MAX_KEYS = MAX_KEYS;
 exports.MAX_REASONS_PER_KEY = MAX_REASONS_PER_KEY;
 exports.MAX_REQUEUED_BUCKETS_PER_SERIES = MAX_REQUEUED_BUCKETS_PER_SERIES;
@@ -115609,6 +116608,7 @@ exports.NETWORK_LINK_UNKNOWN = NETWORK_LINK_UNKNOWN;
 exports.NODE_BENCHMARK_DEFAULTS = NODE_BENCHMARK_DEFAULTS;
 exports.NODE_COLOR_IDS = require_node_color.NODE_COLOR_IDS;
 exports.NO_MEASURED_CAPACITY = NO_MEASURED_CAPACITY;
+exports.NUMERIC_AGGREGATES = require_composition.NUMERIC_AGGREGATES;
 exports.NativeCropBboxSchema = NativeCropBboxSchema;
 exports.NativeCropRefSchema = NativeCropRefSchema;
 exports.NativeCropResultSchema = NativeCropResultSchema;
@@ -116510,6 +117510,7 @@ exports.actionsForDevice = actionsForDevice;
 exports.actionsForDeviceType = actionsForDeviceType;
 exports.actionsForDevices = actionsForDevices;
 exports.activateAlarmProfile = activateAlarmProfile;
+exports.activeForReducer = activeForReducer;
 exports.addonCatalogHref = addonCatalogHref;
 exports.addonPagesCapability = addonPagesCapability;
 exports.addonPagesSourceCapability = addonPagesSourceCapability;
@@ -116663,6 +117664,7 @@ exports.commitWatchdogRestart = commitWatchdogRestart;
 exports.compareToTarget = compareToTarget;
 exports.compileExpression = require_composition.compileExpression;
 exports.compileExpressionSafe = require_composition.compileExpressionSafe;
+exports.compileHelper = compileHelper;
 exports.compileKeyedArrayOverride = compileKeyedArrayOverride;
 exports.compilePulseOverride = compilePulseOverride;
 exports.compileScalarOverride = compileScalarOverride;
@@ -116825,6 +117827,7 @@ exports.enumerateItemArrayFields = enumerateItemArrayFields;
 exports.enumerateSchemaFields = enumerateSchemaFields;
 exports.errMsg = require_err_msg.errMsg;
 exports.estimateNodeBenchmarkDurationMs = estimateNodeBenchmarkDurationMs;
+exports.evaluateAggregate = evaluateAggregate;
 exports.evaluateAst = require_composition.evaluateAst;
 exports.evaluateCompositionField = evaluateCompositionField;
 exports.evaluateCount = require_composition.evaluateCount;
@@ -116855,6 +117858,7 @@ exports.faceGalleryCapability = faceGalleryCapability;
 exports.failureContributionCapability = failureContributionCapability;
 exports.failureRate = failureRate;
 exports.fanControlCapability = fanControlCapability;
+exports.fanOutTargets = fanOutTargets;
 exports.featureFieldEntries = require_composition.featureFieldEntries;
 exports.featureOfRole = featureOfRole;
 exports.featureProbeCapability = featureProbeCapability;
@@ -116898,10 +117902,14 @@ exports.gifFilterComplex = gifFilterComplex;
 exports.gifFromMp4Args = gifFromMp4Args;
 exports.globalSecretScope = require_sleep.globalSecretScope;
 exports.grantRowsOf = grantRowsOf;
+exports.groupCommandsCapability = groupCommandsCapability;
+exports.groupStatusCapability = groupStatusCapability;
+exports.groupTemplate = groupTemplate;
 exports.hasModelBoundOverrides = hasModelBoundOverrides;
 exports.hasMotionTrigger = hasMotionTrigger;
 exports.hasUrlScheme = hasUrlScheme;
 exports.heatingValveCapability = heatingValveCapability;
+exports.helperSaveProblems = helperSaveProblems;
 exports.hfModelUrl = require_sleep.hfModelUrl;
 exports.historyFieldsFor = historyFieldsFor;
 exports.historyItemFieldPath = require_sleep.historyItemFieldPath;
@@ -117134,6 +118142,7 @@ exports.parseAppAuthCallback = parseAppAuthCallback;
 exports.parseAppFlowRequest = parseAppFlowRequest;
 exports.parseAppPageLang = parseAppPageLang;
 exports.parseCameraStreamConfig = parseCameraStreamConfig;
+exports.parseColorInput = parseColorInput;
 exports.parseCredentialScopes = parseCredentialScopes;
 exports.parseDeviceEnrollmentLink = parseDeviceEnrollmentLink;
 exports.parseExpression = require_composition.parseExpression;
@@ -117243,6 +118252,7 @@ exports.recordsCapability = recordsCapability;
 exports.recordsErrorFromMessage = require_sleep.recordsErrorFromMessage;
 exports.rectsToCells = rectsToCells;
 exports.reducePoints = reducePoints;
+exports.reducerForActive = reducerForActive;
 exports.registerKnownSecret = require_sleep.registerKnownSecret;
 exports.remapCropDetections = remapCropDetections;
 exports.renameAlarmProfile = renameAlarmProfile;
@@ -117319,6 +118329,7 @@ exports.ruleSection = ruleSection;
 exports.ruleSectionOf = ruleSectionOf;
 exports.ruleSeedForSection = ruleSeedForSection;
 exports.ruleTriggerZoneIds = ruleTriggerZoneIds;
+exports.runFanOut = runFanOut;
 exports.runInferenceStep = runInferenceStep;
 exports.runningFromDishwasherOperation = runningFromDishwasherOperation;
 exports.runningFromLawnMower = runningFromLawnMower;
@@ -117329,6 +118340,7 @@ exports.runtimeDevices = runtimeDevices;
 exports.runtimeFieldUnit = runtimeFieldUnit;
 exports.runtimeStatePolicyFor = runtimeStatePolicyFor;
 exports.sameDoFamily = sameDoFamily;
+exports.sameHelperBody = sameHelperBody;
 exports.sameRead = sameRead;
 exports.sceneMonitorCapability = sceneMonitorCapability;
 exports.scheduleForSendTimes = scheduleForSendTimes;
@@ -117366,6 +118378,8 @@ exports.settingValuesEqual = settingValuesEqual;
 exports.settingsBelow = settingsBelow;
 exports.settingsStoreCapability = settingsStoreCapability;
 exports.shareViewGrantOf = shareViewGrantOf;
+exports.sharedColorModes = sharedColorModes;
+exports.sharedLightCaps = sharedLightCaps;
 exports.shortHostname = shortHostname;
 exports.shortSecretRefHash = require_sleep.shortSecretRefHash;
 exports.signalPercentFromBars = signalPercentFromBars;
@@ -117378,6 +118392,7 @@ exports.sliceChangedAt = require_composition.sliceChangedAt;
 exports.smokeCapability = smokeCapability;
 exports.smtpProviderCapability = smtpProviderCapability;
 exports.snapshotCapability = snapshotCapability;
+exports.sourcePickForTemplate = sourcePickForTemplate;
 exports.splitTranslationRef = splitTranslationRef;
 exports.squareAround = squareAround;
 exports.ssoBridgeCapability = ssoBridgeCapability;
@@ -117440,6 +118455,7 @@ exports.taskPhaseSchema = taskPhaseSchema;
 exports.taskTargetSchema = taskTargetSchema;
 exports.temperatureSensorCapability = temperatureSensorCapability;
 exports.templateCarriesSummary = templateCarriesSummary;
+exports.templateDeviceType = templateDeviceType;
 exports.templateVarDeliveryApplies = templateVarDeliveryApplies;
 exports.templateVarKindApplies = templateVarKindApplies;
 exports.templateVarSystemEventApplies = templateVarSystemEventApplies;