@camstack/types 1.2.418 → 1.2.420

package/dist/client.mjs

@@ -22677,6 +22677,8 @@ var NcSystemEventKindSchema = z.enum([
 	"detection-blind",
 	"motion-noisy",
 	"motion-calm",
+	"package-llm-silent",
+	"package-llm-answered",
 	"recording-stalled",
 	"recording-healthy",
 	"recording-degraded",
@@ -26233,6 +26235,162 @@ method(z.object({
 	auth: "protected"
 });
 //#endregion
+//#region src/device/container-primary-child.ts
+/**
+* WHICH child a container stands for — one definition, for every consumer.
+*
+* A CONTAINER device has no controllable surface of its own: it groups entity
+* children (a Gree air-conditioner grouping a climate child plus light, x-fan
+* and health switches). Everything that has to show or act on a container has
+* to answer the same question — which child IS the container — and until now
+* three places answered it separately:
+*
+*   - `ui-library/device-controls/primary-child.ts`   (admin-ui rendering)
+*   - `addon-provider-homeassistant` PARENT_TYPE_PRIORITY (adoption)
+*   - the viewer's own `container-primary.ts`         (linked-devices panel)
+*
+* Each carried the same list and a comment asking the others to stay in sync.
+* This is that list, in the one package all of them already depend on.
+*
+* `ui-library` and the server's linked-devices expansion IMPORT it. Two
+* consumers cannot, and keep a checked copy instead: the viewer resolves
+* `@camstack/types` from its own `node_modules` (an installed release, where a
+* newly added export simply is not there), and the Home Assistant provider
+* expresses the same precedence over the `DeviceType` enum because it answers
+* a different question from the same ordering. `scripts/check-container-
+* priority-in-sync.ts` fails the build when either drifts — the comment that
+* used to ask for this could not.
+*
+* The rule has two halves and the ORDER matters: an operator's explicit pick
+* wins outright, and only in its absence does type priority decide. The pick is
+* keyed on the child's re-sync-stable `entityId`, not its numeric id, so it
+* survives a re-sync that reallocates ids.
+*/
+/**
+* Type priority, most→least "primary". An actuator (climate / lock / cover / …)
+* outranks a bare `switch` so a container's defining child wins over its
+* auxiliary switches. Unknown or absent types sort after every entry.
+*
+* NB: `siren` deliberately sits BELOW `switch` — it is a switch-family
+* actuator, and a camera's siren must not out-rank the thing the container is.
+*
+* These strings are matched against a child's `DeviceType` VALUE, so they must
+* equal the enum's string values.
+*/
+var CONTAINER_CHILD_PRIORITY = [
+	"media-player",
+	"alarm-panel",
+	"thermostat",
+	"climate",
+	"humidifier",
+	"water-heater",
+	"lock",
+	"cover",
+	"valve",
+	"fan",
+	"vacuum",
+	"lawn-mower",
+	"dishwasher",
+	"light",
+	"switch",
+	"siren",
+	"button",
+	"control",
+	"notifier",
+	"script",
+	"automation",
+	"update",
+	"presence",
+	"weather",
+	"image",
+	"sensor"
+];
+/**
+* Roles that say what a container IS, most→least defining. Consulted BEFORE
+* type priority, because `DeviceType` cannot tell them apart: Home Assistant
+* maps a door contact, a battery level, a temperature reading and a "last seen"
+* timestamp all to `DeviceType.Sensor`. Measured on container 4127 — children
+* `battery-sensor`, `temperature-sensor`, `datetime-sensor`, `contact-sensor`
+* and a role-less `button` — the type list ranked `button` above `sensor` and
+* the container stood for its "Identifica" button instead of the door contact
+* it is named after.
+*
+* Only STATE-DEFINING roles belong here. A diagnostic reading (battery,
+* temperature, humidity, signal, last-seen) is never what a container is, so
+* they are deliberately absent and fall through to type priority.
+*/
+var CONTAINER_CHILD_ROLE_PRIORITY = [
+	"contact-sensor",
+	"motion-sensor",
+	"occupancy-sensor",
+	"smoke-sensor",
+	"co-sensor",
+	"gas-sensor",
+	"leak-sensor",
+	"vibration-sensor",
+	"tamper-sensor",
+	"sound-sensor"
+];
+/**
+* NOT in the list, deliberately: `binary-sensor` and `binary-helper`. They are
+* GENERIC — they say "this reports a boolean", not what the container is — and
+* ranking them above type priority is a live regression, not a hypothetical:
+* container 1837 holds a real `lock` (features `['lock-open']`) alongside a
+* child named "Actuator" whose only role is `binary-sensor`, and the generic
+* role beat the lock. A role earns a place here by naming a SUBJECT (a contact,
+* a leak, smoke), never by naming a datatype.
+*/
+function roleRank(role) {
+	if (role === void 0) return CONTAINER_CHILD_ROLE_PRIORITY.length;
+	const i = CONTAINER_CHILD_ROLE_PRIORITY.indexOf(role);
+	return i === -1 ? CONTAINER_CHILD_ROLE_PRIORITY.length : i;
+}
+function rank(type) {
+	const i = CONTAINER_CHILD_PRIORITY.indexOf(type);
+	return i === -1 ? CONTAINER_CHILD_PRIORITY.length : i;
+}
+/**
+* The child a container stands for: the operator's pick when it still exists,
+* else the highest-priority type. `null` for a childless container — a caller
+* must decide what an empty container means for it, rather than being handed a
+* child that is not there.
+*/
+/**
+* Two names for the same thing, compared the way an integration writes them.
+*
+* An exact case-insensitive match was not enough, and the failure was total
+* rather than marginal. An ESPHome shutter arrives as a container named
+* `Tapparella-Kitchen` whose children include the COVER, named `Tapparella
+* kitchen`, and a device-presence entity carrying the slug verbatim,
+* `tapparella-kitchen`. The slug matched the container exactly and the cover
+* did not, so the namesake tie-break handed the container to a connectivity
+* indicator — and the viewer's accessory panel, which correctly shows only
+* children with an actuating control, then rendered NOTHING. The operator saw
+* no shutters at all on kitchen, studio and both porch cameras (2026-09-22).
+*
+* `Markise` was the control case that proved the mechanism: there the cover
+* really is called exactly like its container, so it won and appeared.
+*
+* Separators are therefore normalised — `-`, `_` and whitespace are the same
+* character for this comparison, and runs of them collapse. The two candidates
+* then tie on the namesake and the decision falls through to `rank(type)`,
+* where `cover` is eighth and a `presence` entity is not listed at all. The
+* criterion keeps doing its job for a container whose child IS the namesake;
+* it stops being decided by which integration used a hyphen.
+*/
+function sameName(childName, containerName) {
+	const flatten = (v) => v.toLowerCase().replace(/[-_\s]+/g, " ").trim();
+	return flatten(childName) === flatten(containerName);
+}
+function resolveContainerPrimaryChild(children, overrideEntityId, containerName) {
+	if (overrideEntityId !== void 0 && overrideEntityId !== null) {
+		const picked = children.find((c) => c.stableId === overrideEntityId) ?? children.find((c) => c.entityId !== void 0 && c.entityId === overrideEntityId);
+		if (picked !== void 0) return picked;
+	}
+	const namesake = (c) => containerName !== void 0 && containerName.length > 0 && c.name !== void 0 && sameName(c.name, containerName) ? 0 : 1;
+	return [...children].toSorted((a, b) => roleRank(a.role) - roleRank(b.role) || namesake(a) - namesake(b) || rank(a.type) - rank(b.type))[0] ?? null;
+}
+//#endregion
 //#region src/device/device-state-handle.ts
 var DEVICE_STATE_EVENT_CATEGORY = "device.state-changed";
 /**
@@ -26667,6 +26825,7 @@ function createDeviceProxy(api, binding, opts) {
 	const featureProbeInterface = { getStatus: (input) => dispatch("feature-probe", "featureProbe", "getStatus", "query", input) };
 	const floodInterface = { getStatus: (input) => dispatch("flood", "flood", "getStatus", "query", input) };
 	const gasInterface = { getStatus: (input) => dispatch("gas", "gas", "getStatus", "query", input) };
+	const groupCommandsInterface = { getStatus: (input) => dispatch("group-commands", "groupCommands", "getStatus", "query", input) };
 	const groupStatusInterface = { getStatus: (input) => dispatch("group-status", "groupStatus", "getStatus", "query", input) };
 	const heatingValveInterface = { getStatus: (input) => dispatch("heating-valve", "heatingValve", "getStatus", "query", input) };
 	const humidifierInterface = {
@@ -27222,6 +27381,7 @@ function createDeviceProxy(api, binding, opts) {
 			featureProbe: createSliceHandle(stateSource, binding.deviceId, "feature-probe"),
 			flood: createSliceHandle(stateSource, binding.deviceId, "flood"),
 			gas: createSliceHandle(stateSource, binding.deviceId, "gas"),
+			groupCommands: createSliceHandle(stateSource, binding.deviceId, "group-commands"),
 			groupStatus: createSliceHandle(stateSource, binding.deviceId, "group-status"),
 			heatingValve: createSliceHandle(stateSource, binding.deviceId, "heating-valve"),
 			humidifier: createSliceHandle(stateSource, binding.deviceId, "humidifier"),
@@ -27306,6 +27466,7 @@ function createDeviceProxy(api, binding, opts) {
 		...bound("feature-probe") ? { featureProbe: featureProbeInterface } : {},
 		...bound("flood") ? { flood: floodInterface } : {},
 		...bound("gas") ? { gas: gasInterface } : {},
+		...bound("group-commands") ? { groupCommands: groupCommandsInterface } : {},
 		...bound("group-status") ? { groupStatus: groupStatusInterface } : {},
 		...bound("heating-valve") ? { heatingValve: heatingValveInterface } : {},
 		...bound("humidifier") ? { humidifier: humidifierInterface } : {},
@@ -28085,6 +28246,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),
@@ -29172,8 +29334,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);
@@ -29230,6 +29392,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",
@@ -29331,6 +29495,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",
@@ -30328,6 +30498,8 @@ var DEVICE_EVENTS = [
 	"detection-blind",
 	"motion-noisy",
 	"motion-calm",
+	"package-llm-silent",
+	"package-llm-answered",
 	"recording-stalled",
 	"recording-healthy",
 	"recording-degraded",
@@ -30931,7 +31103,8 @@ var NC_TEMPLATE_VARS = [
 		systemEventKinds: [
 			"recording-degraded",
 			...DEVICE_ATTENTION,
-			...ALERT_EPISODE
+			...ALERT_EPISODE,
+			"package-llm-silent"
 		]
 	},
 	{
@@ -31024,7 +31197,8 @@ var NC_TEMPLATE_VARS = [
 		systemEventKinds: [
 			"storage-location-low",
 			"storage-location-critical",
-			"storage-location-ok"
+			"storage-location-ok",
+			"package-llm-silent"
 		]
 	},
 	{
@@ -31435,7 +31609,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"
 ];
 /**
 * Is this descriptor held back from the SERVED catalog as a whole (D647)?
@@ -31548,6 +31724,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",
@@ -32208,4 +32393,4 @@ var TimelapseRuleSchema = TimelapseRuleInputSchema.extend({
 	updatedAt: z.number()
 });
 //#endregion
-export { APPLE_SA_TO_MACRO, AUDIO_MACRO_LABELS, AlarmArmModeSchema, CLIP_BROKER_PACED_RATES, COCO_TO_MACRO, CamProfileSchema, DEFAULT_TIMELAPSE_PREVIEW_TEXT, DEFINITIVE_DEVICE_REFUSALS, DEVICE_CERT_RENEW_WINDOW_DAYS, DEVICE_CERT_SIGNATURE, DEVICE_DEFINITIVE_REFUSALS_BEFORE_DELETE, DEVICE_REFRESH_REFUSAL_PREFIX, DEVICE_SIGNATURE_MESSAGE_VERSION, DeviceType, EVENTFUL_CAP_NAMES, EVENT_KIND_BY_CAP, EVENT_TAXONOMY, ICON_CATEGORIES, ICON_ENTRIES, ICON_KEYS, ICON_VIEWER_MODULES, IconKeySchema, LOCATION_ICON_FALLBACK, MACRO_LABELS, NC_ALARM_DELAY_MAX_SEC, NC_ALARM_SENSORS_MAX, NC_ALARM_SYSTEM_EVENT_KINDS, NC_ALARM_TRIGGERED_MAX_SEC, NC_BATTERY_CONSUMABLE_SYSTEM_EVENT_KINDS, NC_CAMERA_SCOPE_CAP_NAME, NC_CONSUMABLE_LOW_PERCENT_DEFAULT, NC_CONSUMABLE_LOW_PERCENT_MAX, NC_GROUPING_DEFAULT_SEC, NC_GROUPING_MAX_SEC, NC_GROUPING_MIN_SEC, NC_RULE_EDITOR_SECTION_ORDER, NC_RULE_KIND_SPECS, NC_SENSOR_TRANSITION_UNSUPPORTED_REASON, NC_SYSTEM_EVENT_CLASS_SPECS, NC_SYSTEM_EVENT_FAMILY_FILTERS, NC_SYSTEM_EVENT_KIND_GROUP_SPECS, NC_SYSTEM_EVENT_SUMMARY_FAMILIES, NC_TEMPLATE_HELD_BACK_SYSTEM_EVENT_KINDS, NC_TEMPLATE_VARS, NcAlarmConfigSchema, NcAlarmSensorsSchema, NcAlarmSettingsPatchSchema, NcHistoryEntrySchema, NcRuleLastRunsSchema, NodeDirectorySchema, RECORDING_EXPORT_MAX_READ_BYTES, RETRAIN_REVIEW_ADJUSTED_IOU, RETRAIN_REVIEW_MATCH_IOU, RETRAIN_REVIEW_STATUSES, RETRAIN_REVISION_CONFLICT, SystemMirror, TIMELAPSE_DENSE_FLOOR_SEC, TimelapseRuleSchema, YAMNET_TO_MACRO, alarmDeviceBlocksArming, alarmDeviceSecureOnArm, alarmPatchLanded, buildDeviceEnrollmentLink, buildDeviceSignatureMessage, buildSubjectPath, bundledCamstack, canonicalIconKey, classifyRetrainReview, conditionVisibleForKind, createSystemProxy, deviceRefusalFromMessage, droppedConditionsForKind, expandSystemEventClasses, iconCategoryLabel, iconEntry, iconsInCategory, isDefinitiveDeviceRefusal, isDrawableSubjectPath, isHeldBackTemplateVar, isIconKey, isSystemRuleKind, kindsForDiscriminator, knownValues, locationIconKey, nodePickerItems, packagePickerItems, paintHex, paletteResultSchema, parseDeviceEnrollmentLink, parseRetrainRevisionConflict, pickerForCondition, pickerForRuleClasses, projectSubjectPath, resolveIconKey, resolveModeDelays, retrainBoxIou, retrainRevisionConflictMessage, ruleDeviceCompatCapNames, ruleEditorSectionsForKind, ruleGroupingApplies, ruleKindOf, ruleKindSpec, ruleSeedForSection, searchIcons, sensorTransitionNeverFires, sensorTransitionOffered, stateLabel, subjectPathSampleFromBox, subjectPathSvgPoints, summarizeReview, systemEventClassKinds, systemEventClassesFor, systemEventDeliveryProblems, systemEventFilterAppliesToAnyKind, systemEventKindsOfFamily, systemFamilyOfKind, templateCarriesSummary, templateVarDeliveryApplies, templateVarKindApplies, templateVarSystemEventApplies, withSystemEventClasses };
+export { APPLE_SA_TO_MACRO, AUDIO_MACRO_LABELS, AlarmArmModeSchema, CLIP_BROKER_PACED_RATES, COCO_TO_MACRO, CamProfileSchema, DEFAULT_TIMELAPSE_PREVIEW_TEXT, DEFINITIVE_DEVICE_REFUSALS, DEVICE_CERT_RENEW_WINDOW_DAYS, DEVICE_CERT_SIGNATURE, DEVICE_DEFINITIVE_REFUSALS_BEFORE_DELETE, DEVICE_REFRESH_REFUSAL_PREFIX, DEVICE_SIGNATURE_MESSAGE_VERSION, DeviceType, EVENTFUL_CAP_NAMES, EVENT_KIND_BY_CAP, EVENT_TAXONOMY, ICON_CATEGORIES, ICON_ENTRIES, ICON_KEYS, ICON_VIEWER_MODULES, IconKeySchema, LOCATION_ICON_FALLBACK, MACRO_LABELS, NC_ALARM_DELAY_MAX_SEC, NC_ALARM_SENSORS_MAX, NC_ALARM_SYSTEM_EVENT_KINDS, NC_ALARM_TRIGGERED_MAX_SEC, NC_BATTERY_CONSUMABLE_SYSTEM_EVENT_KINDS, NC_CAMERA_SCOPE_CAP_NAME, NC_CONSUMABLE_LOW_PERCENT_DEFAULT, NC_CONSUMABLE_LOW_PERCENT_MAX, NC_GROUPING_DEFAULT_SEC, NC_GROUPING_MAX_SEC, NC_GROUPING_MIN_SEC, NC_RULE_EDITOR_SECTION_ORDER, NC_RULE_KIND_SPECS, NC_SENSOR_TRANSITION_UNSUPPORTED_REASON, NC_SYSTEM_EVENT_CLASS_SPECS, NC_SYSTEM_EVENT_FAMILY_FILTERS, NC_SYSTEM_EVENT_KIND_GROUP_SPECS, NC_SYSTEM_EVENT_SUMMARY_FAMILIES, NC_TEMPLATE_HELD_BACK_SYSTEM_EVENT_KINDS, NC_TEMPLATE_VARS, NcAlarmConfigSchema, NcAlarmSensorsSchema, NcAlarmSettingsPatchSchema, NcHistoryEntrySchema, NcRuleLastRunsSchema, NodeDirectorySchema, RECORDING_EXPORT_MAX_READ_BYTES, RETRAIN_REVIEW_ADJUSTED_IOU, RETRAIN_REVIEW_MATCH_IOU, RETRAIN_REVIEW_STATUSES, RETRAIN_REVISION_CONFLICT, SystemMirror, TIMELAPSE_DENSE_FLOOR_SEC, TimelapseRuleSchema, YAMNET_TO_MACRO, alarmDeviceBlocksArming, alarmDeviceSecureOnArm, alarmPatchLanded, buildDeviceEnrollmentLink, buildDeviceSignatureMessage, buildSubjectPath, bundledCamstack, canonicalIconKey, classifyRetrainReview, conditionVisibleForKind, createSystemProxy, deviceRefusalFromMessage, droppedConditionsForKind, expandSystemEventClasses, iconCategoryLabel, iconEntry, iconsInCategory, isDefinitiveDeviceRefusal, isDrawableSubjectPath, isHeldBackTemplateVar, isIconKey, isSystemRuleKind, kindsForDiscriminator, knownValues, locationIconKey, nodePickerItems, packagePickerItems, paintHex, paletteResultSchema, parseDeviceEnrollmentLink, parseRetrainRevisionConflict, pickerForCondition, pickerForRuleClasses, projectSubjectPath, resolveContainerPrimaryChild, resolveIconKey, resolveModeDelays, retrainBoxIou, retrainRevisionConflictMessage, ruleDeviceCompatCapNames, ruleEditorSectionsForKind, ruleGroupingApplies, ruleKindOf, ruleKindSpec, ruleSeedForSection, searchIcons, sensorTransitionNeverFires, sensorTransitionOffered, stateLabel, subjectPathSampleFromBox, subjectPathSvgPoints, summarizeReview, systemEventClassKinds, systemEventClassesFor, systemEventDeliveryProblems, systemEventFilterAppliesToAnyKind, systemEventKindsOfFamily, systemFamilyOfKind, templateCarriesSummary, templateVarDeliveryApplies, templateVarKindApplies, templateVarSystemEventApplies, withSystemEventClasses };

package/dist/composition/composition.d.ts

@@ -775,6 +775,7 @@ export declare const CompositionSchema: z.ZodObject<{
         templateId: typeof import("./index.js").GroupTemplateIdSchema;
         aggregate: typeof import("./index.js").AggregateReducerSchema;
         members: z.ZodArray<typeof import("./index.js").HelperMemberSchema>;
+        active: z.ZodOptional<typeof import("./index.js").ActiveCriterionSchema>;
     }, z.core.$strip>], "kind">>;
 }, z.core.$strip>;
 export type Composition = z.infer<typeof CompositionSchema>;

package/dist/composition/helpers/actuator.d.ts

@@ -0,0 +1,58 @@
+/**
+ * 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.
+ */
+import { DeviceFeature } from '../../device/device-type.js';
+import type { ActiveCriterion, BinaryAggregate } from './spec.js';
+/** Caps a light group may expose, in display order. Switch is the active state. */
+export declare const LIGHT_SHARED_CAPS: readonly ['switch', 'brightness', 'color'];
+export type LightSharedCap = (typeof LIGHT_SHARED_CAPS)[number];
+/** How many member calls run at once. The rest wait; none are dropped. */
+export declare const FAN_OUT_CONCURRENCY: number;
+export interface FanOutMember {
+    readonly deviceId: number;
+    readonly caps: readonly string[];
+    /** Offline members are still commanded — they may wake. Not a reason to skip. */
+    readonly online: boolean;
+}
+export interface FanOutCall {
+    readonly deviceId: number;
+    readonly cap: string;
+    readonly method: string;
+    readonly args: Readonly<Record<string, unknown>>;
+}
+export interface FanOutOk {
+    readonly deviceId: number;
+    readonly ok: true;
+}
+export interface FanOutFailed {
+    readonly deviceId: number;
+    readonly ok: false;
+    readonly error: string;
+}
+export type FanOutMemberResult = FanOutOk | FanOutFailed;
+/** `at-least-one` is any included member on; `all` is every included member on. */
+export declare function reducerForActive(active: ActiveCriterion): BinaryAggregate;
+export declare function activeForReducer(reducer: BinaryAggregate): ActiveCriterion;
+/**
+ * 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.
+ */
+export declare function sharedLightCaps(memberCaps: readonly (readonly string[])[]): readonly string[];
+/**
+ * Colour modes every member advertises. Offline does not remove a mode:
+ * the caller passes device features, not liveness. No members → no mode.
+ */
+export declare function sharedColorModes(memberFeatures: readonly (readonly string[])[]): readonly DeviceFeature[];
+/**
+ * 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.
+ */
+export declare function fanOutTargets(members: readonly FanOutMember[], cap: string, method: string, args: Readonly<Record<string, unknown>>): readonly FanOutCall[];
+/**
+ * Run every call. A throw is that member's result; the other calls still run.
+ * At most {@link FAN_OUT_CONCURRENCY} are in flight.
+ */
+export declare function runFanOut(calls: readonly FanOutCall[], invoke: (call: FanOutCall) => Promise<void>): Promise<readonly FanOutMemberResult[]>;

package/dist/composition/helpers/catalog.d.ts

@@ -16,14 +16,19 @@ export interface HelperCompanion {
 }
 export interface GroupTemplate {
     readonly id: GroupTemplateId;
-    readonly family: 'numeric' | 'binary';
+    readonly family: 'numeric' | 'binary' | 'actuator';
     readonly summary: string;
     readonly deviceType: DeviceType;
-    readonly role: DeviceRole;
+    readonly role: DeviceRole | undefined;
     /** Members are this one device type. */
     readonly memberDeviceType: DeviceType;
     readonly outputCap: string;
     readonly outputField: string;
+    /**
+     * Methods the composer fans out. Empty for a reading. A free composition
+     * still cannot serve these caps (`has-commands`).
+     */
+    readonly commandCaps: readonly string[];
     /** Quantity of the output reading. `device` is chosen per numeric sensor. */
     readonly quantity: ReadingQuantity;
     readonly baseUnit: string | undefined;

package/dist/composition/helpers/index.d.ts

@@ -1,6 +1,7 @@
+export { FAN_OUT_CONCURRENCY, LIGHT_SHARED_CAPS, type FanOutCall, type FanOutFailed, type FanOutMember, type FanOutMemberResult, type FanOutOk, type LightSharedCap, activeForReducer, fanOutTargets, reducerForActive, runFanOut, sharedColorModes, sharedLightCaps, } from './actuator.js';
 export { type AggregateCounts, type AggregateEmpty, type AggregateOutcome, type AggregatePublish, type AggregateReadResult, type AggregateUnavailable, type AggregateValue, type EvaluateAggregateInput, evaluateAggregate, } from './aggregate.js';
 export { type GroupTemplate, type HelperAccept, type HelperCompanion, GROUP_TEMPLATES, groupTemplate, } from './catalog.js';
 export { type HelperCompileResult, type HelperCompiled, type HelperRefused, compileHelper, sameHelperBody, templateDeviceType, } from './compile.js';
 export { type HelperMemberFact, helperSaveProblems, } from './save.js';
 export { type SourcePick, type SourcePickAccept, type SourcePickHistory, type SourcePickRequest, sourcePickForTemplate, } from './source-pick.js';
-export { AGGREGATE_REDUCERS, AggregateReducerSchema, BINARY_AGGREGATES, GROUP_TEMPLATE_IDS, GroupHelperSpecSchema, GroupTemplateIdSchema, HelperMemberSchema, HelperSpecSchema, MAX_HELPER_MEMBERS, NUMERIC_AGGREGATES, type AggregateReducer, type BinaryAggregate, type GroupHelperSpec, type GroupTemplateId, type HelperMember, type HelperSpec, type NumericAggregate, } from './spec.js';
+export { ACTIVE_CRITERIA, AGGREGATE_REDUCERS, ActiveCriterionSchema, AggregateReducerSchema, BINARY_AGGREGATES, GROUP_TEMPLATE_IDS, GroupHelperSpecSchema, GroupTemplateIdSchema, HelperMemberSchema, HelperSpecSchema, MAX_HELPER_MEMBERS, NUMERIC_AGGREGATES, type ActiveCriterion, type AggregateReducer, type BinaryAggregate, type GroupHelperSpec, type GroupTemplateId, type HelperMember, type HelperSpec, type NumericAggregate, } from './spec.js';

package/dist/composition/helpers/spec.d.ts

@@ -6,16 +6,20 @@ import { z } from 'zod';
 import { CompositionSourceRefSchema } from '../source-ref.js';
 /** A group may name more members than an expression call (the 16-arg cap). */
 export declare const MAX_HELPER_MEMBERS: number;
-export declare const GROUP_TEMPLATE_IDS: readonly ['temperature', 'humidity', 'pressure', 'illuminance', 'power', 'energy', 'battery', 'numeric', 'motion', 'contact', 'leak', 'smoke', 'occupancy', 'binary'];
+export declare const GROUP_TEMPLATE_IDS: readonly ['temperature', 'humidity', 'pressure', 'illuminance', 'power', 'energy', 'battery', 'numeric', 'motion', 'contact', 'leak', 'smoke', 'occupancy', 'binary', 'switch', 'light'];
 export type GroupTemplateId = (typeof GROUP_TEMPLATE_IDS)[number];
 export declare const NUMERIC_AGGREGATES: readonly ['mean', 'median', 'min', 'max', 'sum'];
 export type NumericAggregate = (typeof NUMERIC_AGGREGATES)[number];
 export declare const BINARY_AGGREGATES: readonly ['any', 'all'];
 export type BinaryAggregate = (typeof BINARY_AGGREGATES)[number];
+/** How an actuator group decides it is on. Unknown members never count as off. */
+export declare const ACTIVE_CRITERIA: readonly ['at-least-one', 'all'];
+export type ActiveCriterion = (typeof ACTIVE_CRITERIA)[number];
 export declare const AGGREGATE_REDUCERS: readonly ['mean', 'median', 'min', 'max', 'sum', 'any', 'all'];
 export type AggregateReducer = (typeof AGGREGATE_REDUCERS)[number];
 export declare const GroupTemplateIdSchema: z.ZodType<GroupTemplateId>;
 export declare const AggregateReducerSchema: z.ZodType<AggregateReducer>;
+export declare const ActiveCriterionSchema: z.ZodType<ActiveCriterion>;
 /** One member. The field is stored so occupancy can name motion or binary. */
 export declare const HelperMemberSchema: z.ZodObject<{
     source: typeof CompositionSourceRefSchema;
@@ -32,6 +36,7 @@ export declare const GroupHelperSpecSchema: z.ZodObject<{
     templateId: typeof GroupTemplateIdSchema;
     aggregate: typeof AggregateReducerSchema;
     members: z.ZodArray<typeof HelperMemberSchema>;
+    active: z.ZodOptional<typeof ActiveCriterionSchema>;
 }>;
 export type GroupHelperSpec = z.infer<typeof GroupHelperSpecSchema>;
 export declare const HelperSpecSchema: z.ZodDiscriminatedUnion<[typeof GroupHelperSpecSchema], 'kind'>;

package/dist/{composition-B85l9j1M.mjs → composition-OhpuespA.mjs}

@@ -2193,7 +2193,9 @@ var GROUP_TEMPLATE_IDS = [
 	"leak",
 	"smoke",
 	"occupancy",
-	"binary"
+	"binary",
+	"switch",
+	"light"
 ];
 var NUMERIC_AGGREGATES = [
 	"mean",
@@ -2203,6 +2205,8 @@ var NUMERIC_AGGREGATES = [
 	"sum"
 ];
 var BINARY_AGGREGATES = ["any", "all"];
+/** How an actuator group decides it is on. Unknown members never count as off. */
+var ACTIVE_CRITERIA = ["at-least-one", "all"];
 var AGGREGATE_REDUCERS = [
 	"mean",
 	"median",
@@ -2214,6 +2218,7 @@ var AGGREGATE_REDUCERS = [
 ];
 var GroupTemplateIdSchema = z.enum(GROUP_TEMPLATE_IDS);
 var AggregateReducerSchema = z.enum(AGGREGATE_REDUCERS);
+var ActiveCriterionSchema = z.enum(ACTIVE_CRITERIA);
 /** One member. The field is stored so occupancy can name motion or binary. */
 var HelperMemberSchema = z.object({
 	source: CompositionSourceRefSchema,
@@ -2228,7 +2233,9 @@ var GroupHelperSpecSchema = z.object({
 	kind: z.literal("group"),
 	templateId: GroupTemplateIdSchema,
 	aggregate: AggregateReducerSchema,
-	members: z.array(HelperMemberSchema).min(1).max(64)
+	members: z.array(HelperMemberSchema).min(1).max(64),
+	/** Actuator groups only. Readings leave this unset. */
+	active: ActiveCriterionSchema.optional()
 });
 var HelperSpecSchema = z.discriminatedUnion("kind", [GroupHelperSpecSchema]);
 //#endregion
@@ -2490,4 +2497,4 @@ function featureSources(feature) {
 	return featureFieldEntries(feature).map((e) => e.source);
 }
 //#endregion
-export { evaluateStatefulExpressionCall as $, compositionFeatureEnabled as A, evaluateSensorLevelEdge as At, BINARY_AGGREGATES as B, canonicalHash as Bt, CompositionTargetSchema as C, ExpressionParseError as Ct, MAX_COMPOSITION_ITEMS as D, SOURCE_CAP_CHANGED_AT_FIELD as Dt, MAX_COMPOSITION_FIELDS_PER_FEATURE as E, SOURCE_CAP_ACTIVE_FIELD as Et, featureFieldEntries as F, chooseFfmpegBinary as Ft, HelperSpecSchema as G, buildFfmpegArgs as Gt, GroupHelperSpecSchema as H, AUDIO_PRESETS as Ht, featureSources as I, ffmpegBinaryName as It, CompositionSourceRefSchema as J, invocationFromEncodeProfile as Jt, MAX_HELPER_MEMBERS as K, buildInputArgs as Kt, fieldReads as L, FFMPEG_RELEASE as Lt, compositionReadKey as M, sliceActiveValue as Mt, compositionSliceKey as N, sliceChangedAt as Nt, composedDeviceRef as O, SOURCE_DEVICE_TYPES as Ot, compositionSourceKey as P, FFMPEG_PATH_ENV as Pt, evaluateExpressionSource as Q, resolveStreamMaps as Qt, AGGREGATE_REDUCERS as R, getFfmpegArtifact as Rt, CompositionSchema as S, ExpressionEvalError as St, MAX_COMPOSITION_FEATURES as T, SOURCE_CAPS as Tt, GroupTemplateIdSchema as U, audioPlanFromEncodeProfile as Ut, GROUP_TEMPLATE_IDS as V, Fmp4BoxSplitter as Vt, HelperMemberSchema as W, buildAudioArgs as Wt, cloneStatefulExpressionMemory as X, logBannerArgs as Xt, EXPRESSION_INJECTED_NOW as Y, isSoftwareDecode as Yt, createStatefulExpressionMemory as Z, pickVideoEncoder as Zt, CompositionFromSourceSchema as _, EXPRESSION_BUILTIN_NAMES as _t, CUSTOMIZATION_BLOCK_NAME_PREFIX as a, compileExpressionSafe as at, CompositionNewTargetSchema as b, evaluateRose as bt, CompositionCodeSourceSchema as c, EXPRESSION_COMPILE_CACHE_CAPACITY as ct, CompositionExpressionSourceSchema as d, MAX_EXPRESSION_BINDINGS as dt, toExpressionValue as et, CompositionFeatureSchema as f, MAX_EXPRESSION_CALL_ARGS as ft, CompositionForwardCommandSchema as g, EXPRESSION_BUILTINS as gt, CompositionFieldsFeatureSchema as h, RESERVED_BINDING_NAMES as ht, COMPOSITION_ITEM_KEY_RE as i, compileExpression as it, compositionItemFieldPath as j, isSourceCap as jt, composedDeviceStableId as k, evaluateSensorEdge as kt, CompositionCommandTargetSchema as l, EXPRESSION_IDENTIFIER_RE as lt, CompositionFieldSourceSchema as m, MAX_EXPRESSION_SOURCE_LENGTH as mt, COMPOSER_ADDON_ID as n, createExpressionScope as nt, CompositionAggregateSourceSchema as o, parseExpression as ot, CompositionFieldReadSchema as p, MAX_EXPRESSION_EVAL_STEPS as pt, NUMERIC_AGGREGATES as q, buildVideoArgs as qt, COMPOSITION_ITEM_ARRAY_PATH as r, evaluateAst as rt, CompositionBindingSchema as s, tokenize as st, COMPOSED_DEVICE_STABLE_ID_PREFIX as t, validateExpressionSource as tt, CompositionExistingTargetSchema as u, MAX_EXPRESSION_AST_NODES as ut, CompositionItemEntrySchema as v, disarmRoseMemory as vt, MAX_COMPOSITION_CODE_LENGTH as w, DEFAULT_FIRST_SIGHTING_FRESHNESS_MS as wt, CompositionPassthroughFeatureSchema as x, isStatefulBuiltin as xt, CompositionLiteralBindingSchema as y, evaluateCount as yt, AggregateReducerSchema as z, getFfmpegDownloadUrl as zt };
+export { createStatefulExpressionMemory as $, pickVideoEncoder as $t, compositionFeatureEnabled as A, SOURCE_DEVICE_TYPES as At, ActiveCriterionSchema as B, getFfmpegArtifact as Bt, CompositionTargetSchema as C, isStatefulBuiltin as Ct, MAX_COMPOSITION_ITEMS as D, SOURCE_CAPS as Dt, MAX_COMPOSITION_FIELDS_PER_FEATURE as E, DEFAULT_FIRST_SIGHTING_FRESHNESS_MS as Et, featureFieldEntries as F, sliceChangedAt as Ft, GroupTemplateIdSchema as G, audioPlanFromEncodeProfile as Gt, BINARY_AGGREGATES as H, canonicalHash as Ht, featureSources as I, FFMPEG_PATH_ENV as It, MAX_HELPER_MEMBERS as J, buildInputArgs as Jt, HelperMemberSchema as K, buildAudioArgs as Kt, fieldReads as L, chooseFfmpegBinary as Lt, compositionReadKey as M, evaluateSensorLevelEdge as Mt, compositionSliceKey as N, isSourceCap as Nt, composedDeviceRef as O, SOURCE_CAP_ACTIVE_FIELD as Ot, compositionSourceKey as P, sliceActiveValue as Pt, cloneStatefulExpressionMemory as Q, logBannerArgs as Qt, ACTIVE_CRITERIA as R, ffmpegBinaryName as Rt, CompositionSchema as S, evaluateRose as St, MAX_COMPOSITION_FEATURES as T, ExpressionParseError as Tt, GROUP_TEMPLATE_IDS as U, Fmp4BoxSplitter as Ut, AggregateReducerSchema as V, getFfmpegDownloadUrl as Vt, GroupHelperSpecSchema as W, AUDIO_PRESETS as Wt, CompositionSourceRefSchema as X, invocationFromEncodeProfile as Xt, NUMERIC_AGGREGATES as Y, buildVideoArgs as Yt, EXPRESSION_INJECTED_NOW as Z, isSoftwareDecode as Zt, CompositionFromSourceSchema as _, RESERVED_BINDING_NAMES as _t, CUSTOMIZATION_BLOCK_NAME_PREFIX as a, evaluateAst as at, CompositionNewTargetSchema as b, disarmRoseMemory as bt, CompositionCodeSourceSchema as c, parseExpression as ct, CompositionExpressionSourceSchema as d, EXPRESSION_IDENTIFIER_RE as dt, resolveStreamMaps as en, evaluateExpressionSource as et, CompositionFeatureSchema as f, MAX_EXPRESSION_AST_NODES as ft, CompositionForwardCommandSchema as g, MAX_EXPRESSION_SOURCE_LENGTH as gt, CompositionFieldsFeatureSchema as h, MAX_EXPRESSION_EVAL_STEPS as ht, COMPOSITION_ITEM_KEY_RE as i, createExpressionScope as it, compositionItemFieldPath as j, evaluateSensorEdge as jt, composedDeviceStableId as k, SOURCE_CAP_CHANGED_AT_FIELD as kt, CompositionCommandTargetSchema as l, tokenize as lt, CompositionFieldSourceSchema as m, MAX_EXPRESSION_CALL_ARGS as mt, COMPOSER_ADDON_ID as n, toExpressionValue as nt, CompositionAggregateSourceSchema as o, compileExpression as ot, CompositionFieldReadSchema as p, MAX_EXPRESSION_BINDINGS as pt, HelperSpecSchema as q, buildFfmpegArgs as qt, COMPOSITION_ITEM_ARRAY_PATH as r, validateExpressionSource as rt, CompositionBindingSchema as s, compileExpressionSafe as st, COMPOSED_DEVICE_STABLE_ID_PREFIX as t, evaluateStatefulExpressionCall as tt, CompositionExistingTargetSchema as u, EXPRESSION_COMPILE_CACHE_CAPACITY as ut, CompositionItemEntrySchema as v, EXPRESSION_BUILTINS as vt, MAX_COMPOSITION_CODE_LENGTH as w, ExpressionEvalError as wt, CompositionPassthroughFeatureSchema as x, evaluateCount as xt, CompositionLiteralBindingSchema as y, EXPRESSION_BUILTIN_NAMES as yt, AGGREGATE_REDUCERS as z, FFMPEG_RELEASE as zt };

package/dist/{composition-OJKOJJD-.js → composition-re1aezX9.js}

@@ -2193,7 +2193,9 @@ var GROUP_TEMPLATE_IDS = [
 	"leak",
 	"smoke",
 	"occupancy",
-	"binary"
+	"binary",
+	"switch",
+	"light"
 ];
 var NUMERIC_AGGREGATES = [
 	"mean",
@@ -2203,6 +2205,8 @@ var NUMERIC_AGGREGATES = [
 	"sum"
 ];
 var BINARY_AGGREGATES = ["any", "all"];
+/** How an actuator group decides it is on. Unknown members never count as off. */
+var ACTIVE_CRITERIA = ["at-least-one", "all"];
 var AGGREGATE_REDUCERS = [
 	"mean",
 	"median",
@@ -2214,6 +2218,7 @@ var AGGREGATE_REDUCERS = [
 ];
 var GroupTemplateIdSchema = zod.z.enum(GROUP_TEMPLATE_IDS);
 var AggregateReducerSchema = zod.z.enum(AGGREGATE_REDUCERS);
+var ActiveCriterionSchema = zod.z.enum(ACTIVE_CRITERIA);
 /** One member. The field is stored so occupancy can name motion or binary. */
 var HelperMemberSchema = zod.z.object({
 	source: CompositionSourceRefSchema,
@@ -2228,7 +2233,9 @@ var GroupHelperSpecSchema = zod.z.object({
 	kind: zod.z.literal("group"),
 	templateId: GroupTemplateIdSchema,
 	aggregate: AggregateReducerSchema,
-	members: zod.z.array(HelperMemberSchema).min(1).max(64)
+	members: zod.z.array(HelperMemberSchema).min(1).max(64),
+	/** Actuator groups only. Readings leave this unset. */
+	active: ActiveCriterionSchema.optional()
 });
 var HelperSpecSchema = zod.z.discriminatedUnion("kind", [GroupHelperSpecSchema]);
 //#endregion
@@ -2490,6 +2497,12 @@ function featureSources(feature) {
 	return featureFieldEntries(feature).map((e) => e.source);
 }
 //#endregion
+Object.defineProperty(exports, "ACTIVE_CRITERIA", {
+	enumerable: true,
+	get: function() {
+		return ACTIVE_CRITERIA;
+	}
+});
 Object.defineProperty(exports, "AGGREGATE_REDUCERS", {
 	enumerable: true,
 	get: function() {
@@ -2502,6 +2515,12 @@ Object.defineProperty(exports, "AUDIO_PRESETS", {
 		return AUDIO_PRESETS;
 	}
 });
+Object.defineProperty(exports, "ActiveCriterionSchema", {
+	enumerable: true,
+	get: function() {
+		return ActiveCriterionSchema;
+	}
+});
 Object.defineProperty(exports, "AggregateReducerSchema", {
 	enumerable: true,
 	get: function() {

package/dist/device/cap-vocabulary/entries/sensors.d.ts

@@ -1,5 +1,5 @@
 import type { CapVocabularySlice } from '../types.js';
-type SensorCap = 'air-quality-sensor' | 'ambient-light-sensor' | 'binary' | 'carbon-monoxide' | 'connectivity' | 'contact' | 'enum-sensor' | 'flood' | 'gas' | 'group-status' | 'humidity-sensor' | 'motion' | 'numeric-sensor' | 'power-meter' | 'presence' | 'pressure-sensor' | 'smoke' | 'tamper' | 'temperature-sensor' | 'vibration' | 'weather' | 'battery' | 'network-link' | 'device-status' | 'doorbell' | 'event-emitter';
+type SensorCap = 'air-quality-sensor' | 'ambient-light-sensor' | 'binary' | 'carbon-monoxide' | 'connectivity' | 'contact' | 'enum-sensor' | 'flood' | 'gas' | 'group-commands' | 'group-status' | 'humidity-sensor' | 'motion' | 'numeric-sensor' | 'power-meter' | 'presence' | 'pressure-sensor' | 'smoke' | 'tamper' | 'temperature-sensor' | 'vibration' | 'weather' | 'battery' | 'network-link' | 'device-status' | 'doorbell' | 'event-emitter';
 /** The sensor family of the vocabulary. */
 export declare const SENSOR_CAP_VOCABULARY: CapVocabularySlice<SensorCap>;
 export {};

package/dist/enums/event-category.d.ts

@@ -322,6 +322,14 @@ export declare enum EventCategory {
     PipelineMotionNoisy = "pipeline.motion-noisy",
     /** The recovery edge of {@link PipelineMotionNoisy}: the motion fell back, or a detection arrived. */
     PipelineMotionCalm = "pipeline.motion-calm",
+    /**
+     * A camera's package LLM confirm has failed closed three times in a row
+     * (D931, 2026-10-26). One edge per camera until
+     * {@link PipelinePackageLlmAnswered}.
+     */
+    PipelinePackageLlmSilent = "pipeline.package-llm-silent",
+    /** The recovery edge of {@link PipelinePackageLlmSilent}: a confirm returned yes or no. */
+    PipelinePackageLlmAnswered = "pipeline.package-llm-answered",
     /**
      * Per-camera pipeline config was mutated by the orchestrator
      * (a settings change via `setAgentInferenceDevices` /

package/dist/enums.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_event_category = require("./event-category-DXZ3f9Q5.js");
+const require_event_category = require("./event-category-Ave2VSxY.js");
 //#region src/enums/event-source-type.ts
 var EventSourceType = /* @__PURE__ */ function(EventSourceType) {
 	EventSourceType["Addon"] = "addon";

package/dist/enums.mjs

@@ -1,4 +1,4 @@
-import { t as EventCategory } from "./event-category-DHXxB8t9.mjs";
+import { t as EventCategory } from "./event-category-CT-hz5Rb.mjs";
 //#region src/enums/event-source-type.ts
 var EventSourceType = /* @__PURE__ */ function(EventSourceType) {
 	EventSourceType["Addon"] = "addon";

package/dist/{event-category-DXZ3f9Q5.js → event-category-Ave2VSxY.js}

@@ -324,6 +324,14 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	/** The recovery edge of {@link PipelineMotionNoisy}: the motion fell back, or a detection arrived. */
 	EventCategory["PipelineMotionCalm"] = "pipeline.motion-calm";
 	/**
+	* A camera's package LLM confirm has failed closed three times in a row
+	* (D931, 2026-10-26). One edge per camera until
+	* {@link PipelinePackageLlmAnswered}.
+	*/
+	EventCategory["PipelinePackageLlmSilent"] = "pipeline.package-llm-silent";
+	/** The recovery edge of {@link PipelinePackageLlmSilent}: a confirm returned yes or no. */
+	EventCategory["PipelinePackageLlmAnswered"] = "pipeline.package-llm-answered";
+	/**
 	* Per-camera pipeline config was mutated by the orchestrator
 	* (a settings change via `setAgentInferenceDevices` /
 	* `setCameraStepToggle` / `setCameraStepSettings`). Orchestrator

package/dist/{event-category-DHXxB8t9.mjs → event-category-CT-hz5Rb.mjs}

@@ -324,6 +324,14 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	/** The recovery edge of {@link PipelineMotionNoisy}: the motion fell back, or a detection arrived. */
 	EventCategory["PipelineMotionCalm"] = "pipeline.motion-calm";
 	/**
+	* A camera's package LLM confirm has failed closed three times in a row
+	* (D931, 2026-10-26). One edge per camera until
+	* {@link PipelinePackageLlmAnswered}.
+	*/
+	EventCategory["PipelinePackageLlmSilent"] = "pipeline.package-llm-silent";
+	/** The recovery edge of {@link PipelinePackageLlmSilent}: a confirm returned yes or no. */
+	EventCategory["PipelinePackageLlmAnswered"] = "pipeline.package-llm-answered";
+	/**
 	* Per-camera pipeline config was mutated by the orchestrator
 	* (a settings change via `setAgentInferenceDevices` /
 	* `setCameraStepToggle` / `setCameraStepSettings`). Orchestrator